Tempo de leitura estimado : 4 min · Publicado
Comece com as perguntas que os logs devem responder
Liste as perguntas operacionais: um formulário está falhando, um processo é interrompido, um backup foi testado? Defina o evento, o componente, o tempo e um identificador de correlação apropriado. Evite mensagens que coletem texto sem ajudar a identificar uma ação.
Prepare exemplos sintéticos de sucesso, recusa e fracasso. Uma recusa esperada deve ser distinguível de uma interrupção. Os nomes e níveis de eventos devem ajudar o proprietário a decidir se quer investigar ou monitorar uma tendência.
Relacione eventos da mesma interação por um identificador de diagnóstico controlado, sem copiar um token de sessão. Exemplo fictício: form.saved e mail.failed contêm ambos DEMO-REQ-21. O primeiro descreve a gravação, o segundo uma falha de envio; um não deve apagar o significado do outro. Distinga também a hora do evento da hora de recolha quando o processamento é diferido.
Valores fornecidos por visitantes continuam a ser dados não fiáveis nos registos. Codifique retornos de carro CR, mudanças de linha LF e separadores segundo o formato escolhido para impedir que um campo fabrique outra entrada. JSON estruturado não remove automaticamente segredos: campos permitidos, codificação e limites de tamanho continuam necessários. Verifique a saída real com marcadores fictícios, nunca com palavras-passe reais.
Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.
| Sinal conservado | Interpretação limitada | Verificação a realizar |
|---|---|---|
| form.saved com DEMO-REQ-21 | A etapa de gravação teve sucesso. | Verificar o resultado guardado sem deduzir entrega do email. |
| mail.failed com DEMO-REQ-21 | Uma etapa de envio falhou na mesma interação. | Iniciar o acompanhamento adequado sem considerar o pedido perdido por defeito. |
| Hora do evento e hora de recolha | Descrevem dois momentos que podem diferir. | Conservar fuso e origem; não ordenar apenas pela chegada das linhas. |
| Valor externo com CR ou LF | Continua a ser um campo, não um novo evento. | Verificar codificação, tamanho e ausência de segredos na saída real. |
- OWASP : Registos de eventos
Consultado em 22 de outubro de 2026; identificadores de interação, tempos distintos, dados excluídos e prevenção de injeção nos registos.
Minimize as informações registradas
OWASP discute dados que devem ser excluídos dos logs, incluindo senhas, tokens de acesso e informações confidenciais. Revise as mensagens produzidas pelo seu código, bem como plugins, proxies e serviços de monitoramento.
Use uma lista de permissões de campos em vez de copiar uma solicitação inteira. Um identificador de diagnóstico pode ser suficiente onde uma mensagem de consulta completa seria excessiva. Teste com marcadores sintéticos e, em seguida, as saídas de busca por esses marcadores para detectar a coleção não intencional.
Gerenciar acesso, retenção e volume
Documente quem pode ler logs e por quê. Confirme se eles não são veiculados em um endereço público ou que são disponibilizados por meio de ferramentas de compartilhamento. Uma exportação de diagnóstico precisa da mesma revisão de acesso que o armazenamento primário.
Escolha a retenção de acordo com a necessidade real e o contexto aplicável, em vez de copiar a duração de outro serviço. Organize a rotação, os limites de volume e a exclusão. Uma falha repetida não deve preencher um disco por meio de log ilimitado.
Teste o caminho do sinal para a ação
Acionar uma falha controlada em um ambiente de teste. Verifique o log, a entrega de alertas, o destinatário e o procedimento de resposta. Um alerta enviado a uma caixa de entrada que ninguém verifica não forma um processo operacional.
Agrupe as repetições e siga os sinais que apoiam as decisões. Após um incidente, revise o que estava faltando e o que estava desnecessariamente exposto. Uma entrega útil conecta um evento com dados mínimos, um proprietário e uma ação.
Documentação principal: OWASP : Folha de dicas de log.
Limitar a transmissão de caminhos e parâmetros a sites externos.
Caso fictício: uma ligação externa parte de uma URL com um identificador inventado. Observe Referer num destino de teste com a política escolhida. Retire também dados sensíveis das URL: limitar a origem não apaga histórico nem registos anteriores.
- Só se transmite a origem prevista e não são usados identificadores pessoais reais.
- MDN Referrer-Policy
Referência da política que limita informação de origem nos pedidos de saída.
Documentos de referência
- MDN Referrer-Policy · Fonte consultada
- OWASP : Folha de dicas de log · Fonte consultada
Conteúdo atualizado
Referências documentadas para este tema
| Referência | Valor ou sintaxe | Âmbito |
|---|---|---|
| RFC 3339 · Date-time | 2026-10-22T09:00:00+02:00 | O desvio explícito relaciona a hora local com UTC; este exemplo não é uma marcação. |
As datas indicam a consulta das fontes. Estes dados não constituem uma auditoria do site nem uma declaração global de conformidade.
