Skip to content

feat(devdocs): Add guidance for updating sample_rate #18645

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sentrivana wants to merge 6 commits into
base: master
Choose a base branch
from
Open

feat(devdocs): Add guidance for updating sample_rate #18645

Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
956cd03
feat(devdocs): Add guidance wrt to updating `sample_rate`
sentrivana Jul 6, 2026
e32bf56
fixes
sentrivana Jul 6, 2026
ba6fe2f
fix section id
sentrivana Jul 6, 2026
e9801c1
clarification
sentrivana Jul 6, 2026
5770952
.
sentrivana Jul 6, 2026
c746f62
update version
sentrivana Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions develop-docs/sdk/foundations/trace-propagation/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ spec_depends_on:
- id: sdk/foundations/state-management/scopes
version: ">=1.0.0"
spec_changelog:
- version: 1.10.0
date: 2026-07-06
summary: Added Sampling Rate Propagation section
Comment thread
sentrivana marked this conversation as resolved.
- version: 1.9.0
date: 2026-02-24
summary: Consolidated into foundations/trace-propagation
Expand Down Expand Up @@ -248,6 +251,20 @@ A transaction's sampling decision **MUST** be passed to all of its children, inc

</SpecSection>

<SpecSection id="sampling-rate-propagation" status="stable" since="1.10.0">

### Sampling Rate Propagation

If there is an incoming `sample_rate`, it **SHOULD** be updated in the baggage if:
- an explicit sampling decision is forced, e.g. `startTransaction(sampled: true)`
- the `tracesSampler` is invoked
- the `tracesSampleRate` is used
- the SDK downsamples due to backpressure

In other words, whenever the SDK's effective sampling rate overrides the incoming `sample_rate`, it needs to be updated, even if the baggage is considered immutable.

</SpecSection>

<SpecSection id="default-propagation" status="stable" since="1.5.0">

### Default Propagation (No Tracing Config)
Expand Down
Loading