Updating from airbrake-js for Node.js projects

Get the most out of Airbrake’s features and stay up to date with the latest improvements by updating your project to the latest version of our Node.js error reporting library.

Name change note

Our JavaScript library’s name has recently changed from airbrake-js to @airbrake/node (for Node.js apps). If you are using airbrake-js, we would recommend following this guide to update to the latest version of our JavaScript library.

Step 1: Uninstall airbrake-js

Uninstall the old package:

npm uninstall airbrake-js

Step 2: Install @airbrake/node

Install the new package with npm:

npm install @airbrake/node

We also support installation via Yarn.

Step 3: Replace mentions with new library

Note: Express.js users should follow our Express.js install guide.

Imports: Replace old library import:

var AirbrakeClient = require('airbrake-js');

With new package name:

var Airbrake = require('@airbrake/node');

Class names:

Replace configuration snippet instantiation with new name:

Change AirbrakeClient() to new name: Airbrake.Notifier() in your configuration snippet:

var airbrake = new Airbrake.Notifier({
  // project credentials are set here...

Find advanced configuration options and examples on our official GitHub repo.

Performance Monitoring for Express.js apps

Application Performance Monitoring with Airbrake makes it easy to:

  • Understand high-level performance: Quickly see a broad performance overview for your whole application.
  • Monitor user satisfaction: Measure user satisfaction with your app performance using Apdex.
  • Catch problem routes: Identify routes with slow or error-prone performance.
  • Analyze granular performance metrics: Zoom into specific endpoints to see time spent in the DB, view, cache, external requests, and more.
  • Dive into database performance: Analyze SQL database queries being called and how long they take.
  • Track your background jobs: Monitor background job performance, track job failures and durations.

To get started, install our Express.js middleware as shown in the install guide. Performance Monitoring is completely automatic after installation - no extra setup required.


Great job! If you’ve used this example in your app, you can visit your Airbrake project’s Performance Dashboard to see your performance data! Soon enough you’ll have more insights into your application’s performance. In the meantime why not check out the Performance Dashboard features. Have questions about Performance Monitoring? Check out our Performance Monitoring FAQ for more information.