Pular para o conteúdo

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

Um cliente reclama de um erro de ontem e o time passa a manhã procurando no meio de milhões de linhas de texto. Logs estruturados resolvem isso.

Por Roger C. Ribeiro, fundador da Wecodex3 min de leitura

Um cliente reclama de um erro de ontem e o time passa a manhã procurando no meio de milhões de linhas de texto. Logs estruturados resolvem isso.

"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:

json
{ "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 e logs).

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

  • Logs
  • Observabilidade
  • Node.js
  • Operação
CompartilharWhatsAppLinkedIn

Escrito por

Roger C. Ribeiro

Fundador da Wecodex. Escreve sobre engenharia de software, performance, APIs, segurança e IA aplicada a empresas.

Serviços relacionados

Resolver de vez, com quem faz isso todo dia

Precisa de uma API ou integração que não caia quando o negócio crescer?

Este artigo mostra o caminho. A implementação sob medida, o detalhe que muda o resultado no seu caso, é o trabalho da Wecodex, empresa de engenharia do grupo Wocom.