Zum Hauptinhalt springen
Standard-Instrumentierungen können über die Konfigurationsoption disableDefaultInstrumentations deaktiviert werden. Mehr darüber, wie Sie dies konfigurieren, erfahren Sie in unserer Dokumentation zu Konfigurationsoptionen.
Die Integration von AppSignal für Node.js für Express.

Installation

Express wird vom Paket AppSignal für Node.js automatisch instrumentiert. Damit Fehler, die in Ihrer Express-Anwendung auftreten, an AppSignal weitergeleitet werden, folgen Sie den nachstehenden Anweisungen zur Einrichtung der Error-Handler-Middleware.

Error Handler

Das Modul enthält eine Middleware, die alle Fehler, die in Ihrer Express-Anwendung auftreten, an AppSignal sendet.
import { expressErrorHandler } from "@appsignal/nodejs";
// or: const { expressErrorHandler } = require("@appsignal/nodejs");

const app = express();

// add this after all routes, but before any other error handlers
app.use(expressErrorHandler());
Nur Ausnahmen mit Statuscode 500 und höher werden automatisch an AppSignal gemeldet. Um Ausnahmen mit anderen Statuscodes an AppSignal zu senden, können Sie die benutzerdefinierte Ausnahmebehandlung verwenden.

Funktionen

Die Express-Integration sendet AppSignal einen Child-Span, der die Ausführungszeit jeder Middleware darstellt, sowie einen Child-Span für den Request-Handler. Die Integration verwendet die Request-Route als Namen der Aktion. Query-Parameter der Anfrage werden gesendet. Der Request-Body wird gesendet, wenn req.body vorhanden ist (zum Beispiel bei Verwendung einer Body-Parsing-Middleware wie body-parser). Die Request-Cookies werden gesendet, wenn req.cookies vorhanden ist (zum Beispiel bei Verwendung einer Cookie-Parsing-Middleware wie cookie-parser). Bei Verwendung der Error-Handler-Middleware werden alle Fehler, die vom Request-Handler oder einer der Middlewares ausgelöst werden, an AppSignal gemeldet.