@sentry/tracing

• v7/browser: Add moduleMetadataIntegration lazy loading support

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

This release publishes a new AWS Lambda layer under the name SentryNodeServerlessSDKv7 that users still running v7 can
use instead of pinning themselves to SentryNodeServerlessSDK:235.

Bundle size

• v7: Add support for global onUnhandled Error/Promise for Bun

• replay/v7: Fix user activity not being updated in start()

Bundle size

Important Changes

• browser/v7: Continuously record CLS

This release fixes a bug that caused the cumulative layout shift (CLS) web vital not to be reported in a majority of the
cases where it should have been reported. With this change, the CLS web vital should now always be reported for
pageloads with layout shift. If a pageload did not have layout shift, no CLS web vital should be reported.

Please note that upgrading the SDK to this version may cause data in your dashboards to drastically change.

Other Changes

• v7: Add tunnel support to multiplexed transport

• opentelemetry-node: Support HTTP_REQUEST_METHOD attribute

• react/v7: Fix react router v4/v5 span names

Important Changes

• node: Support Node 22

This release adds support for Node 22! 🎉

It also adds prebuilt-binaries for Node 22 to @sentry/profiling-node.

Other Changes

• feedback: [v7] New feedback button design

• replay/v7: Upgrade rrweb packages to 2.15.0

• ember/v7: Ensure unnecessary spans are avoided

Important Changes

• Export pluggable integrations from SDK packages

Instead of installing @sentry/integrations, you can now import the pluggable integrations directly from your SDK
package:

// Before
import * as Sentry fromv '@sentry/browser';
import { dedupeIntegration } from '@sentry/integrations';

Sentry.init({
  integrations: [dedupeIntegration()],
});

// After
import * as Sentry from '@sentry/browser';

Sentry.init({
  integrations: [Sentry.dedupeIntegration()],
});

Note that only the functional integrations (e.g. xxxIntegration()) are re-exported.

Other Changes

• replay: Add "maxCanvasSize" option for replay canvases

• serverless: [v7] Check if cloud event callback is a function

Bundle size

Important Changes

• tracing: Add interactions sample rate to browser tracing integrations

You can now use a interactionsSampleRate to control the sample rate of INP spans. interactionsSampleRate is applied
on top of the global tracesSampleRate. Therefore if interactionsSampleRate is 0.5 and tracesSampleRate is 0.1,
then the actual sample rate for interactions is 0.05.

Sentry.init({
  tracesSampleRate: 0.1,
  integrations: [
    Sentry.browserTracingIntegration({
      interactionsSampleRate: 0.5,
    }),
  ],
});

• Deprecations

This release deprecates the Hub class, as well as the addRequestDataToTransaction method. The trpcMiddleware
method is no longer on the Handlers export, but instead is a standalone export.

Please see the detailed Migration docs on how to migrate to the new APIs.

• deprecated

  Deprecate and relocate trpcMiddleware

• deprecated

  core: Deprecate Hub class

• deprecated

  types: Deprecate Hub interface

• deprecated

  Deprecate addRequestDataToTransaction

Other Changes

• core: Update metric normalization

• feedback: Customize feedback placeholder text color

• remix: Skip span creation for OPTIONS and HEAD request.

• utils: Add metric buckets rate limit

• core: Unref timer to not block node exit

• metrics: Map statsd to metric_bucket

• spans: Allow zero exclusive time for INP spans

Bundle size

This release deprecates some exports from the @sentry/replay package. These exports have been moved to the browser SDK
(or related framework SDKs like @sentry/react).

• feedback: Make "required" text for input elements configurable

• node: Add scope to ANR events

• node: Local variables skipped after Promise

• node: Skip capturing Hapi Boom error responses

• web-vitals: Check for undefined navigation entry

• deprecated

  replay: Deprecate @sentry/replay exports

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

Bundle size

This release fixes issues with Time to First Byte (TTFB) calculation in the SDK that was introduced with 7.95.0. It
also fixes some bugs with Interaction to First Paint (INP) instrumentation. This may impact your Sentry Performance
Score calculation.

• serverless: Add Node.js 20 to compatible runtimes

• core: Backport ResizeObserver and googletag default filters

• webvitals: Adds event entry names for INP handler. Also guard against empty metric value

• metrics: Use correct statsd data category

• node: Record local variables with falsy values (v7)

• node: Use unique variable for ANR context transfer (v7)

• node: Time zone handling for cron

• tracing: Use web-vitals ttfb calculation

• types: Fix incorrect sampled type on Transaction

• webvitals: Fix mapping not being maintained properly and sometimes not sending INP spans

Work in this release contributed by @quisido and @joshkel. Thank you for your contributions!

Bundle size

This release fixes issues with INP instrumentation with the Next.js SDK and adds support for the enableInp option in
the deprecated BrowserTracing integration for backwards compatibility.

• performance: Port INP span instrumentation to old browser tracing

• ember: Ensure browser tracing is correctly lazy loaded

• node: Do not assert in vendored proxy code (v7 backport)

• react: Set handled value in ErrorBoundary depending on fallback [v7]

Bundle size

• nextjs: Support Hybrid Cloud DSNs with tunnelRoute option

• remix: Add Vite dev-mode support to Express instrumentation

• core: Undeprecate setTransactionName

• browser: Don't use chrome variable name

• nextjs: Client code should not use Node global

• node: Support undici headers as strings or arrays

• types: Add AttachmentType and use for envelope attachment_type property

Work in this release contributed by @jessezhang91 and @bfontaine. Thank you for your contributions!

Bundle size

Important Changes

• Ensure withActiveSpan is exported everywhere

You can use the withActiveSpan method to ensure a certain span is the active span in a given callback. This can be
used to create a span as a child of a specific span with the startSpan API methods:

const parentSpan = Sentry.startInactiveSpan({ name: 'parent' });
if (parentSpan) {
  withActiveSpan(parentSpan, () => {
    // This will be a direct child of parentSpan
    const childSpan = Sentry.startInactiveSpan({ name: 'child' });
  });
}

Bundle size

Important Changes

• performance: Create Interaction standalone spans on inp events

This release adds support for the INP web vital. This is currently only supported for Saas Sentry, and product support
is released with the upcoming 24.3.0 release of self-hosted.

To opt-in to this feature, you can use the enableInp option in the browserTracingIntegration:

Sentry.init({
  integrations: [
    Sentry.browserTracingIntegration({
      enableInp: true,
    });
  ]
})

Other Changes

• feedback: Flush replays when feedback form opens

• profiling-node: Expose nodeProfilingIntegration

• profiling-node: Fix dependencies to point to current versions

• replay: Add errorHandler for replayCanvas integration

• utils: Only mark aggregate errors as exception groups

Bundle size

Important Changes

• core: Allow to pass forceTransaction to startSpan() APIs

You can now pass forceTransaction: true to startSpan(), startSpanManual() and startInactiveSpan(). This allows
you to start a span that you want to be a transaction, if possible. Under the hood, the SDK will connect this span to
the running active span (if there is one), but still send the new span as a transaction to the Sentry backend, if
possible, ensuring it shows up as a transaction throughout the system.

Please note that setting this to true does not guarantee that this will be sent as a transaction, but that the SDK
will try to do so. You can enable this flag if this span is important to you and you want to ensure that you can see it
in the Sentry UI.

Other Changes

• Make breadcrumbs option optional in WinterCGFetch integration

Bundle size

• Export semantic attribute keys from SDK packages

• core: Add metric summaries to spans

• deprecated

  core: Deprecate the Hub constructor

• core: Make custom tracing methods return spans & set default op

• replay: Add getReplay utility function

• angular-ivy: Add exports field to package.json

• sveltekit: Avoid capturing Http 4xx errors on the client

• sveltekit: Properly await sourcemaps flattening

Bundle size