Skip to content

React Native UI profiling docs: now with information about iOS profiling #16260

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alwx merged 5 commits into from
Feb 5, 2026
Merged

React Native UI profiling docs: now with information about iOS profiling #16260

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0396188
UI profiling docs
alwx Feb 4, 2026
b2e3df3
Wording fix
alwx Feb 4, 2026
e3645c5
Merge branch 'master' into alwx/docs/ui-profiling
alwx Feb 5, 2026
2c0457f
Note -> Alert
alwx Feb 5, 2026
3df72d3
Merge branch 'master' into alwx/docs/ui-profiling
alwx Feb 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 16 additions & 7 deletions docs/platforms/react-native/profiling/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,29 +67,38 @@ Sentry.init({

Default value `true`, platform profilers are enabled. By default both React Native JS code executed in Hermes engine and platform specific code (Swift, Objective-C, Kotlin, Java) are profiled by their respective profilers. Setting `platformProfilers` to `false` will disable profiling of the platform specific code and only the JS code executed in Hermes will be profiled. This option is available since the SDK version [5.33.0](https://github.com/getsentry/sentry-react-native/releases/tag/5.33.0).

## Android UI Profiling (experimental)
## UI Profiling (experimental)

<Alert>

Profiling for React Native is available in SDK versions `7.9.0` and above. Android is currently the only supported platform, and support is still experimental.
UI Profiling for React Native is available in SDK versions `7.9.0` and above on Android. iOS support was added in `7.12.0`. This feature is still experimental.

</Alert>

```javascript
import * as Sentry from '@sentry/react-native';
import * as Sentry from "@sentry/react-native";

Sentry.init({
dsn: 'YOUR_DSN',
dsn: "YOUR_DSN",
tracesSampleRate: 1.0, // Required for trace mode

_experiments: {
androidProfilingOptions: {
profilingOptions: {
profileSessionSampleRate: 1.0,
lifecycle: 'trace',
lifecycle: "trace",
startOnAppStart: true,
},
},
});
```

For more information, see [the Android SDK documentation](https://docs.sentry.io/platforms/android/profiling/#enabling-ui-profiling)
<Alert>

The `androidProfilingOptions` key is now deprecated. Use `profilingOptions` instead.

</Alert>

For more information, see the platform-specific documentation:

- [Android SDK documentation](https://docs.sentry.io/platforms/android/profiling/#enabling-ui-profiling)
- [iOS SDK documentation](https://docs.sentry.io/platforms/apple/guides/ios/profiling/#enable-ui-profiling)