monitor-dog

// Assume `process.env.MONITOR_PREFIX === 'myProject'`, then all events
// triggered via monitor dog will be prefixed with `myProject.`.
var monitor = require('monitor-dog');
 
// Trigger an increment (`myProject.requests`)
monitor.increment('requests');
 
// Trigger an increment with additional parameters
monitor.increment('requests', 1, ['env:prod', 'host': '127.0.0.1']);
 
// Trigger an increment with tags as object
monitor.increment('requests', 1, {env: 'prod', host: '127.0.0.1'});
 
// Trigger a gauge event (`myProject.404s`)
monitor.gauge('404s');
 
// Time requests...
var timer = monitor.timer('request.time');
request('http://example.com', function(req, res) {
  // Triggers a histogram event to `myProject.request.time`
  timer.stop();
});

var monitor = require('monitor-dog');
var IntervalMonitor = require('monitor-dog/lib/interval-monitor');
var util = require('util');
 
/**
 * 1. Subclass the IntervalMonitor class
 */
function MyCustomMonitor = function(monitor, prefix, interval) {
  IntervalMonitor.call(this, monitor, prefix, interval);
}
util.inherits(MyCustomMonitor, IntervalMonitor);
 
/**
 * 2. Define your run function to periodically monitor what you wish
 */
MyCustomMonitor.prototype.run = function() {
  // ... Perform custom periodic reporting here using this.monitor
}
 
// 3. Instantiate and start your new interval monitor!
(new MyCustomMonitor(monitor)).start();

// Create the timer
var sumTimer = monitor.timer('sum.time');
 
// Perform a computation
var sum = 0;
for (var i = 0; i < 1000000; i  ) {
  sum  = i;
}
 
// Call .stop() to send a histogram event named 'sum.time'
// with the recorded duration...
sumTimer.stop();

var requestTimer = monitor.timer('request.time');
request('/some/endpoint', function (err, res) {
  requestTimer.stop();
});

var delayedTime = monitor.timer('delayed.timer', false);
 
// ... Do some other stuff ...
 
delayedTimer.start();
 
// ... Do some more stuff ...
 
delayedTimer.stop();

// start monitoring once you start web server
// default interval defined by `process.env.MONITOR_INTERVAL`
monitor.startSocketsMonitor();
 
// stop monitoring before stopping web server
monitor.stopSocketsMonitor();

monitor.captureStreamEvents('some-name', yourStream);