Tutoriais de VPS
Configurar logrotate: retenção, copytruncate e logs do Docker
Entenda retenção por rotações, regras de tempo e tamanho, a janela de perda do copytruncate, nomes com data e reabertura. Verifique execuções manuais e agendadas, limite journald e Docker e investigue falhas por disco cheio.

Se df -h mostra o sistema de arquivos cheio e /var/log concentra arquivos grandes, descubra primeiro quem os está escrevendo. Logs sem limites são uma possibilidade; journal, armazenamento do Docker e arquivos apagados ainda abertos exigem abordagens diferentes.
O logrotate arquiva arquivos de log comuns quando um agendador o executa. Ele não fica observando o tamanho em tempo real. Este guia explica as regras, a diferença entre renomear e copiar/truncar e os controles próprios de Docker e journald.
# 系统自带的配置(不要改这些,它们是发行版维护的)
ls /etc/logrotate.d/
# 全局默认值
cat /etc/logrotate.conf
# 查看某个配置的最终生效结果(最有用的命令)
logrotate -d /etc/logrotate.d/nginx
-d é o modo de depuração: mostra decisões sem rotacionar arquivos nem atualizar o estado. Uma regra executada isoladamente pode não herdar as opções globais; confira também a configuração completa usada pelo agendador.
Os comandos abaixo realmente processam os logs. A opção de forçar ignora as condições normais; planeje qualquer recarga ou reabertura que possa afetar o serviço:
# 强制执行一次(测试用,会真的转)
sudo logrotate -f /etc/logrotate.d/myapp
# 只看某个文件的详细信息
sudo logrotate -v /etc/logrotate.d/myapp
Em /etc/logrotate.d/ há regras mantidas por pacotes como apt, dpkg, nginx e rsyslog. Prefira um arquivo próprio para sua aplicação. Evite alterar arquivos do fornecedor ou criar duas regras para o mesmo log.
/var/log/myapp/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data adm
sharedscripts
postrotate
systemctl reload myapp > /dev/null 2>&1 || true
endscript
}
| Diretiva | Função |
|---|---|
/var/log/myapp/*.log | Arquivos gerenciados; o curinga pode selecionar vários |
daily | Elegibilidade diária, verificada durante a execução |
rotate 14 | Conserva 14 arquivos rotacionados |
compress | Comprime os arquivos arquivados |
delaycompress | Adia a compressão por uma rotação |
missingok | Não gera erro se o arquivo estiver ausente |
notifempty | Pula logs vazios |
create 0640 www-data adm | Cria o novo arquivo com essas permissões e proprietários |
postrotate...endscript | Executa o script após a rotação |
rotate N conta arquivos rotacionados, não dias. daily com rotate 14 geralmente corresponde a cerca de 14 rotações diárias, mas execuções atrasadas ou arquivos vazios impedem garantir exatamente 14 dias. weekly com rotate 14 representa cerca de 14 semanas, aproximadamente três meses.
compress com delaycompress ajuda quando um processo demora a parar de escrever no arquivo renomeado. A compressão não deve disputar esse arquivo com o escritor. No modo copytruncate, o processo mantém o inode original; adiar a compressão não elimina a janela de perda entre copiar e truncar.
notifempty evita arquivos vazios arquivados; ifempty permite rotacioná-los. missingok tolera um arquivo ausente, enquanto nomissingok informa o problema. Um erro de logrotate pode ser útil quando um serviço ativo deveria sempre produzir aquele log.
Configure create de acordo com o usuário e grupo reais. Por exemplo, www-data pode precisar escrever com permissões 0640. Confira também o diretório: as permissões do arquivo não resolvem a falta de acesso ao caminho.
A rotação normal renomeia app.log para algo como app.log.1, cria um substituto e usa postrotate para pedir a reabertura. Sem suporte a essa operação, o programa pode continuar escrevendo no arquivo renomeado.
copytruncate copia o conteúdo e trunca o arquivo original, preservando o inode e o descritor do escritor. As gravações entre a cópia e o truncamento podem ser perdidas. Para auditoria que exige registros completos, prefira a reabertura suportada pela aplicação.
| Serviço | Mecanismo habitual; confirme a instalação |
|---|---|
| Nginx | nginx -s reopen ou kill -USR1 $(cat /run/nginx.pid) |
| Apache | apachectl graceful |
| PHP-FPM | kill -USR1 $(cat /run/php/php8.3-fpm.pid), ajustando o caminho do PID à versão |
| Serviço próprio | Implementar SIGHUP ou uma ação systemctl reload funcional |
Reserve copytruncate para programas que realmente não consigam reabrir e documente o motivo. A diretiva create não atua com copytruncate, pois o arquivo original permanece.
| Configuração | Condição durante a execução |
|---|---|
size 100M | Apenas tamanho; exclui o intervalo temporal e prevalece a diretiva aplicável posterior |
daily com maxsize 100M | Rotação diária ou antecipada se ultrapassar 100M |
daily com minsize 100M | Exige tanto o intervalo quanto o tamanho mínimo |
- Volume estável e arquivos periódicos:
dailyouweekly. - Crescimento variável:
dailycommaxsize 500M. - Pouco volume:
weeklycomminsize 1M.
size 10M não impõe um limite contínuo de 10M. Com execução diária, o arquivo pode crescer muito além disso antes da próxima verificação. Um agendamento mais frequente permite mais rotações por tamanho; evite sobreposição, use o estado apropriado e nomes que não colidam em rotações no mesmo dia.
Reduza também o excesso de mensagens na aplicação. As opções RateLimit do journald e max-size do Docker controlam caminhos diferentes. Use o guia de diagnóstico de logs para localizar o serviço que está produzindo o volume.
app.log.1 e app.log.2.gz indicam a ordem de rotação. .3.gz não significa necessariamente três dias atrás quando houve execuções puladas ou rotações por tamanho.
dateext acrescenta uma data:
/var/log/myapp/*.log {
daily
dateext
dateformat -%Y%m%d
rotate 30
}
Nomes como app.log-20260929 e app.log-20260928 facilitam a busca por dia. Em dateformat, opções suportadas incluem %Y, %m, %d e %s. Consulte o manual instalado: o formato é limitado e não aceita necessariamente tudo de strftime. Preserve a ordenação cronológica por nome e evite : em dateformat quando a portabilidade importar.
dateyesterday usa a data do dia anterior. dateyesterday pode fazer sentido ao arquivar depois da meia-noite os logs de ontem, conforme o horário real. Um sufixo apenas diário pode colidir se houver várias rotações na mesma data.
Renomear um arquivo não prova que as próximas mensagens serão escritas no substituto:
/var/log/nginx/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data adm
sharedscripts
postrotate
[ -f /run/nginx.pid ] && kill -USR1 $(cat /run/nginx.pid)
endscript
}
sharedscripts faz postrotate executar uma vez para o conjunto selecionado por *.log, em vez de uma vez por arquivo. Com sharedscripts, confira se o script trata corretamente todo o grupo.
A condição [ -f /run/nginx.pid ] && evita enviar kill sem o arquivo PID, mas pode retornar um código de falha quando a condição for falsa. Use um condicional explícito para um serviço que esteja parado conforme esperado e mantenha observáveis os erros inesperados de reabertura. endscript deve ficar em sua própria linha.
sudo logrotate -d /etc/logrotate.d/myapp
Observe o estado da última rotação, a condição avaliada e o nome planejado. Os exemplos abaixo contrastam uma execução pulada com uma rotação prevista:
considering log /var/log/myapp/app.log
Now: 2026-09-29 03:00
Last rotated at 2026-09-28 03:00
log does not need rotating (log has already been rotated)
rotating log /var/log/myapp/app.log, log->rotateCount is 14
renaming /var/log/myapp/app.log.14.gz to /var/log/myapp/app.log.15.gz
...
Uma mensagem renaming na depuração descreve a ação planejada; não indica que o arquivo foi alterado. Após uma execução real deliberada, confira conteúdo, proprietário e novas escritas da aplicação.
# 一次检查所有配置(dry-run,不改动任何东西)
sudo logrotate -d /etc/logrotate.conf 2>&1 | less
Alguns sistemas registram erros de logrotate em /var/log/syslog:
grep logrotate /var/log/syslog | tail -20
Em outros, consulte journalctl -u logrotate.service. Erros comuns incluem sintaxe, permissões e retorno diferente de zero do script postrotate.
Os registros exibidos por journalctl usam a retenção do journald:
# 看当前占用
journalctl --disk-usage
# 手动清理到 500M
sudo journalctl --vacuum-size=500M
# 按时间清理
sudo journalctl --vacuum-time=7d
A limpeza remove arquivos journal arquivados, não necessariamente o arquivo ativo. Rotacione antes quando necessário e preserve os registros exigidos para investigação ou retenção.
sudo sed -i 's/^#\?SystemMaxUse=.*/SystemMaxUse=500M/' /etc/systemd/journald.conf
sudo systemctl restart systemd-journald
Esse sed só altera uma linha que já corresponda ao padrão. Se ela não existir, acrescente a opção explicitamente, de preferência em um arquivo adicional de configuração do journald, e reinicie o serviço de forma planejada.
| Opção | Função |
|---|---|
SystemMaxUse= | Orçamento do journal persistente |
SystemKeepFree= | Espaço que deve permanecer livre |
MaxRetentionSec= | Idade máxima, como 1month |
SystemMaxFileSize= | Tamanho máximo de cada arquivo journal |
SystemMaxUse é útil, mas não é o único controle válido. Os padrões dependem de porcentagens e da distribuição; o armazenamento volátil usa RuntimeMaxUse. Limitar a taxa de mensagens não substitui um orçamento de disco.
docker logs consulta o driver de logs do Docker, não a regra de um arquivo comum da aplicação:
# 看哪个容器占得最多
sudo du -sh /var/lib/docker/containers/*/*-json.log | sort -h | tail -10
Essa inspeção de caminhos se aplica a json-file, não a todos os drivers ou diretórios rootless. Não edite diretamente os logs ativos gerenciados pelo Docker.
Integre as opções em /etc/docker/daemon.json, preservando as outras configurações:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "5"
}
}
sudo systemctl restart docker
Reiniciar o Docker pode afetar os serviços. max-size e max-file dão um orçamento aproximado de 20M por arquivo e 5 arquivos, cerca de 100M por contêiner, com variações de implementação e rotação. Contêineres existentes mantêm as opções usadas na criação; docker compose up -d --force-recreate recria para aplicar as novas. Confirme antes os dados persistentes.
Também é possível definir por serviço no Compose:
services:
app:
logging:
driver: json-file
options:
max-size: "20m"
max-file: "5"
Veja limpeza do disco do Docker para diagnosticar outras camadas e arquivos antigos.
Alguns serviços Java e bibliotecas já rotacionam seus próprios arquivos. Escolha um responsável para cada log, evitando dois mecanismos que disputem o mesmo arquivo.
/var/log/nginx/*.log {
daily
rotate 14
compress
delaycompress
missingok
notifempty
create 0640 www-data adm
sharedscripts
prerotate
if [ -d /etc/logrotate.d/httpd-prerotate ]; then \
run-parts /etc/logrotate.d/httpd-prerotate; \
fi
endscript
postrotate
[ -f /run/nginx.pid ] && kill -USR1 $(cat /run/nginx.pid)
endscript
}
Confira ls /etc/logrotate.d/ | grep nginx antes de criar outra regra. O pacote geralmente fornece uma; verifique PID, proprietários e reabertura. A condição do exemplo precisa do tratamento de serviço parado explicado anteriormente.
/srv/app/shared/logs/*.log {
daily
rotate 30
dateext
dateformat -%Y%m%d
compress
delaycompress
missingok
notifempty
create 0640 appuser appuser
sharedscripts
postrotate
systemctl reload myapp > /dev/null 2>&1 || true
endscript
}
|| true no final de postrotate suprime falhas de systemctl reload. || true também pode esconder um erro real. Prefira reconhecer explicitamente um serviço inativo esperado e deixar os demais erros visíveis.
/var/log/bigapp/*.log {
daily
maxsize 500M
rotate 7
compress
copytruncate
notifempty
}
daily com maxsize 500M permite antecipar a rotação por tamanho na próxima execução, não imediatamente ao chegar a 500M. A janela de perda do copytruncate continua existindo.
# 强制转一次(不管条件是否满足)
sudo logrotate -f /etc/logrotate.d/myapp
# 只看会不会转,不实际执行
sudo logrotate -d /etc/logrotate.d/myapp
# 详细模式,实际执行
sudo logrotate -v /etc/logrotate.d/myapp
-f serve para uma verificação real planejada ou uma rotação urgente depois de conferir o espaço. Repetir -f consome rapidamente as cópias retidas e ignora a condição daily. Copiar e comprimir pode precisar de espaço adicional.
Novo arquivo não foi criado: confira create e se a aplicação cria o próprio log. copytruncate conserva o arquivo original.
A aplicação ainda escreve no arquivo arquivado: postrotate não provocou a reabertura, ou o PID/sinal está errado. Confira as novas mensagens e o mecanismo suportado.
Arquivos demais: examine rotate, padrões globais e regras duplicadas. Zero significa nenhuma rotação retida, mas o arquivo global pode substituir esse padrão. rotate 52 são 52 rotações, não necessariamente um ano. compress economiza espaço conforme a compressibilidade.
logrotate: error: stat of /path failed: No such file or directory: verifique o caminho; use missingok se a ausência for esperada.
error: skipping "/path" because parent directory has insecure permissions: examine proprietário e permissões do diretório. 755 pode atender alguns casos; um diretório gravável pelo usuário da aplicação pode precisar de uma diretiva su correta, sem mudanças indiscriminadas de propriedade.
Não executa: confira o agendador real:
systemctl list-timers | grep logrotate
cat /etc/cron.daily/logrotate
Algumas instalações Debian/Ubuntu usam timer; outras usam /etc/cron.daily/logrotate, que pode pular a tarefa quando systemd já a executa. Evite agendamentos duplicados e consulte cron e timers. Não há um daemon logrotate para reiniciar: ele lê a configuração a cada execução.
/var/log já está cheio: identifique arquivos descartáveis e preserve evidências do incidente. O exemplo de emergência contém exclusão; liste e revise as correspondências antes de usar delete. Mais de 30 dias não torna todo log descartável.
1. 先清出空间(不然什么操作都可能失败)
sudo journalctl --vacuum-size=200M
sudo find /var/log -name "*.gz" -mtime +30 -delete
2. 再配好 logrotate 防止复发
Siga a ordem de recuperação de disco cheio. A limpeza do journal pode não liberar o arquivo ativo, e uma rotação baseada em cópia pode precisar de espaço primeiro.
Apagou e não liberou espaço: identifique o processo que mantém o arquivo aberto:
# 找出持有已删除文件的进程
sudo lsof +L1 | head -20
# 正确的做法是重启那个服务,让它重新打开日志
sudo systemctl restart myapp
Evite rm em logs ativos. truncate -s 0 destrói o conteúdo atual e não é uma política de retenção. Use reabertura/rotação ou reinicie deliberadamente o serviço depois de preservar os registros necessários.
Partição separada: isolar /var/log pode proteger a raiz, mas ainda exige limites e alertas. Em uma VPS pequena, uma rotação funcional e SystemMaxUse podem bastar.
- Regras próprias em
/etc/logrotate.d/, sem caminhos duplicados. -
rotate Ntratado como quantidade de rotações. -
postrotatereabre os logs corretamente. -
sharedscriptsquando o script atua sobre um grupo. -
missingokenotifemptyescolhidos conforme a aplicação. -
create, proprietários e acesso ao diretório conferidos. - Decisões de
logrotate -drevisadas. - Orçamento do journald, incluindo
SystemMaxUsepara persistência. -
max-sizeemax-fileconfigurados no Docker. - Alertas de disco e tráfego ativos.
A retenção limita o crescimento; alertas detectam regras que falharam e novas fontes de volume. Verifique os dois mecanismos.