[v9.0.x] Docs: Manual backport of alert list panel docs rewrite (#50516)

Co-authored-by: Gilles De Mey <gilles.de.mey@gmail.com>
This commit is contained in:
Grot (@grafanabot)
2022-06-09 16:27:59 +02:00
committed by GitHub
co-authored by Gilles De Mey
parent 06ed6d25f5
commit 7a4e3a3588
+14 -11
View File
@@ -16,25 +16,29 @@ weight: 100
# Alert list
The Alert list allows you to display your dashboards alerts. You can configure the list to show current state or recent state changes. You can read more about alerts in [Alerts overview]({{< relref "../alerting/_index.md" >}}).
Use Alert list to display your alerts. You can configure the list to show the current state or recent state changes. You can read more about alerts in [Grafana Alerting overview]({{< relref "../alerting/" >}}).
{{< figure src="/static/img/docs/v45/alert-list-panel.png" max-width="850px" >}}
{{< figure src="/static/img/docs/alert-list-panel/alert-list-panel.png" max-width="850px" >}}
Use these settings to refine your visualization.
Customize your visualization using the following settings.
## Options
- **Show -** Choose whether the panel should display the current alert state or recent alert state changes.
- **Group mode -** Choose between "Default grouping" to show alert instances grouped by their alert rule, or "Custom grouping" to group alert instances by a custom set of labels.
- **Max Items -** Sets the maximum number of alerts to list.
- **Sort order -** Select how to order the alerts displayed:
- **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.
- **Alerts from this dashboard -** Shows alerts only from the dashboard the alert list is in.
## Filter
@@ -42,17 +46,16 @@ Use these settings to refine your visualization.
These options allow you to limit alerts shown to only those that match the query, folder, or tags you choose.
- **Alert name -** Enter an alert name query.
- **Dashboard title -** Enter a dashboard title query.
- **Alert instance label -** Filter alert instances using label querying, ex: `{severity="critical", instance=~"cluster-us-.+"}`.
- **Folder -** Select a folder. Only alerts from dashboards in the folder selected will be displayed.
- **Dashboard tags -** Select one or more tags. Only alerts from dashboards with one or more of the tags will be displayed.
- **Datasource -** Filter alerts from the selected data source.
## State filter
Choose which alert states to display in this panel.
- Ok
- Paused
- No data
- Execution error
- Alerting
- Alerting / Firing
- Pending
- No Data
- Normal
- Error