Sentry JavaScript

This release is publishing the AWS Lambda Layer under SentryNodeServerlessSDKv9. The previous release 9.44.1 accidentally published the layer under SentryNodeServerlessSDKv10.

Bundle size 📦

• feat(nuxt): Align build-time options to follow bundler plugins structure (#17255)
• fix(browser-utils): Ensure web vital client hooks unsubscribe correctly (#17272)
• fix(browser): Ensure request from diagnoseSdkConnectivity doesn't create span (#17280)

Bundle size 📦

• fix(replay/v9): Call sendBufferedReplayOrFlush when opening/sending feedback (#17270)

Bundle size 📦

Version 10.0.0 marks a release of the Sentry JavaScript SDKs that contains breaking changes. The goal of this release is to primarily upgrade the underlying OpenTelemetry dependencies to v2 with minimal breaking changes.

How To Upgrade

Please carefully read through the migration guide in the Sentry docs on how to upgrade from version 9 to version 10. Make sure to select your specific platform/framework in the top left corner: https://docs.sentry.io/platforms/javascript/migration/v9-to-v10/

A comprehensive migration guide outlining all changes can be found within the Sentry JavaScript SDK Repository: https://github.com/getsentry/sentry-javascript/blob/develop/MIGRATION.md

Breaking Changes

• feat!: Bump to OpenTelemetry v2 (#16872)
• feat(browser)!: Remove FID web vital collection (#17076)
• feat(core)!: Remove BaseClient (#17071)
• feat(core)!: Remove enableLogs and beforeSendLog experimental options (#17063)
• feat(core)!: Remove hasTracingEnabled (#17072)
• feat(core)!: Remove deprecated logger (#17061)
• feat(replay)!: Promote _experiments.autoFlushOnFeedback option as default (#17220)
• chore(deps)!: Bump bundler plugins to v4 (#17089)

Other Changes

• feat(astro): Implement Request Route Parametrization for Astro 5 (#17105)
• feat(astro): Parametrize routes on client-side (#17133)
• feat(aws): Add SentryNodeServerlessSDKv10 v10 AWS Lambda Layer (#17069)
• feat(aws): Create unified lambda layer for ESM and CJS (#17012)
• feat(aws): Detect SDK source for AWS Lambda layer (#17128)
• feat(core): Add missing openai tool calls attributes (#17226)
• feat(core): Add shared flushIfServerless function (#17177)
• feat(core): Implement strictTraceContinuation (#16313)
• feat(core): MCP server instrumentation without breaking Miniflare (#16817)
• feat(deps): bump @prisma/instrumentation from 6.11.1 to 6.12.0 (#17117)
• feat(meta): Unify detection of serverless environments and add Cloud Run (#17168)
• feat(nestjs): Switch to OTel core instrumentation (#17068)
• feat(node-native): Upgrade @sentry-internal/node-native-stacktrace to 0.2.2 (#17207)
• feat(node): Add shouldHandleError option to fastifyIntegration (#16845)
• feat(node): Add firebase integration (#16719)
• feat(node): Instrument stream responses for openai (#17110)
• feat(react-router): Add createSentryHandleError (#17235)
• feat(react-router): Automatically flush on serverless for loaders/actions (#17234)
• feat(react-router): Automatically flush on Vercel for request handlers (#17232)
• fix(astro): Construct parametrized route during runtime (#17190)
• fix(aws): Add layer build output to nx cache (#17148)
• fix(aws): Fix path to packages directory (#17112)
• fix(aws): Resolve all Sentry packages to local versions in layer build (#17106)
• fix(aws): Use file link in dependency version (#17111)
• fix(cloudflare): Allow non uuid workflow instance IDs (#17121)
• fix(cloudflare): Avoid turning DurableObject sync methods into async (#17184)
• fix(core): Fix OpenAI SDK private field access by binding non-instrumented fns (#17163)
• fix(core): Fix operation name for openai responses API (#17206)
• fix(core): Update ai.response.object to gen_ai.response.object (#17153)
• fix(nextjs): Flush in route handlers (#17223)
• fix(nextjs): Handle async params in url extraction (#17162)
• fix(nextjs): Update stackframe calls for next v15.5 (#17156)
• fix(node): Add mechanism to fastifyIntegration error handler (#17208)
• fix(node): Ensure tool errors for vercelAiIntegration have correct trace connected (#17132)
• fix(node): Fix exports for openai instrumentation (#17238)
• fix(node): Handle stack traces with data URI filenames (#17218)
• fix(react): Memoize wrapped component to prevent rerenders (#17230)
• fix(remix): Ensure source maps upload fails silently if Sentry CLI fails (#17082)
• fix(replay): Fix re-sampled sessions after a click (#17008)
• fix(svelte): Do not insert preprocess code in script module in Svelte 5 (#17114)
• fix(sveltekit): Align error status filtering and mechanism in handleErrorWithSentry (#17157)

Work in this release was contributed by @richardjelinek-fastest. Thank you for your contribution!

Bundle size 📦

• feat(replay/v9): Deprecate _experiments.autoFlushOnFeedback (#17219)
• feat(v9/core): Add shared flushIfServerless function (#17239)
• feat(v9/node-native): Upgrade @sentry-internal/node-native-stacktrace to 0.2.2 (#17256)
• feat(v9/react-router): Add createSentryHandleError (#17244)
• feat(v9/react-router): Automatically flush on serverless for loaders/actions (#17243)
• feat(v9/react-router): Automatically flush on serverless for request handler (#17242)
• fix(v9/astro): Construct parametrized route during runtime (#17227)
• fix(v9/nextjs): Flush in route handlers (#17245)
• fix(v9/node): Fix exports for openai instrumentation (#17238) (#17241)

Bundle size 📦

This is a beta release of the upcoming major release of version 10. This release does not yet entail a comprehensive changelog as version 10 is not yet stable.

For this release's iteration of the migration guide, see the Migration Guide as per 10.0.0-beta.0.

Please note that the migration guide is work in progress and subject to change.

Bundle size 📦

• feat(v9/core): add MCP server instrumentation (#17196)
• feat(v9/meta): Unify detection of serverless environments and add Cloud Run (#17204)
• fix(v9/node): Add mechanism to fastifyIntegration error handler (#17211)
• fix(v9/replay): Fix re-sampled sessions after a click (#17195)

Bundle size 📦

• fix(v7/cdn): Stop using Object.assign to be ES5 compatible (#17080)

No user-facing changes, only internal changes.

• fix(v9/astro): Revert Astro v5 storing route data to globalThis (#17185)
• fix(v9/cloudflare): Avoid turning DurableObject sync methods into async (#17187)
• fix(v9/nextjs): Handle async params in url extraction (#17176)
• fix(v9/sveltekit): Align error status filtering and mechanism in handleErrorWithSentry (#17174)

Bundle size 📦

• feat(v9/aws): Detect SDK source for AWS Lambda layer (#17150)
• fix(v9/core): Fix OpenAI SDK private field access by binding non-instrumented fns (#17167)
• fix(v9/core): Update ai.response.object to gen_ai.response.object (#17155)
• fix(v9/nextjs): Update stackframe calls for next v15.5 (#17161)

Bundle size 📦

This is an alpha release of the upcoming major release of version 10. This release does not yet entail a comprehensive changelog as version 10 is not yet stable.

For this release's iteration of the migration guide, see the Migration Guide as per 10.0.0-alpha.1.

Please note that the migration guide is work in progress and subject to change.

Important Changes

• feat(v9/core): Deprecate experimental enableLogs and beforeSendLog option (#17092)

Sentry now has support for structured logging. Previously to enable structured logging, you had to use the _experiments.enableLogs and _experiments.beforeSendLog options. These options have been deprecated in favor of the top-level enableLogs and beforeSendLog options.

// before
Sentry.init({
  _experiments: {
    enableLogs: true,
    beforeSendLog: log => {
      return log;
    },
  },
});

// after
Sentry.init({
  enableLogs: true,
  beforeSendLog: log => {
    return log;
  },
});

• feat(astro): Implement parameterized routes
  • feat(v9/astro): Parametrize dynamic server routes (#17141)
  • feat(v9/astro): Parametrize routes on client-side (#17143)

Server-side and client-side parameterized routes are now supported in the Astro SDK. No configuration changes are required.

Other Changes

• feat(v9/node): Add shouldHandleError option to fastifyIntegration (#17123)
• fix(v9/cloudflare) Allow non UUID workflow instance IDs (#17135)
• fix(v9/node): Ensure tool errors for vercelAiIntegration have correct trace (#17142)
• fix(v9/remix): Ensure source maps upload fails silently if Sentry CLI fails (#17095)
• fix(v9/svelte): Do not insert preprocess code in script module in Svelte 5 (#17124)

Work in this release was contributed by @richardjelinek-fastest. Thank you for your contribution!

Bundle size 📦

This is an alpha release of the upcoming major release of version 10. This release does not yet entail a comprehensive changelog as version 10 is not yet stable.

For this release's iteration of the migration guide, see the Migration Guide as per 10.0.0-alpha.1.

Please note that the migration guide is work in progress and subject to change.

Bundle size 📦

Important Changes

• feat(browser): Add debugId sync APIs between web worker and main thread (#16981)

This release adds two Browser SDK APIs to let the main thread know about debugIds of worker files:

• webWorkerIntegration({worker}) to be used in the main thread
• registerWebWorker({self}) to be used in the web worker

// main.js
Sentry.init({...})

const worker = new MyWorker(...);

Sentry.addIntegration(Sentry.webWorkerIntegration({ worker }));

worker.addEventListener('message', e => {...});

// worker.js
Sentry.registerWebWorker({ self });

self.postMessage(...);

• feat(core): Deprecate logger in favor of debug (#17040)

The internal SDK logger export from @sentry/core has been deprecated in favor of the debug export. debug only exposes log, warn, and error methods but is otherwise identical to logger. Note that this deprecation does not affect the logger export from other packages (like @sentry/browser or @sentry/node) which is used for Sentry Logging.

import { logger, debug } from '@sentry/core';

// before
logger.info('This is an info message');

// after
debug.log('This is an info message');

• feat(node): Add OpenAI integration (#17022)

This release adds official support for instrumenting OpenAI SDK calls in with Sentry tracing, following OpenTelemetry semantic conventions for Generative AI. It instruments:

• client.chat.completions.create() - For chat-based completions
• client.responses.create() - For the responses API

// The integration respects your `sendDefaultPii` option, but you can override the behavior in the integration options

Sentry.init({
  dsn: '__DSN__',
  integrations: [
    Sentry.openAIIntegration({
      recordInputs: true, // Force recording prompts
      recordOutputs: true, // Force recording responses
    }),
  ],
});

Other Changes

• feat(node-core): Expand @opentelemetry/instrumentation range to cover 0.203.0 (#17043)
• fix(cloudflare): Ensure errors get captured from durable objects (#16838)
• fix(sveltekit): Ensure server errors from streamed responses are sent (#17044)

Work in this release was contributed by @0xbad0c0d3 and @tommy-gilligan. Thank you for your contributions!

Bundle size 📦

Important Changes

• feat(browser): Add afterStartPageloadSpan hook to improve spanId assignment on web vital spans (#16893)

This PR adds a new afterStartPageloadSpan lifecycle hook to more robustly assign the correct pageload span ID to web vital spans, replacing the previous unreliable "wait for a tick" approach with a direct callback that fires when the pageload span becomes available.

• feat(nextjs): Client-side parameterized routes (#16934)

This PR implements client-side parameterized routes for Next.js by leveraging an injected manifest within the existing app-router instrumentation to automatically parameterize all client-side transactions (e.g. users/123 and users/456 now become become users/:id).

• feat(node): Drop 401-404 and 3xx status code spans by default (#16972)

This PR changes the default behavior in the Node SDK to drop HTTP spans with 401-404 and 3xx status codes by default to reduce noise in tracing data.

Other Changes

• feat(core): Prepend vercel ai attributes with vercel.ai.X (#16908)
• feat(nextjs): Add disableSentryWebpackConfig flag (#17013)
• feat(nextjs): Build app manifest (#16851)
• feat(nextjs): Inject manifest into client for turbopack builds (#16902)
• feat(nextjs): Inject manifest into client for webpack builds (#16857)
• feat(node-native): Add option to disable event loop blocked detection (#16919)
• feat(react-router): Ensure http.server route handling is consistent (#16986)
• fix(core): Avoid prolonging idle span when starting standalone span (#16928)
• fix(core): Remove side-effect from tracing/errors.ts (#16888)
• fix(core): Wrap beforeSendLog in consoleSandbox (#16968)
• fix(node-core): Apply correct SDK metadata (#17014)
• fix(react-router): Ensure that all browser spans have source=route (#16984)

Work in this release was contributed by @janpapenbrock. Thank you for your contribution!

Bundle size 📦

Important Changes

• chore: Add craft entry for @sentry/node-native (#16907)

This release publishes the @sentry/node-native SDK.

Other Changes

• feat(core): Introduce debug to replace logger (#16906)
• fix(browser): Guard nextHopProtocol when adding resource spans (#16900)

Bundle size 📦

Important Changes

• feat(nuxt): Parametrize SSR routes (#16843)

  When requesting dynamic or catch-all routes in Nuxt, those will now be shown as parameterized routes in Sentry. For example, /users/123 will be shown as /users/:userId() in Sentry. This will make it easier to identify patterns and make grouping easier.

Other Changes

• feat(astro): Deprecate passing runtime config to astro integration (#16839)
• feat(browser): Add beforeStartNavigationSpan lifecycle hook (#16863)
• feat(browser): Detect redirects when emitting navigation spans (#16324)
• feat(cloudflare): Add option to opt out of capturing errors in wrapRequestHandler (#16852)
• feat(feedback): Return the eventId into the onSubmitSuccess callback (#16835)
• feat(vercel-edge): Do not vendor in all OpenTelemetry dependencies (#16841)
• fix(browser): Ensure standalone CLS and LCP spans have traceId of pageload span (#16864)
• fix(nextjs): Use value injection loader on instrumentation-client.ts|js (#16855)
• fix(sveltekit): Avoid capturing redirect() calls as errors in Cloudflare (#16853)
• docs(nextjs): Update deleteSourcemapsAfterUpload jsdoc default value (#16867)

Work in this release was contributed by @zachkirsch. Thank you for your contribution!

Bundle size 📦

Important Changes

• feat(node-core): Add node-core SDK (#16745)

This release adds a new SDK @sentry/node-core which ships without any OpenTelemetry instrumententation out of the box. All OpenTelemetry dependencies are peer dependencies and OpenTelemetry has to be set up manually.

Use @sentry/node-core when:

• You already have OpenTelemetry set up
• You need custom OpenTelemetry configuration
• You want minimal dependencies
• You need fine-grained control over instrumentation

Use @sentry/node when:

• You want an automatic setup
• You're new to OpenTelemetry
• You want sensible defaults
• You prefer convenience over control

• feat(node): Deprecate ANR integration (#16832)

The ANR integration has been deprecated and will be removed in future versions. Use eventLoopBlockIntegration from @sentry/node-native instead.

• feat(replay): Add _experiments.ignoreMutations option (#16816)

This replay option allows to configure a selector list of elements to not capture mutations for.

Sentry.replayIntegration({
  _experiments: {
    ignoreMutations: ['.dragging'],
  },
});

Other changes

• feat(deps): bump @prisma/instrumentation from 6.10.1 to 6.11.1 (#16833)
• feat(nextjs): Add flag for suppressing router transition warning (#16823)
• feat(nextjs): Automatically skip middleware requests for tunnel route (#16812)
• feat(replay): Export compression worker from @sentry/replay-internal (#16794)
• fix(browser): Avoid 4xx response for succesful diagnoseSdkConnectivity request (#16840)
• fix(browser): Guard against undefined nextHopProtocol (#16806)
• fix(cloudflare): calculate retries not attempts (#16834)
• fix(nuxt): Parametrize routes on the server-side (#16785)
• fix(vue): Make pageload span handling more reliable (#16799)

Work in this release was contributed by @Spice-King and @stayallive. Thank you for your contributions!

Bundle size 📦

This is an internal alpha for @sentry/node-core and @sentry/node.

Bundle size 📦