Node.js

1Installazione

npm install @blipit/node

2Inizializza per primo

Mettilo in un file che viene eseguito prima della tua app, e importalo per primo.

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 o Fastify

Aggiungi l'handler dopo le tue route così sia gli errori gestiti che quelli non gestiti raggiungono Blipit, con metodo, URL e user agent della richiesta.

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());

4Cattura manuale, log e tentativi di accesso

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();

5Verifica che funzioni

Apri Issue in app.blipit.io. Il primo evento compare entro pochi secondi, raggruppato in una issue, e i responsabili ricevono un'email.

Blipit.captureMessage("Hello from Node");

Buono a sapersi

• In caso di eccezione non catturata l'SDK invia gli eventi in sospeso, poi esce con codice 1; puoi sovrascriverlo con onFatal.
• captureConsole: true trasforma console.log e simili in righe di log inviate alla pagina Log.
• Sei già su @sentry/node? Funziona senza modifiche con il DSN https://<public key>@in.blipit.io/<project id>.