O horário permite encontrar o problema relatado e relacionar os registros de várias origens. Um fuso mal interpretado ou uma diferença ignorada entre os relógios leva a análise para outra operação e a uma conclusão sem relação com o atendimento.
A data, a hora e o fuso
Um horário terminado em Z ou em +00:00 está em UTC, a referência usada para expressar os fusos. O deslocamento -03:00 indica três horas a menos que o UTC, e o mesmo instante aparece de duas formas:
2026-10-01T17:32:05Z: o horário em UTC;2026-10-01T14:32:05-03:00: o mesmo instante no horário de Brasília.
A data completa faz parte do horário, porque a conversão perto da meia-noite pode mudar também o dia. Na comparação de um log do fornecedor com um registro local, o fuso de cada origem precisa ser confirmado: o fornecedor não usa necessariamente o UTC, e o programa instalado na loja não usa necessariamente a hora local. Quando o registro não traz o fuso, a configuração do programa e da máquina indica qual é, e a análise registra essa informação.
Os relógios diferentes
Cada máquina usa o próprio relógio. Se o caixa 01 está dois minutos adiantado em relação ao servidor da loja, o mesmo acontecimento parece ocorrer em momentos incompatíveis nos dois arquivos.
A diferença conhecida entre os relógios e uma janela de busca um pouco maior ajudam no cruzamento das origens. O estado atual do relógio, porém, não prova como ele estava no momento de uma falha antiga. Os identificadores da operação completam a ligação, e, quando a ordem entre as máquinas não pode ser estabelecida com segurança, a análise diz isso.
O que a duração mede
Entre um Enviado às 14:32:04.902 e um Recebido às 14:32:05.611, no mesmo dia, no mesmo fuso, no mesmo programa e na mesma tentativa, passaram 709 milissegundos. Esse é o intervalo entre os dois pontos de registro. Ele pode incluir o processamento local, a rede e o processamento do fornecedor, e o log não separa essas parcelas.
Uma espera que termina em 30 ou em 60 segundos sugere um limite configurado, mas o número redondo não prova isso. Uma mensagem explícita de tempo esgotado ou a configuração da integração confirma a hipótese. Em registros de máquinas diferentes, os relógios desalinhados também distorcem a duração calculada.
Um período sem linhas significa apenas que não há registros naquele intervalo do material disponível. O programa parado, a falta de atividade, a gravação adiada e um trecho ausente são explicações possíveis, e o silêncio, sozinho, não confirma um travamento.
O relógio que produziu o horário
Um sistema de coleta pode guardar o horário informado pela origem e o momento em que recebeu o registro. No modelo do OpenTelemetry, essa distinção aparece nos campos Timestamp e ObservedTimestamp. Uma mensagem recebida às 14:35 não aconteceu necessariamente às 14:35, porque pode ter ficado à espera do envio. Antes de ordenar a linha do tempo, a leitura confere qual campo está sendo exibido.
O relógio de data e hora pode ser corrigido durante o funcionamento. Uma sequência que parece voltar alguns segundos pode vir dessa correção, de uma gravação adiada ou de tarefas simultâneas. A conversão do fuso corrige a representação do mesmo instante, e não um relógio adiantado.
Para medir intervalos dentro do mesmo processo, os programas podem usar um contador independente do relógio de data e hora, como o Stopwatch no Windows. Uma duração medida dessa forma continua válida durante uma correção do relógio, mas essa propriedade depende de como o programa mediu e não vale para a simples subtração de dois horários do arquivo.
As linhas intercaladas
As tarefas simultâneas misturam os registros. Para calcular uma duração ou ordenar uma conversa, a leitura acompanha o mesmo terminal, o mesmo documento ou o mesmo código de transação e, quando existe, a mesma tentativa. A linha seguinte do arquivo pode ser de outra operação.
No suporte
O relato registra a data completa, o horário aproximado e o fuso. Antes de relacionar dois arquivos, convém comparar os fusos, os relógios e os identificadores: uma diferença de três horas pode ser a conversão do fuso, e uma diferença de minutos pode ser o desalinhamento dos relógios.
Para guardar
- O Z e o +00:00 indicam o UTC, e o -03:00 indica três horas a menos.
- A conversão pode mudar a data, e a diferença entre os relógios pode alterar a ordem aparente.
- A duração entre duas linhas mede o intervalo entre os pontos em que elas foram registradas.
- O horário do evento, o horário da coleta e a medição da duração podem vir de mecanismos diferentes.
- As esperas redondas e os períodos sem linhas orientam hipóteses, mas não confirmam a causa.
O fornecedor registra 2026-10-01T17:32:05Z. A que data e horário de Brasília isso corresponde?
A 1º de outubro de 2026, às 14:32:05, no fuso -03:00. O Z indica o UTC, e a conversão subtrai três horas. Nesse caso, a data continua a mesma, e perto da meia-noite ela poderia mudar.
Há 30 segundos entre um Enviado e uma linha de erro. Isso prova que o fornecedor levou 30 segundos para processar o pedido?
Não. O intervalo inclui tudo o que aconteceu entre os pontos de registro. Se a mensagem informa um tempo esgotado, o programa atingiu o próprio prazo de espera, o que não revela quanto tempo o fornecedor processou nem se a operação foi concluída do outro lado.