2022-05-26 23:06:25 +08:00
---
aliases:
2024-03-14 23:58:18 +08:00
- ../../alerting/unified-alerting/alerting-rules/rule-list/ # /docs/grafana/< GRAFANA_VERSION > /alerting/unified-alerting/alerting-rules/rule-list
- ../../alerting/alerting-rules/view-alert-rules/ # /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/view-alert-rules
- ../../alerting/alerting-rules/rule-list/ # /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/rule-list
2023-07-18 18:29:00 +08:00
canonical: https://grafana.com/docs/grafana/latest/alerting/manage-notifications/view-alert-rules/
2023-12-12 19:02:58 +08:00
description: View and filter by alert rules
2022-05-26 23:06:25 +08:00
keywords:
- grafana
- alerting
- guide
- rules
- view
Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-07-18 16:10:12 +08:00
labels:
products:
- cloud
- enterprise
- oss
2022-10-17 17:48:39 +08:00
title: View and filter alert rules
2022-10-27 20:21:02 +08:00
weight: 410
2022-05-26 23:06:25 +08:00
---
2021-05-28 22:17:33 +08:00
2022-10-17 17:48:39 +08:00
# View and filter alert rules
2021-05-28 22:17:33 +08:00
2022-06-20 19:24:22 +08:00
The Alerting page lists all existing alert rules. By default, rules are grouped by types of data sources. The Grafana section lists all Grafana managed rules. Alert rules for Prometheus compatible data sources are also listed here. You can view alert rules for Prometheus compatible data sources but you cannot edit them.
2021-07-27 03:05:49 +08:00
2022-06-20 19:24:22 +08:00
The Mimir/Cortex/Loki rules section lists all rules for Mimir, Cortex, or Loki data sources. Cloud alert rules are also listed in this section.
2021-05-28 22:17:33 +08:00
2023-02-03 00:31:03 +08:00
When managing large volumes of alerts, you can use extended alert rule search capabilities to filter on folders, evaluation groups, and rules. Additionally, you can filter alert rules by their properties like labels, state, type, and health.
2022-10-17 17:48:39 +08:00
- [View and filter alert rules ](#view-and-filter-alert-rules )
2022-06-20 19:24:22 +08:00
- [View alert rules ](#view-alert-rules )
2023-02-03 00:31:03 +08:00
- [Export alert rules ](#export-alert-rules )
- [View query definitions for provisioned alerts ](#view-query-definitions-for-provisioned-alerts )
2022-06-20 19:24:22 +08:00
- [Grouped view ](#grouped-view )
2022-04-05 22:22:43 +08:00
- [State view ](#state-view )
2022-06-20 19:24:22 +08:00
- [Filter alert rules ](#filter-alert-rules )
2021-05-28 22:17:33 +08:00
2022-06-20 19:24:22 +08:00
## View alert rules
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
To view alerting details:
2021-05-28 22:17:33 +08:00
2023-11-08 20:43:46 +08:00
1. Click **Alerts & IRM** -> **Alert rules** . By default, the List view displays.
1. In **View as** , toggle between Grouped, List, or State views by clicking the relevant option. See [Grouped view ](#grouped-view ) and [State view ](#state-view ) for more information.
2021-10-28 04:57:54 +08:00
1. Expand the rule row to view the rule labels, annotations, data sources the rule queries, and a list of alert instances resulting from this rule.
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
{{< figure src = "/static/img/docs/alerting/unified/rule-details-8-0.png" max-width = "650px" caption = "Alerting rule details" > }}
2021-05-28 22:17:33 +08:00
2023-02-03 00:31:03 +08:00
From the Alert list page, you can also make copies of alert rules to help you reuse existing alert rules.
## Export alert rules
2023-11-08 20:43:46 +08:00
Click the **Export rule group** icon next to each alert rule group to export to YAML, JSON, or Terraform.
2023-02-03 00:31:03 +08:00
2024-01-29 23:52:34 +08:00
Click **Export rules** to export all Grafana-managed alert rules to YAML, JSON, or Terraform.
2023-11-08 20:43:46 +08:00
Click **More** -> **Modify export** next to each individual alert rule within a group to edit provisioned alert rules and export a modified version.
2023-02-03 00:31:03 +08:00
## View query definitions for provisioned alerts
View read-only query definitions for provisioned alerts. Check quickly if your alert rule queries are correct, without diving into your "as-code" repository for rule definitions.
2022-06-20 19:24:22 +08:00
### Grouped view
2021-07-27 03:05:49 +08:00
2022-06-20 19:24:22 +08:00
Grouped view shows Grafana alert rules grouped by folder and Loki or Prometheus alert rules grouped by `namespace` + `group` . This is the default rule list view, intended for managing rules. You can expand each group to view a list of rules in this group. Expand a rule further to view its details. You can also expand action buttons and alerts resulting from the rule to view their details.
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
{{< figure src = "/static/img/docs/alerting/unified/rule-list-group-view-8-0.png" max-width = "800px" caption = "Alerting grouped view" > }}
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
### State view
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
State view shows alert rules grouped by state. Use this view to get an overview of which rules are in what state. Each rule can be expanded to view its details. Action buttons and any alerts generated by this rule, and each alert can be further expanded to view its details.
2021-05-28 22:17:33 +08:00
2021-10-28 04:57:54 +08:00
{{< figure src = "/static/img/docs/alerting/unified/rule-list-state-view-8-0.png" max-width = "800px" caption = "Alerting state view" > }}
2021-05-28 22:17:33 +08:00
2022-06-20 19:24:22 +08:00
## Filter alert rules
2021-05-28 22:17:33 +08:00
2022-06-20 19:24:22 +08:00
To filter alert rules:
2021-05-28 22:17:33 +08:00
2022-06-20 19:24:22 +08:00
- From **Select data sources** , select a data source. You can see alert rules that query the selected data source.
2021-10-28 04:57:54 +08:00
- In the **Search by label** , enter search criteria using label selectors. For example, `environment=production,region=~US|EU,severity!=warning` .
- From **Filter alerts by state** , select an alerting state you want to see. You can see alerting rules that match the state. Rules matching other states are hidden.