Skip to content

Document that app start profiling is legacy-profiler only - #262

Open
sdzhong wants to merge 1 commit into
mainfrom
docs/profiling-app-start-limitation
Open

Document that app start profiling is legacy-profiler only#262
sdzhong wants to merge 1 commit into
mainfrom
docs/profiling-app-start-limitation

Conversation

@sdzhong

@sdzhong sdzhong commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator

Why

While pinning the empower TDA Android emulator to Android 15 (sentry-demos/empower), I hit the profiling limitations for API level 35+:

App start profiling is not supported. The startProfilerOnAppStart option has no effect with the ProfilingManager (Perfetto) backend. App start profiling is only supported by the legacy profiler used on devices below Android 15.

This manifest sets io.sentry.traces.profiling.start-on-app-start to true, which reads as "app start profiling is on" — but on API 35+ it does nothing. Anyone demoing on a modern device and not seeing an app start profile has no way to tell that from the manifest.

What

Comment only — no behavior change. The meta-data stays enabled: minSdkVersion is 21, so the app still runs on plenty of devices below API 35 where the legacy profiler honors it. Removing it would have silently dropped app start profiling on exactly those devices.

Related

setup_profiling_device.sh (#253) already covers the other API 35+ limitation — the framework rate limiter. This documents the remaining one in the place people actually read.

🤖 Generated with Claude Code

On Android 15 (API level 35) and higher the SDK uses the platform
ProfilingManager (Perfetto) backend, where startProfilerOnAppStart has no
effect. The meta-data stays enabled since minSdkVersion is 21 and it still
applies below API 35, but reading the manifest gave no hint that it is inert
on newer devices.

Ref: https://docs.sentry.io/platforms/android/profiling/#limitations

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@sentry

sentry Bot commented Aug 19, 2026

Copy link
Copy Markdown

📲 Install Builds

Android

🔗 App Name App ID Version Configuration
Android com.example.vu.android 24.12.26 (241226) release
Android com.example.vu.android 24.12.26 (241226) debug
Android com.example.vu.android 24.12.26 (241226) release

⚙️ android Build Distribution Settings

@codecov

codecov Bot commented Aug 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 0.00%. Comparing base (21c77a4) to head (e66619b).

Additional details and impacted files
@@          Coverage Diff          @@
##            main    #262   +/-   ##
=====================================
  Coverage   0.00%   0.00%           
=====================================
  Files         16      16           
  Lines        883     883           
  Branches      67      67           
=====================================
  Misses       883     883           

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

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

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.

1 participant