Notification

In MAAS, notifications are system-generated messages that inform users about events, status changes, or issues related to the MAAS environment. These notifications help administrators monitor and respond to critical system activities, such as machine deployment, commissioning results, or hardware failures.

Purpose in MAAS

Notifications provide real-time updates and logs about various MAAS operations. They serve several functions, including:

  • alerting users to machine state changes (e.g., powered on, failed commissioning, deployed)
  • informing about network or storage configuration changes
  • reporting errors, warnings, or informational messages related to infrastructure health
  • tracking user actions, such as API requests or machine reservations

Scope and behavior in MAAS

  • notifications are displayed in the MAAS web UI under the notifications section
  • they are also accessible via the MAAS API for automation and monitoring
  • notifications persist until acknowledged or dismissed by the user
  • only certain events trigger notifications, depending on their severity and system impact

MAAS CLI usage

Retrieving notifications

maas <profile> notifications read

Lists all active notifications.

Retrieving a specific notification

maas <profile> notification read <notification-id>

Displays details of a specific notification.

Dismissing a notification

maas <profile> notification delete <notification-id>

Removes a notification from the system.

Key considerations

  • notifications do not generate external alerts (e.g., email or webhook) by default
  • they must be manually checked or integrated with external monitoring tools
  • some notifications are informational, while others indicate errors or failures requiring attention
  • users should regularly review notifications to ensure smooth MAAS operations

Last updated 9 hours ago.