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 the various MAAS states and records both automated and user-driven actions.
Quick questions you may have:
- What are commissioning logs?
- What is the syslog logging path?
- How do I use a remote syslog server?
- What are test logs?
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.
The syslog logging path
Syslog data is kept in /var/log/maas/rsyslog/<machine-name><yyyy-mm-dd>/messages
(/var/snap/maas/common/log/rsyslog/<machine-name><yyyy-mm-dd>/messages
when using the snap). Every machine known to MAAS will have corresponding syslogs.
Using a remote syslog server
To add a remote syslog server, click the Settings tab and then click the Network services tab. Scroll down to the Syslog section, where you can add a syslog URL or IP:
Click the Save button to save your changes.
Note that MAAS controllers’ syslogs are not forwarded to the external syslog server – only machine syslog information is forwarded.
See MAAS CLI to learn how to add a remote syslog server using the CLI.