Roteiro de leitura de um log

Uma análise útil liga o relato aos registros e mostra o que foi confirmado. Nem sempre o material disponível revela a causa, mas um roteiro leva a uma conclusão sustentada ou mostra exatamente qual verificação falta.

Do relato aos registros

1. O relato: a operação, a data e o horário aproximado, o fuso, a loja, o terminal, os identificadores e a mensagem da tela definem o que será procurado;
2. A origem inicial: o sistema, a integração, o banco, o Windows e os testes de rede observam partes diferentes do problema, e a leitura começa pela origem que registra a operação e se amplia conforme a falha encontrada;
3. O material do período: as datas dentro dos arquivos e a rotação por dia ou por tamanho são conferidas, porque a sequência pode atravessar mais de um arquivo;
4. A preservação: a origem e o momento da coleta ficam anotados, uma cópia fica sem alterações e outra recebe os recortes e as formatações, com a ferramenta escolhida pelo tamanho do arquivo e pelo que a máquina permite;
5. A operação no tempo: os fusos são convertidos quando necessário, a diferença entre os relógios é considerada, e a operação, o terminal e a tentativa ligam os registros, porque a proximidade do horário, sozinha, não identifica a conversa.

Da sequência à hipótese

6. A primeira anomalia disponível: a leitura volta a partir da falha da operação, e um aviso, um erro, uma repetição ou a falta de uma etapa esperada orientam a busca, com o registro de que o início não foi localizado quando o material já começa com falhas;
7. Os blocos e o contexto: os registros de várias linhas, as etapas anteriores e os resultados posteriores entram na leitura, porque uma extração por linha pode esconder a parte decisiva;
8. A classificação do que foi observado: um erro na resolução do nome, uma conexão recusada, uma espera esgotada, uma recusa de negócio e uma conexão aberta com falha na etapa seguinte são situações diferentes, e, na integração, o resultado técnico e o conteúdo da resposta são lidos conforme o contrato;
9. A comparação e a medida: uma operação parecida que funcionou serve de comparação, e a frequência diz desde quando, em quais terminais e com qual unidade, sem tratar a diferença e a repetição como confirmações.

Da hipótese ao registro do atendimento

10. O cruzamento das origens: o banco, o Windows, o teste de rede, outro terminal ou os registros do fornecedor são examinados, com a conferência de que os identificadores e os horários ligam os acontecimentos e de que existe uma explicação para o encadeamento;
11. As evidências e a conclusão: o registro informa o arquivo ou o canal, a origem da coleta, o período e o fuso, os identificadores e o trecho completo necessário, separa o fato observado da hipótese e da confirmação e, sem a causa estabelecida, descreve o limite e o passo seguinte, com os dados sensíveis mascarados no material compartilhado.

Uma frase como "o programa informou tempo esgotado na tentativa 1, e a situação da pré-autorização ainda não foi confirmada no fornecedor" é uma conclusão útil quando o registro não informa o resultado final. Ela também explica por que a operação não pode ser repetida sem a conferência da situação.

A próxima observação e o limite do atendimento

Quando duas hipóteses continuam possíveis, o registro diz qual resultado as separa. Para uma perda de conexão, a comparação do erro do caixa 01 com a inicialização e a parada do MySQL no servidor da loja é verificável, e uma orientação como "olhar a rede" não define a origem, o destino, o período nem o resultado esperado.

A coleta seguinte é combinada com os envolvidos e delimitada pela operação identificada, pela janela, pelas origens e pela condição de encerramento. O período anterior à falha e a verificação posterior do resultado entram na coleta, porque um teste que inclui só o sintoma repete a falta de contexto do atendimento inicial.

O registro final separa o funcionamento restabelecido, o resultado da operação e a causa. O sistema que volta a responder confirma a observação posterior, mas não explica o que causou a interrupção nem resolve uma gravação de resultado desconhecido. Sem reprodução, o registro informa a janela observada e a evidência necessária em uma nova ocorrência, com a próxima verificação e o responsável por ela.