Fehlerverfolgungs-Integrator
Integriert Fehlerverfolgungsdienste in Anwendungen für besseres Produktionsdebugging und -überwachung.
Wann verwenden
- Benutzer fordert Fehlerüberwachung oder -verfolgung an
- Einrichtung der Produktionsfehlerprotokollierung
- Benutzer erwähnt "Sentry", "Fehlerverfolgung", "Absturzberichte" oder "Produktionsdebugging"
Anleitung
1. Framework erkennen
Identifiziere das Anwendungsframework:
- React, Vue, Angular (Frontend)
- Express, Fastify (Node.js Backend)
- Django, Flask (Python)
- Rails (Ruby)
2. Fehlerverfolgungsdienst auswählen
Beliebte Dienste:
- Sentry: Am beliebtesten, umfassend
- Rollbar: Gut für Backend
- Bugsnag: Multi-Plattform
- Airbrake: Ruby-fokussiert
- LogRocket: Sitzungswiedergabe + Fehler
3. Installieren und Konfigurieren
Sentry (React-Beispiel):
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,
});
// Request-Handler (erste Middleware)
app.use(Sentry.Handlers.requestHandler());
// Fehler-Handler (nach allen Routen, vor der Fehler-Middleware)
app.use(Sentry.Handlers.errorHandler());
4. Fehlergrenzen hinzufügen (React)
import { ErrorBoundary } from '@sentry/react';
function App() {
return (
<ErrorBoundary fallback={<ErrorFallback />}>
<YourApp />
</ErrorBoundary>
);
}
5. Kontext hinzufügen
Benutzerkontext:
Sentry.setUser({
id: user.id,
email: user.email,
username: user.username
});
Tags:
Sentry.setTag("page_locale", "en-US");
Sentry.setTag("feature_flag", "new_ui");
Kontext:
Sentry.setContext("order", {
id: order.id,
total: order.total,
items: order.items.length
});
6. Breadcrumbs
Verfolge Benutzeraktionen, die zum Fehler führen:
Sentry.addBreadcrumb({
category: "auth",
message: "Benutzer angemeldet",
level: "info"
});
Sentry.addBreadcrumb({
category: "ui",
message: "Schaltfläche geklickt",
data: { buttonId: "submit-form" }
});
7. Manuelle Fehlererfassung
try {
riskyOperation();
} catch (error) {
Sentry.captureException(error, {
tags: { section: "payment" },
level: "error",
extra: { orderId: order.id }
});
}
8. Sensible Daten filtern
PII schwärzen:
Sentry.init({
beforeSend(event, hint) {
// Nicht senden, wenn sensible Daten enthalten
if (event.request?.data?.password) {
delete event.request.data.password;
}
return event;
},
ignoreErrors: [
// Browser-Erweiterungsfehler ignorieren
/extensions\//i,
/^Non-Error promise rejection/,
]
});
9. Quellkarten (Produktion)
Aktiviere Quellkarten für lesbare Stacktraces:
Webpack:
// webpack.config.js
module.exports = {
devtool: 'source-map',
plugins: [
new SentryWebpackPlugin({
org: "your-org",
project: "your-project",
authToken: process.env.SENTRY_AUTH_TOKEN,
include: "./dist",
}),
],
};
10. Alarmkonfiguration
Richte Alarme ein für:
- Neue Probleme
- Regression (ein gelöstes Problem tritt erneut auf)
- Anstieg der Fehlerrate
- Kritische Fehler (Zahlungs-, Authentifizierungsfehler)
11. Leistungsüberwachung
Transaktionsverfolgung hinzufügen:
const transaction = Sentry.startTransaction({
name: "processOrder",
op: "task"
});
try {
await processOrder();
} finally {
transaction.finish();
}
12. Best Practices
- Umgebungstrennung: Unterschiedliche Projekte für Entwicklung/Staging/Produktion
- Release-Tracking: Fehler mit Release-Version markieren
- Sample-Raten: 100% für Fehler, niedrigere Raten für Leistung
- Team-Benachrichtigungen: Slack/E-Mail-Integration
- Problemzuweisung: Automatische Zuweisung zu Code-Eigentümern
- Fehlergruppierung: Benutzerdefinierte Fingerabdrücke für bessere Gruppierung
- Keine sensiblen Daten protokollieren: PII, Passwörter, Token
Unterstützende Dateien
templates/sentry-react.js: React-Integrationsvorlagetemplates/sentry-node.js: Node.js-Integrationsvorlagetemplates/sentry-python.py: Python-Integrationsvorlage