Rollbar notifier for Node.js

Generic library for reporting exceptions and other messages to Rollbar. Requires a Rollbar account.

##Quick start

// include and initialize the rollbar library with your access token
var rollbar = require("rollbar");
rollbar.init("POST_SERVER_ITEM_ACCESS_TOKEN");

// record a generic message and send to rollbar
rollbar.reportMessage("Hello world!");

Installation

Install using the node package manager, npm:

$ npm install --save rollbar

Configuration

Using Express

var express = require('express');
var rollbar = require('rollbar');

var app = express();

app.get('/', function(req, res) {
  // ...
});

// Use the rollbar error handler to send exceptions to your rollbar account
app.use(rollbar.errorHandler('POST_SERVER_ITEM_ACCESS_TOKEN'));

app.listen(6943);

Standalone

In your main application, require and initialize using your access_token::

var rollbar = require("rollbar");
rollbar.init("POST_SERVER_ITEM_ACCESS_TOKEN");

Other options can be passed into the init() function using a second parameter. E.g.:

// Queue up and report messages/exceptions to rollbar every 5 seconds
rollbar.init("POST_SERVER_ITEM_ACCESS_TOKEN", {handler: "setInterval", handlerInterval: 5});

When you are finished using rollbar, clean up any remaining items in the queue using the shutdown function:

rollbar.shutdown();

Configuration reference

rollbar.init() takes the following configuration options (pass in the second parameter):

Default: os.hostname()

Default: 'production'

• setInterval -- all items that are queued up are sent to rollbar in batches in a setInterval callback
  • NOTE: using this mode will mean that items are queued internally before being sent. For applications that send a very large amount of items, it is possible to use up too much memory and crash the node process. If this starts to happen, try lowering the handlerInterval setting or switch to a different handler, e.g. 'nextTick'.
• nextTick -- all items that are queued up are sent to rollbar in a process.nextTick callback
• inline -- items are sent to rollbar as they are queued up, one at-a-time

Default: setInterval

Default: 3

Default: 10

Default: 'https://api.rollbar.com/api/1/'

e.g. '/Users/bob/Development'

e.g. 'master'

Default: ['passwd', 'password', 'secret', 'confirm_password', 'password_confirmation']

Contributing

Contributions are welcome. The project is hosted on github at http://github.com/rollbar/node_rollbar

Examples

See the examples directory for more uses.

Additional Help

If you have any questions, feedback, etc., drop us a line at [email protected]