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.

Mis à jour le

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 :

instrument.mjs
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.mjs

En 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 :

checkout.ts
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

Versions de @sentry/node testées contre Errilo
Version majeureVersion 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.

Accès anticipé

Nous ouvrons une bêta privée à l’été 2027 pour quelques équipes qui font tourner Node.js ou TypeScript en production. Inscrivez-vous sur la liste d’attente : nous vous écrirons à l’ouverture.