Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/getsentry/sentry-react-native
Official Sentry SDK for React-Native
https://github.com/getsentry/sentry-react-native
android crash-reporting hacktoberfest ios javascript react-native sdk sentry tag-production typescript
Last synced: 15 days ago
JSON representation
Official Sentry SDK for React-Native
- Host: GitHub
- URL: https://github.com/getsentry/sentry-react-native
- Owner: getsentry
- License: mit
- Created: 2016-11-30T14:45:57.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T10:18:50.000Z (6 months ago)
- Last Synced: 2024-05-22T12:33:48.437Z (6 months ago)
- Topics: android, crash-reporting, hacktoberfest, ios, javascript, react-native, sdk, sentry, tag-production, typescript
- Language: TypeScript
- Homepage: https://sentry.io
- Size: 59.7 MB
- Stars: 1,528
- Watchers: 72
- Forks: 321
- Open Issues: 168
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
_Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us [**Check out our open positions**](https://sentry.io/careers/)_
# Sentry SDK for React Native
[](https://github.com/getsentry/sentry-react-native/actions/workflows/buildandtest.yml)
[](https://www.npmjs.com/package/@sentry/react-native)
[](https://www.npmjs.com/package/@sentry/react-native)
[](https://www.npmjs.com/package/@sentry/react-native)
[](https://discord.gg/PXa5Apfe7K)
[](https://expo.dev/)
## Releases
This repo uses the following ways to release SDK updates:
- `Pre-release`: We create pre-releases (alpha, beta, RC,…) for larger and potentially more impactful changes, such as new features or major versions.
- `Latest`: We continuously release major/minor/hotfix versions from the `main` branch. These releases go through all our internal quality gates and are very safe to use and intended to be the default for most teams.
- `Stable`: We promote releases from `Latest` when they have been used in the field for some time and in scale, considering time since release, adoption, and other quality and stability metrics. These releases will be indicated on [the releases page](https://github.com/getsentry/sentry-react-native/releases/) with the `Stable` suffix.
## Requirements
- `react-native >= 0.65.0`
## Features
- Automatic JS Error Tracking (using [@sentry/browser](https://github.com/getsentry/sentry-javascript))
- Automatic Native Crash Error Tracking (using [sentry-cocoa](https://github.com/getsentry/sentry-cocoa) & [sentry-android](https://github.com/getsentry/sentry-java) under the hood)
- Offline storage of events
- On Device symbolication for JS (in Debug)
- [Autolinking](https://facebook.github.io/react-native/blog/2019/07/03/version-60#native-modules-are-now-autolinked)
- Events with enriched device data
- RAM bundle support
- Hermes support
- [Expo support](https://docs.sentry.io/platforms/react-native/manual-setup/expo/)
- RN New Architecture support
## Installation and Usage
To install the package and setup your project:
```sh
npx @sentry/wizard -s -i reactNative
```
How to use it:
```javascript
import * as Sentry from "@sentry/react-native";
Sentry.init({
dsn: "__DSN__",
// Set tracesSampleRate to 1.0 to capture 100%
// of transactions for performance monitoring.
// We recommend adjusting this value in production
tracesSampleRate: 1.0,
});
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](https://docs.sentry.io/platforms/react-native/#upgrading-from-react-native-sentry) and then follow the [install steps](https://docs.sentry.io/platforms/react-native/#integrating-the-sdk).
## Blog posts
[Introducing Mobile Screenshots and Suspect Commits](https://blog.sentry.io/2022/07/07/introducing-mobile-screenshots-and-suspect-commits).
[Tips for Optimizing React Native Application Performance - Part 2: Using Sentry SDK for Performance Monitoring](https://blog.sentry.io/2022/06/28/tips-for-optimizing-react-native-application-performance-part-2-using-sentry).
[Tips for Optimizing React Native Application Performance: Part 1](https://blog.sentry.io/2022/06/01/tips-for-optimizing-react-native-application-performance-part-1).
[Tracking Stability in a Bluetooth Low Energy-Based React-Native App](https://blog.sentry.io/2022/02/22/tracking-stability-in-a-bluetooth-low-energy-based-react-native-app).
[Mobile Vitals - Four Metrics Every Mobile Developer Should Care About](https://blog.sentry.io/2021/08/23/mobile-vitals-four-metrics-every-mobile-developer-should-care-about/).
[Performance Monitoring Support for React Native](https://blog.sentry.io/2021/03/11/performance-monitoring-support-for-react-native/?utm_source=github&utm_medium=readme&utm_campaign=sentry-react-native).
## Resources
- [](https://docs.sentry.io/platforms/react-native/)
- [](https://github.com/getsentry/sentry-react-native/discussions)
- [](https://discord.gg/PXa5Apfe7K)
- [](http://stackoverflow.com/questions/tagged/sentry)
- [](https://github.com/getsentry/.github/blob/main/CODE_OF_CONDUCT.md)
- [](https://twitter.com/intent/follow?screen_name=getsentry)