feat(replay): Record segment names on Android by buenaflor · Pull Request #3897 · getsentry/sentry-dart

buenaflor · 2026-07-16T11:33:28Z

📜 Description

While Android session replay is recording, finishing a streaming segment-root span now registers that span's name with native replay via ReplayController.registerSegmentName. Replay events can then carry segment_names, so Transaction Summary can find related replays without relying on sentry.replay.id alone.

Non-Android platforms get a no-op on the new binding method. Depends on sentry-android 8.49.0 already on main.

💡 Motivation and Context

Under span streaming, buffer-mode replay often leaves sentry.replay.id pointing at missing replays, which breaks "query spans by segment name → get replay IDs → fetch replays". Recording segment_names on the replay event sidesteps that.

Fixes #3865

Related: getsentry/sentry-java#5763, getsentry/sentry-javascript#21851

💚 How did you test it?

Unit tests in replay_telemetry_integration_test.dart: segment root registers name; child/empty skip; close removes the hook

📝 Checklist

I reviewed submitted code
I added tests to verify changes
No new PII added or SDK only sends newly added PII if sendDefaultPii is enabled
I updated the docs if needed
All tests passing
Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec
No breaking changes

🔮 Next steps

Cocoa/iOS once a native registerSegmentName API exists

github-actions · 2026-07-16T11:33:45Z

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

Features

(replay) Record segment names on Android by buenaflor in #3897

Fixes

(flutter) Prevent StateError when delayed frames list is empty by muhammadkamel in #3876

Dependencies

Deps

chore(deps): update Android SDK to v8.49.0 by github-actions in #3895
chore(deps): update Native SDK to v0.15.3 by github-actions in #3862
chore(deps): update Cocoa SDK to v8.58.4 by github-actions in #3864
chore(deps): update Android SDK to v8.48.0 by github-actions in #3873

Internal Changes

(dart) Accept beta wasm function name by sentry-junior in #3898

_{🤖 This preview updates automatically when you update the PR.}

codecov · 2026-07-16T11:35:32Z

Codecov Report

❌ Patch coverage is 75.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 91.85%. Comparing base (65ec450) to head (0707155).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...ckages/flutter/lib/src/native/c/sentry_native.dart	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3897      +/-   ##
==========================================
+ Coverage   87.36%   91.85%   +4.49%     
==========================================
  Files         338      105     -233     
  Lines       12282     3806    -8476     
==========================================
- Hits        10730     3496    -7234     
+ Misses       1552      310    -1242

Flag	Coverage Δ
sentry	`?`
sentry_dio	`?`
sentry_drift	`?`
sentry_file	`?`
sentry_firebase_remote_config	`100.00% <ø> (ø)`
sentry_flutter	`91.47% <75.00%> (+0.34%)`	⬆️
sentry_grpc	`?`
sentry_hive	`?`
sentry_isar	`?`
sentry_link	`?`
sentry_logging	`?`
sentry_sqflite	`?`
sentry_supabase	`97.27% <ø> (ø)`

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

Copilot

Pull request overview

Adds Android session-replay support for recording span segment names by introducing a new native binding (registerSegmentName) and wiring it into the replay telemetry lifecycle so replay events can later include segment_names for Transaction Summary lookups.

Changes:

Add SentryNativeBinding.registerSegmentName and implement it for Android JNI; other platforms provide a no-op.
Register the segment-root span name during OnProcessSpan in ReplayTelemetryIntegration, with integration tests covering root/child/empty and hook removal on close().
Bump Android sentry-android / sentry-spotlight to 8.49.0 and regenerate JNI bindings.

Reviewed changes

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

Show a summary per file

File	Description
packages/flutter/lib/src/integrations/replay_telemetry_integration.dart	Registers segment-root span names via lifecycle hook for replay telemetry.
packages/flutter/lib/src/native/sentry_native_binding.dart	Adds `registerSegmentName` to the native binding interface.
packages/flutter/lib/src/native/java/sentry_native_java.dart	Implements `registerSegmentName` via JNI and forwards to native replay integration.
packages/flutter/lib/src/native/java/binding.dart	Regenerated JNI bindings to include `ReplayIntegration.registerSegmentName` + related updates.
packages/flutter/lib/src/web/sentry_web.dart	Adds no-op `registerSegmentName` implementation for web binding.
packages/flutter/lib/src/native/sentry_native_channel.dart	Adds no-op `registerSegmentName` for method-channel binding.
packages/flutter/lib/src/native/c/sentry_native.dart	Adds no-op `registerSegmentName` for C/FFI binding.
packages/flutter/test/integrations/replay_telemetry_integration_test.dart	Adds unit tests verifying segment-name registration and callback cleanup on close.
packages/flutter/test/mocks.mocks.dart	Updates mock native binding with `registerSegmentName`.
packages/flutter/android/build.gradle	Bumps `io.sentry:sentry-android` and `sentry-spotlight` to `8.49.0`.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Register streaming segment-root names with native replay so replay events include segment_names for Transaction Summary. Uses sentry-android 8.49.0 ReplayController.registerSegmentName. Fixes #3865 Co-Authored-By: Cursor Grok 4.5 <[email protected]> Co-authored-by: Cursor <[email protected]>

github-actions · 2026-07-16T13:07:36Z

Android Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	350.46 ms	352.59 ms	2.13 ms
Size	14.55 MiB	15.87 MiB	1.31 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`fd88186`	422.07 ms	469.10 ms	47.03 ms
`d5a1225`	377.37 ms	366.56 ms	-10.81 ms
`1980dca`	354.77 ms	346.96 ms	-7.82 ms
`d0371bb`	426.85 ms	437.14 ms	10.29 ms
`bfabaf2`	408.04 ms	444.38 ms	36.34 ms
`7b21e8b`	467.74 ms	466.24 ms	-1.50 ms
`2f63d89`	415.95 ms	424.21 ms	8.26 ms
`0265ce5`	406.39 ms	418.48 ms	12.09 ms
`7cfee3b`	498.78 ms	516.98 ms	18.20 ms
`6f47800`	451.04 ms	509.64 ms	58.60 ms

App size

Revision	Plain	With Sentry	Diff
`fd88186`	13.93 MiB	15.00 MiB	1.06 MiB
`d5a1225`	14.31 MiB	15.49 MiB	1.19 MiB
`1980dca`	14.55 MiB	15.87 MiB	1.31 MiB
`d0371bb`	14.31 MiB	15.62 MiB	1.31 MiB
`bfabaf2`	13.93 MiB	15.06 MiB	1.13 MiB
`7b21e8b`	13.93 MiB	15.00 MiB	1.06 MiB
`2f63d89`	14.09 MiB	15.28 MiB	1.19 MiB
`0265ce5`	14.09 MiB	15.28 MiB	1.19 MiB
`7cfee3b`	6.54 MiB	7.70 MiB	1.17 MiB
`6f47800`	6.54 MiB	7.69 MiB	1.15 MiB

Previous results on branch: feat/android-replay-segment-names

Startup times

Revision	Plain	With Sentry	Diff
`4c1d390`	370.08 ms	370.52 ms	0.44 ms
`e01dcdf`	403.87 ms	427.02 ms	23.15 ms
`e6cedf5`	357.61 ms	363.94 ms	6.33 ms

App size

Revision	Plain	With Sentry	Diff
`4c1d390`	14.55 MiB	15.87 MiB	1.31 MiB
`e01dcdf`	14.55 MiB	15.87 MiB	1.31 MiB
`e6cedf5`	14.55 MiB	15.87 MiB	1.31 MiB

Empty names are already skipped in the Android JNI wrapper. Co-Authored-By: Cursor Grok 4.5 <[email protected]> Co-authored-by: Cursor <[email protected]>

github-actions · 2026-07-16T13:10:03Z

iOS Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1271.79 ms	1276.41 ms	4.62 ms
Size	5.83 MiB	6.28 MiB	460.55 KiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`73dca78`	1246.65 ms	1265.42 ms	18.76 ms
`3f47ea3`	1263.90 ms	1263.87 ms	-0.02 ms
`d379a16`	1239.65 ms	1237.52 ms	-2.13 ms
`667e3c4`	1254.70 ms	1268.23 ms	13.52 ms
`114239b`	1225.74 ms	1230.17 ms	4.43 ms
`a10aff4`	1241.67 ms	1255.02 ms	13.35 ms
`9993fa9`	1255.60 ms	1254.31 ms	-1.29 ms
`dc53d48`	1252.06 ms	1255.61 ms	3.55 ms
`c1e775e`	1263.08 ms	1275.32 ms	12.24 ms
`38a22c2`	1257.60 ms	1259.71 ms	2.12 ms

App size

Revision	Plain	With Sentry	Diff
`73dca78`	7.86 MiB	9.44 MiB	1.58 MiB
`3f47ea3`	5.53 MiB	5.96 MiB	444.81 KiB
`d379a16`	5.83 MiB	6.28 MiB	459.63 KiB
`667e3c4`	5.83 MiB	6.28 MiB	459.83 KiB
`114239b`	5.53 MiB	5.96 MiB	444.85 KiB
`a10aff4`	5.53 MiB	6.00 MiB	486.71 KiB
`9993fa9`	5.83 MiB	6.28 MiB	459.39 KiB
`dc53d48`	5.65 MiB	6.09 MiB	446.96 KiB
`c1e775e`	20.70 MiB	22.46 MiB	1.75 MiB
`38a22c2`	5.73 MiB	6.17 MiB	453.62 KiB

Previous results on branch: feat/android-replay-segment-names

Startup times

Revision	Plain	With Sentry	Diff
`e01dcdf`	1257.02 ms	1249.51 ms	-7.51 ms
`e6cedf5`	1262.89 ms	1269.87 ms	6.98 ms
`4c1d390`	1251.05 ms	1254.33 ms	3.29 ms

App size

Revision	Plain	With Sentry	Diff
`e01dcdf`	5.83 MiB	6.28 MiB	459.02 KiB
`e6cedf5`	5.83 MiB	6.28 MiB	460.55 KiB
`4c1d390`	5.83 MiB	6.28 MiB	460.54 KiB

Co-Authored-By: Cursor Grok 4.5 <[email protected]> Co-authored-by: Cursor <[email protected]>

lucas-zimerman

LGTM!

buenaflor marked this pull request as ready for review July 16, 2026 11:34

buenaflor requested a review from denrase as a code owner July 16, 2026 11:34

Copilot AI review requested due to automatic review settings July 16, 2026 11:34

Copilot started reviewing on behalf of buenaflor July 16, 2026 11:35 View session

Copilot AI reviewed Jul 16, 2026

View reviewed changes

Comment thread packages/flutter/lib/src/integrations/replay_telemetry_integration.dart

buenaflor force-pushed the feat/android-replay-segment-names branch from e01dcdf to 4c1d390 Compare July 16, 2026 12:57

buenaflor changed the base branch from v10-branch to main July 16, 2026 12:57

buenaflor force-pushed the feat/android-replay-segment-names branch from 4c1d390 to 151a549 Compare July 16, 2026 12:58

ref(replay): Drop empty segment name guard

e6cedf5

Empty names are already skipped in the Android JNI wrapper. Co-Authored-By: Cursor Grok 4.5 <[email protected]> Co-authored-by: Cursor <[email protected]>

test(replay): Clarify closed segment name test name

0707155

Co-Authored-By: Cursor Grok 4.5 <[email protected]> Co-authored-by: Cursor <[email protected]>

romtsn approved these changes Jul 16, 2026

View reviewed changes

lucas-zimerman approved these changes Jul 16, 2026

View reviewed changes

sentry Bot reviewed Jul 17, 2026

View reviewed changes

Comment thread packages/flutter/lib/src/integrations/replay_telemetry_integration.dart

buenaflor merged commit e0da04d into main Jul 20, 2026
70 checks passed

buenaflor deleted the feat/android-replay-segment-names branch July 20, 2026 08:57

This was referenced Jul 21, 2026

publish: getsentry/[email protected] getsentry/publish#8946

Closed

publish: getsentry/[email protected] getsentry/publish#8947

Closed

github-actions Bot mentioned this pull request Jul 21, 2026

Record segment names that occur during replay for span streaming #3865

Closed

Uh oh!

Uh oh!

Conversation

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

Uh oh!

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

Features

Fixes

Dependencies

Deps

Internal Changes

Uh oh!

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

Uh oh!

Codecov Report

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

github-actions Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Android Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: feat/android-replay-segment-names

Startup times

App size

Uh oh!

github-actions Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

iOS Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: feat/android-replay-segment-names

Startup times

App size

Uh oh!

lucas-zimerman left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

buenaflor commented Jul 16, 2026 •

edited

Loading

github-actions Bot commented Jul 16, 2026 •

edited

Loading

codecov Bot commented Jul 16, 2026 •

edited

Loading

github-actions Bot commented Jul 16, 2026 •

edited

Loading

github-actions Bot commented Jul 16, 2026 •

edited

Loading