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:
{ "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
Escrito por
Roger C. RibeiroFundador 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.
Continue lendo
Tudo sobre Backend & APIs- Ler artigo
Backend & APIs3 min
Tratamento global de erros no Node.js: respostas e logs
Cada rota trata erro de um jeito, o cliente recebe stack trace e ninguém acha o problema no log. Veja como centralizar o tratamento de erros no Node.js.
- Ler artigo
Backend & APIs3 min
Observabilidade para quem não é SRE: métricas, logs e traces
Você descobre que o sistema está lento quando o cliente reclama? Observabilidade é saber antes. Um guia para quem não é especialista em infraestrutura.
- Ler artigo
Segurança3 min
Logs sem dados sensíveis: o vazamento que ninguém percebe
O sistema está seguro, mas os logs registram senhas, CPFs e tokens em texto puro — e meia empresa tem acesso a eles. O vazamento que ninguém percebe.