Sentry middleware for Inngest.
npm install @inngest/middleware-sentryThis package provides a middleware for Inngest to interface with
Sentry.
- Capture exceptions for reporting
- Add tracing to each function run
- Include useful context for each exception and trace like function ID and event
names
``sh`
npm install @inngest/middleware-sentry
> [!NOTE]
> Requires inngest@>=3.0.0 and @sentry/*@>=8.0.0
To use the middleware, import and initialize it. It assumes that Sentry has
already been initialized elsewhere in your code using Sentry.init().
``ts
import * as Sentry from "@sentry/node";
import { Inngest } from "inngest";
import { sentryMiddleware } from "@inngest/middleware-sentry";
// Initialize Sentry as usual wherever is appropriate
Sentry.init(...);
const inngest = new Inngest({
id: "my-app",
middleware: [sentryMiddleware()],
});
`
By default, the middleware will force Sentry to
flush
as part of the Inngest request, ensuring all events, execptions, and traces are
sent before a response is returned.
This is important for serverless environments where the runtime doesn't wait for
the event loop to be empty and background tasks such as sending exception data
may be lost.
If you're not in a serverless runtime or otherwise wish to have Sentry handle
flushing itself, you can disable this behaviour by setting
disableAutomaticFlush: true.
`ts``
sentryMiddleware({
disableAutomaticFlush: true,
});