Offline docs (switch to live docs)                         UI-only          CLI-only 

How to work with log files

MAAS has a robust logging capability, which presents several different views, including a number of node-specific log files and several syslogd-style text logs. Each of these logs provides different information, or at the very least, different views of the same information. MAAS gathers logging information about the various MAAS states and records both automated and user-driven actions.

This document will help you learn:

It also links to reference material for:

The discussion of these logs and their contents can be very extensive, so each type of logging has its own documentation section, reachable from the left-hand menu – or from the list of questions above.

About the syslog logging path

How to use a remote syslog server

To add or update a remote syslog server in your MAAS environment:

maas $PROFILE maas set-config name="remote_syslog" value="$SYSLOG_FQDN"

For example, to set your syslog server to 192.168.100.11:

maas $PROFILE maas set-config name="remote_syslog" value=192.168.100.11

If you clear the remote_syslog value, MAAS will revert to the default behaviour, which is to send all syslog information to all MAAS region controllers.

For example:

maas $PROFILE maas set-config name="remote_syslog" value=""

NOTE: Note that MAAS controllers’ syslogs are not forwarded to the external syslog server – only machine syslog information is forwarded.