Disco cheio no cPanel: os 3 logs que crescem sozinhos
Onde medir antes de apagar, qual tela do WHM cobre o quê, como escrever a regra em /etc/logrotate.d e a tabela de retenção para reusar em cada servidor.

Resposta curta: em servidor com cPanel, três caminhos respondem pela maior parte do disco consumido sem o cliente subir arquivo: /usr/local/apache/domlogs, o error_log do servidor web e o /var/log/exim_mainlog. Todos crescem sem limite até alguém definir rotação e retenção.
Neste artigo
- Os três diretórios que enchem o disco sem o cliente subir nada
- Como medir qual log está grande antes de apagar qualquer coisa
- O que o WHM rotaciona sozinho e o que fica por sua conta
- Como escrever uma regra em /etc/logrotate.d e testar com logrotate -d
- Quanto tempo guardar cada tipo de log, e por quê
- Os quatro erros que se repetem na rotação de log
- Como padronizar a rotação em todos os servidores que você administra
- A mensagem pronta para explicar o disco cheio ao cliente
Os três diretórios que enchem o disco sem o cliente subir nada
Quando o alerta de disco chega e o du do /home do cliente não mudou de tamanho em semanas, o espaço quase sempre está em log de serviço, não em arquivo de site. Três lugares respondem pela maior parte disso em servidor com cPanel/WHM:
- Logs de acesso por domínio: ficam em
/usr/local/apache/domlogs(ou/etc/apache2/logs/domlogs, conforme a versão e se o servidor usa LiteSpeed sobre a configuração do Apache). Um arquivo por domínio, mais os-bytes_logusados pela contabilidade de banda. - Error log do servidor web:
/usr/local/apache/logs/error_log. Cresce rápido quando um site PHP está emitindo notice/warning em produção, e cresce muito rápido quando um plugin entra em loop. - Mainlog do Exim:
/var/log/exim_mainlog, maisexim_rejectlogeexim_paniclog. Em servidor que envia newsletter ou que está sendo usado para spam, é o arquivo que cresce em ordem de grandeza.
Fora desses, dois acumuladores silenciosos: o diretório de estatísticas (Webalizer/AWStats) dentro de /home/usuario/tmp, que guarda histórico mensal por anos, e os logs do ModSecurity.
Como medir qual log está grande antes de apagar qualquer coisa
A ordem importa: medir, decidir retenção, só então mexer. Apagar primeiro é o jeito mais rápido de perder justamente o log que você precisaria para explicar ao cliente por que o site caiu.
# Maiores diretórios na raiz, 1 nível
du -sh /* 2>/dev/null | sort -h | tail -15
# Dentro dos candidatos
du -sh /var/log/* | sort -h | tail -10
du -sh /usr/local/apache/logs/* | sort -h | tail -10
# Os 20 maiores domlogs
du -ah /usr/local/apache/domlogs | sort -h | tail -20
# Espaço e inodes
df -h
df -i
Se df -h mostra disco cheio mas du não encontra o volume, provavelmente alguém já apagou um log que ainda está aberto por um processo. O espaço só volta quando o processo solta o descritor:
lsof +L1 | head -20
Esse comando lista arquivos deletados que ainda têm handle aberto. É o sintoma clássico de rm em log ativo, e a correção é reiniciar o serviço dono do arquivo, não apagar mais nada.
O que o WHM rotaciona sozinho e o que fica por sua conta
O WHM tem a tela Log Rotation Configuration, em *Service Configuration*, que controla quais logs do servidor entram na rotação feita pelo cPanel. Segundo a documentação oficial do cPanel, nessa interface você marca os arquivos de log que deseja rotacionar e define as opções de rotação aplicadas a eles, e o próprio cPanel executa a rotação dos itens selecionados.
Na prática isso divide o trabalho em duas partes:
| Camada | Onde se configura | O que cobre |
|---|---|---|
| Logs de serviço do cPanel | WHM › Service Configuration › Log Rotation | Arquivos listados pela própria interface, marcados um a um |
| Logs de acesso por domínio | WHM › Server Configuration › Statistics Software Configuration | Geração das estatísticas a partir dos domlogs |
| Qualquer outro arquivo | /etc/logrotate.d/ |
Logs de aplicação, cron de cliente, ModSecurity, scripts próprios |
A pegadinha de agência é a segunda linha, e aqui vale a ressalva: a documentação de Log Rotation do WHM trata dos arquivos marcados naquela interface, não do ciclo de vida dos domlogs. O que segue é observação de operação, não comportamento documentado. Na prática, quando o processamento de estatísticas está desligado ou falhando, o domlog fica sem ser consumido e continua crescendo. Antes de escrever regra nova, confirme nessa tela se as estatísticas estão rodando para as contas que você administra, e confira o tamanho real dos arquivos em domlogs com o du da seção anterior.
Como escrever uma regra em /etc/logrotate.d e testar com logrotate -d
Para o que o painel não cobre, o caminho é um arquivo em /etc/logrotate.d. Antes de criar a regra, confirme que ninguém já rotaciona aquele arquivo: a tela Log Rotation do WHM para os logs de serviço do cPanel, e os arquivos que já vêm em /etc/logrotate.d com o sistema. Duas regras sobre o mesmo log geram rotação dupla, truncamento fora de hora e estado conflitante em logrotate.status. Regra própria só para log que está fora dessas duas listas.
Exemplo fictício, para um log de aplicação de cliente:
# /etc/logrotate.d/app-cliente (exemplo)
/home/cliente/logs/app.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
copytruncate
su cliente cliente
}
O que cada diretiva resolve:
daily/rotate 14: frequência e quantas gerações ficam. Catorze arquivos diários é o exemplo, não uma regra universal.compresscomdelaycompress: comprime as gerações antigas e deixa a mais recente intacta, o que evita comprimir um arquivo que o processo ainda pode tocar.missingokenotifempty: a regra não falha se o arquivo sumir e não gera rotação de arquivo vazio.copytruncate: copia o conteúdo e trunca o original em vez de renomear. Use quando a aplicação não sabe reabrir o arquivo. Quando ela sabe, prefirapostrotatecom o sinal adequado ao serviço.
Teste sempre em simulação antes de deixar no automático:
# Simula sem alterar nada e mostra o raciocínio
logrotate -d /etc/logrotate.d/app-cliente
# Força a execução real daquela regra
logrotate -vf /etc/logrotate.d/app-cliente
# Confere o estado registrado
grep app.log /var/lib/logrotate/logrotate.status
O -d não escreve nada: ele imprime o que faria. Se a saída diz "log does not need rotating" quando você esperava rotação, o problema é critério (tamanho, data) e não permissão. Se ela reclama de dono do diretório, resolva com su na regra em vez de afrouxar permissão do /home.
Quanto tempo guardar cada tipo de log, e por quê
Esta é a tabela que vale copiar para cada servidor novo. Os prazos são critério editorial de operação, não parâmetro imposto pelo painel: ajuste para o compromisso contratual do cliente e para o disco disponível.
| Log | Caminho típico | Retenção sugerida | Por quê |
|---|---|---|---|
| Acesso por domínio | /usr/local/apache/domlogs/ |
90 dias comprimido | Reconstruir invasão e auditar bot exige janela longa |
| ModSecurity | /usr/local/apache/logs/modsec_audit.log |
90 dias comprimido | Correlacionar regra disparada com o acesso que a disparou |
| Error log web | /usr/local/apache/logs/error_log |
14 a 30 dias | Diagnóstico é recente; volume alto |
| Exim mainlog | /var/log/exim_mainlog |
30 dias | Rastrear entrega e abuso de conta |
| Exim reject/panic | /var/log/exim_rejectlog, exim_paniclog |
30 dias | Pequenos, úteis em disputa de entregabilidade |
| Estatísticas (archive) | /home/*/tmp/ |
12 meses | Histórico de tráfego raramente é consultado além disso |
| Log de aplicação do cliente | definido no projeto | 14 dias | Quem precisa de mais manda para fora do servidor |
Acesso e ModSecurity recebem retenção maior porque são os únicos que respondem "quando começou e por onde entrou". Sem a janela longa, a investigação de um site comprometido termina em suposição. Error log e mainlog, ao contrário, só interessam enquanto o problema está acontecendo, e são justamente os que mais engordam.
Os quatro erros que se repetem na rotação de log
Apagar o arquivo aberto não devolve espaço
rm no error_log ou no exim_mainlog com o serviço rodando não devolve espaço. O inode continua alocado enquanto o processo mantém o descritor. Use : > arquivo para zerar mantendo o inode, ou deixe o logrotate fazer com copytruncate.
Sem postrotate, o log novo fica zerado para sempre
Se a regra renomeia o arquivo mas o serviço não é avisado, ele continua escrevendo no arquivo antigo (agora renomeado) e o novo fica em zero byte para sempre. O sintoma é log que "parou" depois que alguém mexeu na rotação. Corrija com copytruncate ou com um bloco postrotate que sinalize o serviço.
O archive de estatísticas que acumula anos dentro do tmp da conta
O histórico de Webalizer/AWStats fica no tmp da conta e não aparece no gerenciador de arquivos do cliente. Em servidor com muitas contas antigas, é o acúmulo mais invisível da lista.
Regra escrita e nunca testada pode abortar o logrotate inteiro
Arquivo em /etc/logrotate.d com erro de sintaxe pode fazer o logrotate abortar a execução. Rode logrotate -d depois de qualquer edição e releia a saída inteira, não só a última linha.
Como padronizar a rotação em todos os servidores que você administra
Transforme em checklist de implantação, aplicado uma vez por servidor novo e revisado por trimestre:
df -hedf -iregistrados como linha de base, com data.- Conferir em WHM › Service Configuration › Log Rotation quais logs estão marcados para rotação, conforme a documentação do cPanel.
- Conferir em Statistics Software Configuration se o processamento de estatísticas está ativo para as contas administradas.
- Aplicar o arquivo padrão da agência em
/etc/logrotate.dpara os logs fora do painel. - Rodar
logrotate -dem cada arquivo novo e guardar a saída no ticket interno do projeto. - Agendar um alerta de disco em 80% em vez de descobrir em 100%.
Guarde o arquivo padrão da agência em /etc/logrotate.d em um repositório versionado, com um arquivo por tipo de serviço. Copiar um arquivo testado para o servidor seguinte custa dois minutos; descobrir de novo quais diretivas funcionam custa uma tarde.
A mensagem pronta para explicar o disco cheio ao cliente
Quando o site cai por disco cheio e o cliente jura que não subiu nada, a explicação precisa caber em uma mensagem. Sugestão pronta, adapte os nomes:
Funciona porque não culpa ninguém, nomeia a causa real e já entrega a correção aplicada. Guarde como template: a mesma mensagem serve para o próximo cliente.
Nota de transparência: os caminhos, prazos e linhas de configuração deste guia são exemplos e critérios operacionais. A referência citada para as telas do WHM é a documentação oficial do cPanel. Não há medição própria da Napoleon Host neste tema.
Referências
- Documentação oficial (cpanel) — Log Rotation. Consultado em 2026-09-24.