# 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.

> 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.

João Rizzon · 2026-10-04 · Servidores

---

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:

- **Você tem o horário do incidente e quer achar a linha no log:** some 3 horas. Cliente reclamou das 14h20, procure por `17:2` no log em UTC.
- **Você tem o carimbo do log e vai contar ao cliente:** subtraia 3 horas. O log diz `17:20`, o cliente viveu aquilo às 14h20.

| 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.

## Confirme qual fuso o sistema está usando

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

```bash
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ó:

```bash
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`:

```bash
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](https://docs.cpanel.net/whm/server-configuration/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:

- **PHP:** a diretiva é `date.timezone = America/Sao_Paulo`, definida no painel, no `php.ini` ou num `.user.ini` na raiz do site. O `.user.ini` não vale na hora: o PHP recarrega o arquivo conforme o intervalo de cache do próprio interpretador, então pode levar alguns minutos até a mudança valer. Dentro do código, quem faz o ajuste é a função `date_default_timezone_set('America/Sao_Paulo')`, que vale só para aquele processo.
- **WordPress:** Configurações, Geral, Fuso horário, escolha a cidade `São Paulo` em vez de um deslocamento UTC. Isso corrige a data dos posts e dos agendamentos do WP-Cron, não corrige o `access_log`.
- **MySQL/MariaDB:** `SET time_zone` na sessão, se o aplicativo depender de `NOW()`.

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.

## 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:

- Ao investigar um incidente antigo, confira se ele é anterior ou posterior à troca de fuso antes de aplicar a conversão.
- 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:

- Para cada servidor, rode `timedatectl` (ou `date +%Z`) e anote o fuso numa planilha, junto do nome do cliente e do painel usado.
- 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.
- Onde você tem root, aplique o padrão e reinicie a lista de serviços da tabela acima.
- Onde não tem root, registre o fuso real na planilha e configure o fuso do WordPress por cidade em todos os sites.
- Rode a linha de teste do cron em cada servidor e anote se o cron bate com o fuso do sistema.
- 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:

> **** O servidor registra tudo no fuso universal (UTC), que está 3 horas à frente do horário de Brasília. O pico aconteceu às 14h20 do seu horário, e no log ele aparece como 17:20 do mesmo dia. É o mesmo evento, só muda a forma de gravar a hora.

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

> **** Os acessos a partir das 21h de Brasília aparecem no log já com a data do dia seguinte, pelo mesmo motivo. Por isso o relatório de terça inclui o começo da madrugada de quarta.

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

> **** A tarefa estava agendada corretamente, só que no fuso do servidor. Ajustamos para o horário de Brasília e ela passa a rodar às 03h do seu horário a partir de hoje.

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.

