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

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

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

---

## 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_log` usados 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`, mais `exim_rejectlog` e `exim_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.

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

```bash
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](https://docs.cpanel.net/whm/service-configuration/log-rotation/), 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.
- `compress` com `delaycompress`: comprime as gerações antigas e deixa a mais recente intacta, o que evita comprimir um arquivo que o processo ainda pode tocar.
- `missingok` e `notifempty`: 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, prefira `postrotate` com o sinal adequado ao serviço.

Teste sempre em simulação antes de deixar no automático:

```bash
# 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 -h` e `df -i` registrados 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](https://docs.cpanel.net/whm/service-configuration/log-rotation/).
- 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.d` para os logs fora do painel.
- Rodar `logrotate -d` em 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:

> **** O site saiu do ar por falta de espaço em disco, mas não foi por causa dos seus arquivos. O servidor grava um registro de cada visita e de cada e-mail processado, e esses registros não tinham limite de tempo configurado. Já definimos rotação e prazo de descarte para cada tipo de registro, mantendo 90 dias dos logs de acesso, que são os que usamos em caso de invasão. O espaço voltou e o crescimento agora é controlado.

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.

