Sentry.io Traces Instrumentation

[johnny-woodtke]

While there are docs and articles out there that detail how to integrate basic Sentry error handling with an Elysia server, what follows is how to properly instrument an Elysia server to enable Sentry tracing.

Initialize Sentry:

// instrumentation/sentry.ts
import * as Sentry from "@sentry/bun";

const dsn = Bun.env.SENTRY_DSN;
if (!dsn) {
  throw new Error("SENTRY_DSN is not set");
}

const environment = Bun.env.SENTRY_ENVIRONMENT;
if (!environment) {
  throw new Error("SENTRY_ENVIRONMENT is not set");
}

Sentry.init({
  dsn,
  environment,
  integrations: [Sentry.bunServerIntegration()],
  tracesSampleRate: 1.0,
});

export default Sentry;

Instrument your Elysia server:

// index.ts
import Sentry from "./instrumentation/sentry"; // must be imported first

import { opentelemetry } from "@elysiajs/opentelemetry";
import { Elysia } from "elysia";

const port = Bun.env.PORT;
if (!port) {
  throw new Error("PORT is not set");
}

const app = new Elysia()
  .use(opentelemetry())
  .onError(({ error }) => {
    Sentry.captureException(error);
  })
  .get("/", () => "Server is running")
  .listen({
    port,
  });

Now you should see traces tracked by Sentry:

[kravetsone]

fine
Do you interested in sending PR with this guide to documentation?

[johnny-woodtke]

I'll turn this into a plugin and make a PR to add to the community plugins documentation.

[johnny-woodtke]

The plugin is here: https://github.com/johnny-woodtke/elysiajs-sentry

Added to the docs here: elysiajs/documentation#470