Intégration Sentry
Directives pour l'utilisation de Sentry pour la surveillance des erreurs et le traçage des performances.
Capture des exceptions
Utilisez Sentry.captureException(error) dans les blocs try/catch :
try {
await riskyOperation();
} catch (error) {
Sentry.captureException(error);
throw error;
}
Traçage des performances
Créez des spans pour les actions significatives comme les clics sur les boutons, les appels API et les appels de fonction.
Actions UI
function handleClick() {
Sentry.startSpan(
{ op: "ui.click", name: "Soumettre le formulaire" },
(span) => {
span.setAttribute("formId", formId);
submitForm();
}
);
}
Appels API
async function fetchData(id) {
return Sentry.startSpan(
{ op: "http.client", name: `GET /api/items/${id}` },
async () => {
const response = await fetch(`/api/items/${id}`);
return response.json();
}
);
}
Configuration (Next.js)
Fichiers d'initialisation Sentry :
sentry.client.config.ts- Côté clientsentry.server.config.ts- Côté serveursentry.edge.config.ts- Runtime Edge
Importez avec import * as Sentry from "@sentry/nextjs" - pas besoin d'initialiser dans d'autres fichiers.
Configuration de base
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
enableLogs: true,
});
Avec journalisation console
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
integrations: [
Sentry.consoleLoggingIntegration({ levels: ["log", "warn", "error"] }),
],
});
Journalisation structurée
Utilisez logger.fmt pour les littéraux de modèle avec variables :
const { logger } = Sentry;
logger.trace("Démarrage de la connexion", { database: "users" });
logger.debug(logger.fmt`Cache manquant pour : ${userId}`);
logger.info("Profil mis à jour", { profileId: 345 });
logger.warn("Limite de débit atteinte", { endpoint: "/api/data" });
logger.error("Échec du paiement", { orderId: "order_123" });
logger.fatal("Pool de connexions épuisé", { activeConnections: 100 });