README.markdown

Exceptional for node.js

Exceptional helps you track errors in your node.js apps!

This module posts exception data from your node.js apps to Exceptional http://getexceptional.com. When an exception occurs, data about the environment and backtrace of the exception are sent.

To use Exceptional for node.js you must have an account at http://getexceptional.com.

Installation

Install from NPM:

npm install exceptional-node

var Exceptional = require('exceptional-node').Exceptional;

Exceptional.API_KEY = **YOUR-API-KEY**;

Alternately, include the exceptional.js file in your application, and set your Exceptional API-KEY

var Exceptional = require('./exceptional').Exceptional;

Exceptional.API_KEY = **YOUR-API-KEY**;

Usage

There a are multiple ways you can use exceptional with your node.js app.

• The process.uncaughtException event can be used to catch exceptions that bubble all the way up to the event loop.

process.addListener('uncaughtException', function(err) {
  Exceptional.handle(err);
});

• You can send exception data to exceptional from inside your own try/catch blocks

try {
  // Your Code
} catch(error) {
  // Your own error processing
  Exceptional.handle(error);
}

Example

Check out the small example in examples/demo.js (replace 'your-api-key-here' with your read API-KEY).

node example/demo.js

Copyright © 2008, 2010, 2012 getexceptional.com