From 7149e9468dd876df4d4c1db960e5d23d2081c050 Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Tue, 17 Mar 2026 15:42:32 +0100 Subject: [PATCH 1/2] docs: Add strict trace continuation for Dart/Flutter --- .../dart/common/configuration/options.mdx | 18 ++++++++++++ .../how-to-use/dart.flutter.mdx | 29 +++++++++++++++++++ 2 files changed, 47 insertions(+) diff --git a/docs/platforms/dart/common/configuration/options.mdx b/docs/platforms/dart/common/configuration/options.mdx index dd063a80700e27..ca305faef77b55 100644 --- a/docs/platforms/dart/common/configuration/options.mdx +++ b/docs/platforms/dart/common/configuration/options.mdx @@ -240,3 +240,21 @@ String entries do not have to be full matches, meaning the URL of a request is m If is not provided, trace data is attached to every outgoing request from the instrumented client. + + + +If set to `true`, the SDK will only continue a trace if the organization ID of the incoming trace found in the `baggage` header matches the organization ID of the current Sentry client. + +The client's organization ID is extracted from the DSN or can be set with the `orgId` option. + +If the organization IDs do not match, the SDK will start a new trace instead of continuing the incoming one. This is useful to prevent traces of unknown third-party services from being continued in your application. + + + + + +The organization ID for your Sentry project. + +The SDK will try to extract the organization ID from the DSN. If it cannot be found, or if you need to override it, you can provide the ID with this option. The organization ID is used for trace propagation and features like `strictTraceContinuation`. + + diff --git a/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx b/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx index 9f6d50a1dda417..cb52ae0015cf20 100644 --- a/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx +++ b/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx @@ -1,3 +1,32 @@ If you're using the current version of our Flutter SDK, distributed tracing will work out of the box. If you're using version `7.10.0` or below, you'll need to have our tracing feature enabled in order for distributed tracing to work. + +### Strict Trace Continuation + +When your application receives requests, they might include `sentry-trace` and `baggage` headers from an upstream service that is also using Sentry. +By default, the SDK will continue the trace from these incoming headers. However, this behavior can be undesirable if the requests are from a third-party service, +as it can lead to unwanted traces, increased billing, and skewed performance data. + +To prevent this, you can enable `strictTraceContinuation`. When this option is set to `true`, the SDK checks the incoming trace for Sentry trace information and only continues it if it belongs to the same Sentry organization. +Otherwise, it starts a new trace. + +```dart {4} +await SentryFlutter.init((options) { + options.dsn = '___PUBLIC_DSN___'; + options.tracesSampleRate = 1.0; + // Ensure that only traces from your own organization are continued + options.strictTraceContinuation = true; +}); +``` + +The SDK automatically parses the organization ID from your DSN. If you use a DSN format that doesn't include the organization ID (number followed by the letter `"o"`), or if you need to override it, you can provide it manually using the `orgId` option: + +```dart {5} +await SentryFlutter.init((options) { + options.dsn = '___PUBLIC_DSN___'; + options.tracesSampleRate = 1.0; + options.strictTraceContinuation = true; + // Manually provide your organization ID (overrides organization ID parsed from DSN) + options.orgId = '12345'; +}); From 149736802c819e04b2f4d07ee4904f62a4a208b0 Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Tue, 17 Mar 2026 16:37:57 +0100 Subject: [PATCH 2/2] fix: Add missing closing code fence --- .../distributed-tracing/how-to-use/dart.flutter.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx b/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx index cb52ae0015cf20..45f406e55a8df7 100644 --- a/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx +++ b/platform-includes/distributed-tracing/how-to-use/dart.flutter.mdx @@ -30,3 +30,4 @@ await SentryFlutter.init((options) { // Manually provide your organization ID (overrides organization ID parsed from DSN) options.orgId = '12345'; }); +```