ref(node)!: Remove deprecated fastify exports, deprecate setupFastifyErrorHandler

MIGRATION.md

@@ -616,6 +616,12 @@ Affected SDKs: All server-side SDKs.
 
 The LangGraph instrumentation no longer emits `gen_ai.create_agent` spans when a graph is compiled. `gen_ai.invoke_agent` and `gen_ai.execute_tool` spans are unaffected. If you reference `create_agent` spans in dashboards or alerts, update them accordingly.
 
+### Fastify: `setupFastifyErrorHandler` is deprecated
+
+Affected SDKs: All server-side SDKs.
+
+`fastifyIntegration` is now a single, channel-based plugin that instruments Fastify v3.21 through v5, including error capture. Calling `setupFastifyErrorHandler(app)` is no longer required — errors are captured automatically once the integration is added `setupFastifyErrorHandler` is therefore deprecated and will be removed in the next major.
+
 ### `@sentry/nextjs`
 
 **Tracing removed from generated templates:** Tracing was removed from the generated Pages Router API handler, Edge API handler, and Middleware wrapper templates. Route handlers and middleware are still instrumented automatically, so no action is required for most users.
@@ -806,6 +812,7 @@ Sentry.init({
 - (Remix) The `@sentry/remix/loader` entry point was removed. Use `node --import @sentry/remix/import` instead.
 - (TanStack Start) The `@sentry/tanstackstart-react/loader` entry point was removed. Use `node --import @sentry/tanstackstart-react/import` instead.
 - (Express) The deprecated `patchExpressModule(options)` signature was removed. Use `patchExpressModule(moduleExports, getOptions)` instead.
+- (Fastify) The deprecated `instrumentFastify` and `handleFastifyError` exports were removed. `fastifyIntegration` now instruments Fastify (v3.21–v5) and captures errors on its own, so neither export is needed. See [Fastify: `setupFastifyErrorHandler` is deprecated](#fastify-setupfastifyerrorhandler-is-deprecated).
 - The `@sentry/node-core/light/otlp` entry point was removed, along with its optional `@opentelemetry/exporter-trace-otlp-http` peer dependency. `otlpIntegration` is now exported directly from every server-side SDK, so `Sentry.otlpIntegration()` needs no extra import or install.
 - The `otlpIntegration` options `setupOtlpTracesExporter` and `collectorUrl` were removed, and the integration no longer sets up a span exporter, span processor, or tracer provider. Configure your own exporter and point it at `Sentry.getOtlpTracesEndpoint(dsn)`, or at your collector's URL if you route through one. See [Connecting Sentry to your OpenTelemetry traces](#connecting-sentry-to-your-opentelemetry-traces).
 

dev-packages/e2e-tests/test-applications/node-fastify-3/package.json

@@ -4,13 +4,11 @@
   "private": true,
   "scripts": {
     "start": "ts-node src/app.ts",
-    "start:override": "ts-node src/app-handle-error-override.ts",
     "test": "playwright test",
-    "test:override": "playwright test --config playwright.override.config.mjs",
     "clean": "npx rimraf node_modules pnpm-lock.yaml",
     "typecheck": "tsc",
     "test:build": "pnpm install && pnpm run typecheck",
-    "test:assert": "pnpm test && pnpm test:override"
+    "test:assert": "pnpm test"
   },
   "dependencies": {
     "@sentry/node": "file:../../packed/sentry-node-packed.tgz",

dev-packages/e2e-tests/test-applications/node-fastify-3/src/app.ts

@@ -47,8 +47,6 @@ const app = fastify();
 const port = 3030;
 const port2 = 3040;
 
-Sentry.setupFastifyErrorHandler(app);
-
 app.get('/test-success', function (_req, res) {
   res.send({ version: 'v1' });
 });

dev-packages/e2e-tests/test-applications/node-fastify-4/package.json

@@ -4,13 +4,11 @@
   "private": true,
   "scripts": {
     "start": "ts-node src/app.ts",
-    "start:override": "ts-node src/app-handle-error-override.ts",
     "test": "playwright test",
-    "test:override": "playwright test --config playwright.override.config.mjs",
     "clean": "npx rimraf node_modules pnpm-lock.yaml",
     "typecheck": "tsc",
     "test:build": "pnpm install && pnpm run typecheck",
-    "test:assert": "pnpm test && pnpm test:override"
+    "test:assert": "pnpm test"
   },
   "dependencies": {
     "@sentry/node": "file:../../packed/sentry-node-packed.tgz",