Add Sentry to a Bun app

Sentry is an error tracking and performance monitoring platform. Its Bun SDK, @sentry/bun, instruments your application to automatically collect error and performance data. If you don’t have a Sentry account and project yet, create one at sentry.io, then return to this page.

First, install the Sentry Bun SDK.

terminal

bun add @sentry/bun

Then initialize the SDK with your Sentry DSN in your app’s entry file. You can find your DSN in your Sentry project settings.

sentry.ts

import * as Sentry from "@sentry/bun";

// Ensure to call this before importing any other modules!
Sentry.init({
  dsn: "__SENTRY_DSN__",

  // Add Performance Monitoring by setting tracesSampleRate
  // We recommend adjusting this value in production
  tracesSampleRate: 1.0,
});

Verify that Sentry is working by capturing a test error:

sentry.ts

setTimeout(() => {
  try {
    foo();
  } catch (e) {
    Sentry.captureException(e);
  }
}, 99);

To view and resolve the recorded error, log into sentry.io and open your project. Clicking the error’s title opens a page with details, where you can mark it as resolved.

To learn more about the Sentry Bun SDK, see the Sentry documentation.