4.3.1.2. SystemD

SystemD como de tantas otras tareas ha acabado por encargarse también de los registros del sistemai (servicio systemd-journald), de manera que su consulta puede llevarse a cabo a través de la orden journalctl. La configuración predeterminada del demonio se lleva a cabo en /etc/systemd/journald.conf.

En esta configuración predeterminada:

  • Los registros no son persistentes, porque se almacenan bajo /run/log/journal. Ahora bien, si se crea el directorio /var/log/journal, los registros pasarán a almacenarse en esta ubicación y, por tanto, se mantendrán entre reinicios[1].

  • Los registros se pasan también al demonio rsyslogd para que este siga clasificándolos y registrándolos tal como venía haciendo antes de la aparición de systemd. Esta posibilidad es muy importante, porque muchos programas usan el sistema tradicional de logs para obtener datos.

Por tanto, podríamos seguir consultando los logs como hasta ahora (de ahí que los apuntes hayan explicado con cierta extención rsyslogd y logrotate), pero la consulta a través de journalctl tiene algunas ventajas, que trataremos a continuación.

4.3.1.2.1. Consulta

Con systemd-journald los registros son binarios (no texto), así que no pueden consultarse a través de los comandos ordinarios. Sin embargo, para la consulta systemd provee del journalctl que permite muchos criterios de filtrado.

El modo más sencillo de usarlo es sin argumento alguno:

# journalctl

Esto mostraría todos los registros desde el primero que se almacena. La orden pagina automáticamente con lo que no es necesario el uso de paginadores adicionales como more o less.

Los criterios de selección son muy variados (y pueden usarse conjuntamente):

  • Seleccionar por la unidad:

    # journalctl --unit ssh.service
    

    Es posible usar comodines:

    # journalctl --unit "systemd-*"
    
  • Seleccionar por la prioridad (o el nivel) del mensaje:

    # journalctl -p err
    
  • Seleccionar los mensajes del núcleo:

    # journalctl -k
    
  • Seleccionar los mensajes desde un determinado momento. Se puede poner tanto un momento absoluto:

    # journalctl --since "2016-12-16 12:15:00"
    

    Como un periodo de tiempo respecto al momento actual. Esto muestra los mensajes de los últimos 10 minutos:

    # journalctl --since "-10m"
    

    También pueden usarse las palabras today o yesterday.

  • Seleccionar los mensajes hasta un determinado momento. Como en el caso anterior admite fechas absolutas o relativas:

    # journalctl --since "-10m" --until "-5m"
    
  • Selecciona mensajes generados por un determinado comando:

    # journalctl /usr/sbin/sshd
    
  • Selecciona según el identificador de syslog[2]:

    # journalctl -t sshd
    

    El identificador es la cadena que hay antes del PID encerrado entre corchetes y que generalmente coincide con el ejecutable.

  • Selecciona mensajes según determinados campos. Los campos posibles pueden consultarse con:

    # journalctl -N
    

    o bien recurriendo a la página del manual:

    $ man systemd.journal-fields
    

    De entre ellos pueden ser útiles:

    SYSLOG_FACILITY

    Para seleccionar por la facility (mail, authpriv, etc.). Sin embargo, sólo pueden usarse los códigos numéricos:

    # journalctl SYSLOG_FACILITY=3
    
    _TRANSPORT

    Para seleccionar mensajes según la forma en que se transmitieron a sytemd. Por ejemplo, un valor kernel mostrará los mensajes del núcleo:

    # journalctl _TRANSPORT=kernel
    

    o un valor audit los mensajes generados por el servicio de auditoria:

    # journalctl _TRANSPORT=audit
    
    _UID

    Mensajes generados por el usuario con un determinado UID:

    # journalctl _UID=1000
    
    _PID

    Mensajes generados por el proceso con el PID indicado.

    _GID

    Mensajes generados por el grupo con el GID especificado

    Algunos otros campos interesantes se pueden seleccionar mediante opciones ya vistas: PRIORITY (-p), _SYSTEMD_UNIT (-unit o -u).

    Si se especifican varios campos en la línea las condiciones se consideran enlazadas con el operador lógico AND[3]. Para unirlos con OR debe añadirse un signo +:

    # journalctl SYSLOG_FACILITY=4 + SYSLOG_FACILITY=10
    

Es posible conocer qué valores distintos muestra uno de los campos anteriores con la opción -F:

# journalctl -F _SYSTEMD_UNIT

Además de estos criterios, se puede mostrar los últimos N mensajes con la opción -n. Esta orden mostraría los últimos diez registros de la unidad ssh:

# journalctl --unit ssh.service -n

Son 10, porque es el número que se muestra si no se especifica ningún argumento para -n. En estos casos en que sabemos de antemano que no ocuparemos toda la pantalla es útil prescindir del paginador:

# journalctl --unit ssh.service -n --no-pager

Una alternativa a esto es desconfigurar el paginador:

# PAGER= journalctl --unit ssh.service -n

También es posible hacer un seguimiento de los registros tal como se puede hacer con tail -f:

# journalctl --unit ssh.service -f

que mostrará los diez últimos registros y quedará esperando a recibir los siguientes. En este caso, también se podría haber añadido -n para modificar el número de líneas previsualizadas.

Por último, es posible cambiar el formato con que se muestran las líneas a través de la opción -o. Hay varios (véase la página de manual de journalctl). Por ejemplo, esto mostraría una salida en formato json en que se muestra cada campo del mensaje:

# journalctl -o json-pretty

Si se quiere filtrar registros usando expresiones regulares sobre el mensaje, no queda más remedio que pasar la salida de journalctl a un comando como grep.

4.3.1.2.2. Persistencia

Ya se ha indicado que los registros de systemd no son persistentes, puesto que se almacenan sobre un sistema de ficheros volátil (/run). Sin embargo, existe la posibilidad de hacerlos persistentes:

  • Porque deseemos revisar registros con journalctl producidos antes del último reinicio.

  • Porque deseamos prescindir de rsyslogd. Para esto último deberíamos estar muy seguros de que ninguna de nuestras aplicaciones usa los archivos que este demonio genera.

Lo primero es comprobar que systemd-journald está configurado para hacer persistentes lo datos. Para ello, en /etc/systemd/journald.conf la directiva Storage debe tener el valor de auto o de persistent o no estar fijada en absoluto (en cuyo caso, su valor será auto). En caso de que su valor sea auto, el almacenamiento será persistente si existe la ruta /var/log/journal.

Revisado esto, debemos crear el directorio donde se almacenarán los registros:

# mkdir -p /var/log/journal
# systemd-tmpfiles --create --prefix /var/log/jourtnal

Y reiniciar el servicio:

# systemctl restart systemd-journald

Algo importante a tener en cuenta, cuando se hacen persistentes, es el espacio que ocupan los registros. Para controlarlo existen las directivas[4]:

  • SystemMaxUse, que determina la cantidad máxima de espacio que ocuparan los registros. Se indica con un número que expresa bytes, aunque el número puede acompañarse de unidades: K, M, G, etc.

  • SystemKeepFree, que determina la cantidad mínima de espacio en el sistema de ficheros que deben dejar libre los registros.

  • SystemMaxFileSize, que determina el tamaño máximo de archivo de registro.

  • SystemMaxFiles, que determina el número máximo de ficheros de registros que puede haber.

  • MaxFileSec indica el tiempo máximo que se almacenarán registros en un mismo fichero después del cual se procederá a rotarlo. Se expresa en segundos, pero puedo usar unidades: m, h, day, week, month ó year.

Por defecto, SystemMaxUse se fija al 10% y SystemMaxFileSize a la octava parte del valor anterior, por lo que se guardarán siete rotaciones del fichero de registro, antes de que empiecen a eliminarse entradas.

Para comprobar cuánto espacio ocupan los logs puede hacerse:

# journalctl --disk-usage

Al hacer persistentes los ficheros, se acomularán registros de varios arranques[5]. journalctl posee la opción -b para escoger de qué arranque mostrar los registros (0 el actual, -1 el penúltimo, etc). Por ejemplo, esto mostrará los mensajes generados por el servicio ssh durante el penúltimo arranque:

# journalctl -b -1 --unit ssh

Si no se indica arranque alguno, se buscará en todos. Para conocer qué arranques hay almacenados en el registro:

# journalctl --list-boots

Nota

La persistencia de sus registros no implica que systemd-journald deje de seguir enviando los registros a rsyslogd. Esto se rige a través de la directiva ForwardToSyslog que por defecto está fijada a yes. Puede fijarse a no y eliminar rsyslog y logrotate[6].

Notas al pie