Tutorial de Debian 13 / Usar journalctl y logrotate para investigar y conservar registros

Debian 13 gestiona los registros distinguiendo entre los diarios que se ven con journalctl y los registros de archivos que las aplicaciones escriben directamente. Primero se exportan los registros necesarios para la resolución de problemas, y para los registros de archivos, es necesario configurar la rotación, compresión y el número de archivos conservados de acuerdo con el método de reapertura del programa. Este tutorial demuestra el funcionamiento de logrotate con archivos y servicios dedicados sin eliminar los registros operativos.

Distinga el journal de los registros de aplicaciones en archivos

systemd-journald recopila la salida estándar y los errores de los servicios, así como los mensajes del sistema en diarios con campos. journalctl es una herramienta para ver los registros almacenados. Por el contrario, los archivos de registro de aplicaciones ubicados, por ejemplo, en /var/log/nginx pueden ser abiertos y escritos por el propio programa, y logrotate usualmente los renombra, comprime y conserva.

Objetivo Herramientas principales Elementos a comprobar
Diario de systemd Configuraciones de journalctl y journald Servicio, arranque, tiempo, prioridad, ubicación de almacenamiento y política de tamaño
Registros de archivos de programas Configuraciones de la aplicación y logrotate Ruta del archivo, propiedad y archivos abiertos, reabrir en rotación y tiempo de compresión

No elimine los archivos de diario con rm como si fueran archivos de texto normales ni los incluya en logrotate. Si se eliminan los registros de archivos pero el espacio sigue ocupado, también está relacionado con archivos eliminados que aún están abiertos. Use el laboratorio de diagnóstico de espacio y archivos eliminados aún abiertos para comparar df y du, y primero identifique los servicios que escriben registros.

Filtre por servicio, arranque y periodo

Determine el servicio y la hora en que ocurrió el problema y consulte de la siguiente manera. Reemplace el ejemplo de hora con la hora real de falla del servidor. La salida puede incluir información como cuentas, direcciones y tokens, por lo que se debe revisar antes de compartir externamente.

sudo journalctl --list-boots --no-pager
sudo journalctl -b -u nginx.service -n 50 --no-pager
sudo journalctl -b -u nginx.service --since '2026-11-16 22:00:00' --until '2026-11-16 23:00:00' -o short-iso --no-pager
sudo journalctl -b -p warning --no-pager
sudo journalctl -b -k --no-pager

-b selecciona el arranque actual, -b -1 selecciona el arranque guardado previamente. Primero verifique la existencia con --list-boots. -u es para servicios, -k es para mensajes del kernel, -p warning restringe el alcance a advertencias y prioridades más graves. Si especifica el nivel de error, podría perder pistas a nivel de información, así que no consulte solo eso desde el principio.

La máquina virtual de práctica tenía diarios de arranque anteriores preservados y journalctl --disk-usage reportó 40MiB combinando archivos activos y archivados. Esta es la observación en el ejemplo actual y no la retención predeterminada para todos los servidores Debian. Los permisos de consulta y los filtros se pueden verificar en manual de journalctl de Debian.

Para un servicio de usuario, use journalctl --user -u UNIT, reemplazando UNIT con el nombre real del servicio. Si el acceso al journal del sistema está restringido, use sudo para la consulta necesaria en lugar de agregar la cuenta a un grupo con privilegios amplios por conveniencia.

Cree el servicio completo de escritura de registros

Este es un entorno de práctica dedicado para Debian 13, systemd 257, Python 3 y logrotate 3.22. El ejemplo a continuación asume una máquina virtual con un usuario normal lfstudent. Si está usando una cuenta diferente, cambie el User y Group de la unidad y el propietario indicado en la directiva create de logrotate al mismo usuario existente. Puede verificar si la cuenta existe con id lfstudent.

Prepare después de la instalación y la verificación de ruta. Si ya existe un nombre dedicado, deténgase sin sobrescribir los archivos existentes. Este archivo solo registra datos de práctica y no está vinculado a los registros existentes de Nginx.

sudo apt install logrotate python3
id lfstudent
for p in /var/log/lf-log29 /var/backups/lf-debian13-29 /usr/local/libexec/lf-log29-writer.py /etc/systemd/system/lf-log29.service; do
    if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 755 /var/log/lf-log29 /usr/local/libexec
sudo install -d -m 700 /var/backups/lf-debian13-29
sudo install -m 640 -o lfstudent -g lfstudent /dev/null /var/log/lf-log29/app.log

Guarde todo el siguiente programa de Python. Mantiene el archivo abierto mientras escribe. Al recibir SIGHUP (señal de desconexión, utilizada aquí para solicitar la reapertura), solicita cerrar y reabrir la misma ruta en su siguiente iteración. El programa está limitado a 6.000 iteraciones, aproximadamente diez minutos, para permitir realizar la práctica. No todos los servicios generales admiten la reapertura con SIGHUP.

sudo tee /usr/local/libexec/lf-log29-writer.py > /dev/null <<'PY'
import os,signal,time
path='/var/log/lf-log29/app.log'
reopen=True
running=True
def hup(signum,frame):
    global reopen
    reopen=True
def stop(signum,frame):
    global running
    running=False
signal.signal(signal.SIGHUP,hup)
signal.signal(signal.SIGTERM,stop)
f=None
try:
    for number in range(6000):
        if not running: break
        if reopen:
            if f is not None: f.close()
            f=open(path,'a',buffering=1)
            reopen=False
            print(f'<6>opened inode={os.fstat(f.fileno()).st_ino}',flush=True)
        f.write(f'line={number:04d} sample log record\n')
        time.sleep(.1)
finally:
    if f is not None: f.close()
    print('<6>writer stopped',flush=True)
PY

Confirme que id lfstudent tenga éxito antes de preparar los archivos; deténgase si la cuenta o cualquier paso de instalación falla. Después de guardar la unidad, verifíquelo con sudo systemd-analyze verify /etc/systemd/system/lf-log29.service antes de daemon-reload y start.

Guarde toda la unidad siguiente. La salida estándar registra el inode del archivo abierto, y el archivo registra entradas numeradas. La reapertura del archivo se solicita mediante el HUP enviado a través de ExecReload. Si se aplica tal cual a un programa real que no lo soporta, puede terminar, por lo que se debe consultar la documentación del programa.

sudo tee /etc/systemd/system/lf-log29.service > /dev/null <<'UNIT'
[Unit]
Description=LF log rotation lab 29
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-log29-writer.py
ExecReload=/bin/kill -HUP $MAINPID
SyslogIdentifier=lf-log29
UNIT
sudo chmod 644 /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo systemctl start lf-log29.service
sleep 1
sudo systemctl is-active lf-log29.service
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 10 --no-pager

El archivo recibe líneas numeradas como line=0000 sample log record. En el journal, opened inode= va seguido del número del inode abierto. Si el programa se terminó durante la práctica, revise los registros y el estado, y luego reinicie solo el servicio dedicado. Distinga entre la terminación normal al alcanzar el tiempo máximo de ejecución del ejemplo y los errores de permisos.

Cree una configuración independiente de logrotate y verifique la depuración

Los ajustes de práctica se colocan como archivos independientes en la carpeta de respaldo, no en /etc/logrotate.d. Por lo tanto, el temporizador diario del sistema no maneja automáticamente este ejemplo, y solo se realiza la verificación manual. Usar un --state separado tampoco modifica el archivo de estado predeterminado del sistema.

sudo tee /var/backups/lf-debian13-29/logrotate.conf > /dev/null <<'CONF'
/var/log/lf-log29/app.log {
    size 100
    rotate 2
    compress
    delaycompress
    missingok
    notifempty
    create 0640 lfstudent lfstudent
    sharedscripts
    postrotate
        /usr/bin/systemctl reload lf-log29.service
    endscript
}
CONF
sudo chmod 600 /var/backups/lf-debian13-29/logrotate.conf
sudo logrotate --debug --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sudo ls -l /var/log/lf-log29

--debug muestra el razonamiento pero no cambia los registros ni los archivos de estado. En la verificación de ejecución, el proceso de escritura se pausó temporalmente para comparar los hashes, confirmando que el contenido del archivo, los archivos rotados y los archivos de estado separados no cambian. Los lectores no necesitan detener el proceso operativo para esta verificación. El hecho de que el hash del archivo que se está escribiendo cambió no significa que debug haya modificado el archivo.

Directivas Significado y criterios de selección
size 100 Este es un límite de práctica pequeño basado en 100 bytes. No es una función de monitoreo de rotación en tiempo real a este tamaño exacto.
rotate 2 Mantener dos copias de seguridad rotadas. La configuración no garantiza dos días.
compress / delaycompress Comprimir, pero diferir la compresión del archivo más reciente hasta la siguiente rotación.
create 0640 Especificar los permisos y la propiedad del nuevo registro activo.
postrotate En este ejemplo, solicite recarga para que el servicio abra un archivo nuevo después de la rotación.

El manual de logrotate de Debian describe las opciones soportadas y el comportamiento de depuración/estado. Verifique la precedencia al combinar condiciones como size y daily. Un umbral de tamaño pequeño no impide un crecimiento sustancial entre invocaciones cuando logrotate se ejecuta solo una vez al día.

Verifique la rotación, la compresión y la reapertura

La siguiente es la primera rotación con --force aplicado solo a la configuración dedicada. Es una ejecución forzada para aclarar las condiciones al probar inicialmente y no se utiliza para toda la configuración de producción.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo tail /var/log/lf-log29/app.log
sudo journalctl -b -u lf-log29.service -n 15 --no-pager

Durante la primera rotación, el archivo existente se convierte en app.log.1 y el nuevo app.log tiene un inode diferente. Este programa abre la nueva ruta en la siguiente iteración después de recibir HUP. En ese breve intervalo, las líneas escritas en el archivo anterior pueden permanecer en el archivo archivado anterior. Lo importante es si los registros posteriores continúan yendo al nuevo archivo activo. En la verificación, incluso comparamos si el inode del descriptor de archivo abierto en /proc coincidía con el inode del archivo activo.

Ejecute el siguiente bloque dos veces, dando un total de tres rotaciones. Después de cada rotación, espere brevemente para verificar que el contenido haya aparecido en el archivo activo. Si el nuevo archivo está vacío, puede omitir la rotación debido a notifempty, y si el programa ha salido, el recargado postrotate puede fallar.

sudo logrotate --verbose --force --state /var/backups/lf-debian13-29/logrotate.state /var/backups/lf-debian13-29/logrotate.conf
sleep 1
sudo ls -li /var/log/lf-log29
sudo gzip -t /var/log/lf-log29/app.log.2.gz
sudo gzip -cd /var/log/lf-log29/app.log.2.gz | head
Número de rotaciones Registro activo Archivos
Primero Reanudar escritura en app.log app.log.1, aún no comprimido
Segundo Registrado en nuevo app.log app.log.1 y app.log.2.gz
Tercero Registrado en nuevo app.log Mantener dos versiones de respaldo, eliminar primero el contenido de la copia de seguridad más antigua

En las tres rotaciones reales, la verificación de gzip pasó y app.log.3.gz no permaneció. Los números de inode pueden ser reutilizados, así que no espere que aumenten globalmente. Si solo cambia el nombre sin volver a abrir, el proceso puede continuar escribiendo en el inode anterior. copytruncate no se utiliza como una solución general para todos los programas porque existe la posibilidad de perder registros entre la copia y la truncación.

Exporte el journal y conserve los archivos antes de limpiar

Al conservar logs para investigar, registre los filtros, zonas horarias y condiciones de arranque juntos. El texto es fácil de leer, y el formato de exportación se puede usar al mantener los campos del journal juntos. El hecho de que se haya creado un archivo de exportación no significa que se haya re-registrado en el journal principal.

sudo systemctl stop lf-log29.service
sudo journalctl --sync
sudo journalctl -b -u lf-log29.service -o short-iso --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.txt > /dev/null
sudo journalctl -b -u lf-log29.service -o export --no-pager | sudo tee /var/backups/lf-debian13-29/service-journal.export > /dev/null
sudo cp -a /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz /var/backups/lf-debian13-29/
sudo ls -lh /var/backups/lf-debian13-29

En la práctica, la reapertura de registros y los mensajes de terminación normal del programa de escritura se incluyeron en el diario exportado, y los registros de archivos y las copias de seguridad comprimidas también se copiaron por separado. Si hay archivos omitidos debido a rotaciones intermedias, se deben conservar según la lista real, y no se debe tratar la copia de seguridad como completa mientras se ignoren fallos de copia.

Revise la política de retención y elimine el laboratorio

La política de almacenamiento de journald se verifica con la configuración de fusión de la siguiente manera. Storage=auto cambia el método de almacenamiento según la presencia del directorio de diario permanente, etc. Para conservar los arranques anteriores, también se debe comprobar si se almacena realmente de forma permanente y si es escribible.

systemd-analyze cat-config systemd/journald.conf
sudo journalctl --disk-usage
systemctl cat logrotate.timer
systemctl list-timers logrotate.timer --no-pager

SystemMaxUse y RuntimeMaxUse en journald son las políticas de uso para el almacenamiento permanente y temporal respectivamente, y MaxRetentionSec es un elemento que limita el período de retención de los registros antiguos. Los datos pueden eliminarse antes debido a los límites de capacidad, por lo que no garantiza un período mínimo de retención. Basado en el manual de configuración de retención de journald de Debian, decida conjuntamente sobre la disponibilidad de espacio en disco, el volumen de generación de registros y el período de retención requerido.

Al cambiar realmente la política, haga una copia de seguridad de la configuración existente y especifique la sección [Journal] en un archivo .conf separado que usted mismo gestione en /etc/systemd/journald.conf.d, luego verifique el resultado combinado. Aplique ejecutando sudo systemctl restart systemd-journald y verifique el estado del servicio y los errores de registro. Al revertir, solo elimine el drop-in que creó y aplíquelo nuevamente. Los registros que ya han sido eliminados según la política de retención no se restauran al revertir la configuración, por lo que primero debe conservar externamente los registros necesarios.

Esta práctica no cambió la política de retención existente de journald ni eliminó el diario operativo usando vacuum. La función vacuum de journalctl elimina únicamente archivos de journal archivados. Como --disk-usage también incluye los activos, el uso total puede seguir superando el límite solicitado. No elimine registros en masa antes de investigar solo porque falte espacio.

Detenga el servicio de práctica, verifique la copia y luego limpie solo los archivos dedicados. Dado que no se agregó nada a /etc/logrotate.d, otras reglas del temporizador del sistema permanecen en su lugar.

sudo rm -- /etc/systemd/system/lf-log29.service /usr/local/libexec/lf-log29-writer.py
sudo systemctl daemon-reload
sudo rm -- /var/log/lf-log29/app.log /var/log/lf-log29/app.log.1 /var/log/lf-log29/app.log.2.gz
sudo rmdir /var/log/lf-log29

Después de la verificación, se eliminaron el servicio dedicado y la ruta de registro, y se preservaron las evidencias junto con los archivos de configuración y estado en /var/backups/lf-debian13-29. Solo las reglas con tamaño real apropiado, horario de ejecución y comandos de recarga se agregan al logrotate operativo, y el umbral de 100 bytes y la rotación forzada de esta práctica no se utilizan como valores predeterminados operativos.