Pino + OpenTelemetry + Sentry egy stackben — a Nortinia observability recept
A három eszköz együtt dolgozik, vagy átfedi egymást és dupla log-okat generál. Mutatjuk, hogyan állítsuk össze helyesen.
Az observability nem 3 külön eszköz. Egy stack, ami egy kérdésre válaszol: "mi történt a 14:32-es kérésnél?"
A Nortinia minden terméke ugyanazt az observability stack-et használja: Pino a strukturált logoláshoz, OpenTelemetry a distributed tracing-hez, Sentry a hibakövetéshez. Ez a három eszköz átfedi egymást, ha nem állítod be őket — és akkor dupla log-ok, dupla hiba riasztások, zavaros nyomozások lesznek.
Pino — a "mi történt" válasz
A Pino strukturált JSON logokat ír. Minden sorban van egy requestId, userId, tenantId, route, httpMethod, statusCode. Ez a 6 mező 90%-ban elég a debughoz. A log level runtime konfigurálható (a Netorigo stack-ben env variable-ből), így prod-on info, staging-en debug, dev-en trace. Pinonak nincs napi limit, nincs havidíj — csak a te log gyűjtőd rendszer (Loki vagy CloudWatch) fizetős.
OpenTelemetry — a "hol történt" válasz
Az OpenTelemetry trace-eket generál minden http request-re. Egy trace 1 kérés, 1 trace ID, több span (lépések: db query, redis get, külső API hívás). A Nortinia stack-ben a Jaeger-be küldjük, és a Grafana Tempo-ban ábrázoljuk. A legfontosabb: a Pino logok trace_id mezőjét beírjuk, hogy log → trace átkattintás egyetlen klikk legyen.
Sentry — a "miért történt" válasz
- Csak kivételeket (exception) kap — nem minden logot
- Source map feltöltés CI-ben, hogy a stack trace forráskódos legyen
- Tag: tenantId, release (git SHA), environment
- User context: userId + email (PII nélkül, titkosítva)
- Sample rate: 100% dev, 25% staging, 1% prod — különben csillagos a számla
A három együtt
A flow: egy hiba → Sentry értesítést küld → a mérnök megnyitja → ott van a requestId + trace_id. Átklikkel a Grafana Loki-ra (Pino log) a requestId-vel — látja a user flowt. Átklikkel a Tempo-ra (trace) a trace_id-vel — látja, hogy melyik span lassított, és melyik külső szolgáltatás hibázott. 60 másodperc alatt az első klikk után tudja, mi történt. Ez az, amire a "one pane of glass" szó született — és ez az, amire minden Nortinia ügyfél a második hónap után függőleg.