Immutable solution version
Sentry Next.js edge runtime: its own config, its own limits
Complete solution
Edge runtime code needs its own Sentry config with edge-safe integrations. What goes in sentry.edge.config.ts, what breaks there, and how tunnelRoute fixes adblocker losses.
Sentry Next.js edge runtime: its own config, its own limits
The file
Sentry.edge.config.ts initializes Sentry for middleware and edge-route code. Keep it minimal:
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: "___PUBLIC_DSN___",
tracesSampleRate: 0.1,
// no Node-only integrations here
});instrumentation.ts loads it only when NEXT_RUNTIME === "edge". If edge errors are missing while Node.js server errors arrive, the edge config is usually absent or throwing on import.
What breaks at the edge
The edge runtime has no Node.js APIs: no fs, no process.nextTick tricks, no native modules. Integrations that depend on them (like the Node profiling integration) must stay in sentry.server.config.ts only. An edge config that imports a Node-only integration fails at the worst time: inside middleware, on every request.
Also keep beforeSend lean here. Edge functions bill by duration; a heavy scrub function on every event adds latency to the request path.
Adblockers eat client events
Browser extensions block requests to ingest endpoints. tunnelRoute: "/sentry-tunnel" in withSentryConfig routes client events through your own server so they look first-party. If client-side issues are undercounted relative to server-side, and the gap appeared without a code change, check whether tunnelRoute is actually set and the route is not behind auth middleware that rejects POSTs.
Debugging edge init
Edge console output is harder to reach. Temporarily set debug: true in the edge config and watch the edge logs during a deploy preview, then remove it. Confirm with one intentional error from middleware before calling it done.
Evidence
Researched against live Sentry docs 2026-09-26. The Next.js guide (docs.sentry.io/platforms/javascript/guides/nextjs/) documents the three init files including sentry.edge.config.ts for edge runtimes, instrumentation.ts registering by NEXT_RUNTIME (nodejs vs edge), and withSentryConfig tunnelRoute /sentry-tunnel described as Route Sentry requests through your server (avoids ad-blockers). The Node.js guide (docs.sentry.io/platforms/javascript/guides/node/) documents the dataCollection option and the built-in denylist filtering sensitive values.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_ovfxYIHu_z_QMr0aPSvSDQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Sentry Next.js edge runtime: its own config, its own limits <span>— Vectle</span></a>