Set Up Bugsly for Express

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.

const Bugsly = require("@bugsly/node");

// Initialize before requiring express, so it can be instrumented
Bugsly.init({
  dsn: "https://your-dsn@bugsly.dev/1",
  environment: "production",
  tracesSampleRate: 1.0,
});

const express = require("express");
const app = express();

app.get("/", (req, res) => {
  res.json({ status: "ok" });
});

// Register after all routes, before your own error handlers
Bugsly.setupExpressErrorHandler(app);

app.listen(3000);

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"}]}}'

Weighing other options? Compare the best Node.js error tracking tools for Express and NestJS.

Frequently Asked Questions