Was macht Sentry-Integration?
Richtlinien zur Nutzung von Sentry für Fehlerüberwachung und Performance-Tracing.
Ausnahmen abfangen
Verwenden Sie Sentry.captureException(error) in try/catch-Blöcken:
try {
await riskyOperation();
} catch (error) {
Sentry.captureException(error);
throw error;
}
Performance-Tracing
Erstellen Sie Spans für sinnvolle Aktionen wie Button-Klicks, API-Aufrufe und Funktionsaufrufe.
UI-Aktionen
function handleClick() {
Sentry.startSpan(
{ op: "ui.click", name: "Formular absenden" },
(span) => {
span.setAttribute("formId", formId);
submitForm();
}
);
}
API-Aufrufe
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();
}
);
}
Konfiguration (Next.js)
Sentry-Initialisierungsdateien:
sentry.client.config.ts- Clientseitigsentry.server.config.ts- Serverseitigsentry.edge.config.ts- Edge-Runtime
Importieren Sie mit import * as Sentry from "@sentry/nextjs" - keine Initialisierung in anderen Dateien erforderlich.
Grundlegende Einrichtung
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
enableLogs: true,
});
Mit Konsolenprotokollierung
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
integrations: [
Sentry.consoleLoggingIntegration({ levels: ["log", "warn", "error"] }),
],
});
Strukturiertes Logging
Verwenden Sie logger.fmt für Template-Literale mit Variablen:
const { logger } = Sentry;
logger.trace("Verbindung wird hergestellt", { database: "users" });
logger.debug(logger.fmt`Cache-Fehler für: ${userId}`);
logger.info("Profil aktualisiert", { profileId: 345 });
logger.warn("Ratenlimit erreicht", { endpoint: "/api/data" });
logger.error("Zahlung fehlgeschlagen", { orderId: "order_123" });
logger.fatal("Verbindungspool erschöpft", { activeConnections: 100 });