diff --git a/docs/platforms/android/migration/v8-to-v9.mdx b/docs/platforms/android/migration/v8-to-v9.mdx index f7e9850e1cd15..7534c8880ab2c 100644 --- a/docs/platforms/android/migration/v8-to-v9.mdx +++ b/docs/platforms/android/migration/v8-to-v9.mdx @@ -31,6 +31,22 @@ The Scopes model introduced in version 8 is the supported context model in versi On Android, APIs such as `Sentry.configureScope()` and `Sentry.setTag()` use the current scope by default. +## Removed `traceSampling` Option + +Version 9 removes `SentryOptions.setTraceSampling(...)`, `SentryOptions.isTraceSampling()`, and the `io.sentry.traces.trace-sampling` manifest option. This option was a global switch for trace propagation, not a transaction sampling setting. + +To stop attaching `sentry-trace` and `baggage` headers to outgoing HTTP requests, set `tracePropagationTargets` to an empty list. If your app uses manifest-only auto-initialization, replace the removed manifest option with an empty propagation target value: + +```xml {filename:AndroidManifest.xml} + +``` + +For Apollo v2, set `attachTracingHeaders` to `false` on `SentryApolloInterceptor` because the interceptor doesn't have a request URL to match against propagation targets. + +There is no replacement for suppressing the trace context in Sentry envelopes. Transactions with baggage now always include that context. + ## Manual Logs and Metrics Calls to `Sentry.logger()` and `Sentry.metrics()` no longer require a global enable option. Remove calls to: diff --git a/docs/platforms/java/common/migration/8.x-to-9.0.mdx b/docs/platforms/java/common/migration/8.x-to-9.0.mdx index 6ec80d9ad6348..70ece012077e1 100644 --- a/docs/platforms/java/common/migration/8.x-to-9.0.mdx +++ b/docs/platforms/java/common/migration/8.x-to-9.0.mdx @@ -49,6 +49,14 @@ The Scopes model introduced in version 8 is the supported context model in versi For backend and other JVM applications, APIs such as `Sentry.configureScope()` and `Sentry.setTag()` use the isolation scope by default. +## Removed `traceSampling` Option + +Version 9 removes `SentryOptions.setTraceSampling(...)` and `SentryOptions.isTraceSampling()`. The option was a global switch for trace propagation, not a transaction sampling setting. + +To stop attaching `sentry-trace` and `baggage` headers to outgoing HTTP requests, set `tracePropagationTargets` to an empty list. For Apollo v2, set `attachTracingHeaders` to `false` on `SentryApolloInterceptor` because the interceptor doesn't have a request URL to match against propagation targets. + +There is no replacement for suppressing the trace context in Sentry envelopes. Transactions with baggage now always include that context. + ## Removed OpenTelemetry APIs Version 9 removes these deprecated OpenTelemetry integration classes: