| title | Experimental Features |
|---|---|
| sidebar_order | 6500 |
| sidebar_section | features |
| description | Learn about the experimental features available for Sentry's Apple SDK. |
Experimental features are features that are still being developed and tested. They may have bugs, incomplete functionality, or may change in future releases. Use them at your own risk and provide feedback to help us improve them.
For stable features, see the Features page.
Profiling features are only available on iOS and macOS.
Enable App Launch Profiling to get detailed profiles for your app launches.
Enable Continuous Profiling to get full coverage of your app's execution.
Enable the enablePersistingTracesWhenCrashing option to link ongoing transactions to a crash event when your app crashes.
Enable the enableUnhandledCPPExceptionsV2 option to capture fatal C++ exceptions using a more reliable mechanism that hooks into all __cxa_throw calls.
options.experimental.enableUnhandledCPPExceptionsV2 = trueoptions.experimental.enableUnhandledCPPExceptionsV2 = YES;This provides more comprehensive and consistent exception handling across your app's runtime, regardless of the number of C++ modules or how they're linked, and helps in obtaining accurate stack traces.
Note: The mechanism of hooking into __cxa_throw could cause issues with symbolication on iOS due to caching of symbol references.
Use Metrics to send counters, gauges, and distributions from your application to Sentry. Once in Sentry, these metrics can be viewed alongside related errors, traces, and logs, and searched using their individual attributes.
The metrics feature is enabled by default, but metrics are not collected automatically. You must manually call the SentrySDK.metrics API to record metrics (e.g., SentrySDK.metrics.count(key: "my_counter", value: 1)). To disable the feature entirely:
options.experimental.enableMetrics = falseoptions.experimental.enableMetrics = NO;Learn more in the Metrics documentation.
Let us know if you have feedback through GitHub issues. Your feedback helps us improve these experimental features and move them toward stable releases.