Passer au contenu principal
Les instrumentations par défaut peuvent être désactivées via l’option de configuration disableDefaultInstrumentations. Vous pouvez en savoir plus sur la façon de la configurer dans notre documentation des options de configuration.
L’intégration AppSignal pour Node.js pour Express.

Installation

Express est instrumenté automatiquement par le package AppSignal pour Node.js. Afin que les erreurs survenant dans votre application Express soient transmises à AppSignal, suivez les instructions ci-dessous pour configurer le middleware de gestion des erreurs.

Gestionnaire d’erreurs

Le module contient un middleware pour envoyer toutes les erreurs qui se produisent dans votre application Express à AppSignal.
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());
Seules les exceptions avec un code de statut 500 et supérieur seront signalées automatiquement à AppSignal. Pour envoyer à AppSignal des exceptions avec d’autres codes de statut, vous pouvez utiliser la gestion personnalisée des exceptions.

Fonctionnalités

L’intégration Express enverra à AppSignal un span enfant représentant le temps d’exécution de chaque middleware, ainsi qu’un span enfant pour le gestionnaire de requêtes. L’intégration utilisera la route de la requête comme nom de l’action. Les paramètres de requête (query) seront envoyés. Le corps de la requête sera envoyé si req.body est présent (par exemple, lorsqu’un middleware d’analyse de corps tel que body-parser est utilisé). Les cookies de la requête seront envoyés si req.cookies est présent (par exemple, lorsqu’un middleware d’analyse de cookies tel que cookie-parser est utilisé). Lors de l’utilisation du middleware de gestion d’erreurs, toutes les erreurs levées par le gestionnaire de requêtes ou par l’un des middlewares seront signalées à AppSignal.