What alerts are

The new alerts system is available to preview in StorageGRID 11.3. The alerts system is designed to be easier to use and more powerful than the legacy alarms system. However, the alarms system continues to be the primary system for this release.

Benefits of the alerts system

The alerts system provides an easy-to-use interface for detecting, evaluating, and resolving the issues that can occur during StorageGRID operation. Available to preview in the StorageGRID 11.3 release, the alerts system offers significant benefits when compared to the alarms system:
  • The new alerts system focuses on real problems in the system. Unlike some alarms in the legacy system, all of the new alerts are triggered for events that require your immediate attention, not for events that can safely be ignored.
  • Multiple alerts of the same type are grouped into one email to reduce the number of notifications. In addition, multiple alerts of the same type are shown as a group on the Alerts page. You can expand and collapse alert groups to show or hide the individual alerts. For example, if several nodes are reporting the Unable to communicate with node alert, only one email is sent and the alert is shown as a group on the Alerts page.
  • The Alerts page provides a more user friendly interface for viewing current problems. You can sort the listing by individual alerts and alert groups. For example, you might want to sort all alerts by node/site to see which alerts are affecting a specific node. Or, you might want to sort the alerts in a group by time triggered to find the most recent instance of a specific alert.
  • Alerts use intuitive names and descriptions to help you understand more quickly what the problem is. Alert notifications include details about the node and site affected, the alert severity, the time when the alert rule was triggered, and the current value of metrics related to the alert.
  • Both alert notifications and the alert listings on the Alerts page provide recommended actions for resolving an alert. These recommended actions often include direct links to the StorageGRID documentation center to make it easier to find and access more detailed troubleshooting procedures.
  • If you need to temporarily suppress the notifications for an alert at one or more severity levels, you can easily silence a specific alert rule for a specified duration. You can silence an alert rule for the entire grid, a single site, or a single node. The new silences functionality is more powerful than the acknowledge functionality in the alarms system.
  • Creating custom alert rules is significantly easier and allows for greater functionality than creating custom alarms using the StorageGRID attributes system. You can create custom alert rules to target the specific conditions that are relevant to your situation and to provide your own recommended actions. To define the conditions for a custom alert, you create expressions using the Prometheus metrics available from the Metrics section of the Grid Management API.

Comparing alarms and alerts in StorageGRID 11.3

The new alerts system is available to preview in the StorageGRID 11.3 release; however, this new system does not currently offer comprehensive coverage or complete functionality. For example, alerts are not yet shown on the Dashboard or on the Nodes page, and alerts are not linked to the events logged in StorageGRID logs.
Attention: For StorageGRID 11.3, consider the alerts system to be a supplement to the alarms system, not a replacement for it. You must use the alarms system as your primary tool for detecting and resolving any issues with your system.

The following table shows the high-level similarities and differences between the alarms system and the preview alerts system in StorageGRID 11.3. Additional alerts and more complete alert functionality will be added in future StorageGRID releases.

  Alarms Alerts (preview)

Where are they displayed

When an alarm is triggered, you can see it in the following places:
  • On the Dashboard
  • On the Nodes page
  • In the Grid Topology tree
You can also access details about current and historical alarms from the Alarms menu.

When an alert is triggered, you can only see it on the Alerts page (Alarms > Alerts (preview) > Alerts).

Where are they managed

Select Alarms. Then, use the options in the Alarms section of the menu.

Managing alarms

Select Alarms. Then, use the options in the Alerts (Preview) section of the menu.

Managing alerts (preview mode for 11.3)

Where are email notifications managed

Select Alarms. Then, in the Alarms section of the menu, select Email Setup.

Note: You can access the same Email Server page by selecting Support > AutoSupport and selecting Email Server from the AutoSupport menu.

Configuring email notifications for alarms

Select Alarms. Then, in the Alerts (Preview) section of the menu, select Notifications.

Note: Because alarms and alerts are independent systems, the email setup used for alarm and AutoSupport notifications is not used for alert notifications. You can use the same mail server for all notifications; however, the alerts system does not yet support SMTP server authentication (username, password).

Managing alert notifications

What user group permissions required

  • Anyone who can sign in to the Grid Manager can monitor alarms.
  • You must have the Acknowledge Alarms permission to acknowledge alarms.
  • You must have both the Grid Topology Page Configuration and Other Grid Configuration permissions to manage global alarms and email notifications.

You must have Root Access permission to view and manage alerts and notifications for the StorageGRID 11.3 preview.

Which Admin Nodes send notifications

A single Admin Node (the "preferred sender").

All Admin Nodes, across all sites.

How are notifications suppressed

You can acknowledge an alarm after it has been triggered, or you can disable an alarm globally or for a particular service or component.

You configure silences to suppress alert notifications for a specified amount of time.

Each silence suppresses the notifications for an alert rule at one or more severities. You can silence an alert rule on the entire grid, a single site, or a single node.

Where are recommended actions

You must refer to the StorageGRID documentation.

Alarms reference

Each alert rule includes a set of recommended actions, which are included in email notifications and available directly from the Alerts pages in the Grid Manager.

As required, additional information is provided in the StorageGRID documentation.

Alerts reference