OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Managing cluster alerts

OpenShift Container Platform 4.2 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 three pages of the Alerting UI are the Alerts, the Silences, and the YAML pages.

The Alerts page is accessible by clicking Monitoring → Alerting → Alerts in the OpenShift Container Platform web console.

monitoring alerts screen

  1. Filtering alerts by their names.

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

  3. Alert name.

  4. Description of an alert.

  5. Current state of the alert and when the alert went into this state.

  6. Value of the Severity label of the alert.

  7. Actions you can do with the alert.

The Silences page is accessible by clicking Monitoring → Alerting → Silences in the OpenShift Container Platform web console.

monitoring silences screen

  1. Creating a silence for an alert.

  2. Filtering silences by their name.

  3. 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.

  4. Description of a silence. It includes the specification of alerts that it matches.

  5. Current state of the silence. For active silences, it shows when it ends, and for pending silences, it shows when it starts.

  6. Number of alerts that are being silenced by the silence.

  7. Actions you can do with a silence.

The YAML page is accessible by clicking Monitoring → Alerting → YAML in the OpenShift Container Platform web console.

monitoring yaml screen

  1. Upload a file with Alertmanager configuration.

  2. Examine and edit the current Alertmanager configuration.

  3. Save the updated Alertmanager configuration.

Also, next to the title of each of these pages is a link to the old Alertmanager interface.

Additional resources

Getting information about alerts and alerting rules

You can find an alert and see information about it or its governing alerting rule.

Procedure

  1. Open the OpenShift Container Platform web console and navigate to the Monitoring → Alerting → Alerts page.

  2. Optional: Filter the alerts by name using the Filter Alerts by name field.

  3. Optional: Filter the alerts by state using one or more of the state buttons Firing, Silenced, Pending, Not firing.

  4. Optional: Sort the alerts by clicking one or more of the Name, State, and Severity column headers.

  5. 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:

    monitoring alert overview

    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:

    monitoring alerting rule overview

    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:

  1. Navigate to the Monitoring → Alerting → Silences page of the OpenShift Container Platform web console.

  2. Click Create Silence.

  3. Populate the Create Silence form.

  4. To create the silence, click Create.

To silence a specific alert:

  1. Navigate to the Monitoring → Alerting → Alerts page of the OpenShift Container Platform web console.

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

  3. Optional: Modify the silence.

  4. To create the silence, click Create.

Getting information about silences

You can find a silence and view its details.

Procedure

  1. Open the OpenShift Container Platform web console and navigate to the Monitoring → Alerting → Silences page.

  2. Optional: Filter the silences by name using the Filter Silences by name field.

  3. Optional: Filter the silences by state using one or more of the state buttons Active, Pending, Expired.

  4. Optional: Sort the silences by clicking one or more of the Name, State, and Firing alerts column headers.

  5. 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

  1. Navigate to the Monitoring → Alerting → Silences page.

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

  3. 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

  1. Navigate to the Monitoring → Alerting → Silences page.

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

  3. Confirm by clicking Expire Silence. This expires the silence.

Next steps

Examine cluster metrics.