Node.js

1Installation

npm install @blipit/node

2Initialiser en premier

Placez ceci dans un fichier qui s'exécute avant votre application, et importez-le en premier.

import * as Blipit from "@blipit/node";

Blipit.init({
  key: process.env.BLIPIT_SECRET_KEY,
  environment: process.env.NODE_ENV,
  release: process.env.RELEASE,
  serverName: "api",
});

3Express ou Fastify

Ajoutez le handler après vos routes pour que les erreurs gérées et non gérées atteignent toutes Blipit, avec la méthode, l'URL et le user agent de la requête.

import "./instrument.mjs";
import * as Blipit from "@blipit/node";
import express from "express";

const app = express();
app.get("/", (req, res) => res.send("ok"));
app.use(Blipit.expressErrorHandler());
app.listen(3000);

await app.register(Blipit.fastifyPlugin());

4Capture manuelle, logs et tentatives de connexion

Blipit.captureException(err);
Blipit.captureMessage("cache miss rate above 50%", "warning");
Blipit.setUser({ id: "user-42" });
Blipit.log.info("order placed", { order_id: 42 });
Blipit.captureSecurity({ kind: "login_failed", actor: email, ip, userAgent, outcome: "bad_password" });
await Blipit.flush();

5Vérifier que ça fonctionne

Ouvrez Problèmes dans app.blipit.io. Le premier événement apparaît en quelques secondes, regroupé en un problème, et les responsables reçoivent un e-mail.

Blipit.captureMessage("Hello from Node");

Bon à savoir

• Sur une exception non interceptée, le SDK vide les événements en attente puis quitte avec le code 1 ; remplacez ce comportement avec onFatal.
• captureConsole: true transforme console.log et consorts en lignes de log envoyées à la page Logs.
• Déjà sur @sentry/node ? Il fonctionne sans modification avec le DSN https://<public key>@in.blipit.io/<project id>.