bugsnag

Bugsnag error reporter for Node.js

Automatically detect synchronous and asynchronous errors in your Node.js apps, collect diagnostic information, and receive notifications immediately.

Learn more about error reporting with Bugsnag.

Features

• Automatically report synchronous and asynchronous errors
• Report handled errors
• Attach user information to determine how many people are affected by a crash
• Send customized diagnostic data

Getting started

1. Create a Bugsnag account
2. Complete the instructions in the integration guide for your framework:
   • Express or Connect
   • Koa
   • Restify
   • Other Node.js apps
3. Relax!

Support

• Read the configuration reference:
  • Express or Connect
  • Koa
  • Restify
  • Other Node.js apps
• Search open and closed issues for similar problems
• Report a bug or request a feature

Contributing

All contributors are welcome! For information on how to build, test and release bugsnag-node, see our contributing guide.

License

The Bugsnag error reporter for Node.js is free software released under the MIT License. See LICENSE.txt for details.

Changelog

2.4.0 (2018-06-01)

Note: this release alters the behaviour of the notifier to track sessions automatically.

As part of this change, the way in which URLs are configured has been updated:

- useSSL: true,
- notifyHost: 'bugsnag-notify.example.com',
- notifyPort: 9876
- notifyPath: '/payloads'
- sessionEndpoint: 'https://bugsnag-sessions.example.com',
+ endpoints: {
+  notify: 'https://bugsnag-notify.example.com:9876/payloads',
+  sessions: 'https://bugsnag-sessions.example.com'
+ }

useSSL, notifyHost, notifyPort, notifyPath and sessionEndpoint are now deprecated but still supported. Note that session tracking will be disabled if the notify endpoint is configured but the sessions endpoint is not – this is to avoid inadvertently sending session payloads to the wrong server.

Added

• Unit tests have been added for lib/configuration.js (#143)

Changed

• autoCaptureSessions default value was false and is now true (#143)
• The interval used to send periodic session summaries now has unref() called on it, to avoid keeping a process running that would otherwise terminate (#143)

Deprecated

• useSSL, notifyHost, notifyPort, notifyPath and sessionEndpoint have been deprecated and combined into a single new option: endpoints (#143)