Alert list

Alert lists allow you to display a list of important alerts that you want to track. You can configure the alert list to show the current state of your alert, such as firing, pending, or normal. Learn more about alerts in Grafana Alerting overview.

On each dashboard load, this visualization queries the alert list, always providing the most up-to-date results.

Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Alert List.

Try it

Configure an alert list

Once you’ve created a dashboard, the following video shows you how to configure an alert list visualization:

Configuration options

The following section describes the configuration options available in the panel editor pane for this visualization. These options are, as much as possible, ordered as they appear in Grafana.

Panel options

In the Panel options section of the panel editor pane, set basic options like panel title and description, as well as panel links. To learn more, refer to Configure panel options.

Options

Use the following options to refine your alert list visualization.

Option	Description
View mode	Choose between List to display alerts in a detailed list format with comprehensive information, or Stat to show alerts as a summarized single-value statistic.
Group mode	Choose between Default grouping to show alert instances grouped by their alert rule, or Custom grouping to show alert instances grouped by a custom set of labels.
Max items	Sets the maximum number of alerts to list. By default, Grafana sets this value to 10.
Sort order	Select how to order the alerts displayed.
Alerts linked to this dashboard	Toggle the switch on to only show alerts from the dashboard the alert list is in.

Sort order

Select how to order the alerts displayed. Choose from:

Alphabetical (asc) - Alphabetical order.
Alphabetical (desc) - Reverse alphabetical order.
Importance - By importance according to the following values, with 1 being the highest:
- alerting: 1
- firing: 1
- no_data: 2
- pending: 3
- ok: 4
- paused: 5
- inactive: 5
Time (asc) - Newest active alert instances first.
Time (desc) - Oldest active alert instances first.

These options allow you to limit alerts shown to only those that match the query, folder, or tags you choose.

Option	Description
Alert name	Filter alerts by name.
Alert instance label	Filter alert instances using label querying. For example,`{severity="critical", instance=~"cluster-us-.+"}`.
Datasource	Filter alerts from the selected data source.
Folder	Filter alerts by the selected folder. Only alerts from dashboards in this folder are displayed.
Show alerts with 0 instances	Filter for alert rules with no instances. Alert rules with 0 (zero) instances are hidden by default. You can choose to show them by toggling this switch. Because these rules have no instances, they remain hidden if the Alert instance label filter is configured.

Choose which alert states to display in this visualization.

Option	Description
Alerting / Firing	Shows alerts that are currently active and triggering an alert condition.
Pending	Shows alerts that are in a transitional state, waiting for conditions to be met before triggering.
No Data	Shows alerts where the data source is not returning any data, which could indicate an issue with data collection.
Normal	Shows alerts that are in a normal or resolved state, where no alert condition is currently met.
Error	Shows alerts where an error has occurred, typically related to an issue in the alerting process.