getsentry/sentry-react-native-sdk

Que fait sentry-react-native-sdk ?

Configuration complète du SDK Sentry pour React Native et Expo. Utilisez cette compétence lorsqu'on vous demande d'« ajouter Sentry à React Native », d'« installer @sentry/react-native », de « configurer Sentry dans Expo » ou de paramétrer la surveillance des erreurs, le tracing, le profilage, le rejeu de session ou la journalisation pour les applications React Native. Prend en charge Expo managed, Expo bare et React Native vanilla.

Installation

Exécutez la commande suivante pour installer le package Sentry :

npx @sentry/wizard -i reactNative

Pour Expo (managed)

Après avoir exécuté le wizard, suivez les instructions supplémentaires pour Expo :

1. Mettez à jour app.json :

{
  "expo": {
    "plugins": [
      "@sentry/react-native/expo"
    ]
  }
}

2. Configurez les variables d'environnement (par exemple, dans un fichier .env ou directement dans app.json) :

SENTRY_DSN=https://[email protected]/0

Configuration

Ouvrez votre fichier d'entrée principal (généralement App.tsx ou App.js) et ajoutez :

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

Sentry.init({
  dsn: 'https://[email protected]/0',
  tracesSampleRate: 1.0, // Ajustez en production
  profilesSampleRate: 1.0, // Pour le profilage
  replaysSessionSampleRate: 0.1, // Rejeu de session (session replay)
  replaysOnErrorSampleRate: 1.0,
  enableNative: true,
  enableAutoPerformanceTracing: true,
});

Surveillance des performances avec des traces

Pour capturer des transactions personnalisées, utilisez Sentry.startTransaction :

const transaction = Sentry.startTransaction({ name: 'example-transaction' });
const span = transaction.startChild({ op: 'task' });
// ... votre code ...
span.finish();
transaction.finish();

Rejeu de session (Session Replay)

Actif par défaut si le taux d'échantillonnage est configuré. Pour l'arrêter, définissez replaysSessionSampleRate à 0.

Utilisation

Cette compétence répond aux demandes suivantes :

• « Ajoute Sentry à mon projet React Native »
• « Installe @sentry/react-native »
• « Configure la surveillance des erreurs avec Sentry dans mon application React Native »
• « Active le tracing des performances dans mon application React Native »
• « Configure le rejeu de session Sentry dans Expo »
• « Mets en place le profilage avec Sentry dans mon application React Native »

Dépannage

• Erreur de compilation native : Assurez-vous que @sentry/react-native est correctement lié. Pour Expo managed, vérifiez que le plugin @sentry/react-native/expo est dans app.json.
• Pas de traces : Vérifiez que tracesSampleRate est supérieur à 0 et que l'option enableAutoPerformanceTracing est activée.
• Rejeu de session non fonctionnel : Confirmez que replaysSessionSampleRate est défini (par exemple, 0.1).

Références

• Documentation Sentry pour React Native : https://docs.sentry.io/platforms/react-native/
• Documentation Sentry pour Expo : https://docs.sentry.io/platforms/react-native/guides/expo/