Skip to content

logging.md

Latest commit

 

History

History
33 lines (22 loc) · 879 Bytes

logging.md

File metadata and controls

33 lines (22 loc) · 879 Bytes

Structured Logging (#409)

AgenticPay backend uses Pino for JSON structured logs with correlation IDs.

Fields

Field Source
traceId X-Trace-Id header or generated UUID
requestId x-request-id header or generated UUID
module Per-module child loggers (webhooks, prisma, …)

Configuration

LOG_LEVEL=info
LOG_LEVELS=webhooks:debug,prisma:warn

Local log aggregation (Loki + Grafana)

docker compose up -d loki grafana
  • Grafana: http://localhost:3002 (admin / admin)
  • Query: {service="agenticpay-backend"} in Explore → Loki

Ship production logs with Promtail or your cloud log agent targeting Loki.

PII redaction

Emails, API keys, Bearer tokens, and card-like numbers are redacted in log formatters. Sensitive object keys (password, secret, token, …) are censored.