node.js client for Riemann. Because you should be monitoring all of those non-blocking buffet plates.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 35 commits behind perezd:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Riemann Node.js Client

because you should be monitoring all of those non-blocking buffet plates.


Riemann uses Google Protocol Buffers, so make sure thats installed beforehand, and available on your PATH.

npm install riemann

NOTE: unfortuantely, this module only works with node v0.6.x, for the time being. There is a problem with node's protocol buffers library support in node v0.8.x. If you'd like to contribute to solving that problem, it'd be greatly appreciated!

Getting Started

first things first, we'll want to establish a new client:

var client = require('riemann').createClient({ host: 'some.riemann.server', port: 5555 });
client.on('connect', function() { console.log('connected!'); });

Just like Riemann ruby client, the client sends small events over UDP, by default. TCP is used for queries, and large events. There is no acknowledgement of UDP packets, but they are roughly an order of magnitude faster than TCP. We assume both TCP and UDP are listening to the same port.

sending events is easy (see list of valid event properties):

  service: 'buffet_plates',
  metric:  252.2,
  tags:    ['nonblocking']

If you wanted to send that message over TCP and receive an acknowledgement, you can specify the transport, explicitly:

client.on('data', function(ack) { console.log('got it!'); });

  service: 'buffet_plates',
  metric:  252.2,
  tags:    ['nonblocking']
}), client.tcp);

When you're done monitoring, disconnect:

client.on('disconnect', function(){ console.log('disconnected!'); });


Contributing is easy, just send me a pull request. Please take a look at the project issues, to see how you can help. Here are some helpful tips:

  • install the developer dependencies using npm install --dev
  • please add tests. I'm using Mocha as a test runner, you can run the tests using npm test
  • please check your syntax with the included jshint configuration using npm run-script lint. It shouldn't report any errors.