Node.js

1Installation

npm install @blipit/node

2Zuerst initialisieren

Legen Sie dies in eine Datei, die vor Ihrer App läuft, und importieren Sie sie zuerst.

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

Fügen Sie den Handler nach Ihren Routen hinzu, damit behandelte und unbehandelte Fehler beide Blipit erreichen, mit Methode, URL und User Agent des Requests.

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

4Manuelles Erfassen, Logs und Anmeldeversuche

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

5Prüfen, ob es funktioniert

Öffnen Sie Issues in app.blipit.io. Das erste Event erscheint innerhalb weniger Sekunden, gruppiert zu einem Issue, und die verantwortlichen Personen erhalten eine E-Mail.

Blipit.captureMessage("Hello from Node");

Gut zu wissen

• Bei einer nicht abgefangenen Exception sendet das SDK ausstehende Events und beendet dann mit Code 1; überschreiben Sie das mit onFatal.
• captureConsole: true macht aus console.log und Co. Log-Zeilen, die an die Logs-Seite gesendet werden.
• Bereits auf @sentry/node? Es funktioniert unverändert mit dem DSN https://<public key>@in.blipit.io/<project id>.