Skip to content

docs: Add strict trace continuation for Dart/Flutter#16986

Draft
antonis wants to merge 3 commits intomasterfrom
docs/strict-trace-continuation-dart-flutter
Draft

docs: Add strict trace continuation for Dart/Flutter#16986
antonis wants to merge 3 commits intomasterfrom
docs/strict-trace-continuation-dart-flutter

Conversation

@antonis
Copy link
Copy Markdown
Contributor

@antonis antonis commented Mar 17, 2026

DESCRIBE YOUR PR

Add documentation for the strictTraceContinuation and orgId options for the Dart/Flutter SDK.

Changes:

  • dart.flutter.mdx — Add strict trace continuation section to the Flutter distributed tracing guide with Dart code examples
  • options.mdx — Add strictTraceContinuation and orgId option descriptions to the Dart SDK configuration options page

Related SDK PR: getsentry/sentry-dart#3567

⚠️ Should be merged after the above PR is shipped

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Mar 17, 2026 3:49pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Mar 17, 2026 3:49pm

Request Review


<SdkOption name="strictTraceContinuation" type="bool" defaultValue="false">

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.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
If set to `true`, the SDK will only continue a trace when the organization ID in the incoming `baggage` header matches the organization ID of the current Sentry 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.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The client's organization ID is extracted from the DSN or can be set with the `orgId` option.
The client's organization ID is extracted from the DSN or can be explicitly set with the `orgId` option.


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.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
If the organization IDs don't 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`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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`.
The SDK will try to extract the organization ID from the DSN. If it can't be found, or if you need to override it, you can explicitly provide the ID with this option. The organization ID is used for trace propagation and features like `strictTraceContinuation`.

Copy link
Copy Markdown
Contributor

@coolguyzone coolguyzone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

@antonis antonis marked this pull request as draft March 26, 2026 14:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants