NestJS Observability
Installation
SKILL.md
Observability Standards
Structured Logging
- Standard: Use
nestjs-pinofor high-performance JSON logging.- Why: Node's built-in
console.logis blocking and unstructured.
- Why: Node's built-in
- Configuration:
- Redaction: Mandatory masking of sensitive fields (
password,token,email). - Context: Always inject
Loggerand set the context (LoginService).
- Redaction: Mandatory masking of sensitive fields (
Tracing (Correlation)
- Request ID: Every log line must include a
reqId(Request ID).nestjs-pinohandles this automatically usingAsyncLocalStorage.- Propagation: Pass
x-request-idto downstream microservices/database queries key to trace flows.