docs: rewrite new alert list panel docs (#50406)

Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
This commit is contained in:
Gilles De Mey 2022-06-08 15:23:16 +02:00 committed by GitHub
parent fee0b9d1f2
commit 4c8c8e9741
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

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/" >}}).
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,17 @@ 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
- Inactive
- No Data
- Normal
- Error