How to use MAAS systemd logs

MAAS logs considerable runtime information to standard log files, useful when things don’t work as expected. Prior to version 3.5, MAAS used custom log files for different components of the MAAS architecture. In version 3.5, all logging has been transferred to the standard systemd logs. This page gives a summary of how to access runtime logging for both version groups.

MAAS 3.5 log commands

Pebble (snap-only)

journalctl -u snap.maas.pebble -t maas.pebble

Regiond (ex-regiond.log)

For the snap, use:

journalctl -u snap.maas.pebble -t maas-regiond

For the debian packages, use:

journalctl -u maas-regiond

Rackd (ex-rackd.log)

For the snap, use::

journalctl -u snap.maas.pebble -t maas-rackd

For the debian packages, use:

journalctl -u maas-rackd

MAAS Agent

For the snap, use::

journalctl -u snap.maas.pebble -t maas-agent

For the debian packages, use:

journalctl -u maas-agent

maas.log

For the snap, use::

journalctl -u snap.maas.pebble -t maas-log

For the debian packages, use:

journalctl -u maas-syslog -t maas-log

API server

For the snap, use::

journalctl -u snap.maas.pebble -t maas-apiserver

For the debian packages, use:

journalctl -u maas-apiserver

Temporal

For the snap, use::

journalctl -u snap.maas.pebble -t maas-temporal

For the debian packages, use:

journalctl -u maas-temporal

HTTP (nginx)

For the snap, use::

journalctl -u snap.maas.pebble -t maas-http

For the debian packages, use:

journalctl -u maas-http

Proxy (squid)

For the snap, use::

journalctl -u snap.maas.pebble -t maas-proxy

For the debian packages, use:

journalctl -u maas-proxy

NTP (chrony)

For the snap, use::

journalctl -u snap.maas.pebble -t chronyd

For the debian packages, use:

journalctl -u chrony

DNS (bind9)

For the snap, use::

journalctl -u snap.maas.pebble -t named

For the debian packages, use:

journalctl -u named

Syslog (rsyslog)

For the snap, use::

journalctl -u snap.maas.pebble -t maas-machine

For the debian packages, use:

journalctl -u maas-syslog
  • Fields to filter over:
    • MAAS_MACHINE_IP
    • MAAS_MACHINE_HOSTNAME
    • MAAS_MACHINE_SYSLOG_TAG
    • MAAS_MACHINE_PID (to filter over remote machine process IDs)
    • MAAS_MACHINE_TIMESTAMP (to troubleshoot possible time sync issues)

For example, if using the snap, use a command like this:

journalctl -u snap.maas.pebble -t maas-machine --since "-15m" MAAS_MACHINE_HOSTNAME=ace-cougar MAAS_MACHINE_SYSLOG_TAG=systemd

On the other hand, if using debian packages, use a command similar to:

journalctl -u maas-syslog -t maas-machine --since "-15m" MAAS_MACHINE_HOSTNAME=ace-cougar MAAS_MACHINE_SYSLOG_TAG=systemd

DHCP (dhcpd, dhcpd6)

For the snap, use::

journalctl -u snap.maas.pebble -t dhcpd

For the debian packages, use:

journalctl -u maas-dhcpd

Pre-3.5 log commands

Supervisor (snap-only)

For the snap, use:

less /var/snap/maas/common/log/supervisor-run.log
journalctl -u snap.maas.supervisor

Regiond

For the snap, use:

less /var/snap/maas/common/log/regiond.log

For the debian packages, use:

less /var/log/maas/regiond.log

Rackd

For the snap, use::

less /var/snap/maas/common/log/rackd.log

For the debian packages, use:

less /var/log/maas/rackd.log

maas.log

For the snap, use::

less /var/snap/maas/common/log/maas.log

For the debian packages, use:

less /var/log/maas/maas.log

HTTP (nginx)

For the snap, use::

less /var/snap/maas/common/log/http/access.log (or error.log)
less /var/snap/maas/common/log/nginx.log

For the debian packages, use:

less /var/log/maas/http/access.log (or error.log)
journalctl -u maas-http

Proxy (squid)

For the snap, use::

less /var/snap/maas/common/log/proxy/access.log (or cache.log or storage.log)

For the debian packages, use:

less /var/log/maas/proxy/access.log (or cache.log or storage.log)

NTP (chrony)

For the debian packages, use:

journalctl -u chrony

DNS (bind9)

For the snap, use::

less /var/snap/maas/common/log/named.log

For the debian packages, use:

journalctl -u named

Syslog (rsyslog)

For the snap, use::

less /var/snap/maas/common/log/rsyslog.log
less /var/snap/maas/common/log/rsyslog/MACHINE_HOSTNAME/DATE/messages

For the debian packages, use:

journalctl -u maas-syslog
less /var/log/maas/rsyslog/MACHINE_HOSTNAME/DATE/messages

DHCP (dhcpd, dhcpd6)

For the snap, use::

less /var/snap/maas/common/log/dhcpd.log

For the debian packages, use:

journalctl -u dhcpd