Set Up Bugsly for Node.js

1. Install the SDK

2. Configure Bugsly

Add the following to your application entry point. Replace the DSN with your project DSN from the Bugsly dashboard.

import * as Bugsly from "@bugsly/node";

// Initialize before any other imports
Bugsly.init({
  dsn: "https://your-dsn@bugsly.dev/1",
  environment: "production",
  tracesSampleRate: 1.0,
});

// Uncaught exceptions and unhandled rejections are captured automatically.
// Capture handled errors manually:
Bugsly.captureException(new Error("Something broke"));

// Short-lived scripts: wait for the send before the process exits
await Bugsly.flush(2000);

// Add context to errors
Bugsly.setUser({ id: "user-123", email: "user@example.com" });
Bugsly.setTag("feature", "checkout");

3. Verify It Works

Trigger a test error in your application and check your Bugsly dashboard. The error should show up as an issue within a few seconds.

Want to check your DSN before touching any code? From a macOS, Linux or WSL terminal, this sends one real error without any SDK (replace your-dsn with the key from your DSN):

curl -sS -X POST "https://bugsly.dev/api/1/envelope/" \
  -H "X-Sentry-Auth: Sentry sentry_version=7, sentry_key=your-dsn" \
  --data-binary $'{}\n{"type":"event"}\n{"level":"error","platform":"other","exception":{"values":[{"type":"CurlTestError","value":"Hello from my terminal"}]}}'

Choosing between tools? Our Node.js error tracking comparison covers Bugsly, Sentry, Rollbar, Honeybadger and Airbrake.

Frequently Asked Questions