Skip to content

feat(extend-app-start): [3/4] Eagerly create the extended app start transaction#5608

Open
buenaflor wants to merge 37 commits into
feat/app-start-extension-androidfrom
feat/app-start-extension-materialize
Open

feat(extend-app-start): [3/4] Eagerly create the extended app start transaction#5608
buenaflor wants to merge 37 commits into
feat/app-start-extension-androidfrom
feat/app-start-extension-materialize

Conversation

@buenaflor

@buenaflor buenaflor commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

PR Stack (Extend App Start)


📜 Description

Registers the extend-listener and wires the extension through to the trace and the vital, making the feature work end-to-end. The extension is eager and standalone-only — only the standalone app.start transaction is independent of an activity and can be created in Application.onCreate.

Class Change
ActivityLifecycleIntegration Registers the extend-listener, but only when enableStandaloneAppStartTracing is on (this is what makes the API standalone-only). On Sentry.extendAppStart() the listener eagerly creates the standalone app.start transaction (waitForChildren + deadline) and its app.start.extended child, and returns them as an ExtendedAppStart.
PerformanceAndroidEventProcessor App start vital is now max(natural first-frame duration, extended end), so an early finish never shortens it. On deadline the measurement is suppressed entirely (no inflated ~30s value); spans still attach. Non-extended starts are unchanged.

Notes

  • The transaction is owned by the extension, not the integration's appStartTransaction field, so per-activity cleanup can't cancel it.
  • The first activity continues the eager trace into ui.load (via isActive()) instead of starting a second app.start, and attaches the screen so the foreground app.start keeps its app.vitals.start.screen.
  • The first frame finishes the transaction; waitForChildren holds it open until Sentry.finishExtendedAppStart(). Headless finishes it at the headless stop time. A shared createStandaloneAppStartTransaction(...) helper backs both paths.
  • The legacy deferred-span path and the non-standalone (ui.load) extension path are removed — eager creation makes them unnecessary.

💡 Motivation and Context

Part of the app start extension API stack (#5553). This is where the extension actually affects the trace and the vital, scoped to standalone app start tracing because only the standalone app.start transaction can be created eagerly in onCreate.

💚 How did you test it?

Unit tests (TDD):

  • ActivityLifecycleIntegrationTest — eager app.start + extended child on extend; first activity continues the trace with no second app.start and the screen attached; standalone & headless stay open until finishExtendedAppStart(); standalone-off is a no-op; the eager txn survives activity destroy.
  • PerformanceAndroidEventProcessorTest — extended end drives the cold measurement; an early finish never reports shorter than the first-frame duration; a deadline finish suppresses the measurement.

apiCheck, spotless, and the :sentry-android-core unit suite pass.

📝 Checklist

  • I added GH Issue ID & Linear ID
  • I added tests to verify the changes.
  • No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
  • I updated the docs if needed.
  • I updated the wizard if needed.
  • Review from the native team if needed.
  • No breaking change or entry added to the changelog.
  • No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

[4/4] — add the public Sentry.extendAppStart() / Sentry.finishExtendedAppStart() / Sentry.getExtendedAppStartSpan() facade.

⚠️ Merge this PR using a merge commit (not squash). Only the collection branch is squash-merged into main.

#skip-changelog

@github-actions

github-actions Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor
Messages
📖 Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against a6846bd

@sentry

sentry Bot commented Jun 23, 2026

Copy link
Copy Markdown

📲 Install Builds

Android

🔗 App Name App ID Version Configuration
SDK Size io.sentry.tests.size 8.44.1 (1) release

⚙️ sentry-android Build Distribution Settings

@github-actions

github-actions Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Performance metrics 🚀

  Plain With Sentry Diff
Startup time 310.90 ms 334.00 ms 23.10 ms
Size 0 B 0 B 0 B

Baseline results on branch: feat/app-start-extension-android

Startup times

Revision Plain With Sentry Diff
db5be2f 311.84 ms 365.94 ms 54.10 ms
388ffc5 315.18 ms 362.43 ms 47.25 ms
d8041d7 305.32 ms 370.59 ms 65.27 ms
ca0c0cf 318.45 ms 370.06 ms 51.61 ms
201a6fd 326.00 ms 371.92 ms 45.92 ms
b76203f 336.02 ms 403.42 ms 67.40 ms
ba0608b 319.63 ms 373.04 ms 53.41 ms
682e090 347.33 ms 427.28 ms 79.95 ms

App size

Revision Plain With Sentry Diff
db5be2f 0 B 0 B 0 B
388ffc5 0 B 0 B 0 B
d8041d7 0 B 0 B 0 B
ca0c0cf 0 B 0 B 0 B
201a6fd 0 B 0 B 0 B
b76203f 0 B 0 B 0 B
ba0608b 0 B 0 B 0 B
682e090 0 B 0 B 0 B

Previous results on branch: feat/app-start-extension-materialize

Startup times

Revision Plain With Sentry Diff
69caaee 313.73 ms 373.92 ms 60.19 ms
e5800ed 318.21 ms 375.48 ms 57.27 ms
ae82ca0 381.62 ms 426.12 ms 44.51 ms
a037262 318.06 ms 364.59 ms 46.52 ms
511890d 315.38 ms 376.00 ms 60.62 ms
20bbe9a 305.48 ms 387.25 ms 81.77 ms
4451634 321.21 ms 376.21 ms 55.00 ms
3a27919 371.17 ms 447.31 ms 76.14 ms
4cf89ba 340.51 ms 416.92 ms 76.41 ms
44c06ea 324.19 ms 384.88 ms 60.69 ms

App size

Revision Plain With Sentry Diff
69caaee 0 B 0 B 0 B
e5800ed 0 B 0 B 0 B
ae82ca0 0 B 0 B 0 B
a037262 0 B 0 B 0 B
511890d 0 B 0 B 0 B
20bbe9a 0 B 0 B 0 B
4451634 0 B 0 B 0 B
3a27919 0 B 0 B 0 B
4cf89ba 0 B 0 B 0 B
44c06ea 0 B 0 B 0 B

@buenaflor buenaflor force-pushed the feat/app-start-extension-android branch from 54be119 to d2b96ad Compare June 24, 2026 10:47
@buenaflor buenaflor force-pushed the feat/app-start-extension-materialize branch from 0f8ee4d to 5dfb0e1 Compare June 24, 2026 23:28
@buenaflor buenaflor force-pushed the feat/app-start-extension-materialize branch from 5dfb0e1 to 0bd259a Compare June 25, 2026 09:59
@buenaflor buenaflor changed the title feat(extend-app-start): [3/4] Materialize extended app start span and extend the vital feat(extend-app-start): [3/4] Eagerly create the extended app start transaction Jun 25, 2026
@buenaflor buenaflor force-pushed the feat/app-start-extension-android branch from 5dd39af to 3bc1643 Compare June 25, 2026 11:07
@buenaflor buenaflor force-pushed the feat/app-start-extension-materialize branch from 0bd259a to 0b6ada0 Compare June 25, 2026 11:07
@buenaflor buenaflor force-pushed the feat/app-start-extension-android branch from 3bc1643 to 45f6c0b Compare June 25, 2026 11:37
@buenaflor buenaflor force-pushed the feat/app-start-extension-materialize branch 5 times, most recently from c3f3627 to cbaef2f Compare June 25, 2026 12:23
…tion (standalone-only)

Registers an extend-listener on AppStartExtension that eagerly creates the
standalone app.start transaction + extended child span in Application.onCreate,
held open via waitForChildren until Sentry.finishAppStart() or the deadline. The
first activity continues the eager trace into ui.load (attaching the screen so it
stays a foreground app.start) instead of creating a second app.start; headless
finishes the eager txn. The app start vital is max(natural, extended) so an early
finish never shortens it, and is suppressed on deadline. Standalone-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@buenaflor buenaflor force-pushed the feat/app-start-extension-android branch from 2d5188e to 01b1dc4 Compare June 25, 2026 12:32
@buenaflor buenaflor force-pushed the feat/app-start-extension-materialize branch from cbaef2f to d996425 Compare June 25, 2026 12:32
buenaflor and others added 8 commits June 25, 2026 14:52
…on extendAppStart

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… coverage

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…nd trim comments

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…app start path

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
buenaflor and others added 6 commits June 26, 2026 14:12
…t screen

While the extension was open, every activity's onActivityCreated re-attached
app.vitals.start.screen to the eager app.start, so a second activity opened
before finishExtendedAppStart() overwrote the launch screen. Gate the attach
on isAppStart so only the launch activity sets it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…lize' into feat/app-start-extension-materialize

# Conflicts:
#	sentry-android-core/src/main/java/io/sentry/android/core/ActivityLifecycleIntegration.java
buenaflor and others added 4 commits June 29, 2026 09:50
Remove comments that restated the adjacent test code (the eager
extendAppStart call and the second-activity open).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
buenaflor and others added 3 commits June 29, 2026 11:32
The test names describe the scenarios; the inline comments restated them.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
buenaflor and others added 3 commits June 29, 2026 14:05
…dAppStartSpan is nullable

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The get-then-clear of the app start sampling decision in
onExtendAppStartRequested looks redundant without context. Document
that the decision is pre-rolled on the previous run, forces the eager
app.start transaction's sampling and profiler binding, and must be
cleared so the first ui.load can't also claim it.

Co-Authored-By: Claude <noreply@anthropic.com>
…ager extension finishes

The eager extendAppStart path persists trace headers so a later
ui.load can continue the app.start trace, but never recorded the app
start end time - that was only set on the headless path. If the
extended transaction finished (user finish or deadline) before any
activity, the first ui.load treated the continuation window as
unbounded and joined the completed app-start trace no matter how much
later it started.

Persist the transaction's finish date via the transaction finished
callback, which covers every finish path (finishExtendedAppStart,
first frame, deadline), so the existing continuation window check
bounds the extend path the same way it bounds the headless one.

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

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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

Fix All in Cursor

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

Reviewed by Cursor Bugbot for commit 9196ec9. Configure here.

@romtsn romtsn left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM, but we really need to refactor this thing 🙈 it's just too many if-elses in here. If you got time could you task Fable to come up with nice a refactor plan maybe and create an issue out of that?

@buenaflor

Copy link
Copy Markdown
Contributor Author

it's just too many if-elses in here

yeah :/ so many edge cases with all the different combinations, prolly some of the complexity will be gone as well once we make standalone the only way to go.

come up with nice a refactor plan maybe and create an issue out of that?

👍

…ension is active

A first activity arriving more than a minute after launch resets the
app start span to the activity create time and flips the type to warm.
While an app start extension is active this corrupts the extended
vital: the eager app.start transaction stays anchored at process start
while the measurement subtracts the reset span start, and a cold
launch gets reported under the warm key.

An active extension is the user explicitly saying the launch is still
in progress, so let it pin the launch: skip the reclassification while
the extension is active and apply the heuristic as before once it has
finished.

Co-Authored-By: Claude <noreply@anthropic.com>
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.

4 participants