×
Managing cluster alerts
OpenShift Container Platform 4 provides a Web interface to the Alertmanager, which enables you to manage alerts. This section demonstrates how to use the Alerting UI.
Contents of the Alerting UI
This section shows and explains the contents of the Alerting UI, a Web interface to the Alertmanager.
The main two pages of the Alerting UI are the Alerts and the Silences pages.
The Alerts page is located in Monitoring → Alerts of the OpenShift Container Platform web console.
-
Filtering alerts by their names.
-
Filtering the alerts by their states. To fire, some alerts need a certain condition to be true for the duration of a timeout. If a condition of an alert is currently true, but the timeout has not been reached, such an alert is in the Pending state.
-
Alert name.
-
Description of an alert.
-
Current state of the alert and when the alert went into this state.
-
Value of the Severity label of the alert.
-
Actions you can do with the alert.
The Silences page is located in Monitoring → Silences of the OpenShift Container Platform web console.
-
Creating a silence for an alert.
-
Filtering silences by their name.
-
Filtering silences by their states. If a silence is pending, it is currently not active because it is scheduled to start at a later time. If a silence expired, it is no longer active because it has reached its end time.
-
Description of a silence. It includes the specification of alerts that it matches.
-
Current state of the silence. For active silences, it shows when it ends, and for pending silences, it shows when it starts.
-
Number of alerts that are being silenced by the silence.
-
Actions you can do with a silence.
Additionally, next to the title of each of these pages is a link to the old Alertmanager interface.
Getting information about alerts and alerting rules
You can find an alert and see information about it or its governing alerting rule.
Procedure
-
Open the OpenShift Container Platform web console and navigate to Monitoring → Alerts.
-
Optional: Filter the alerts by name using the Filter alerts by name field.
-
Optional: Filter the alerts by state using one or more of the state buttons Firing, Silenced, Pending, Not firing.
-
Optional: Sort the alerts by clicking one or more of the Name, State, and Severity column headers.
-
After you see the alert, you can see either details of the alert or details of its governing alerting rule.
To see alert details, click on the name of the alert. This is the page with alert details:
The page has the graph with timeseries of the alert. It also has information about the alert, including:
-
A link to its governing alerting rule
-
Description of the alert
To see alerting rule details, click the button in the last column and select View Alerting Rule. This is the page with alerting rule details:
The page has information about the alerting rule, including:
-
Alerting rule name, severity, and description
-
The expression that defines the condition for firing the alert
-
The time for which the condition should be true for an alert to fire
-
Graph for each alert governed by the alerting rule, showing the value with which the alert is firing
-
Table of all alerts governed by the alerting rule
-
Silencing alerts
You can either silence a specific alert or silence alerts that match a specification that you define.
Procedure
To silence a set of alerts by creating an alert specification:
-
Navigate to the Monitoring → Silences page of the OpenShift Container Platform web console.
-
Click Create Silence.
-
Populate the Create Silence form.
-
To create the silence, click Create.
To silence a specific alert:
-
Navigate to the Monitoring → Alerts page of the OpenShift Container Platform web console.
-
For the alert that you want to silence, click the button in the last column and click Silence Alert. The Create Silence form will appear with prepopulated specification of the chosen alert.
-
Optional: Modify the silence.
-
To create the silence, click Create.
Getting information about silences
You can find a silence and view its details.
Procedure
-
Open the OpenShift Container Platform web console and navigate to Monitoring → Silences.
-
Optional: Filter the silences by name using the Filter Silences by name field.
-
Optional: Filter the silences by state using one or more of the state buttons Active, Pending, Expired.
-
Optional: Sort the silences by clicking one or more of the Name, State, and Firing alerts column headers.
-
After you see the silence, you can click its name to see the details, including:
-
Alert specification
-
State
-
Start time
-
End time
-
Number and list of firing alerts
-
Editing silences
You can edit a silence, which will expire the existing silence and create a new silence with the changed configuration.
Procedure
-
Navigate to the Monitoring → Silences screen.
-
For the silence you want to modify, click the button in the last column and click Edit silence.
Alternatively, you can click Actions → Edit Silence in the Silence Overview screen for a particular silence.
-
In the Edit Silence screen, enter your changes and click the Save button. This will expire the existing silence and create one with the chosen configuration.
Expiring silences
You can expire a silence. Expiring a silence deactivates it forever.
Procedure
-
Navigate to the Monitoring → Silences page.
-
For the silence you want to expire, click the button in the last column and click Expire Silence.
Alternatively, you can click the Actions → Expire Silence button in the Silence Overview page for a particular silence.
-
Confirm by clicking Expire Silence. This expires the silence.