Resposta direta
Investigar um log começa pela pergunta que se quer responder, não pelo arquivo. Define-se o efeito observado, o horário aproximado e o identificador que liga uma execução às demais etapas. Sem esse identificador, o log vira uma pilha de linhas sem ordem. A leitura segue três cortes: o que a automação recebeu, o que decidiu e o que enviou de volta. A causa costuma estar na fronteira entre sistemas, onde um dado chega vazio, fora de formato ou repetido. Se o registro não permite reconstruir esses três pontos, o problema é de instrumentação, não de análise. Corrigir o log vem antes de corrigir o fluxo.
- Objetivo
- Diagnosticar
- Formato indicado
- Workshop executivo
- Atualizado em
O que esta página acrescenta: Trata a leitura do log como investigação, com ordem de busca e classificação da divergência, em vez de listar campos a registrar.
Ordem de leitura, do efeito para a causa
A investigação começa pelo efeito, não pelo arquivo. Descrever em uma frase o que deveria ter acontecido e o que aconteceu fornece o ponto de partida e o intervalo de tempo a examinar.
O identificador de correlação liga a execução às etapas que ela tocou. Sem ele, cada sistema produz um registro isolado e a comparação vira suposição. Com ele, a leitura avança do fim para o começo até a primeira divergência.
Fronteira entre sistemas, onde a falha costuma aparecer
Boa parte das falhas aparece na fronteira. Um campo chega vazio, um formato muda entre a origem e o destino, um registro duplica, uma permissão é negada longe da origem do dado.
Classificar a divergência reduz o espaço de busca: dado, regra, permissão ou tempo. Cada classe aponta para um responsável e para uma correção diferente. Sem classificação, a discussão gira em torno de quem recebeu a chamada.
O que o log não resolve
O registro cobre o que foi instrumentado. Ele não recupera dado perdido, não desfaz um envio indevido e não alcança ação feita fora do fluxo, por pessoa ou por outro sistema.
Também não distribui responsabilidade. O log mostra onde a regra falhou, não quem deveria tê-la definido. Quando a automação depende de terceiro que não expõe evento, a leitura para na fronteira, e o limite é contratual antes de ser técnico.
Recurso prático
Sequência para chegar à causa de uma falha no log
- Descrever o efeito observado em uma frase, com horário aproximado e quem notou.
- Localizar o identificador de correlação da execução e reunir as linhas ligadas a ele.
- Marcar a última etapa concluída e a primeira em que o registrado difere do esperado.
- Classificar a divergência: dado ausente ou inválido, regra não aplicada, permissão negada ou tempo excedido.
- Confirmar no log do sistema receptor antes de apontar causa e anotar o que faltou no registro.
O erro mais comum é ler apenas o log da automação e concluir pela causa sem abrir o registro do sistema que recebeu a chamada. Quando os dois discordam, a divergência entre eles é a informação principal.
Sobre o que está escrito aqui
Conceitos relacionados: identificador de correlação · carimbo de tempo · código de retorno · divergência entre registros · trilha de execução. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Workshop executivo, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Governança e controle de automação — Página central do tema
- Alerta que ninguém recebe: onde definir quem… — alerta que ninguém recebe
- Alerta que ninguém recebe: onde a responsabil… — alerta que ninguém recebe
Páginas relacionadas
O mesmo problema em outro objetivo
- Logs espalhados entre automações: onde concentrar a leitura — Organizar um processo
- Logs de automação: como comparar o que cada origem entrega — Comparar alternativas
- Logs de automação: o que gravar e por quanto tempo — Orientar implementação
- Logs na contratação: o que precisa estar escrito no contrato — Orientar avaliação e contratação
Outras leituras em Governança e controle de automação
- Registro de execução sem hora confiável: ordenar eventos — Organização do registro de execução quando o horário não é confiável: separar marcador de ordem, horário e evidência indireta, com o grau de certeza declarado.
- Execução sem data confiável: como ordenar os fatos — Registro de execução quando a hora é ausente ou não confiável: campos que sustentam a leitura, âncoras externas e os limites dessa reconstrução.
- Ordem de execução sem data confiável: o que se pode provar — Avaliação de registro de execução quando a data não é confiável: o que ainda sustenta ordem, autoria e sequência, e o que fica em aberto.
- Inventário de automações: quais alternativas comparar — Compara formas de levantar e manter inventário de automações, o que cada uma cobre, o que deixa em aberto e quem responde pela atualização.
- Registro sem data confiável: como comparar alternativas — Compara três desenhos de registro de execução quando a data não é confiável: encadeamento por identificador, hora aproximada e fonte externa de tempo.