Log de acesso sumiu: ative a retenção no cPanel
Como ligar o arquivamento mensal no cPanel, aplicar a mesma política em toda a carteira pela WHM e dimensionar o disco extra antes de dizer sim ao cliente.

Resposta curta: o log bruto do mês passado foi descartado porque o cPanel apaga o arquivo depois de gerar as estatísticas, a menos que o arquivamento mensal esteja ligado. Ative em Métricas > Raw Access (ou em massa pela WHM, em Web Log Retention) e o histórico passa a ficar em ~/logs.
Neste artigo
- Por que o cPanel apaga o log bruto depois de gerar as estatísticas
- As duas opções que decidem se o log do mês sobrevive
- Ativar o arquivamento mensal dentro da conta, sem WHM
- Aplicar a mesma política de retenção em toda a carteira pela WHM
- Quanto disco a retenção consome, medido no próprio cliente
- O que ainda dá para reconstruir quando o log já foi descartado
- Checklist de padronização e o texto para enviar ao cliente
Por que o cPanel apaga o log bruto depois de gerar as estatísticas
O cliente te chama em 12 de novembro de 2026: "descobrimos que alguém publicou um post estranho no dia 3 de outubro, consegue ver quem foi?". Você abre o gerenciador de arquivos, vai em /home/usuario/access-logs/, e lá está só o arquivo do domínio com os acessos recentes. Outubro não está lá.
Isso não é falha do servidor. É o comportamento padrão. O cPanel processa os logs de acesso periodicamente para alimentar as estatísticas (Awstats, Webalizer, Analog) e, terminado o processamento, o log bruto é descartado, a menos que a conta esteja configurada para arquivar. A documentação oficial do cPanel sobre Web Log Retention descreve exatamente essas duas decisões: arquivar os logs no diretório do usuário ao final de cada mês e remover os arquivos do mês anterior ao final do mês seguinte.
Conclusão prática e desconfortável: retenção de log é configuração preventiva. Quem só pensa nisso durante o incidente já perdeu a janela. O que você consegue recuperar depois é quase sempre pouco e indireto.
As duas opções que decidem se o log do mês sobrevive
Segundo a documentação do cPanel, existem duas opções independentes que governam o ciclo de vida dos logs de acesso de uma conta:
| Opção | Efeito quando ligada | Efeito quando desligada |
|---|---|---|
| Arquivar logs no diretório do usuário ao fim de cada mês | O log bruto é compactado e guardado em ~/logs |
O log é descartado depois do processamento das estatísticas |
| Remover os arquivos do mês anterior ao fim do mês seguinte | O servidor apaga o arquivo do mês anterior quando fecha o mês seguinte, mantendo um horizonte curto | Os arquivos se acumulam indefinidamente em ~/logs, consumindo disco da conta |
A combinação que a maioria das agências quer é: arquivar ligado, remoção automática desligada, com uma limpeza manual ou por cron quando o volume incomodar. Assim você controla o horizonte de retenção em vez de deixá-lo em um mês.
A combinação pior de todas é arquivar ligado e remoção ligada: dá a sensação de que existe histórico, mas o histórico útil é curto e some sozinho justamente no mês em que você precisava.
Ativar o arquivamento mensal dentro da conta, sem WHM
Essa é a rota que serve quando você tem acesso de cliente, sem WHM.
Onde fica a tela Raw Access no cPanel
No cPanel, vá em Métricas e depois em Raw Access (Acesso Bruto). O caminho de menu é o da versão atual da interface e pode mudar entre temas e releases; as duas opções de arquivamento e remoção são as descritas na documentação citada acima. Essa tela lista os domínios da conta, os logs brutos disponíveis para download e, no topo, as caixas de arquivamento.
Qual caixa marcar e qual deixar desmarcada
Marque a opção que arquiva os logs no diretório inicial ao final de cada mês. Deixe desmarcada a opção que remove os arquivos do mês anterior ao final do mês seguinte, se o seu objetivo é manter histórico. Salve.
Como confirmar que ~/logs passou a receber arquivo
O arquivamento acontece no fechamento do ciclo, não na hora em que você clica. Então não espere ver nada imediatamente. No começo do mês seguinte, confira por SSH ou pelo gerenciador de arquivos:
ls -lh ~/logs/
Você deve ver arquivos compactados nomeados por domínio e período. Se a pasta ~/logs não existir e já virou o mês, a opção não foi salva ou a conta não teve tráfego registrado.
Baixe o log do ciclo corrente antes de qualquer coisa
Na tela Raw Access do cPanel, na versão atual, há o download do log bruto do ciclo corrente. Em incidente ativo, baixe antes de qualquer coisa: é o registro que ainda está vivo. Isso é prática de operação nossa, não uma garantia da documentação.
Aplicar a mesma política de retenção em toda a carteira pela WHM
Fazer conta por conta é o erro que custa tempo de agência. A WHM tem a interface Web Log Retention, em Account Functions, criada para aplicar essa política em escala. Conforme a documentação, ela permite definir o arquivamento e a remoção automática para as contas do servidor, inclusive aplicando a configuração a contas existentes, e não só às novas.
O fluxo que recomendo para quem administra revenda ou VPS:
- Decida a política uma vez, por escrito, para toda a carteira. Exemplo: arquivar sim, remoção automática não, limpeza manual acima de 12 meses.
- Aplique em WHM > Account Functions > Web Log Retention para as contas existentes.
- Garanta que novas contas nasçam com a mesma política, para não criar duas gerações de servidor com comportamentos diferentes.
- Registre a data em que a política entrou em vigor. É isso que te permite responder com precisão até onde o histórico vai.
Esse último item vale mais do que parece. Quando o cliente pergunta "desde quando vocês guardam?", a resposta tem que ser uma data, não um "acho que desde sempre".
Quanto disco a retenção consome, medido no próprio cliente
Log de acesso cresce com requisição, não com o tamanho do site. Um site pequeno com bot agressivo gera mais log que uma loja média bem protegida. Então não estime por bolso: meça o log atual do próprio cliente e projete.
Por SSH, dentro da conta:
# tamanho dos logs brutos ativos
du -sh ~/access-logs/
# tamanho dos arquivos já arquivados, se existirem
du -sh ~/logs/ 2>/dev/null
Se você tem WHM, dá para varrer todas as contas de uma vez:
du -sh /home/*/logs/ 2>/dev/null | sort -h
Com o número em mãos, a projeção é aritmética simples. Os valores abaixo são exemplos fictícios, só para mostrar a conta, não medição nossa:
| Cenário (exemplo) | Log bruto do mês | Arquivo compactado estimado | 12 meses retidos |
|---|---|---|---|
| Site institucional, pouco tráfego | 40 MB | ~4 MB | ~48 MB |
| Blog com bots ativos | 400 MB | ~40 MB | ~480 MB |
| Loja com busca interna indexada | 1,5 GB | ~150 MB | ~1,8 GB |
Log de acesso é texto repetitivo e comprime muito bem, o que torna a retenção barata na maioria dos sites institucionais. O caso em que ela pesa é o terceiro: aí vale limitar a 6 meses, ou mover o arquivo para fora do servidor com rsync mensal.
E o lembrete contra o nosso próprio interesse: se o disco encheu por causa de ~/logs acumulado, o problema não é o plano, é a falta de limpeza. Apagar arquivos antigos resolve sem upgrade nenhum.
O que ainda dá para reconstruir quando o log já foi descartado
Nem tudo se perde junto com o log bruto. A ordem de busca que costuma render:
- Estatísticas processadas: na prática que vemos em servidores cPanel, Awstats e Webalizer guardam resumos mensais mesmo depois de o log bruto sumir, já que são gerados antes do descarte. Confirme no servidor em questão antes de prometer ao cliente. Não mostram IP por requisição, mas costumam mostrar picos de tráfego, user agents e URLs mais acessadas no mês do incidente.
- Logs de erro: ficam em
~/logsou na visão de Errors do cPanel e têm rotação própria, às vezes mais longa que a do access log. - Timestamps no sistema de arquivos:
find . -newermt '2026-10-01' ! -newermt '2026-10-05' -type fdentro do docroot mostra o que foi alterado na janela suspeita. - Banco do WordPress: tabela de posts com
post_modified, usuários criados fora do padrão, plugins instalados fora de ciclo.
Nenhum desses substitui o log. Todos juntos costumam bastar para datar o comprometimento e decidir o escopo da limpeza.
Checklist de padronização e o texto para enviar ao cliente
Checklist de padronização da retenção
- Definir a política de retenção por escrito e a data de vigência.
- Aplicar arquivamento em todas as contas da carteira, preferencialmente via WHM.
- Deixar desligada a remoção dos arquivos do mês anterior ao final do mês seguinte, quando o objetivo é histórico.
- Medir
du -sh /home/*/logs/a cada trimestre e podar o que passar do horizonte definido. - Incluir a retenção no contrato ou na proposta de manutenção, com o prazo explícito.
Frase pronta para explicar a perda e a correção
"O registro de acessos do site é apagado automaticamente depois que o servidor gera as estatísticas do período, que é o comportamento padrão do painel. A partir de hoje ativamos o arquivamento mensal, então passamos a guardar esse histórico por [X] meses. Para outubro, não existe mais log bruto, mas conseguimos reconstruir a linha do tempo pelas estatísticas do mês e pelas datas de alteração dos arquivos."
Diz a verdade, não culpa ninguém e já entrega a correção junto com o problema. Envie essa mensagem no mesmo e-mail em que você confirma que a configuração foi ligada.
Referências
- Documentação oficial (cpanel) — Web Log Retention (WHM). Consultado em 2026-10-09.