blog
Servidores

Log 3 horas adiantado e cron fora de hora: é UTC

Como confirmar o fuso em uso, trocar para America/Sao_Paulo, saber quais serviços reiniciar e explicar ao cliente por que o relatório marca 17:20.

JR · · 7 min de leitura · 2 tabelas · 5 blocos de código

Resposta curta: A diferença é fuso horário, não atraso: UTC está 3 horas à frente do horário de Brasília. O incidente das 14h20 aparece no log como 17:20, e tudo a partir das 21h cai com a data do dia seguinte. Some 3h para achar a linha, subtraia 3h para contar ao cliente.

Neste artigo
  1. Some 3 horas para achar a linha, subtraia 3 para contar ao cliente
  2. Confirme qual fuso o sistema está usando
  3. Trocar o fuso do servidor com timedatectl ou pelo WHM
  4. O que precisa reiniciar para começar a gravar no horário novo
  5. As linhas já gravadas continuam em UTC para sempre
  6. Checklist para padronizar vários servidores
  7. Como explicar ao cliente sem parecer desculpa

O log não está atrasado. Ele está em UTC, e o Brasil continental (depois do fim do horário de verão) está em UTC-3. A conta que resolve a confusão é curta: UTC = horário de Brasília + 3 horas. O pico que o cliente viu às 14h20 aparece gravado como 17:20. E a visita das 23h30 de terça cai no log já com a data de quarta, porque 23:30 + 3h = 02:30 do dia seguinte.

Quem mantém sites de clientes topa com isso em dois lugares: investigando lentidão no access_log e explicando por que um cron agendado para 03h00 rodou, aparentemente, à meia-noite.

Some 3 horas para achar a linha, subtraia 3 para contar ao cliente

A maior parte dos erros de interpretação vem de somar quando era para subtrair. Separe por objetivo:

Horário de Brasília (UTC-3) Como aparece no log em UTC Observação
00:15 03:15 (mesmo dia)
09:00 12:00 (mesmo dia)
14:20 17:20 (mesmo dia)
20:45 23:45 (mesmo dia)
21:00 00:00 do dia seguinte vira a data
23:30 02:30 do dia seguinte vira a data

Tudo a partir das 21h00 de Brasília já está gravado com a data do dia seguinte. Esse é o detalhe que faz gente procurar no arquivo errado e concluir que "não tem log do incidente".

Se o servidor estiver em outro fuso que não UTC nem America/Sao_Paulo, a diferença muda. Confirme antes de aplicar a regra, em vez de assumir 3 horas.

Qual direção converter: cliente ou logPonto de partidaHorário do cliente ou do logVeio do clienteSome três horas para buscarVeio do logSubtraia três horas para explicarNoite de BrasíliaLog já grava data seguinte
Direção da conversão entre horário de Brasília e UTC no log.

Confirme qual fuso o sistema está usando

Não deduza pelo carimbo de uma linha. Pergunte ao sistema.

timedatectl

A saída mostra Local time, Universal time e Time zone. Se a linha de fuso disser UTC (UTC, +0000), está confirmado: todo serviço que herda o fuso do sistema grava em UTC.

Em servidores sem systemd, ou para uma checagem rápida de uma linha só:

date
date +%Z
cat /etc/timezone 2>/dev/null; ls -l /etc/localtime

date +%Z devolve a abreviação (UTC, -03). O link simbólico de /etc/localtime aponta para o arquivo de zona em uso, o que é útil quando /etc/timezone não existe na distribuição.

O fuso que o cron enxerga pode não ser o do seu shell

O cron não usa necessariamente o mesmo fuso que você vê no seu shell, porque o ambiente dele é mínimo. A forma honesta de descobrir é fazer o próprio cron responder. Agende uma linha temporária que grava a data dele:

* * * * * /bin/date >> /home/usuario/fuso-cron.txt 2>&1

Espere dois minutos, leia o arquivo, compare com o relógio do seu celular e remova a linha. Se o arquivo mostrar 3 horas a mais, o cron está em UTC e um agendamento de 0 3 * * * dispara às 00h00 de Brasília.

Quando você precisa que uma tarefa específica rode no horário local sem mexer no servidor inteiro, declare a variável no topo do crontab do usuário:

TZ=America/Sao_Paulo
0 3 * * * /usr/local/bin/php /home/usuario/public_html/wp-cron.php

O suporte a TZ dentro do crontab depende da implementação de cron instalada. Teste com a mesma linha de /bin/date antes de confiar nela em produção.

Trocar o fuso do servidor com timedatectl ou pelo WHM

Em servidor com acesso root e systemd:

timedatectl list-timezones | grep Sao_Paulo
timedatectl set-timezone America/Sao_Paulo
timedatectl

Em ambiente com WHM, a documentação do cPanel para Server Time descreve a interface que ajusta o fuso do servidor e sincroniza o relógio com um servidor de tempo. Use a interface em vez do terminal quando o servidor é gerenciado por WHM, para que a mudança fique registrada na configuração do painel.

Use sempre o identificador de zona (America/Sao_Paulo), nunca um deslocamento fixo tipo GMT-3. O identificador carrega o histórico de regras daquela região, inclusive os anos em que houve horário de verão, o que mantém datas antigas coerentes.

Em hospedagem compartilhada, o fuso é do serviço, não do servidor

Sem root você não troca o relógio do sistema, e nem deveria. Ajuste onde o conteúdo é gerado:

O log do Apache ou do LiteSpeed continua no fuso do servidor. Em compartilhada, a regra das 3 horas continua valendo para ler log, e tudo bem.

O que precisa reiniciar para começar a gravar no horário novo

Processo de longa duração lê o fuso quando sobe e guarda na memória. Trocar /etc/localtime não avisa ninguém. Por isso o log continua em UTC depois da mudança e a pessoa conclui que não funcionou.

Serviço Por que precisa O que verificar depois
Apache / LiteSpeed grava o carimbo do access_log e do error_log uma linha nova no log, com horário local
PHP-FPM define a hora de date() e dos logs de erro do PHP date('H:i') em um arquivo de teste
MySQL / MariaDB NOW(), CURRENT_TIMESTAMP e o slow query log SELECT NOW(), @@system_time_zone;
cron / crond horário de disparo das tarefas a linha de teste com /bin/date
Serviço de e-mail (Exim/Dovecot) cabeçalho Date: e logs de entrega cabeçalho de uma mensagem nova

Reinicie um por vez, em janela de baixo tráfego, e valide cada um antes do próximo. Reinício do banco e do PHP-FPM derruba conexões em andamento. Se o servidor hospeda vários clientes, avise ou faça de madrugada.

Troca de fuso: confirmar, trocar, reiniciar, validarConfirmartimedatectl, date +%Z, localtimeTrocarIdentificador de zona, nunca deslocamentoReiniciarWeb, PHP-FPM, banco, cron, e-mailValidarLinha nova no log, NOW()
Sequência de troca de fuso em servidor com root.

As linhas já gravadas continuam em UTC para sempre

O carimbo é texto escrito no arquivo no momento do evento. Ele não é recalculado quando o fuso muda. Isso significa que um mesmo arquivo de log pode ter a primeira metade em UTC e a segunda em horário de Brasília, com uma descontinuidade de 3 horas no meio.

Duas consequências práticas:

  1. Ao investigar um incidente antigo, confira se ele é anterior ou posterior à troca de fuso antes de aplicar a conversão.
  2. Anote a data da troca em algum lugar que você vá reencontrar: comentário no arquivo de configuração, nota no gerenciador de senhas do cliente, card no sistema de tarefas. Daqui a oito meses ninguém lembra.

Não tente "corrigir" logs antigos com busca e substituição. O risco de estragar a linha e perder a evidência é maior do que o ganho de legibilidade.

Checklist para padronizar vários servidores

Quem cuida de dez ou trinta sites não quer descobrir o fuso de cada um na hora do incidente. Faça uma passada só, uma vez:

  1. Para cada servidor, rode timedatectl (ou date +%Z) e anote o fuso numa planilha, junto do nome do cliente e do painel usado.
  2. Decida o padrão da sua operação e escreva isso em algum lugar. Manter tudo em UTC é defensável para quem cruza logs entre servidores; manter tudo em America/Sao_Paulo é mais fácil para quem conversa com cliente brasileiro. O que não funciona é metade e metade.
  3. Onde você tem root, aplique o padrão e reinicie a lista de serviços da tabela acima.
  4. Onde não tem root, registre o fuso real na planilha e configure o fuso do WordPress por cidade em todos os sites.
  5. Rode a linha de teste do cron em cada servidor e anote se o cron bate com o fuso do sistema.
  6. Antes de responder qualquer chamado de lentidão, abra a planilha e veja o fuso daquele servidor antes de abrir o log.

Esse checklist também serve de roteiro de onboarding quando você assume um site de outro fornecedor.

Como explicar ao cliente sem parecer desculpa

O cliente vê 17:20 no relatório e lembra que o site caiu depois do almoço. Se você não explicar, ele acha que o relatório é de outro dia.

Frase pronta, pode copiar:

Quando a diferença virar data, acrescente uma linha:

E a frase que evita o chamado seguinte, quando o cron parecia estar na hora errada:

Depois disso, a investigação volta ao normal: achar a faixa de horário certa no access_log, ver quem acessou, olhar o log de erro do PHP. A diferença é que agora você está lendo a hora certa.

Referências

  1. Documentação oficial (cpanel) — Server Time. Consultado em 2026-10-03.
Leia também