spm-agent

SPM Agent Framework for Node.js

• spm-agent is used in: spm-agent-nodejs, spm-agent-mongodb and sematext-agent-docker
• SPM: http://sematext.com/spm (performance monitoring, alerting, etc.)
• Node.js monitoring: http://sematext.com/spm/integrations/nodejs-monitoring.html

Functionality

• Sender interface to SPM backend receivers
• Buffering metrics to disk in case of network outages (using NeDB)
• Limit the file size of buffers
• Reconnect after failures
• Logging functions
• Configuration handling
• Pluggable agents

Example to implement a monitoring agent:

var SpmAgent = require('spm-agent')
var client = new SpmAgent()
var testAgent = client.createAgent(new SpmAgent.Agent ({
  start: function (agent) {
    // initialize your metrics collector ...
    this.tid = setInterval(function () {
      // get every 30 seconds some metrics 
      // SPM gets an array of metrics for a specific app
       agent.addMetrics({name: 'test-app', value: [1, 2, 3]})
    }, client.config.collectionInterval)
  }
}))
// monitor which values we added by "addMetrics"
testAgent.on ('metrics', console.log)

Let us know about monitoring agents you need, maybe you like to contribute with your domain expertise!

Related Modules

Please check spm-metrics-js to ship your application specific metrics to SPM.

Changelog

1.31.2

24 January 2017

• read spm client setting for docker hostname 2b89348
• add. parameters for docker setups 0d63e3d
• add support for YAML config files, updated dependencies ec6c242