diff --git a/develop-docs/sdk/telemetry/traces/trace-propagation-cheat-sheet.mdx b/develop-docs/sdk/telemetry/traces/trace-propagation-cheat-sheet.mdx new file mode 100644 index 0000000000000..614cb426a1f43 --- /dev/null +++ b/develop-docs/sdk/telemetry/traces/trace-propagation-cheat-sheet.mdx @@ -0,0 +1,39 @@ +--- +title: Trace Propagation Cheat Sheet +--- + +This is a cheat sheet where you can see how the trace propagation work in SDKs in different scenarios. + +| SCENARIO:
Incoming trace in `sentry-trace/baggage` headers | SCENARIO:
Incoming sampled flag in `sentry-trace/baggage` header | SCENARIO:
`traces_propagation_targets` are matching? | SCENARIO:
`traces_sample_rate` setting | OUTCOME:
Send Spans to Sentry? | OUTCOME:
Outgoing Requests Have Trace? (`sentry-trace/baggage` are present) | OUTCOME:
Continue Incoming Trace? (outgoing `trace_id` is the incoming `trace_id`) | +| -------------------------------------------------------------- | :------------------------------------------------------------------: | :------------------------------------------------------: | :----------------------------------------: | :--------------------------------: | :-----------------------------------------------------------------------------: | :------------------------------------------------------------------------------------: | +| not present | - | yes | null | no | yes | - | +| not present | - | yes | 0 | no | yes | - | +| not present | - | yes | 1 | yes | yes | - | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| not present | - | no | null | no | no | - | +| not present | - | no | 0 | no | no | - | +| not present | - | no | 1 | yes | no | - | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | empty (deferred) | yes | null | no | yes | yes | +| present | empty (deferred) | yes | 0 | no | yes | yes | +| present | empty (deferred) | yes | 1 | yes | yes | yes | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | 1 | yes | null | no | yes | yes | +| present | 1 | yes | 0 | yes | yes | yes | +| present | 1 | yes | 1 | yes | yes | yes | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | 0 | yes | null | no | yes | yes | +| present | 0 | yes | 0 | no | yes | yes | +| present | 0 | yes | 1 | no | yes | yes | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | empty (deferred) | no | null | no | no | - | +| present | empty (deferred) | no | 0 | no | no | - | +| present | empty (deferred) | no | 1 | yes | no | - | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | 1 | no | null | no | no | - | +| present | 1 | no | 0 | yes | no | - | +| present | 1 | no | 1 | yes | no | - | +| -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | -------------------- | +| present | 0 | no | null | no | no | - | +| present | 0 | no | 0 | no | no | - | +| present | 0 | no | 1 | no | no | - |