The @sentry/opentelemetry-node package has been removed. Instead, you can either use @sentry/node with built-in OpenTelemetry support, or use @sentry/opentelemetry to manually connect Sentry with OpenTelemetry.

Removal/Refactoring of deprecated functionality

ref: Refactor some deprecated startSpan options (#10825)
feat(v8/core): remove void from transport return (#10794)
ref(integrations): Delete deprecated class integrations (#10887)

Other Changes

feat(core): Use serialized spans in transaction event (#10912)
feat(deps): bump @sentry/cli from 2.28.6 to 2.29.1 (#10908)
feat(node): Allow to configure skipOpenTelemetrySetup (#10907)
feat(esm): Import rather than require inspector (#10910)
fix(browser): Don't use chrome variable name (#10874)
chore(sveltekit): Fix punctuation in a console.log (#10895)
fix(opentelemetry): Ensure DSC propagation works correctly (#10904)
feat(browser): Exclude span exports from non-performance CDN bundles (#10879)
ref: Refactor span status handling to be OTEL compatible (#10871)
feat(core): Fix span scope handling & transaction setting (#10886)
ref(ember): Avoid namespace import to hopefully resolve minification issue (#10885)

Work in this release contributed by @harish-talview & @bfontaine. Thank you for your contributions!

8.0.0-alpha.1

Diff

sentry-bot

published 8.0.0-alpha.1 • 9 months ago

Changelog

Source

8.0.0-alpha.1

This is the first Alpha release of the v8 cycle, which includes a variety of breaking changes.

Read the in-depth migration guide to find out how to address any breaking changes in your code.

Important Changes

- feat(node): Make @sentry/node powered by OpenTelemetry (#10762)

The biggest change is the switch to use OpenTelemetry under the hood in @sentry/node. This brings with it a variety of changes:

There is now automated performance instrumentation for Express, Fastify, Nest.js and Koa. You can remove any performance and request isolation code you previously wrote manually for these frameworks.
All performance instrumention is enabled by default, and will only take effect if the instrumented package is used. You don't need to use autoDiscoverNodePerformanceMonitoringIntegrations() anymore.
You need to ensure to call Sentry.init() before you import any other packages. Otherwise, the packages cannot be instrumented:

const Sentry = require('@sentry/node');
Sentry.init({
  dsn: '...',
  // ... other config here
});
// now require other things below this!
const http = require('http');
const express = require('express');
// ....

Currently, we only support CJS-based Node application out of the box. There is experimental ESM support, see the instructions.
startTransaction and span.startChild() are no longer supported. This is due to the underlying change to OpenTelemetry powered performance instrumentation. See docs on the new performance APIs for details.

Related changes:

feat(node-experimental): Add missing re-exports (#10679)
feat(node-experimental): Move defaultStackParser & getSentryRelease (#10722)
feat(node-experimental): Move errorHandler (#10728)
feat(node-experimental): Move cron code over (#10742)
feat(node-experimental): Move integrations from node (#10743)
feat(node-experimental): Properly set request & session on http requests (#10676)
feat(opentelemetry): Support forceTransaction in OTEL (#10807)
feat(opentelemetry): Align span options with core span options (#10761)
feat(opentelemetry): Do not capture span events as breadcrumbs (#10612)
feat(opentelemetry): Ensure DSC & attributes are correctly set (#10806)
feat(opentelemetry): Fix & align isolation scope usage in node-experimental (#10570)
feat(opentelemetry): Merge node-experimental changes into opentelemetry (#10689)
ref(node-experimental): Cleanup re-exports (#10741)
ref(node-experimental): Cleanup tracing intergations (#10730)
ref(node-experimental): Copy transport & client to node-experimental (#10720)
ref(node-experimental): Remove custom isInitialized (#10607)
ref(node-experimental): Remove custom hub & scope (#10616)
ref(node-experimental): Remove deprecated class integrations (#10675)
ref(node-experimental): Rename errorHandler to expressErrorHandler (#10746)
ref(node-integration-tests): Migrate to new Http integration (#10765)
ref(node): Align semantic attribute handling (#10827)

- feat: Remove @sentry/integrations package (#10799)

This package is no longer published. You can instead import these pluggable integrations directly from your SDK package (e.g. @sentry/browser or @sentry/react).

- feat: Remove @sentry/hub package (#10783)

This package is no longer published. You can instead import directly from your SDK package (e.g. @sentry/react or @sentry/node).

- feat(v8): Remove @sentry/tracing (#10625)

This package is no longer published. You can instead import directly from your SDK package (e.g. @sentry/react or @sentry/node).

- feat: Set required node version to >=14.8.0 for all packages (#10834)

The minimum required node version is now 14.8+. If you need support for older node versions, you can stay on the v7 branch.

- Removed class-based integrations

We have removed most of the deprecated class-based integrations. Instead, you can use the functional styles:

import * as Sentry from '@sentry/browser';
// v7
Sentry.init({
  integrations: [new Sentry.BrowserTracing()],
});
// v8
Sentry.init({
  integrations: [new Sentry.browserTracingIntegration()],
});

ref: Remove BrowserTracing (#10653)
feat(v8/node): Remove LocalVariables class integration (#10558)
feat(v8/react): Delete react router exports (#10532)
feat(v8/vue): Remove all deprecated exports from vue (#10533)
feat(v8/wasm): Remove deprecated exports (#10552)

- feat(v8/browser): Remove XHR transport (#10703)

We have removed the XHR transport, and are instead using the fetch-based transport now by default. This means that if you are using Sentry in a browser environment without fetch, you'll need to either provide a fetch polyfill, or provide a custom transport to Sentry.

- feat(sveltekit): Update @sentry/vite-plugin to 2.x and adjust options API (#10813)

We have updated @sentry/sveltekit to use the latest version of @sentry/vite-plugin, which lead to changes in configuration options.

Other Changes

feat: Ensure withActiveSpan is exported everywhere (#10878)
feat: Allow passing null to withActiveSpan (#10717)
feat: Implement new Async Context Strategy (#10647)
feat: Remove hub from global, hub.run & hub utilities (#10718)
feat: Update default trace propagation targets logic in the browser (#10621)
feat: Ignore ResizeObserver and undefined error (#10845)
feat(browser): Export getIsolationScope and getGlobalScope (#10658)
feat(browser): Prevent initialization in browser extensions (#10844)
feat(core): Add metric summaries to spans (#10554)
feat(core): Decouple metrics aggregation from client (#10628)
feat(core): Lookup client on current scope, not hub (#10635)
feat(core): Make setXXX methods set on isolation scope (#10678)
feat(core): Make custom tracing methods return spans & set default op (#10633)
feat(core): Make global addBreadcrumb write to the isolation scope instead of current scope (#10586)
feat(core): Remove health check transaction filters (#10818)
feat(core): Streamline custom hub creation for node-experimental (#10555)
feat(core): Update addEventProcessor to add to isolation scope (#10606)
feat(core): Update Sentry.addBreadcrumb to skip hub (#10601)
feat(core): Use global TextEncoder and TextDecoder (#10701)
feat(deps): bump @sentry/cli from 2.26.0 to 2.28.0 (#10496)
feat(deps): bump @sentry/cli from 2.28.0 to 2.28.5 (#10620)
feat(deps): bump @sentry/cli from 2.28.5 to 2.28.6 (#10727)
feat(integrations): Capture error arguments as exception regardless of level in captureConsoleIntegration (#10744)
feat(metrics): Remove metrics method from BaseClient (#10789)
feat(node): Remove unnecessary URL imports (#10860)
feat(react): Drop support for React 15 (#10115)
feat(remix): Add Vite dev-mode support to Express instrumentation. (#10784)
fix: Export session API (#10711)
fix(angular-ivy): Add exports field to package.json (#10569)
fix(angular): Ensure navigations always create a transaction (#10646)
fix(core): Add lost scope tests & fix update case (#10738)
fix(core): Fix scope capturing via captureContext function (#10735)
fix(feedback): Replay breadcrumb for feedback events was incorrect (#10536)
fix(nextjs): Remove webpack:// prefix more broadly from source map sources field (#10642)
fix(node): import worker_threads and fix node v14 types (#10791)
fix(node): Record local variables with falsy values, null and undefined (#10821)
fix(stacktrace): Always use ? for anonymous function name (#10732)
fix(sveltekit): Avoid capturing Http 4xx errors on the client (#10571)
fix(sveltekit): Ensure navigations and redirects always create a new transaction (#10656)
fix(sveltekit): Properly await sourcemaps flattening (#10602)
fix(types): Improve attachment type (#10832)
fx(node): Fix anr worker check (#10719)
ref: Cleanup browser profiling integration (#10766)
ref: Collect child spans references via non-enumerable on Span object (#10715)
ref: Make scope setters on hub only write to isolation scope (#10572)
ref: Store runtime on isolation scope (#10657)
ref(astro): Put request as SDK processing metadata instead of span data (#10840)
ref(core): Always use a (default) ACS (#10644)
ref(core): Make on and emit required on client (#10603)
ref(core): Make remaining client methods required (#10605)
ref(core): Rename Span class to SentrySpan (#10687)
ref(core): Restructure hub exports (#10639)
ref(core): Skip hub in top level captureXXX methods (#10688)
ref(core): Allow number as span traceFlag (#10855)
ref(core): Remove status field from Span (#10856)
ref(remix): Make @remix-run/router a dependency. (#10479)
ref(replay): Use beforeAddBreadcrumb hook instead of scope listener (#10600)
ref(sveltekit): Hard-pin Vite plugin version (#10843)

Other Deprecation Removals/Changes

We have also removed or updated a variety of deprecated APIs.

feat(v8): Remove extractTraceparentData export (#10559)
feat(v8): Remove defaultIntegrations deprecated export (#10691)
feat(v8): Remove deprecated span.isSuccess method (#10699)
feat(v8): Remove deprecated traceHeaders method (#10776)
feat(v8): Remove deprecated addInstrumentationHandler (#10693)
feat(v8): Remove deprecated configureScope call (#10565)
feat(v8): Remove deprecated runWithAsyncContext API (#10780)
feat(v8): Remove deprecated spanStatusfromHttpCode export (#10563)
feat(v8): Remove deprecated trace and startActiveSpan methods (#10593)
feat(v8): Remove requestData deprecations (#10626)
feat(v8): Remove Severity enum (#10551)
feat(v8): Remove span.origin (#10753)
feat(v8): Remove span.toTraceparent method (#10698)
feat(v8): Remove usage of span.description and span.name (#10697)
feat(v8): Update eventFromUnknownInput to only use client (#10692)
feat(v8/astro): Remove deprecated exports from Astro SDK (#10611)
feat(v8/browser): Remove _eventFromIncompleteOnError usage (#10553)
feat(v8/browser): Remove XHR transport (#10703)
feat(v8/browser): Rename TryCatch integration to browserApiErrorsIntegration (#10755)
feat(v8/core): Remove deprecated setHttpStatus (#10774)
feat(v8/core): Remove deprecated updateWithContext method (#10800)
feat(v8/core): Remove getters for span.op (#10767)
feat(v8/core): Remove span.finish call (#10773)
feat(v8/core): Remove span.instrumenter and instrumenter option (#10769)
feat(v8/ember): Remove deprecated exports (#10535)
feat(v8/integrations): Remove deprecated exports (#10556)
feat(v8/node): Remove deepReadDirSync export (#10564)
feat(v8/node): Remove deprecated anr methods (#10562)
feat(v8/node): Remove getModuleFromFilename export (#10754)
feat(core): Remove deprecated props from Span interface (#10854)
fix(v8): Remove deprecated tracing config (#10870)
ref: Make setupOnce optional in integrations (#10729)
ref: Migrate transaction source from metadata to attributes (#10674)
ref: Refactor remaining makeMain usage (#10713)
ref(astro): Remove deprecated Replay and BrowserTracing (#10768)
feat(core): Remove deprecated scope.applyToEvent() method (#10842)
ref(integrations): Remove offline integration (#9456)
ref(nextjs): Remove all deprecated API (#10549)
ref: Remove lastEventId (#10585)
ref: Remove reuseExisting option for ACS (#10645)
ref: Remove tracingOrigins options (#10614)
ref: Remove deprecated showReportDialog APIs (#10609)
ref: Remove usage of span tags (#10808)
ref: Remove user segment (#10575)