fix(tracing): Fix unsampled/deferred trace propagation in span streaming

[sentrivana]

Description

The SDK didn't behave correctly in some trace propagation scenarios in stream mode.

The current SDK design was emitting headers with a deferred sampling decision if the sampling decision was negative (whether inherited or not), because it was falling back to TWP behavior too eagerly.

How it should be working

In the following, tracing enabled means either a traces_sample_rate or a traces_sampler is defined. Tracing disabled means both are None and tracing without performance is active.

There are three kinds of sampling decisions: sampled (1), unsampled (0), and deferred (``), meaning no decision.

1. No incoming trace headers
   • tracing enabled: make a sampling decision and propagate it
   • tracing disabled: do not make a decision, propagate a deferred decision (no sampling decision)
2. Incoming trace headers with a sampled/unsampled decision
   • tracing enabled: respect and propagate incoming decision
   • tracing disabled: respect and propagate incoming decision
3. Incoming trace headers with a deferred sampling decision (essentially same as 1)
   • tracing enabled: make a sampling decision and propagate it
   • tracing disabled: propagate deferred sampling decision

The fix

NoOpStreamedSpans now carry their own trace and span ID information as well as the current propagation data (a snapshot of the propagation context, like StreamedSpans) and use it to emit the correct headers.

Issues

Closes #6755

Reminders

• Please add tests to validate your changes, and lint your code using uv run ruff.
• Add GH Issue ID & Linear ID (if applicable)
• PR title should use conventional commit style (feat:, fix:, ref:, meta:)
• For external contributors: CONTRIBUTING.md, Sentry SDK development docs, Discord community

[github-actions]

Codecov Results 📊

✅ 90184 passed | ⏭️ 6302 skipped | Total: 96486 | Pass Rate: 93.47% | Execution Time: 314m 32s

📊 Comparison with Base Branch

Metric	Change
Total Tests	📈 +150
Passed Tests	📈 +150
Failed Tests	—
Skipped Tests	—

All tests are passing successfully.

✅ Patch coverage is 96.97%. Project has 2436 uncovered lines.
✅ Project coverage is 89.78%. Comparing base (base) to head (head).

Files with missing lines (1)

File	Patch %	Lines
sentry_sdk/traces.py	92.86%	⚠️ 1 Missing and 1 partials

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    89.76%    89.78%    +0.02%
==========================================
  Files          192       192         —
  Lines        23823     23833       +10
  Branches      8226      8232        +6
==========================================
+ Hits         21384     21397       +13
- Misses        2439      2436        -3
- Partials      1351      1348        -3

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 46b410a. Configure here.}

[cursor]

Ignored spans wrong trace propagation

Medium Severity

Segment-level ignored spans create an active NoOpStreamedSpan without a propagation sampled value, so it defaults to False. Outgoing headers now come from that noop via _to_traceparent, which uses sampled, not parent_sampled. Downstream traces can be marked unsampled even when the incoming trace was sampled or should stay deferred.

 

^{Reviewed by Cursor Bugbot for commit 46b410a. Configure here.}

[sentrivana]

Converting to draft to address bot comments