Manage alerting policies and groups

Google Distributed Cloud (GDC) air-gapped lets you manage alerting policies, rule groups, and alert status to control notifications for critical project events. From the GDC console, you can view configured alerts and policies, silence alerts, and update or delete alert rules and groups.

An alerting policy defines the conditions and actions that determine when and how you receive alert notifications. Each policy consists of alert rule groups, which organize individual alert rules by system, application, severity, or other criteria.

For information about creating alert rules, see Create alert rules. To view and filter open alerts, see Query and view open alerts.

Before you begin

To manage alerts and policies custom resources, request the necessary permissions from your administrator.

Required IAM roles

Contact your IAM Project Admin to request the following roles:

  • Project Cortex Alertmanager Editor (project-cortex-alertmanager-editor): edit the Cortex Alertmanager instance in the project namespace.
  • Project Cortex Alertmanager Viewer (project-cortex-alertmanager-viewer): access the Cortex Alertmanager instance in the project namespace.

View configured alerts

Obtain a list of the latest alerts in your project and click an alert name for more details. The GDC console shows the most recent alerts.

View the alerts in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerts tab.
  5. View the list of alerts.
  6. Click an alert name to view the alert details.

Silence an alert

Silence an alert for a specific time. When you silence an alert, you temporarily prevent it from opening for a period, even if the condition is met.

Silence an alert from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerts tab.
  5. Click an alert name to view the alert details.
  6. Click Silence alert.
  7. In the Silence duration field, choose the length of time to silence the alert.
  8. In the Enter a justification field, choose a justification.
  9. Click Confirm.
  10. To view all silenced alerts, click Filter in the Alerts silenced section of the Alerts tab.
  11. To remove a silence from an alert, click the name of the silenced alert and then click Remove silence.

View alerting policies

Obtain a list of all alert group rules in a project and select a group for more details.

View all alert group rules in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerting Policy tab.
  5. View the list of alert rule groups.
  6. Click a rule group name to view its details and the list of its alert rules.
  7. Click an alert rule name to view the alert rule details.

Update alert rule groups

Alert rule groups contain alert rules. Select a rule group and edit the rule group details.

Update alert rule groups in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerting Policy tab.
  5. View the list of alert rule groups.
  6. Click a rule group name that has the Editable value in the Permissions column.
  7. In the rule group details page, click Edit next to the field that you want to update, such as Limit.
  8. Edit the value and click Save.

Delete alert rule groups

Select a rule group and delete it. When you delete an alert rule group, the alert rules associated with the group are also deleted.

Delete alert rule groups in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerting Policy tab.
  5. Click the name of the rule group that you want to delete. The rule group must have the Editable value in the Permissions column so you can delete it.
  6. Click Delete.
  7. In the confirmation dialog, click Confirm to delete.

Update alert rules

Select a rule group and edit an alert rule that belongs to the group.

Update alert rules in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerting Policy tab.
  5. Click the name of the rule group that contains the rule that you want to update. The rule group must have the Editable value in the Permissions column so you can update its alert rules.
  6. In the Alert rules section, click a rule that is editable.
  7. In the Edit alert rule page, edit the values and click Save.

Delete alert rules

Select a rule group and delete an alert rule that belongs to the group.

Delete alert rules in a project from the GDC console:

  1. Sign in to the GDC console.
  2. In the GDC console, select a project.
  3. In the navigation menu, select Operations > Alerting.
  4. Click the Alerting Policy tab.
  5. Click the name of the rule group that contains the rule that you want to delete. The rule group must have the Editable value in the Permissions column so you can delete its alert rules.
  6. In the Alert rules section, select the checkbox for the rule that you want to delete.
  7. Click Delete.
  8. In the confirmation dialog, click Confirm to delete.