Logs estruturados: encontre o erro em minutos, não em horas

"Deu erro no pagamento do cliente X ontem à tarde." Com logs em texto livre — console.log('erro', err) —, encontrar a linha certa é uma busca às cegas. Com logs estruturados, é uma consulta de segundos.

O que são

Cada registro é um objeto com campos fixos, em vez de uma frase:

{ "nivel": "error", "msg": "pagamento recusado", "pedidoId": "123", "clienteId": "45", "requestId": "a1b2", "duracaoMs": 812 }

Assim é possível filtrar por cliente, pedido, rota ou tipo de erro.

Campos que valem ouro

• requestId: identifica uma requisição do começo ao fim, mesmo passando por vários serviços.
• Usuário ou empresa (sem dados pessoais desnecessários).
• Rota e método.
• Duração.
• Versão do sistema.

Níveis com significado

• error: algo falhou e precisa de atenção.
• warn: situação estranha, mas tratada.
• info: eventos importantes do negócio.
• debug: detalhes só para desenvolvimento.

Bibliotecas

Em Node.js, o pino é rápido e gera JSON por padrão. Os logs vão para uma ferramenta de busca centralizada.

O que nunca registrar

Senhas, tokens, números de cartão e dados pessoais além do necessário (Logs sem dados sensíveis: o vazamento que ninguém percebe).

Parte de algo maior

Logs, métricas e rastreamento formam a observabilidade do sistema (Observabilidade para quem não é SRE: métricas, logs e traces). E o tratamento centralizado de erros garante que nada escape sem registro (Tratamento global de erros no Node.js: respostas consistentes e logs úteis).

A We Codex entrega sistemas preparados para operação. Veja sistemas web ou fale com a gente.