leroix/node-statsd

node.js client for Etsy'd StatsD server

node-statsd

A node.js client for Etsy's StatsD server.

This client will let you fire stats at your StatsD server from a node.js application.

% npm install node-statsd
% node
> var StatsD = require('node-statsd').StatsD
> c = new StatsD('example.org',8125)
{ host: 'example.org', port: 8125 }
> c.increment('node_test.int')
> c.decrement('node_test.int')
> c.timing('node_test.some_service.task.time', 500) // time in millis

License

node-statsd is licensed under the MIT license.

Status

node-statsd should run on modern nodes, and will soon be tested on 0.8 and 0.6.

Error handling policy

• exceptions "bubble up" into the app that uses this library
• we don't log or print to console any errors ourself, it's the toplevel app that decides how to log/write to console.
• we document which exceptions can be raised, and where. (TODO, sivy#17)

in your main app, you can leverage the fact that you have access to c.socket and do something like: (this is the best way I've found so far)

c.socket.on('error', function (exception) {
   return console.log ("error event in socket.send(): " + exception);
});