Common Observability Standards

Priority: P1 (HIGH)

Logging & Tracing

• JSON Logs: Always emit JSON structured logs. Never plain-text in prod.
• Correlation: Extract X-Request-Id or traceparent. Attach to async context.
• Tracing: Use OpenTelemetry. Propagate W3C traceparent.
• Spans: Name spans like <HTTP_METHOD> <route> (GET /users/:id).

See implementation examples for structured logger setup with Pino.

Metrics

• Required: Request rate, Error rate, Latency histogram (p50/p95/p99), Saturation.
• SLOs: Alert on SLO burn rates, not raw threshold spikes.

Instrumentation Workflow