Skip to content

docs(android): Introduce Android ProfilingManager options - #18481

Merged
markushi merged 9 commits into
masterfrom
feat/android-profiling-manager
Jul 29, 2026
Merged

docs(android): Introduce Android ProfilingManager options#18481
markushi merged 9 commits into
masterfrom
feat/android-profiling-manager

Conversation

@markushi

@markushi markushi commented Jun 18, 2026

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Introduce new docs for Android ProfilingManager.

Warning

do not merge before getsentry/sentry-java#5251

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:

@vercel

vercel Bot commented Jun 18, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jul 29, 2026 4:37pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jul 29, 2026 4:37pm

Request Review

UI Profiling relies on the Android ProfilingManager, which rate limits
profiling requests at the framework level on top of the SDK sampling
rate. Document this in the Limitations section and add a callout with the
shell command to disable the restrictions for local testing.

Co-Authored-By: Claude <noreply@anthropic.com>
Comment thread docs/platforms/android/configuration/options.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/legacy/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/profiling/troubleshooting/index.mdx Outdated
Comment thread docs/platforms/android/index.mdx Outdated

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Some of the formatting needs adjusting, but once those are done this looks good to go!

markushi and others added 3 commits June 29, 2026 12:36
Apply reviewer suggestions: inline multi-line Alert/paragraph JSX to fix
stray line breaks in rendered output, reword the useProfilingManager
description, and fix minor wording and spelling.

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

Update the Android profiling docs to match the SDK change where
ProfilingManager (Perfetto) is always used on Android 15 (API level 35)
and higher, with no opt-in. The legacy tracer-based profiler now runs
automatically on older devices, controlled by the new enableLegacyProfiling
option (default true, deprecated, removed in the next major).

- Replace the useProfilingManager option with enableLegacyProfiling (8.47.0)
- Remove use-profiling-manager from onboarding, manual-setup, and profiling
  examples since Perfetto is now automatic on API 35+
- Reframe UI Profiling and Legacy Profiling pages around automatic backend
  selection and the legacy fallback
- Clarify that app start profiling is only supported by the legacy profiler

Co-Authored-By: Claude <noreply@anthropic.com>
Collapse the rewritten "Looking for the old profiler?" alert onto a single
line, matching the inline formatting convention applied to the sibling
profiling alerts in PR review, and drop the stray {" "} artifact.

Co-Authored-By: Claude <noreply@anthropic.com>
Comment thread docs/platforms/android/configuration/options.mdx Outdated

@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.

one thing about the flag deprecation path, but LGTM otherwise!

…based profiling

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@markushi
markushi enabled auto-merge (squash) July 29, 2026 16:39
@markushi
markushi merged commit c7c49a9 into master Jul 29, 2026
22 checks passed
@markushi
markushi deleted the feat/android-profiling-manager branch July 29, 2026 16:40
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