Que fait Intégrateur de Suivi d'Erreurs ?
Intègre des services de suivi d'erreurs dans les applications pour un meilleur débogage et une surveillance en production.
Quand l'utiliser
- L'utilisateur demande une surveillance ou un suivi des erreurs
- Configuration de la journalisation des erreurs en production
- L'utilisateur mentionne "Sentry", "suivi d'erreurs", "rapport de crash" ou "débogage en production"
Instructions
1. Détecter le Framework
Identifier le framework de l'application :
- React, Vue, Angular (frontend)
- Express, Fastify (backend Node.js)
- Django, Flask (Python)
- Rails (Ruby)
2. Choisir le Service de Suivi d'Erreurs
Services populaires :
- Sentry : Le plus populaire, complet
- Rollbar : Bon pour le backend
- Bugsnag : Multi-plateforme
- Airbrake : Spécialisé Ruby
- LogRocket : Relecture de session + erreurs
3. Installer et Configurer
Sentry (exemple React) :
npm install @sentry/react
import * as Sentry from "@sentry/react";
Sentry.init({
dsn: process.env.REACT_APP_SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
integrations: [
new Sentry.BrowserTracing(),
new Sentry.Replay()
],
});
Sentry (Node.js/Express) :
const Sentry = require("@sentry/node");
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
});
// Gestionnaire de requêtes (premier middleware)
app.use(Sentry.Handlers.requestHandler());
// Gestionnaire d'erreurs (après toutes les routes, avant le middleware d'erreur)
app.use(Sentry.Handlers.errorHandler());
4. Ajouter des Limites d'Erreurs (React)
import { ErrorBoundary } from '@sentry/react';
function App() {
return (
<ErrorBoundary fallback={<ErrorFallback />}>
<YourApp />
</ErrorBoundary>
);
}
5. Ajouter du Contexte
Contexte utilisateur :
Sentry.setUser({
id: user.id,
email: user.email,
username: user.username
});
Étiquettes :
Sentry.setTag("page_locale", "en-US");
Sentry.setTag("feature_flag", "new_ui");
Contexte :
Sentry.setContext("order", {
id: order.id,
total: order.total,
items: order.items.length
});
6. Miettes de Navigation
Suivre les actions utilisateur menant à l'erreur :
Sentry.addBreadcrumb({
category: "auth",
message: "Utilisateur connecté",
level: "info"
});
Sentry.addBreadcrumb({
category: "ui",
message: "Bouton cliqué",
data: { buttonId: "submit-form" }
});
7. Capture Manuelle d'Erreurs
try {
riskyOperation();
} catch (error) {
Sentry.captureException(error, {
tags: { section: "payment" },
level: "error",
extra: { orderId: order.id }
});
}
8. Filtrer les Données Sensibles
Nettoyer les PII :
Sentry.init({
beforeSend(event, hint) {
// Ne pas envoyer si contient des données sensibles
if (event.request?.data?.password) {
delete event.request.data.password;
}
return event;
},
ignoreErrors: [
// Ignorer les erreurs d'extensions navigateur
/extensions\//i,
/^Rejet de promesse non-erreur/,
]
});
9. Cartes Source (Production)
Activer les cartes source pour des traces de pile lisibles :
Webpack :
// webpack.config.js
module.exports = {
devtool: 'source-map',
plugins: [
new SentryWebpackPlugin({
org: "votre-org",
project: "votre-projet",
authToken: process.env.SENTRY_AUTH_TOKEN,
include: "./dist",
}),
],
};
10. Configuration des Alertes
Configurer des alertes pour :
- Nouveaux problèmes
- Régression (un problème résolu se reproduit)
- Pic du taux d'erreurs
- Erreurs critiques (paiement, échecs d'authentification)
11. Surveillance des Performances
Ajouter le suivi des transactions :
const transaction = Sentry.startTransaction({
name: "processOrder",
op: "task"
});
try {
await processOrder();
} finally {
transaction.finish();
}
12. Bonnes Pratiques
- Séparation des environnements : Projets différents pour dev/staging/prod
- Suivi des versions : Étiqueter les erreurs avec la version de publication
- Taux d'échantillonnage : 100% des erreurs, % plus faible pour les performances
- Notifications d'équipe : Intégration Slack/email
- Attribution des problèmes : Attribution automatique aux propriétaires de code
- Regroupement d'erreurs : Empreinte digitale personnalisée pour un meilleur regroupement
- Ne pas journaliser les données sensibles : PII, mots de passe, jetons
Fichiers d'Assistance
templates/sentry-react.js: Modèle d'intégration Reacttemplates/sentry-node.js: Modèle d'intégration Node.jstemplates/sentry-python.py: Modèle d'intégration Python