How to read event logs

Errors or typos? Topics missing? Hard to read? Let us know.

This page explains how to interpret event logs.

Reviewing logs

Take a look at what a simple view of your event logs might resemble:

  Time 	                      Event
  Sun, 04 Oct. 2020 23:12:35 	Ready
  Sun, 04 Oct. 2020 23:12:31 	Running test - smartctl-validate on sda
  Sun, 04 Oct. 2020 23:10:37 	Gathering information
  Sun, 04 Oct. 2020 23:10:30 	Loading ephemeral
  Sun, 04 Oct. 2020 23:10:15 	Performing PXE boot
  Sun, 04 Oct. 2020 23:09:54 	Powering on
  Sun, 04 Oct. 2020 23:09:53 	Commissioning

Navigating

  1. In the UI: Navigate to a specific machine from the machine list and click on the “Events” tab at the top. For a more detailed history, select “View full history” near the upper right of the log display.

  2. In the CLI: Access raw events with:

    maas $PROFILE events query
    

    To arrange the results neatly, try:

    maas admin events query | jq -r '(["HOSTNAME","TIMESTAMP","TYPE","DESCRIPTION"] | (., map(length*"-"))), (.events[] | [.hostname, .created, .type, .description // "-"]) | @tsv' | column -t -s $'\t'
    

Categorising events

MAAS events generally fall into four intriguing categories:

  • INFO: Just the facts, like news updates for your machines.
  • WARNING: Yellow flags on the racetrack, cautioning you to investigate.
  • ERROR: Red flags telling you that something has broken down.
  • DEBUG: Behind-the-scenes footage for those who love details.

Each category has internal and external representations, useful for those times when MAAS decides to throw cryptic exceptions your way.

INFO events

Internal representation External message
ABORTED_COMMISSIONING Aborted commissioning
ABORTED_DEPLOYMENT Aborted deployment
ABORTED_DISK_ERASING Aborted disk erasing
ABORTED_TESTING Aborted testing
COMMISSIONING Commissioning
CONFIGURING_OS Configuring OS
CONFIGURING_STORAGE Configuring storage
ENTERING_RESCUE_MODE Entering rescue mode
EXITED_RESCUE_MODE Exited rescue mode
FAILED_COMMISSIONING Failed commissioning
FAILED_EXITING_RESCUE_MODE Failed exiting rescue mode
FAILED_TESTING Failed testing
GATHERING_INFO Gathering information
INSTALLING_OS Installing OS
LOADING_EPHEMERAL Loading ephemeral
NODE_POWER_CYCLE_STARTING Power cycling
NODE_POWER_OFF_STARTING Powering off
NODE_POWER_ON_STARTING Powering on
PERFORMING_PXE_BOOT Performing PXE boot
RESCUE_MODE Rescue mode
RUNNING_TEST Running test
SCRIPT_DID_NOT_COMPLETE Script

WARNING events

Internal representation External message
NODE_POWER_QUERY_FAILED Failed to query node’s BMC
RACK_IMPORT_WARNING Rack import warning
REGION_IMPORT_WARNING Region import warning

ERROR events

Internal representation External message
NODE_COMMISSIONING_EVENT_FAILED Node commissioning failure
NODE_ENTERING_RESCUE_MODE_EVENT_FAILED Node entering rescue mode failure
NODE_EXITING_RESCUE_MODE_EVENT_FAILED Node exiting rescue mode failure
NODE_INSTALL_EVENT_FAILED Node installation failure
NODE_POST_INSTALL_EVENT_FAILED Node post-installation failure
NODE_POWER_CYCLE_FAILED Failed to power cycle node
NODE_POWER_OFF_FAILED Failed to power off node
NODE_POWER_ON_FAILED Failed to power on node
RACK_IMPORT_ERROR Rack import error
REGION_IMPORT_ERROR Region import error
REQUEST_NODE_MARK_BROKEN_SYSTEM Marking node broken
REQUEST_NODE_MARK_FAILED_SYSTEM Marking node failed
SCRIPT_RESULT_ERROR Script result lookup or storage error

DEBUG events

Internal representation External message
NODE_CHANGED_STATUS Node changed status
NODE_COMMISSIONING_EVENT Node commissioning
NODE_ENTERING_RESCUE_MODE_EVENT Node entering rescue mode
NODE_EXITING_RESCUE_MODE_EVENT Node exiting rescue mode
NODE_HTTP_REQUEST HTTP Request
NODE_INSTALLATION_FINISHED Installation complete
NODE_INSTALL_EVENT Node installation
NODE_POWERED_OFF Node powered off
NODE_POWERED_ON Node powered on
NODE_PXE_REQUEST PXE Request
NODE_STATUS_EVENT Node status event
NODE_TFTP_REQUEST TFTP Request
RACK_IMPORT_INFO Rack import info
REGION_IMPORT_INFO Region import info
REQUEST_CONTROLLER_REFRESH Starting refresh of controller hardware and networking information
REQUEST_NODE_ABORT_COMMISSIONING User aborting node commissioning
REQUEST_NODE_ABORT_DEPLOYMENT User aborting deployment
REQUEST_NODE_ABORT_ERASE_DISK User aborting disk erase
REQUEST_NODE_ABORT_TESTING User aborting node testing
REQUEST_NODE_ACQUIRE User acquiring node
REQUEST_NODE_ERASE_DISK User erasing disk
REQUEST_NODE_LOCK User locking node
REQUEST_NODE_MARK_BROKEN User marking node broken
REQUEST_NODE_MARK_FAILED User marking node failed
REQUEST_NODE_MARK_FIXED User marking node fixed
REQUEST_NODE_MARK_FIXED_SYSTEM Marking node fixed
REQUEST_NODE_OVERRIDE_FAILED_TESTING User overrode ‘Failed testing’ status
REQUEST_NODE_RELEASE User releasing node
REQUEST_NODE_START User powering up node
REQUEST_NODE_START_COMMISSIONING User starting node commissioning
REQUEST_NODE_START_DEPLOYMENT User starting deployment
REQUEST_NODE_START_RESCUE_MODE User starting rescue mode
REQUEST_NODE_START_TESTING User starting node testing
REQUEST_NODE_STOP User powering down node
REQUEST_NODE_STOP_RESCUE_MODE User stopping rescue mode
REQUEST_NODE_UNLOCK User unlocking node
REQUEST_RACK_CONTROLLER_ADD_CHASSIS Querying chassis and enlisting all machines
SCRIPT_RESULT_CHANGED_STATUS Script result

Last updated a month ago.