structured-log-contracts

What problem does it solve?

Define e implemente contratos de log estruturado (JSON) garantindo rastreabilidade ponta-a-ponta, isolamento de side-effects e resiliência a falhas de serialização, com foco em código de observabilidade de infraestrutura.

Core Features & Use Cases

• Define a interface (schema) do log com campos obrigatórios (timestamp, level, message, service, trace_id, span_id) e campos opcionais para erro e contexto.
• Assegura a propagação de contexto sem depender de parâmetros manuais, via AsyncLocalStorage (Node) ou ContextVar (Python).
• Isola a construção do payload da escrita em I/O e fornece fallback seguro se a serialização falhar.
• Sanitiza PII e limita tamanho de payloads para evitar vazamento e degradação de desempenho.
• Oferece fallback de I/O para não travar a aplicação quando o destino de logs estiver indisponível.

Quick Start

Configure the structured log contract in your logging layer and wire trace propagation middleware across services.