docs(dart): Document stream mode in configuration pages by buenaflor · Pull Request #18609 · getsentry/sentry-docs

buenaflor · 2026-07-01T09:05:17Z

DESCRIBE YOUR PR

Documents stream mode across the Dart/Flutter configuration pages.

options.mdx: new traceLifecycle, beforeSendSpan, and ignoreSpans options (both Dart and Flutter)
filtering.mdx: a "Filtering Spans in Stream Mode" section (ignoreSpans + beforeSendSpan)
sampling.mdx: notes that a custom tracesSampler receives a span sampling context in stream mode, and that custom sampling context / forcing a decision don't apply
Stream-mode notes in sensitive-data and profiling

Stacked on #18554 — review/merge that first.

Ref: getsentry/sentry-dart#3886

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

Urgent deadline (GA date, etc.):
Other deadline:
None: Not urgent, can wait up to 1 week+

SLA

Teamwork makes the dream work, so please add a reviewer to your PRs.
Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

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 · 2026-07-01T09:05:23Z

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

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ready	Preview, Comment	Jul 14, 2026 11:49am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored	Preview	Jul 14, 2026 11:49am

Copilot

Pull request overview

Documents Dart/Flutter “stream mode” (span streaming) behavior across existing Configuration and data-management pages, aligning Dart/Flutter guidance with the corresponding Python documentation effort and the new span APIs introduced in sentry-dart 9.19.0.

Changes:

Adds Stream Mode configuration options (traceLifecycle, beforeSendSpan, ignoreSpans) to Options pages (common + Flutter override).
Adds stream-mode-specific guidance to Sampling, Filtering, and Sensitive Data pages (including samplingContext.spanContext and span scrubbing).
Notes feature limitations in stream mode (profiling unavailable) on the Flutter Profiling page.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
docs/platforms/dart/guides/flutter/profiling/index.mdx	Adds a warning that profiling is not available in stream mode.
docs/platforms/dart/guides/flutter/data-management/sensitive-data/index.mdx	Adds stream-mode span scrubbing guidance via `beforeSendSpan` and link to New Spans.
docs/platforms/dart/guides/flutter/configuration/sampling.mdx	Adds stream-mode callout about `tracesSampler` sampling context (`samplingContext.spanContext`).
docs/platforms/dart/guides/flutter/configuration/options.mdx	Documents stream-mode options (`traceLifecycle`, `beforeSendSpan`, `ignoreSpans`) and sampling-context note.
docs/platforms/dart/guides/flutter/configuration/filtering.mdx	Adds a stream-mode section describing span filtering/modification using `ignoreSpans`/`beforeSendSpan`.
docs/platforms/dart/common/data-management/sensitive-data/index.mdx	Same stream-mode sensitive data guidance for the common Dart pages.
docs/platforms/dart/common/configuration/sampling.mdx	Same stream-mode sampling-context callout for the common Dart pages.
docs/platforms/dart/common/configuration/options.mdx	Same stream-mode options and sampling-context note for the common Dart pages.
docs/platforms/dart/common/configuration/filtering.mdx	Same stream-mode filtering section for the common Dart pages.

Document stream mode (SentryTraceLifecycle.stream) for the Dart and Flutter SDKs, where spans are sent as they finish instead of being batched into a transaction. Mirrors the Python New Spans pages. - New Spans page: enabling stream mode, manual instrumentation with startSpan/startSpanSync/startInactiveSpan, typed attributes, status, beforeSendSpan/ignoreSpans, sampling, and verification - Migration guide: mapping transaction-based APIs to the new span APIs - Platform-includes split init snippets for Flutter vs plain Dart Co-Authored-By: Claude <noreply@anthropic.com>

Add the stream mode configuration options (traceLifecycle, beforeSendSpan, ignoreSpans) to the Options pages, and cover stream mode behavior in the filtering, sampling, sensitive-data, and profiling pages for both Dart and Flutter. Note that a custom tracesSampler receives a different sampling context and that profiling is unavailable in stream mode. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude <noreply@anthropic.com>

Custom sampling context and forcing a sampling decision don't exist in stream mode; note that data should be passed as span attributes and read via samplingContext.spanContext in a tracesSampler instead. Co-Authored-By: Claude <noreply@anthropic.com>

Add beforeSendTransaction and ignoreTransactions guidance to the Dart and Flutter filtering pages. Explain how to migrate transaction filters to ignoreSpans in stream mode. Co-Authored-By: Claude <noreply@anthropic.com>

## DESCRIBE YOUR PR Introduces the Dart/Flutter **stream mode** (span streaming) documentation — the base of a 4-PR stack. Mirrors the Python New Spans docs. - New **New Spans** page: enabling stream mode (`traceLifecycle: SentryTraceLifecycle.stream`), manual instrumentation (`startSpan`/`startSpanSync`/`startInactiveSpan`), typed `SentryAttribute` attributes (including array factories), span status, `beforeSendSpan`/`ignoreSpans`, sampling, and verification - New **Migrate to Stream Mode** guide mapping the transaction API to the new span API - Minimum SDK version documented as `9.23.0` This is the bottom of the stack — merge this first. Stacked children: #18609, #18610, #18611. Ref: getsentry/sentry-dart#3886 ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.):  - [ ] Other deadline:  - [x] None: Not urgent, can wait up to 1 week+ ## SLA - Teamwork makes the dream work, so please add a reviewer to your PRs. - Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it. Thanks in advance for your help! ## PRE-MERGE CHECKLIST *Make sure you've checked the following before merging your changes:* - [ ] 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](https://github.com/orgs/getsentry/teams/docs) --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: inventarSarah <sarah@codingwriter.com>

Branch to merge all of span streaming for Dart/Flutter - #18611 - #18610 - #18609 - #18554 Closes #18655 --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: inventarSarah <sarah@codingwriter.com>

Copilot AI review requested due to automatic review settings July 1, 2026 09:05

codeowner-assignment Bot requested a review from a team July 1, 2026 09:05

Copilot started reviewing on behalf of buenaflor July 1, 2026 09:05 View session

Copilot AI reviewed Jul 1, 2026

View reviewed changes

Comment thread docs/platforms/dart/common/configuration/options.mdx Outdated

buenaflor marked this pull request as draft July 1, 2026 09:11

vercel Bot deployed to Preview – sentry-docs July 1, 2026 09:20 View deployment

buenaflor force-pushed the buenaflor/docs/dart-span-streaming-config branch from 77a12de to 7328412 Compare July 1, 2026 10:23

buenaflor changed the base branch from master to buenaflor/docs/dart-span-streaming-new-spans July 1, 2026 10:23

vercel Bot deployed to Preview – sentry-docs July 1, 2026 10:34 View deployment

vercel Bot deployed to Preview – sentry-docs July 6, 2026 10:09 View deployment

vercel Bot deployed to Preview – sentry-docs July 6, 2026 12:29 View deployment

buenaflor force-pushed the buenaflor/docs/dart-span-streaming-config branch from 93cbe73 to d291d3b Compare July 6, 2026 12:36

vercel Bot deployed to Preview – sentry-docs July 6, 2026 12:46 View deployment

buenaflor mentioned this pull request Jul 6, 2026

docs(dart): Add New Spans page and stream mode migration guide #18554

Merged

6 tasks

buenaflor force-pushed the buenaflor/docs/dart-span-streaming-config branch from d291d3b to ad6539b Compare July 6, 2026 13:43

vercel Bot deployed to Preview – sentry-docs July 6, 2026 13:54 View deployment

inventarSarah reviewed Jul 7, 2026

View reviewed changes

Comment thread docs/platforms/dart/guides/flutter/profiling/index.mdx Outdated

inventarSarah reviewed Jul 7, 2026

View reviewed changes

Comment thread docs/platforms/dart/common/configuration/filtering.mdx Outdated

inventarSarah reviewed Jul 9, 2026

View reviewed changes

Comment thread docs/platforms/dart/common/configuration/filtering.mdx

vercel Bot deployed to Preview – sentry-docs July 9, 2026 08:50 View deployment

inventarSarah force-pushed the buenaflor/docs/dart-span-streaming-new-spans branch from 47f4b17 to e3ee6bc Compare July 9, 2026 11:17

inventarSarah force-pushed the buenaflor/docs/dart-span-streaming-config branch from bc30c88 to da34ec1 Compare July 9, 2026 11:32

inventarSarah marked this pull request as ready for review July 9, 2026 11:38

inventarSarah requested review from cleptric and sfanahata July 9, 2026 11:39

inventarSarah assigned inventarSarah and buenaflor Jul 9, 2026

vercel Bot deployed to Preview – sentry-docs July 9, 2026 12:35 View deployment

buenaflor force-pushed the buenaflor/docs/dart-span-streaming-new-spans branch from e3ee6bc to 522b994 Compare July 14, 2026 11:37

buenaflor and others added 7 commits July 14, 2026 13:37

docs(dart): Bump span streaming option availableSince to 9.23.0

2df5fe0

Co-Authored-By: Claude <noreply@anthropic.com>

minor wording updates; changes to align with Python guides

229981f

delete unused folder

d3c4833

docs(dart): Document transaction filtering options

dee1a7a

Add beforeSendTransaction and ignoreTransactions guidance to the Dart and Flutter filtering pages. Explain how to migrate transaction filters to ignoreSpans in stream mode. Co-Authored-By: Claude <noreply@anthropic.com>

buenaflor force-pushed the buenaflor/docs/dart-span-streaming-config branch from 2f7ddbb to dee1a7a Compare July 14, 2026 11:38

vercel Bot deployed to Preview – sentry-docs July 14, 2026 11:49 View deployment

inventarSarah approved these changes Jul 16, 2026

View reviewed changes

buenaflor merged commit c898c62 into buenaflor/docs/dart-span-streaming-new-spans Jul 20, 2026
9 checks passed

buenaflor deleted the buenaflor/docs/dart-span-streaming-config branch July 20, 2026 08:41

buenaflor mentioned this pull request Jul 20, 2026

docs(dart/flutter): Add Span Streaming Docs #18764

Merged

Navigation Menu

Uh oh!

Uh oh!

docs(dart): Document stream mode in configuration pages - #18609

docs(dart): Document stream mode in configuration pages#18609
buenaflor merged 7 commits into
buenaflor/docs/dart-span-streaming-new-spansfrom
buenaflor/docs/dart-span-streaming-config

buenaflor commented Jul 1, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jul 1, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Uh oh!

Conversation

buenaflor commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

DESCRIBE YOUR PR

IS YOUR CHANGE URGENT?

SLA

PRE-MERGE CHECKLIST

Uh oh!

vercel Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

buenaflor commented Jul 1, 2026 •

edited

Loading

vercel Bot commented Jul 1, 2026 •

edited

Loading