Skip to content

docs(rust): Document strict trace continuation options - #18872

Open
szokeasaurusrex wants to merge 1 commit into
masterfrom
docs/rust-strict-trace-continuation
Open

docs(rust): Document strict trace continuation options#18872
szokeasaurusrex wants to merge 1 commit into
masterfrom
docs/rust-strict-trace-continuation

Conversation

@szokeasaurusrex

@szokeasaurusrex szokeasaurusrex commented Jul 29, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Documents the Rust SDK's org_id and strict_trace_continuation options (shipped in sentry-rust 0.49.0) on the Rust configuration options page.

The new entries explain that the SDK compares the incoming baggage sentry-org_id with its own organization ID when a transaction starts from incoming headers: mismatched org IDs always start a new trace, and enabling strict trace continuation additionally rejects traces carrying no org ID. An info alert covers org ID configuration (SaaS DSNs need nothing; self-hosted/Relay setups should set org_id explicitly), and a warning alert notes that not all SDKs attach org IDs to outgoing traces yet — including the Rust SDK itself — so the option should stay disabled if upstream services use such SDKs.

Closes #18553
Closes RUST-254

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

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Jul 29, 2026 3:14pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jul 29, 2026 3:14pm

Request Review

@codeowner-assignment
codeowner-assignment Bot requested a review from a team July 29, 2026 15:00
Add org_id and strict_trace_continuation to the Rust SDK options page, covering baseline org ID comparison on incoming traces, strict mode behavior, and guidance for self-hosted/Relay setups and SDKs that don't attach org IDs yet.

Fixes #18553
@szokeasaurusrex
szokeasaurusrex force-pushed the docs/rust-strict-trace-continuation branch from 0676ae1 to 9a04441 Compare July 29, 2026 15:00
@szokeasaurusrex
szokeasaurusrex requested a review from dingsdax July 29, 2026 15:01
@szokeasaurusrex
szokeasaurusrex marked this pull request as ready for review July 29, 2026 15:01
@szokeasaurusrex
szokeasaurusrex requested a review from a team July 29, 2026 15:01
@linear-code

linear-code Bot commented Jul 30, 2026

Copy link
Copy Markdown

RUST-254

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.

Document Rust strict trace continuation options

2 participants