Guide Node.js
Suivi des erreurs Node.js
Errilo reçoit les erreurs de vos services Node.js et TypeScript via le SDK officiel @sentry/node : API, workers, scripts. Déjà sur Sentry ? Seul le DSN change.
Errilo est en développement. Ce guide décrit la configuration que notre suite de compatibilité teste aujourd’hui ; la bêta privée ouvre à l’été 2027.
Installation
Initialisez le SDK dans un fichier à part, chargé avant le reste de l’application :
import * as Sentry from "@sentry/node";
Sentry.init({
dsn: process.env.SENTRY_DSN,
});SENTRY_DSN=https://<key>@ingest.errilo.com/<project> node --import ./instrument.mjs server.mjsEn CommonJS, require("./instrument.js") en première ligne du fichier d’entrée fait la même chose.
Remonter une erreur vous-même
Pour une erreur que vous gérez mais que vous voulez quand même voir dans Errilo :
import * as Sentry from "@sentry/node";
try {
await chargeCustomer(order);
} catch (error) {
Sentry.captureException(error); // envoyée à Errilo
throw error;
}Dans un script court ou une fonction serverless, appelez await Sentry.flush() avant la fin du processus, pour que les événements en attente partent.
Des stack traces lisibles
En développement : l’envoi des source maps et les stack traces lisibles seront prêts pour la bêta privée.
sentry-cli ou un plugin de bundler Sentry envoie vos source maps au build. Errilo implémente la même API d’envoi : donnez au plugin l’adresse d’Errilo et un jeton Errilo, et les stack traces pointent vers votre source TypeScript plutôt que vers le code compilé. Voir le guide de migration.
Versions testées
| Version majeure | Version testée |
|---|---|
| v9 | @sentry/node@9.47.2 |
| v10 | @sentry/node@10.78.0 |
| v11 | @sentry/node@11.12.0 |
Notre suite lance chaque version dans son propre processus Node.js, capture une erreur, l’envoie et la vérifie dans Errilo : message, niveau, plateforme et SDK. Express, Fastify et NestJS utilisent aussi @sentry/node ; leurs gestionnaires d’erreurs ne sont pas encore couverts par notre suite.