Upgrading from 6.x to 7.0
Version 7 of the Sentry React Native SDK primarily introduces API cleanup and version support changes based on the Sentry Javascript SDK version 9. This update contains behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling.
Version 7 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v6). Lower versions may continue to work, but may not support all features.
Major Changes
- Set
{{auto}}ifuser.ip_addressisundefinedandsendDefaultPii: true(#4466) Sentry.captureUserFeedbackremoved, useSentry.captureFeedbackinstead (#4855)
Major Changes from Sentry JS SDK v9
- Exceptions from
captureConsoleIntegrationare now marked as handled: true by default shutdownTimeoutmoved fromcoreto@sentry/react-nativehasTracingEnabledwas renamed tohasSpansEnabled- You can no longer drop spans or return null on
beforeSendSpanhook - Fork
scopeif custom scope is passed tostartSpanManualorstartSpan
Removed types
- TransactionNamingScheme
- Request
- Scope (prefer using the Scope class)
Other removed items.
autoSessionTrackingfrom options.
To enable session tracking, ensure thatenableAutoSessionTrackingis enabled.enableTracing. Instead, settracesSampleRateto a value greater thanzerotoenable tracing,0to keep tracing integrations active without sampling, orundefinedto disable the performance integration.getCurrentHub(),Hub, andgetCurrentHubShim()spanIdfrom propagationcontext- metrics API
transactionContextfromsamplingContext@sentry/utilspackage, the exports were moved to@sentry/core- Standalone
Clientinterface & deprecateBaseClient
Features
- Add experimental support for Log tracing (#4827)
To enable it add the following code to your Sentry Options:
Sentry.init({
// other options...
_experiments: {
enableLogs: true,
},
});You can also filter the logs being collected by adding beforeSendLogs into _experiments
Sentry.init({
// other options...
_experiments: {
enableLogs: true,
beforeSendLog: (log) => {
return log;
},
}
});Changes
- Expose
loggerandconsoleLoggingIntegration(#4930) - Remove deprecated
appOwnershipconstant use in Expo Go detection (#4893) - Disable AppStart and NativeFrames in unsupported environments (web, Expo Go) (#4897)
Self Hosted
- It is recommended to use Sentry Self Hosted version
25.2.0or new for React Native V7 or newer