Node.js

Installeren npm install @blipit/node

@blipit/node vangt uit zichzelf uncaught exceptions en unhandled promise rejections, voegt handlers toe voor Express en Fastify, en verstuurt logs en inlogpogingen met dezelfde sleutel. Gebruik de geheime sleutel; die blijft op de server. Vanaf 0.3 is er ook installatie in één regel voor Koa, Hono en NestJS, en een wrapper voor handlers in AWS Lambda-stijl.

Plak hem in Claude Code, Cursor of een andere AI-codeerassistent. Hij bevat de stappen en de code. In app.blipit.io, onder API-sleutels, staat dezelfde prompt met je sleutel al ingevuld.
Video: Blipit installeren in elke stack, vanaf 1:07

1Installeren

sh
npm install @blipit/node

2Haal je sleutels op

Log in op app.blipit.io en open API-sleutels in de zijbalk, en dan je project. Elk project heeft twee sleutels. De publieke sleutel begint met blipit_pk_: hij gaat in browser- en appcode, kan alleen events insturen en mag door iedereen gezien worden. De geheime sleutel begint met blipit_sk_: hij blijft op je server of in Odoo, nooit in een browser, omdat hij ook issues kan lezen en wijzigen. De geheime sleutel wordt maar één keer getoond, direct na het aanmaken, dus kopieer hem dan; raak je hem kwijt, druk dan op Nieuwe geheime sleutel aanmaken, en de oude werkt meteen niet meer. Sommige SDK's hebben ook het project-id nodig, dat op dezelfde pagina staat.

API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.

3Bewaar de sleutel in de omgeving

Node gebruikt de geheime sleutel. Zet hem in een omgevingsvariabele, nooit in code: lokaal in een .env-bestand dat Node 20.6 en later laadt met --env-file, in productie in de omgeving of geheime instellingen van je host (Fly secrets, Docker, systemd, Render, Vercel). Herstart het proces nadat je hem hebt gewijzigd.

.env
BLIPIT_SECRET_KEY=blipit_sk_your_secret_key
sh
node --env-file=.env --import ./instrument.mjs server.mjs

4Houd sleutels buiten git

Bewaar sleutels in omgevingsvariabelen of in de geheime instellingen van je host, nooit in code die je commit, en zet je .env-bestanden in .gitignore. Een publieke sleutel in een webpagina is normaal. Belandt een geheime sleutel ooit in git, op een openbare pagina, in een screenshot of in een chat, open dan API-sleutels, druk op Nieuwe geheime sleutel aanmaken en plak de nieuwe sleutel overal waar de oude werd gebruikt: de oude sleutel werkt meteen niet meer.

.gitignore
.env
.env.local
.env.*.local

5Initialiseer als eerste

Zet dit in een bestand dat vóór je app draait, en importeer het als eerste.

instrument.mjs
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",
});

6Express, Fastify, Koa, Hono of NestJS

Voeg de handler toe na je routes, zodat afgehandelde en niet-afgehandelde fouten allebei Blipit bereiken, met de methode, URL en user agent van het request. Koa, Hono en NestJS hebben elk één regel nodig: de Koa-middleware eerst, die van Hono vóór de routes. Ze melden fouten met een status van 500 of hoger. Verzoeken verschijnen dan op de pagina Pulse per route, zoals GET /users/:id, in plaats van één regel per URL.

js
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);
Fastify
await app.register(Blipit.fastifyPlugin());
Koa
app.use(Blipit.koaMiddleware());
Hono
app.use(Blipit.honoMiddleware());
NestJS
app.useGlobalInterceptors(Blipit.nestInterceptor());

7Serverless: AWS Lambda en Vercel

Serverless hosts pauzeren de functie zodra die antwoordt, en Lambda draait de HTTP-server van Node niet, dus wikkel de handler in. wrapHandler legt het verzoek vast (API Gateway-, function URL- en load balancer-events op methode en route, andere events op functienaam), meldt fouten en verstuurt alles voordat de handler terugkeert; hij wacht alleen als er iets te versturen is, hooguit 2 seconden. traceRequest doet hetzelfde voor elke handler die een Request krijgt. Op Vercel gaan de gegevens na het antwoord weg via waitUntil, dus niets wordt vertraagd. Gebruik in Next.js withBlipit (zie de Next.js-handleiding).

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

export const handler = Blipit.wrapHandler(async (event, context) => {
  return { statusCode: 200, body: "ok" };
});
traceRequest
export default { fetch: (request) => Blipit.traceRequest(request, () => app.fetch(request)) };

8Handmatige capture, logs en inlogpogingen

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

9Afhankelijkheden en servergezondheid

Vanaf 0.2 legt de SDK ook je database- en externe aanroepen vast, en de CPU, het geheugen en de event loop van je server. Zie de gidsen Afhankelijkheden en Servergezondheid; je stuurt het met tracesSampleRate, tracing: false en metrics: false.

10Check of het werkt

Open Issues in app.blipit.io. Het eerste event verschijnt binnen een paar seconden, gegroepeerd in een issue, en de verantwoordelijken krijgen een e-mail.

js
Blipit.captureMessage("Hello from Node");

Goed om te weten

  • Bij een uncaught exception flusht de SDK de wachtende events en stopt daarna met exitcode 1; overschrijf dit met onFatal.
  • captureConsole: true maakt van console.log en verwanten logregels die naar de pagina Logs worden verstuurd.
  • Controleer de geïnstalleerde versie met npm ls @blipit/node (of pnpm list @blipit/node). pnpm 11 wacht een dag voordat het een nieuwe release installeert (minimum-release-age), dus op de releasedag installeert pnpm add stilletjes de vorige versie; voor de nieuwe meteen voer je pnpm add @blipit/node@<version> --config.minimum-release-age=0 uit.
  • Blipit up-to-date houden: de gids Blipit up-to-date houden (docs.blipit.io/updates) legt de updatebanner uit, de e-mails voor belangrijke releases, de melding in je ontwikkelconsole en het updatecommando voor dit platform.
  • Eén project per app en platform: elk project kiest bij het aanmaken zijn platform (Android, iOS, React Native, Flutter, Web, Backend of Odoo), en Blipit weigert gegevens van elk ander platform met een duidelijke foutmelding. Een iOS-app en een Android-app hebben dus twee projecten met twee sleutels nodig. Releases, versies, crashpercentages en store-builds verschillen per platform, en door ze in één project te mengen klopt geen van die cijfers meer. Een Web-project neemt ook de serverkant van dezelfde web-app aan (de Next.js-server of Node), en een React Native- of Flutter-project ook zijn eigen native Android- en iOS-crashrapporten.

Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.