docs(android): Document standalone app start tracing and extend API#18667
Merged
Conversation
Mirror the Apple auto-instrumentation page for Android. Add a Standalone App Start Tracing section with enablement (manifest and code) and an app.start tracesSampler example, plus an Extending the App Start subsection covering extendAppStart(), getExtendedAppStartSpan(), and finishExtendedAppStart() in Java and Kotlin. Co-Authored-By: Claude <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
Document that the extended app start span auto-finishes after 30 seconds (dropping the app start measurement) and that finishing before the first frame falls back to the natural app start end. Co-Authored-By: Claude <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Android documentation for standalone app start tracing and the new APIs for extending the app start window, aligning the Android tracing auto-instrumentation docs with the equivalent Apple guidance.
Changes:
- Documented how to enable Standalone App Start Tracing (manifest
meta-dataand in-code configuration). - Added guidance and examples for sampling standalone app starts via
tracesSamplerusing theapp.startoperation. - Added an Extending the App Start subsection documenting
Sentry.extendAppStart(),Sentry.getExtendedAppStartSpan(), andSentry.finishExtendedAppStart()(noted as available since8.48.0), including the standalone-tracing requirement.
Use the page established indentation for the new XML, Java, and Kotlin snippets. Present the SDK version note with the existing inline convention. Co-Authored-By: Claude <noreply@anthropic.com>
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
Distinguish the standalone app.start transaction from cold and warm app start spans. Explain that a deadline suppresses the measurement while preserving the transaction and spans. Co-Authored-By: Claude <noreply@anthropic.com>
Place the Java and Kotlin examples in Application.onCreate so developers call the extension while the app start window is open. Clarify initialization order for automatic and manual setup. Co-Authored-By: Claude <noreply@anthropic.com>
Finish extended app start tracing from an asynchronous completion callback so the examples demonstrate work that continues beyond the first frame. Co-Authored-By: Claude <noreply@anthropic.com>
Use a synchronous preloadResources call while retaining the optional child span. Remove the invented asynchronous helper and callback to keep the example focused on the SDK flow. Co-Authored-By: Claude <noreply@anthropic.com>
Finish the extension span directly in the examples and document finishExtendedAppStart as the equivalent alternative. Clarify that child spans should finish before the extension. Co-Authored-By: Claude <noreply@anthropic.com>
Keep the setup paragraph neutral about the completion method so it matches both the direct span finish example and the documented static API alternative. Co-Authored-By: Claude <noreply@anthropic.com>
Use the static finish helper as the primary completion path in the examples while documenting direct span completion as an equivalent alternative. Co-Authored-By: Claude <noreply@anthropic.com>
markushi
approved these changes
Jul 13, 2026
romtsn
approved these changes
Jul 13, 2026
…umentation.mdx Co-authored-by: Markus Hintersteiner <markus.hintersteiner@sentry.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DESCRIBE YOUR PR
Mirrors the Apple auto-instrumentation page for Android by documenting standalone app start tracing and the new extend-app-start API on the Android tracing auto-instrumentation page.
8.48.0) coveringSentry.extendAppStart(),Sentry.getExtendedAppStartSpan(), andSentry.finishExtendedAppStart()in Java and Kotlin, with the standalone-tracing requirement called outRefs sentry-java#5604
IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes: