JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 367
  • Score
    100M100P100Q91469F
  • License Copyright (c) Sematext Group, Inc.

Node.js monitoring agent for SPM by Sematext

Package Exports

  • spm-agent-nodejs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (spm-agent-nodejs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

spm-agent-nodejs

bitHound Score build status

npm-stats

SPM performance monitoring by Sematext - this is the Node.js monitoring agent for SPM.

Following information is collected and transmitted to SPM (Cloud or On-Premises version):

  • OS Metrics (CPU / Mem)
  • Process Memory
  • EventLoop stats
  • Garbage Collector stats
  • Web server stats (requests, error rate, response times etc.) Working for all web servers frameworks that use Node.js http/https module including
    • "connect" based frameworks
    • Express.js,
    • Sails.js
    • Hapi.js
    • Restify
    • and others ...

The module is able to run in cluster mode (master/worker).

Status

Supported Node-Versions: Node >= 0.10, io.js >= 1.2

Please check our blog for more information or contact us npmjs@sematext.com.

Installation


    npm install spm-agent-nodejs

Get a free account and create a Node.js API token at www.sematext.com

Configuration

We use https://www.npmjs.com/package/rc for configuration. This means config parameters can be passed via several config locations commandline args or ENV variables. We recommend to use a file in current directory in INI or JSON format called ".spmagentrc". This file can be generated by providing setting and environment variable and calling a helper script:

    export SPM_TOKEN=YOUR-SPM-TOKEN
    node ./node_modules/spm-agent-nodejs/bin/spmconfig.js

The command above generates following default configuration file:

    # Directory for buffered metrics
    dbDir = ./spmdb

    # Application Token for SPM
    [tokens]
      spm = YOUR-SPM-TOKEN

    [logger]
      # log file directory default is ./spmlogs
      dir = ./spmlogs
      # silent = true means no creation of log files
      silent = false
      # log level for output - debug, info, error, defaults to error to be quiet
      level = error

The only required setting is the SPM Application Token, this could be set via config file ".spmagentrc" or environment variable:

export spmagent_tokens__spm=YOUR-SPM-APP-TOKEN

Please note the use of double "_" for nested properties

Usage

Add this line at the begin of your source code / main script / app.js

    var spmAgent = require ('spm-agent-nodejs')

There is an alternative using io.js (>1.6.4). It supports a command line option "-r" to preload node modules before the actual application is started. In this case the original source code needs no modification:

  iojs -r './spm-agent-nodejs' yourApp.js

Results

Screenshot taken from announcement blog post

SPM for Node.js screenshot

Troubleshooting

Please visit our WIKI for more information

Other SPM related packages

Please check out spm-metrics-js to monitor any custom metric in your application.

spm-agent-docker, aka SPM for Docker

LICENCE

  Copyright (c) Sematext Group, Inc.
  All Rights Reserved

  SPM for NodeJS is free-to-use, proprietary software.
  THIS IS PROPRIETARY SOURCE CODE OF Sematext Group, Inc. (Sematext)
  This source code may not be copied, reverse engineered, or altered for any purpose.
  This source code is to be used exclusively by users and customers of Sematext.
  Please see the full license (found in LICENSE in this distribution) for details on its license and the licenses of its dependencies.