Pular para o conteúdo
Criação de Apps

Logs de aplicação: o que registrar e o que nunca gravar

Resposta rápida

Logs de aplicação são registros do que o sistema faz, como erros, ações importantes e eventos. Registre o suficiente para entender um problema, com data, nível e contexto, e nunca grave senhas, tokens, dados de cartão ou informações pessoais desnecessárias.

Neste artigo
  1. O que vale registrar
  2. Níveis de log
  3. Escreva mensagens úteis
  4. O que nunca gravar
  5. Cuidados com armazenamento
  6. Como começar sem complicar

Quando um app falha na mão de um usuário, você não vê a tela dele. O que sobra para investigar são os logs: registros escritos pelo sistema sobre o que aconteceu. Um log bem feito encurta a busca por um erro de horas para minutos. Um log mal feito atrapalha ou, pior, expõe dados.

O que vale registrar

  • Erros e exceções, com a mensagem e o local onde ocorreram.
  • Ações importantes: login realizado, pedido criado, pagamento confirmado, e-mail enviado.
  • Falhas ao falar com serviços externos, como o meio de pagamento ou uma API.
  • Mudanças relevantes de configuração.
  • Marcas de tempo, para ordenar os eventos.

Inclua um identificador que ajude a ligar eventos do mesmo pedido ou usuário, como um número de pedido ou um código de requisição. Sem ele, em um sistema com muitos acessos, as linhas se misturam.

Níveis de log

Os níveis indicam a gravidade e permitem filtrar o que mostrar:

  • Debug: detalhes para desenvolvimento, normalmente desligados em produção.
  • Info: eventos normais, como o início de um processo.
  • Warning: algo estranho que não impediu o funcionamento.
  • Error: uma falha que impediu uma operação.

Use o nível certo. Se tudo vira erro, ninguém mais olha os alertas.

Escreva mensagens úteis

Compare estas duas:

  • Falhou.
  • Falha ao criar pedido 4821: o serviço de pagamento não respondeu em 10 segundos.

A segunda diz o quê, onde e por quê. Prefira mensagens com contexto e, se possível, em formato estruturado, como pares de campo e valor, que facilitam busca e filtros em ferramentas de monitoramento.

O que nunca gravar

Este é o ponto de maior risco. Evite registrar:

  • Senhas, mesmo erradas.
  • Tokens de acesso e chaves de API. Se uma chave aparecer em logs, trate como vazada. Veja o que fazer se uma chave vazou.
  • Dados completos de cartão.
  • Documentos e informações pessoais sem necessidade, como CPF, endereço e conteúdo de mensagens.

Se precisar identificar um usuário, use um código interno em vez do dado pessoal. Quando for inevitável registrar algo sensível, mascare parte do valor.

Cuidados com armazenamento

  1. Limite o acesso aos logs apenas a quem precisa.
  2. Defina por quanto tempo guardar e apague o restante, para não crescer sem fim e ocupar disco.
  3. Faça rotação de arquivos, para que um único log não fique gigante.
  4. Se os logs contêm dados pessoais, entram nas regras da LGPD. Busque orientação especializada para definir prazos e bases legais.

Como começar sem complicar

Em um projeto pequeno, comece registrando erros e três ou quatro eventos de negócio. Use a biblioteca de logs da sua linguagem em vez de imprimir mensagens soltas. Depois que o app crescer, considere uma ferramenta de monitoramento que reúna os registros e avise quando algo quebrar.

  • Logs
  • Boas Práticas
  • Depuração

Perguntas frequentes

Quais são os níveis de log mais comuns?

Os mais usados são debug, info, warning e error. Cada ferramenta pode ter nomes extras, como critical ou fatal.

Por quanto tempo devo guardar os logs?

Depende do uso e das obrigações do seu negócio. Defina um prazo, apague o que não precisa mais e consulte um profissional se os logs tiverem dados pessoais.

Leia também

Criação de Apps

Subi uma chave de API ou senha no GitHub: o que fazer agora

O passo a passo de emergência para quem publicou um segredo por engano num repositório.

· 5 min de leitura
Criação de Apps

Logs de erro: como ler mensagens e usar para achar bugs

Saber ler o log transforma um erro misterioso em uma pista concreta.

· 2 min de leitura
Criação de Apps

Como depurar erros no código: passo a passo para iniciantes

Depurar é um método, não sorte: ler o erro, isolar e testar uma hipótese por vez.

· 2 min de leitura
Criação de Apps

Tarefas em segundo plano: como usar filas de jobs no seu app

Tirar o trabalho pesado da requisição deixa o app mais rápido e mais confiável.

· 2 min de leitura

Deixe seu comentário