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
-
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.
-
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 2 months ago.