blog
Painéis

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.

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

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
  1. Por que o cPanel apaga o log bruto depois de gerar as estatísticas
  2. As duas opções que decidem se o log do mês sobrevive
  3. Ativar o arquivamento mensal dentro da conta, sem WHM
  4. Aplicar a mesma política de retenção em toda a carteira pela WHM
  5. Quanto disco a retenção consome, medido no próprio cliente
  6. O que ainda dá para reconstruir quando o log já foi descartado
  7. 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.

Ciclo de vida do log de acesso no cPanelRequisiçõesServidor grava o log brutoProcessamentoAwstats e Webalizer geram resumosDecisãoArquivar em ~/logs ou descartarResultadoHistórico guardado ou log perdido
Ciclo padrão do log de acesso no cPanel: sem arquivamento ligado, o bruto some após as estatísticas.

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:

  1. 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.
  2. Aplique em WHM > Account Functions > Web Log Retention para as contas existentes.
  3. Garanta que novas contas nasçam com a mesma política, para não criar duas gerações de servidor com comportamentos diferentes.
  4. 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:

Nenhum desses substitui o log. Todos juntos costumam bastar para datar o comprometimento e decidir o escopo da limpeza.

Ordem de busca sem o log brutoEstatísticas processadasPicos, user agents, URLs do mêsLogs de erroRotação própria, às vezes mais longaTimestamps dos arquivosfind com janela de datasBanco do WordPresspost_modified, usuários e pluginsLinha do tempoDatar e definir escopo da limpeza
Ordem de busca quando o log bruto já foi descartado. Nenhuma fonte substitui o log, mas juntas datam o comprometimento.

Checklist de padronização e o texto para enviar ao cliente

Checklist de padronização da retenção

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

  1. Documentação oficial (cpanel) — Web Log Retention (WHM). Consultado em 2026-10-09.
Leia também