Tutoriales de VPS
Configurar logrotate: retención, copytruncate y registros Docker
Comprende la retención por rotaciones, las reglas de tiempo y tamaño, la pérdida posible con copytruncate, las fechas y la reapertura. Verifica ejecuciones manuales y programadas, limita journald y Docker y diagnostica fallos de disco lleno.

Si df -h muestra un sistema de archivos lleno y /var/log contiene archivos enormes, identifica primero quién los escribe. Los registros sin límites son una causa posible; el journal, el almacenamiento de Docker y los archivos borrados que siguen abiertos requieren tratamientos distintos.
logrotate archiva registros de texto cuando lo ejecuta un temporizador o cron. No vigila continuamente el tamaño de los archivos. Aquí explicamos las reglas, el coste de copiar y truncar, y los controles independientes de Docker y journald.
# 系统自带的配置(不要改这些,它们是发行版维护的)
ls /etc/logrotate.d/
# 全局默认值
cat /etc/logrotate.conf
# 查看某个配置的最终生效结果(最有用的命令)
logrotate -d /etc/logrotate.d/nginx
-d activa el modo de depuración: muestra las decisiones sin rotar archivos ni actualizar el estado. Una regla ejecutada por separado puede no heredar los valores del archivo global; revisa también la configuración completa.
Estos comandos sí procesan registros. La opción de forzar omite las condiciones normales; planifica cualquier reapertura o recarga que pueda afectar al servicio:
# 强制执行一次(测试用,会真的转)
sudo logrotate -f /etc/logrotate.d/myapp
# 只看某个文件的详细信息
sudo logrotate -v /etc/logrotate.d/myapp
En /etc/logrotate.d/ suele haber reglas de paquetes como apt, dpkg, nginx y rsyslog. Crea una regla propia para tu aplicación, evitando modificar archivos del proveedor o gestionar dos veces el mismo registro.
/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
}
| Directiva | Función |
|---|---|
/var/log/myapp/*.log | Archivos que se gestionan; admite varios mediante comodín |
daily | Condición diaria, evaluada cuando se ejecuta logrotate |
rotate 14 | Conserva 14 archivos rotados |
compress | Comprime los archivos rotados |
delaycompress | Retrasa la compresión una rotación |
missingok | No falla si el archivo no existe |
notifempty | Omite archivos vacíos |
create 0640 www-data adm | Crea el nuevo archivo con esos permisos y propietarios |
postrotate...endscript | Ejecuta el script posterior a la rotación |
rotate N cuenta archivos rotados, no días. daily con rotate 14 suele equivaler a unas 14 rotaciones diarias, pero ejecuciones omitidas y archivos vacíos impiden prometer exactamente 14 días. weekly con rotate 14 representa unas 14 semanas, aproximadamente tres meses.
compress junto con delaycompress resulta útil cuando un proceso tarda en dejar de escribir en el archivo renombrado. No comprimas mientras siga usándolo. En modo copytruncate, el escritor conserva el archivo original; retrasar la compresión no elimina el intervalo en que copiar y truncar puede perder datos.
notifempty evita archivos rotados vacíos; ifempty permite rotarlos. missingok tolera un archivo ausente y nomissingok lo considera un error. Una advertencia de logrotate puede ser deseable si un servicio activo debería estar creando el registro.
Configura create para el usuario y grupo reales. Por ejemplo, www-data puede necesitar escribir con permisos 0640. Comprueba también el acceso al directorio; los permisos del archivo no bastan si el proceso no puede llegar a él.
La rotación normal renombra app.log a un archivo como app.log.1, crea su sustituto y utiliza postrotate para que la aplicación lo abra. Si el programa no admite reapertura, continuará escribiendo en el archivo renombrado.
copytruncate copia el contenido y trunca el original, manteniendo el mismo inode y descriptor. Las escrituras entre la copia y el truncado pueden perderse. Para registros de auditoría completos, usa una reapertura compatible.
| Servicio | Mecanismo habitual; verifica tu instalación |
|---|---|
| Nginx | nginx -s reopen o kill -USR1 $(cat /run/nginx.pid) |
| Apache | apachectl graceful |
| PHP-FPM | kill -USR1 $(cat /run/php/php8.3-fpm.pid), adaptando la ruta del PID a la versión |
| Servicio propio | Implementar SIGHUP o una acción systemctl reload funcional |
Reserva copytruncate para aplicaciones que realmente no puedan reabrir y documenta el motivo. La directiva create no actúa con copytruncate, porque el archivo original permanece.
| Configuración | Condición al ejecutarse el programa |
|---|---|
size 100M | Solo tamaño; excluye el intervalo temporal y prevalece la directiva aplicable posterior |
daily más maxsize 100M | Rotación diaria o antes si supera 100M |
daily más minsize 100M | Deben cumplirse el intervalo y el tamaño mínimo |
- Volumen estable y archivo periódico:
dailyoweekly. - Crecimiento variable:
dailyconmaxsize 500M. - Pocos registros:
weeklyconminsize 1M.
size 10M no establece un límite continuo de 10M. Si la tarea corre una vez al día, el archivo puede superar ampliamente esa cifra antes de la siguiente revisión. Un horario más frecuente permite rotaciones por tamaño más frecuentes; evita ejecuciones simultáneas, utiliza el estado adecuado y nombres que no colisionen.
Reduce también el volumen en la aplicación. Las opciones RateLimit de journald y max-size de Docker controlan rutas distintas. Identifica primero el servicio ruidoso con la guía de registros.
app.log.1 y app.log.2.gz indican el orden de rotación. .3.gz no significa necesariamente «hace tres días» si hubo saltos o rotaciones adicionales por tamaño.
Con dateext puedes añadir la fecha:
/var/log/myapp/*.log {
daily
dateext
dateformat -%Y%m%d
rotate 30
}
Los nombres app.log-20260929 y app.log-20260928 facilitan buscar por día. dateformat admite opciones como %Y, %m, %d y %s. Consulta el manual instalado: no admite necesariamente todos los formatos de strftime. Mantén un orden de fecha que se pueda ordenar alfabéticamente y evita : en dateformat cuando importe la portabilidad.
dateyesterday usa la fecha del día anterior. dateyesterday puede encajar si archivas después de medianoche lo escrito ayer, según el horario real. Un sufijo que solo contiene el día puede colisionar con varias rotaciones en esa fecha.
Renombrar correctamente no demuestra que las nuevas escrituras lleguen al archivo sustituto:
/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 hace que postrotate se ejecute una vez para el conjunto de *.log, en vez de una vez por archivo. Con sharedscripts, comprueba que el script sirve para todo el grupo.
La comprobación [ -f /run/nginx.pid ] && evita enviar kill sin un archivo PID, pero puede devolver un estado distinto de cero cuando la condición sea falsa. Usa un condicional explícito para un servicio detenido previsto y deja visibles los errores inesperados de reapertura. endscript debe ocupar su propia línea.
sudo logrotate -d /etc/logrotate.d/myapp
Revisa la última rotación, la condición evaluada y el nombre previsto. Estos ejemplos muestran una rotación omitida y una planificada:
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
...
renaming en depuración describe una operación prevista; no demuestra que el archivo haya cambiado. Después de una ejecución real deliberada, verifica contenido, propietario y nuevas escrituras.
# 一次检查所有配置(dry-run,不改动任何东西)
sudo logrotate -d /etc/logrotate.conf 2>&1 | less
Algunos sistemas escriben los errores de logrotate en /var/log/syslog:
grep logrotate /var/log/syslog | tail -20
En otros consulta journalctl -u logrotate.service. Los fallos habituales son sintaxis, permisos y scripts postrotate con salida distinta de cero.
Los registros que muestra journalctl tienen retención independiente:
# 看当前占用
journalctl --disk-usage
# 手动清理到 500M
sudo journalctl --vacuum-size=500M
# 按时间清理
sudo journalctl --vacuum-time=7d
La limpieza elimina archivos journal archivados, no necesariamente el activo. Rota antes cuando corresponda y conserva la información necesaria para incidentes o requisitos de retención.
sudo sed -i 's/^#\?SystemMaxUse=.*/SystemMaxUse=500M/' /etc/systemd/journald.conf
sudo systemctl restart systemd-journald
Ese sed solo modifica una línea que ya coincida. Si no existe, añade explícitamente la opción, preferiblemente en un archivo de configuración adicional de journald, y reinicia el servicio de forma planificada.
| Opción | Función |
|---|---|
SystemMaxUse= | Presupuesto del journal persistente |
SystemKeepFree= | Espacio que debe quedar libre |
MaxRetentionSec= | Edad máxima, por ejemplo 1month |
SystemMaxFileSize= | Tamaño máximo de cada archivo journal |
SystemMaxUse es útil, pero no es el único control válido. Los valores predeterminados dependen de porcentajes y de la distribución; el almacenamiento volátil utiliza RuntimeMaxUse. Limitar la frecuencia de mensajes no sustituye un presupuesto de disco.
docker logs utiliza el driver de Docker, no la regla de un archivo normal de tu aplicación:
# 看哪个容器占得最多
sudo du -sh /var/lib/docker/containers/*/*-json.log | sort -h | tail -10
Esa búsqueda corresponde a json-file, no a todos los drivers ni a todas las rutas de Docker rootless. No modifiques directamente los registros activos gestionados por Docker.
Integra las opciones en /etc/docker/daemon.json sin borrar otros ajustes del daemon:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "5"
}
}
sudo systemctl restart docker
Reiniciar Docker puede afectar a los servicios. max-size y max-file dan un presupuesto aproximado de 20M por archivo y 5 archivos, unos 100M por contenedor, con margen para la implementación. Los contenedores existentes conservan sus ajustes originales; docker compose up -d --force-recreate los recrea para aplicar los nuevos. Verifica primero los datos persistentes.
También puedes configurar cada servicio en Compose:
services:
app:
logging:
driver: json-file
options:
max-size: "20m"
max-file: "5"
Consulta limpieza del disco de Docker para otras capas y archivos antiguos.
Algunos servicios Java y bibliotecas ya rotan sus archivos. Elige un responsable de la rotación: dos mecanismos sobre el mismo archivo pueden interferir.
/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
}
Comprueba ls /etc/logrotate.d/ | grep nginx antes de añadir otra regla. El paquete suele proporcionar una; verifica PID, propietarios y reapertura. Aplica también el tratamiento de servicio detenido explicado antes.
/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 al final de postrotate oculta fallos de systemctl reload. || true también puede esconder un error real. Es preferible detectar explícitamente un servicio inactivo esperado y dejar observables los fallos inesperados.
/var/log/bigapp/*.log {
daily
maxsize 500M
rotate 7
compress
copytruncate
notifempty
}
daily con maxsize 500M permite adelantar la rotación por tamaño en la siguiente ejecución, no justo al alcanzar 500M. Sigue existiendo el intervalo de pérdida de copytruncate.
# 强制转一次(不管条件是否满足)
sudo logrotate -f /etc/logrotate.d/myapp
# 只看会不会转,不实际执行
sudo logrotate -d /etc/logrotate.d/myapp
# 详细模式,实际执行
sudo logrotate -v /etc/logrotate.d/myapp
-f sirve para una prueba real planificada o una rotación urgente tras comprobar el espacio. Repetir -f consume rápidamente los archivos retenidos y omite la condición daily. Copiar y comprimir puede requerir espacio adicional.
No aparece el nuevo archivo: revisa create y si la aplicación lo crea por sí misma. copytruncate conserva el original.
Se sigue escribiendo en el archivo rotado: postrotate no logró reabrirlo, o el PID/señal es incorrecto. Verifica nuevas escrituras y el mecanismo admitido por el servicio.
Demasiados archivos retenidos: revisa rotate, los valores globales y reglas duplicadas. Cero significa ninguna rotación retenida, pero la configuración global puede cambiarlo. rotate 52 son 52 rotaciones, no necesariamente un año. compress ahorra espacio según la compresibilidad.
logrotate: error: stat of /path failed: No such file or directory: verifica la ruta; usa missingok solo si es normal que no exista.
error: skipping "/path" because parent directory has insecure permissions: comprueba propietario y permisos del directorio. 755 puede servir en algunos casos; para una ruta escribible por el usuario de la aplicación puede hacer falta una directiva su correcta, sin cambiar propietarios indiscriminadamente.
No se ejecuta: revisa quién programa la tarea:
systemctl list-timers | grep logrotate
cat /etc/cron.daily/logrotate
Algunas instalaciones Debian/Ubuntu usan timer; otras /etc/cron.daily/logrotate, que puede omitir la ejecución si systemd ya se encarga. Evita duplicarlos y consulta cron y timers. No hay un daemon logrotate que reiniciar: lee las reglas en cada ejecución.
/var/log ya está lleno: identifica archivos prescindibles y conserva pruebas del incidente. El ejemplo de emergencia incluye borrado; lista y revisa las coincidencias antes de ejecutar delete. Tener más de 30 días no hace automáticamente desechable un registro.
1. 先清出空间(不然什么操作都可能失败)
sudo journalctl --vacuum-size=200M
sudo find /var/log -name "*.gz" -mtime +30 -delete
2. 再配好 logrotate 防止复发
Sigue el orden de recuperación de disco lleno. Limpiar el journal puede no liberar su archivo activo y una rotación por copia puede necesitar primero más espacio.
Borraste un archivo y no se liberó espacio: identifica quién lo mantiene abierto:
# 找出持有已删除文件的进程
sudo lsof +L1 | head -20
# 正确的做法是重启那个服务,让它重新打开日志
sudo systemctl restart myapp
Evita rm en registros activos. truncate -s 0 destruye su contenido y tampoco es una política de retención: utiliza reapertura/rotación o un reinicio deliberado tras guardar la información necesaria.
Partición separada: aislar /var/log puede proteger la raíz, pero aún necesita límites y alertas. En un VPS pequeño, una rotación funcional y SystemMaxUse pueden bastar.
- Reglas propias en
/etc/logrotate.d/, sin rutas duplicadas. -
rotate Ninterpretado como número de rotaciones. -
postrotatereabre correctamente los registros. -
sharedscriptscuando el script opera sobre un grupo. -
missingokynotifemptyelegidos según el servicio. -
create, propietarios y acceso al directorio verificados. - Decisiones de
logrotate -drevisadas. - Presupuesto de journald, incluido
SystemMaxUsepara persistencia. -
max-sizeymax-fileconfigurados en Docker. - Alertas de disco y tráfico activas.
La retención limita el crecimiento; las alertas detectan reglas que dejaron de funcionar y escritores inesperados. Comprueba ambas.