@sentry/react-native

What is @sentry/react-native?

@sentry/react-native is a comprehensive error tracking and performance monitoring tool for React Native applications. It helps developers capture and report errors, monitor application performance, and gain insights into issues affecting their apps.

What are @sentry/react-native's main functionalities?

Error Tracking

This feature allows you to capture and report errors in your React Native application. The code sample initializes Sentry with a DSN and captures an exception.

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

Sentry.init({
  dsn: 'https://[e-mail]/0',
});

try {
  throw new Error('Test error');
} catch (error) {
  Sentry.captureException(error);
}

Performance Monitoring

This feature allows you to monitor the performance of your application. The code sample initializes Sentry with a DSN and a traces sample rate, then starts and finishes a transaction.

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

Sentry.init({
  dsn: 'https://[e-mail]/0',
  tracesSampleRate: 1.0,
});

const transaction = Sentry.startTransaction({
  name: 'test-transaction',
});

setTimeout(() => {
  transaction.finish();
}, 2000);

Breadcrumbs

Breadcrumbs are used to record events that lead up to an error. The code sample initializes Sentry and adds a breadcrumb for a user login event.

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

Sentry.init({
  dsn: 'https://[e-mail]/0',
});

Sentry.addBreadcrumb({
  category: 'auth',
  message: 'User logged in',
  level: Sentry.Severity.Info,
});

User Feedback

This feature allows users to provide feedback when an error occurs. The code sample initializes Sentry and shows a report dialog for user feedback.

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

Sentry.init({
  dsn: 'https://[e-mail]/0',
});

Sentry.showReportDialog({
  title: 'Feedback',
  subtitle: 'Please describe what you were doing when the error occurred.',
  labelName: 'Name',
  labelEmail: 'Email',
  labelComments: 'Comments',
  labelSubmit: 'Submit',
  successMessage: 'Thank you for your feedback!',
});

Other packages similar to @sentry/react-native

bugsnag-react-native

Bugsnag provides error monitoring and crash reporting for React Native applications. It offers similar functionalities to Sentry, such as error tracking, performance monitoring, and user feedback. Bugsnag is known for its user-friendly interface and detailed error reports.

instabug-reactnative

Instabug provides comprehensive bug and crash reporting for React Native applications. It offers similar functionalities to Sentry, including error tracking, performance monitoring, and user feedback. Instabug is known for its in-app feedback and bug reporting capabilities, which allow users to report issues directly from the app.

README

Sentry SDK for React Native

Requirements

• react-native >= 0.56.0

Features

• Automatic JS Error Tracking (using @sentry/browser)
• Automatic Native Crash Error Tracking (using sentry-cocoa & sentry-android under the hood)
• Offline storage of events
• On Device symbolication for JS (in Debug)
• Autolinking
• Events with enriched device data
• RAM bundle support
• Hermes support
• Expo support (sentry-expo)

Installation and Usage

To install the package:

npm install --save @sentry/react-native
# OR
yarn add @sentry/react-native

If you are using a version of React Native <= 0.60.x link the package using react-native.

react-native link @sentry/react-native
# OR, if self hosting
SENTRY_WIZARD_URL=http://sentry.acme.com/ react-native link @sentry/react-native

How to use it:

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

Sentry.init({
  dsn: "__DSN__"
});

Sentry.setTag("myTag", "tag-value");
Sentry.setExtra("myExtra", "extra-value");
Sentry.addBreadcrumb({ message: "test" });

Sentry.captureMessage("Hello Sentry!");

Upgrade

If you are coming from react-native-sentry which was our SDK < 1.0 you should follow the upgrade guide and then follow the install steps.

Resources

• 
• 
• 
• 
• 
• 

Changelog

1.5.0

• feat: Track touch events as breadcrumbs #939
• fix: Serialize the default user keys in setUser #926
• Bump android 2.2.0 #942
• fix(android): Fix unmapped context keys being overwritten on Android.