blog
Servidores

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.

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

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
  1. Os três diretórios que enchem o disco sem o cliente subir nada
  2. Como medir qual log está grande antes de apagar qualquer coisa
  3. O que o WHM rotaciona sozinho e o que fica por sua conta
  4. Como escrever uma regra em /etc/logrotate.d e testar com logrotate -d
  5. Quanto tempo guardar cada tipo de log, e por quê
  6. Os quatro erros que se repetem na rotação de log
  7. Como padronizar a rotação em todos os servidores que você administra
  8. 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:

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.

Diagnóstico de disco cheio antes de apagarMedir o discodf -h e df -i primeiroLocalizar o volumedu nos diretórios candidatosdu não acha nada?lsof +L1 mostra log deletadoArquivo ainda abertoreiniciar o serviço donoDecidir retençãosó então mexer no arquivo
Ordem de diagnóstico antes de apagar qualquer log. Apagar primeiro costuma destruir a evidência que explicaria a queda ao cliente.

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:

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.

Da regra nova à rotação validadaChecar duplicidadeWHM e /etc/logrotate.dEscrever a regraum arquivo por serviçoSimularlogrotate -d, ler a saída inteiraForçar uma vezlogrotate -vf na regraConferir estadogrep no logrotate.status
Ciclo de implantação de uma regra nova. A simulação é o passo que impede erro de sintaxe abortar o logrotate inteiro.

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:

  1. df -h e df -i registrados como linha de base, com data.
  2. Conferir em WHM › Service Configuration › Log Rotation quais logs estão marcados para rotação, conforme a documentação do cPanel.
  3. Conferir em Statistics Software Configuration se o processamento de estatísticas está ativo para as contas administradas.
  4. Aplicar o arquivo padrão da agência em /etc/logrotate.d para os logs fora do painel.
  5. Rodar logrotate -d em cada arquivo novo e guardar a saída no ticket interno do projeto.
  6. 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

  1. Documentação oficial (cpanel) — Log Rotation. Consultado em 2026-09-24.
Leia também