v8 Release Plan

[mydea]

This issue collects concrete things we know we want to include/do in v8 for sure. We have a lot of things captured already in various places, but not all of these things will necessarily happen in v8. The goal of this issue is to have a proper overview.

For feedback please reach out via GH discussions.

Main user facing changes

The biggest changes, from an SDK user perspective, are the changes to performance APIs:

• [v8] New Performance APIs #9956
• [v8] Use OpenTelemetry for Node performance instrumentation #9842
• [v8] New Node performance auto instrumentation #11023

All Changes

Version support

Preview Give feedback

1. [v8] Update Node support to Node 14+ #9827
   +0
   
2. [v8] Drop support for React v15 #9828
   +0
   
3. [v8] Drop support for ES5 #9829
   +0
   
4. [v8] Define version support policy & next major schedule #9831
   +0
5. [v8] Merge angular & angular-ivy packages #9830
   Package: angular +1
   
6. [v8] Bump @sentry/vite-plugin in @sentry/sveltekit & stop exposing options directly #9835
   Package: sveltekit +1
   
7. [v8] Bump @sentry/webpack-plugin in @sentry/nextjs & stop exposing options directly #9836
   Package: nextjs +1
8. [v8] Update Next.js support policy #9838
   Package: nextjs +1
9. [v8] Bump @sentry/webpack-plugin in @sentry/gatsby & stop exposing options directly #9837
   Package: gatsby +1
   

Update meta SDKs to use OpenTelemetry

Preview Give feedback

1. [v8] Port @sentry/nextjs to be powered by OpenTelemetry #11042
   2 of 3
   +0
   
2. [v8] Port @sentry/astro to be powered by OpenTelemetry #11039
   2 of 4
   Feature: Spans Package-Meta: OpenTelemetry Package: astro +3
3. Port @sentry/remix to be powered by OpenTelemetry #11040
   6 of 6
   Feature: Spans Package-Meta: OpenTelemetry Package: remix +3
   
4. [v8] Port @sentry/sveltekit to be powered by OpenTelemetry #11041
   4 of 7
   Feature: Spans Package-Meta: OpenTelemetry Package: sveltekit +3
   
5. Ensure serverless packages use OpenTelemetry

Package changes

Preview Give feedback

1. [v8] Remove @sentry/hub package #5665
   Meta: Breaking +1
   
2. [v8] Remove @sentry/tracing package #8796
   Meta: Breaking +1
   
3. [v8] Merge @sentry/integrations into @sentry/core #9833
   +0
   
4. [v8] Merge @sentry-internal/tracing into @sentry/core #9885
   7 of 7
   +0
   
5. [v8] Merge @sentry/utils into @sentry/core #9832
   2 of 4
   +0
6. [v8] Stop publishing @sentry/replay #9834
   +0
7. [v8] Stop publishing @sentry/opentelemetry-node package #9843
   +0
8. [v8] Stop publishing @sentry-internal/feedback #9886
   Feature: User Feedback +1
9. [v8] Move @sentry/wasm into @sentry/browser

Integrations

Preview Give feedback

1. Revamp the Integrations API #4790
   Meta: Breaking Type: Improvement +2
2. [v8] Get rid of Sentry.Integrations hash in favor of top-level exports #8844
   10 of 10
   Meta: Breaking +1
3. Rename TryCatch integration #8838
   Meta: Breaking Package: browser Type: Improvement +3
   
4. RewriteFrames not functional in browser environments #6423
   Meta: Breaking Package: integrations Type: Improvement +3
5. ref(integrations): Remove offline integration #9456
   +0
6. ref(angular): Don't include BrowserApiErrors in bundle #11294
   +0
   
7. [v8] Replace custom BrowserTracing routing instrumentations #10387
   9 of 9
   +0
8. ref: Remove convertIntegrationFnToClass #11343
   +0
   

General changes

Preview Give feedback

1. Update Hub & Scope handling #9841
   8 of 8
   +0
   
2. [v8] Use OpenTelemetry for Node performance instrumentation #9842
   2 of 2
   +0
3. [v8] Remove startTransaction API #9925
   4 of 4
   +0
4. [v8] New Performance APIs #9956
   8 of 8
   +0
5. [v8] Update for ESM monkeypatch + ESM file structure #10046
   12 of 12
   Meta: Breaking +1
   
6. [v8] Add INP support #10945
   0 of 7
   Feature: Spans +1
   
7. [v8] Changes to serverless package #10976
   7 of 8
   Feature: Serverless Package: aws-serverless Platform: Google Cloud Functions +3
8. [v8] Add request mode sessions to http instrumentation #11320
   Package: node +1
9. [v8] Remove public APIs around Hub class #11482
   9 of 9
   +0
   

Remove deprecated code

Preview Give feedback

1. Remove deprecated tracing configuration options in v8 #6230
   Meta: Breaking Package: browser Package: node Type: Improvement +4
   
2. Deprecate or Change type of exported wrap function #8897
   Meta: Breaking Package: browser Type: Improvement +3
   
3. [Breaking Change] Replay options unblock and unmask will require explicit opt-in #8887
   Meta: Breaking Package: replay +2
   
4. Delete deprecated Replay session and error sample rates #6958
   Meta: Breaking Package: replay Type: Improvement +3
   
5. _eventFromIncompleteOnError is no longer required #5842
   Meta: Breaking Type: Improvement +2
   
6. v8 Deprecation Removal Task list #10100
   50 of 50
   +0
7. Deprecated configureScope is used in a few templates sentry-wizard#519
   +0
   

Docs

Preview Give feedback

1. [v8] Docs Changes #11064
   4 of 22
   Type: Documentation +1

Other / open for discussion

Preview Give feedback

1. Remove withSentry in favor of withSentryAPI
2. Delete deprecated Replay session and error sample rates #6958
   Meta: Breaking Package: replay Type: Improvement +3
   
3. ref(browser): Remove XHR transport from default bundle #5927
   Meta: Breaking Type: Improvement +2
4. Stack parsers use both ? and <anonymous> to denote anonymous functions #5523
   Meta: Breaking +1
5. Remove Gatsby Plugin configuration in favour of only using sentry.config.ts/sentry.config.js
6. Rethink debouncing of click handlers #9254
   Meta: Breaking +1
7. Mark transactions status to ok instead of none which leads to unknown #5745
   Feature: Spans Meta: Breaking Type: Improvement +3
8. Can't prevent Sentry SDK from exiting the process even with onFatalError #1661
   Meta: Help Wanted Package: node +2
9. Support generator functions in startSpan APIs #10772
   Feature: Spans Type: Improvement +2
10. OpenTelemetry Instrumentation Issues #11070
    8 of 15
    Package-Meta: OpenTelemetry +1
11. Add v8 Transformers sentry-migr8#1
    20 of 21
    +0
12. Add getTracingMetaTags helper function to Node SDK #8843
    2 of 2
    Package: node Type: Improvement +2
13. Avoid the loader from using v8

Testing

Check all SDKs for feature regression

Preview Give feedback

1. Browser JavaScript
2. Angular
3. Astro
4. Bun
5. Capacitor
6. Cordova
7. Deno
8. Electron
9. Ember
10. Gatsby
11. Next.js
12. React
13. Remix
14. Solid
15. Svelte
16. SvelteKit
17. Vue
18. Wasm
19. Node.js
20. AWS Lambda
21. Azure Functions
22. Connect
23. Express
24. Google Cloud Functions
25. Koa
26. Hapi (v8 only)
27. Fastify (v8 only)
28. Nest.js (v8 only)

ref #5194
ref #9802

[m1heng]

Will the team try to reduce the bundle size in v8?

[Lms24]

@m1heng by removing deprecated parts of the SDK, we'll be able to reduce some size. Maybe also by the proposed hub/scope changes. However, at this time, we haven't planned a big bundle size reduction intiative as in v7.
We recently reduced Session Replay bundle size by a lot. Also, you might want to look into advanced tree shaking configuration for saving a few extra bytes.

[lforst]

Task list to remove internal usage of deprecated APIs: #10100

[mahnunchik]

Could you please pay more attention to updating documentation: getsentry/sentry-docs#8953

[AbhiPrasad]

Docs issues tracked with: #11064

[AbhiPrasad]

I removed Remove SyncPromise from the list.

Tried it in v7, no dice. I guess v8 isn't it yet either 😢.

One day!!

[AbhiPrasad]

First beta version is out! https://github.com/getsentry/sentry-javascript/releases/tag/8.0.0-beta.1

[r34son]

@AbhiPrasad Hi! Excited about v8 beta! Could you please take a look at pr for updating @sentry/nextjs to v8-beta in my project. Faced few issues while updating. I left questions about them in pr.

r34son/profile#422

[AbhiPrasad]

We've released our 4th beta, https://github.com/getsentry/sentry-javascript/releases/tag/8.0.0-beta.4, and with it we now have detailed migration guides for every SDK!

• Browser JS: https://docs.sentry.io/platforms/javascript/migration/v7-to-v8/
• Node: https://docs.sentry.io/platforms/javascript/guides/node/migration/v7-to-v8/

Browser

• Angular: https://docs.sentry.io/platforms/javascript/guides/angular/migration/v7-to-v8/
• Ember: https://docs.sentry.io/platforms/javascript/guides/ember/migration/v7-to-v8/
• React: https://docs.sentry.io/platforms/javascript/guides/react/migration/v7-to-v8/
• Svelte: https://docs.sentry.io/platforms/javascript/guides/svelte/migration/v7-to-v8/
• Vue: https://docs.sentry.io/platforms/javascript/guides/vue/migration/v7-to-v8/
• Gatsby: https://docs.sentry.io/platforms/javascript/guides/gatsby/migration/v7-to-v8/

JS frameworks

• Next.js: https://docs.sentry.io/platforms/javascript/guides/nextjs/migration/v7-to-v8/
• Remix: https://docs.sentry.io/platforms/javascript/guides/remix/migration/v7-to-v8/
• SvelteKit: https://docs.sentry.io/platforms/javascript/guides/sveltekit/migration/v7-to-v8/

Node

• Connect: https://docs.sentry.io/platforms/javascript/guides/connect/migration/v7-to-v8/
• Express: https://docs.sentry.io/platforms/javascript/guides/express/migration/v7-to-v8/
• Koa: https://docs.sentry.io/platforms/javascript/guides/koa/migration/v7-to-v8/

Alternate JS Runtimes

• Bun: https://docs.sentry.io/platforms/javascript/guides/bun/migration/v7-to-v8/
• Deno: https://docs.sentry.io/platforms/javascript/guides/deno/migration/v7-to-v8/

Serverless

• AWS Lambda: https://docs.sentry.io/platforms/javascript/guides/aws-lambda/migration/v7-to-v8/
• Azure Functions: https://docs.sentry.io/platforms/javascript/guides/angular/migration/v7-to-v8/
• Google Cloud Functions: https://docs.sentry.io/platforms/javascript/guides/gcp-functions/migration/v7-to-v8/

[mwskwong]

Is there an ETA for v8 integration in Sentry.io (whether it is beta or not)? I'm thinking of using Sentry, but I'm still deciding whether I should wait for v8, or adopt for v7 now

[mydea]

Is there an ETA for v8 integration in Sentry.io (whether it is beta or not)? I'm thinking of using Sentry, but I'm still deciding whether I should wait for v8, or adopt for v7 now

v8 is almost ready, unless any issues pop up in the beta (which we don't forsee right now) we expect to do a stable release next week!

[mydea]

Since we shipped this, I am closing this - we can keep track of other stuff elsewhere! 🎉