7.0.0
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 versions 9 and 10. 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 25.2.0 or higher (up from 24.4.2 for v6). Lower versions may continue to work, but may not support all features.
See our migration docs for more information.
Major Changes
-
Ensure IP address is only inferred by Relay if
sendDefaultPiiistrue(#5111) -
Set
{{auto}}ifuser.ip_addressisundefinedandsendDefaultPii: true(#4466) -
Sentry.captureUserFeedbackremoved, useSentry.captureFeedbackinstead (#4855) -
Exceptions from
captureConsoleIntegrationare now marked as handled: true by default -
shutdownTimeoutmoved fromcoreto@sentry/react-native -
hasTracingEnabledwas renamed tohasSpansEnabled -
You can no longer drop spans or return null on
beforeSendSpanhook -
Tags formatting logic updated (#4965)
Here are the altered/unaltered types, make sure to update your UI filters and alerts.Unaltered: string, null, number, and undefined values remain unchanged.
Altered: Boolean values are now capitalized: true -> True, false -> False.
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
Changes
- Expose
featureFlagsIntegration(#4984) - Expose
loggerandconsoleLoggingIntegration(#4930) - Remove deprecated
appOwnershipconstant use in Expo Go detection (#4893) - Disable AppStart and NativeFrames in unsupported environments (web, Expo Go) (#4897)
- Use
Replayinterface forbrowserReplayIntegrationreturn type (#4858) - Allow using
browserReplayIntegrationwithoutisWebguard (#4858)- The integration returns noop in non-browser environments
- Use single
encodeUTF8implementation through the SDK (#4885) - Use global
TextEncoder(available with Hermes in React Native 0.74 or higher) to improve envelope encoding performance. (#4874) breadcrumbsIntegrationdisables React Native incompatible options automatically (#4886)- Fork
scopeif custom scope is passed tostartSpanManualorstartSpan - On React Native Web,
browserSessionIntegrationis added whenenableAutoSessionTrackingis set toTrue(#4732) - Change
Cold/Warm App Startspan description toCold/Warm Start(#4636)
Features
To enable it add the following code to your Sentry Options:
Sentry.init({
enableLogs: true,
});You can also filter the logs being collected by adding beforeSendLogs
Sentry.init({
enableLogs: true,
beforeSendLog: log => {
return log;
},
});- Automatically detect Release name and version for Expo Web (#4967)
Fixes
- Align span description with other platforms (#4636) by @krystofwoldrich
- Tags with symbol are now logged (#4965)
- IgnoreError now filters Native errors (#4948)
You can use strings to filter errors or RegEx for filtering with a pattern.
example:
ignoreErrors: [
'1234', // Will filter any error message that contains 1234.
'.*1234', // Will not filter as regex, instead will filter messages that contains '.*1234"
/.*1234/, // Regex will filter any error message that ends with 1234
/.*1234.*/ // Regex will filter any error message that contains 1234.
]- Expo Updates Context is passed to native after native init to be available for crashes (#4808)
- Expo Updates Context values should all be lowercase (#4809)
- Avoid duplicate network requests (fetch, xhr) by default (#4816)
traceFetchis disabled by default on mobile as RN uses a polyfill which will be traced bytraceXHR