Skip to content

docs(android): Explain when ProfilingManager rejects profiling requests - #20129

Merged
markushi merged 3 commits into
masterfrom
docs/android-profilingmanager-rate-limits
Oct 29, 2026
Merged

markushi merged 3 commits into
masterfrom
docs/android-profilingmanager-rate-limits

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

On Android 15+, UI Profiling runs on Android's ProfilingManager. Until now the docs only said requests are "rate limited and not guaranteed". This adds a When Android Rejects Profiling Requests section to the Android profiling page that covers:

  • How the SDK uses ProfilingManager: each chunk of up to 60s is a separate request, and trace mode sends a new request each time it restarts.
  • Why Android rejects requests: the per-app hourly/daily/weekly budget (ERROR_FAILED_RATE_LIMIT_PROCESS), the system-wide budget shared by all apps (ERROR_FAILED_RATE_LIMIT_SYSTEM), and a profiling session that's already running (ERROR_FAILED_PROFILING_IN_PROGRESS).
  • Why the app start and first screens get profiled more often than parts of the app users reach later in a session.
  • How to use the manual lifecycle (Sentry.startProfiler() / Sentry.stopProfiler()) to spend the limited budget on specific flows.

I also moved the existing local-testing adb tip into this section and added a troubleshooting entry that points to it.

The behavior matches PerfettoContinuousProfiler / PerfettoProfiler in sentry-java (60s MAX_CHUNK_DURATION_MILLIS, rate-limit error logging) and Android's profiling limitations page.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • 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

via markus.hintersteiner.

--

View Junior Session [Sentry]

@vercel

vercel Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 29, 2026 4:11pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 29, 2026 4:11pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 21, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team October 21, 2026 11:42
@markushi
markushi marked this pull request as ready for review October 21, 2026 11:53
@cursor

cursor Bot commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Services awaiting deployment · Rollout details

Status Service Environment
⚪ Not deployed yet sentry-docs

Mention @rollout in a comment to update the plan.

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

one nit, LGTM otherwise!

@codeowner-assignment
codeowner-assignment Bot requested review from a team, 0xadam-brown and runningcode and removed request for a team October 29, 2026 16:05
@markushi
markushi enabled auto-merge (squash) October 29, 2026 16:09
@markushi
markushi merged commit bc48e9b into master Oct 29, 2026
27 checks passed
@markushi
markushi deleted the docs/android-profilingmanager-rate-limits branch October 29, 2026 16:14
@cursor

cursor Bot commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Rollouts can't watch this change after it deploys: every data source for this team needs to be signed in again, so a check has no telemetry to read. Sign in to your data sources, or ask a team admin to.

This branch was successfully deployed

2 active (1 outdated) deployments
Preview – sentry-docs — 80dc0987 Deployed Oct 29, 2026 by vercel[bot]
Preview – develop-docs — 0f62341f Deployed Oct 28, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants