Skip to content

feat(develop/spans): Add Span Buffer specification#16327

Merged
Lms24 merged 2 commits intomasterfrom
lms/feat-develop-span-buffer
Feb 11, 2026
Merged

feat(develop/spans): Add Span Buffer specification#16327
Lms24 merged 2 commits intomasterfrom
lms/feat-develop-span-buffer

Conversation

@Lms24
Copy link
Member

@Lms24 Lms24 commented Feb 10, 2026

As discussed yesterday, this PR adds a spec for a span buffer. This is less specified than the Telemetry Processor but more formal than the recommendation in the Span-First implementation guide (which I removed in favor of this page).

Most important change: We added weight-based flushing as an addition to the previous flushing behaviour

closes https://linear.app/getsentry/issue/FE-718/span-buffer-section-in-dev-docs

@vercel
Copy link

vercel bot commented Feb 10, 2026

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Feb 10, 2026 11:00am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Preview Feb 10, 2026 11:00am

Request Review

@Lms24 Lms24 self-assigned this Feb 10, 2026
@linear
Copy link

linear bot commented Feb 10, 2026

Copy link
Contributor

@buenaflor buenaflor left a comment

Choose a reason for hiding this comment

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

overall looks reasonable, however what is the long-term plan for the span buffer page? I'd imagine that it will easily gets out of sync with the telemetry processor docs and since both kinda have the same info it could be confusing which one is the source of truth for spans

@cleptric
Copy link
Member

cleptric commented Feb 10, 2026

The work on the telemetry processor is on hold. So having all things spans under one menu item is ok imo.

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

LGTM!

@Lms24
Copy link
Member Author

Lms24 commented Feb 11, 2026

overall looks reasonable, however what is the long-term plan for the span buffer page? I'd imagine that it will easily gets out of sync with the telemetry processor docs and since both kinda have the same info it could be confusing which one is the source of truth for spans

My take for now: If SDKs already implement(ed) the telemetry processor (not sure if any), the span buffer specification is more or less in there, so I'd recommend they stick with that. For SDKs having not done this yet (which I assume is the majority), the new span buffer page should be all they care about at the moment for span streaming. Does this sound reasonable?

Copy link
Contributor

@sentrivana sentrivana left a comment

Choose a reason for hiding this comment

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

Looks great, thanks for adding!

@Lms24 Lms24 merged commit cfbb3d9 into master Feb 11, 2026
14 checks passed
@Lms24 Lms24 deleted the lms/feat-develop-span-buffer branch February 11, 2026 11:58
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.

5 participants