From cde86ff5678b5ef5c91dd42e8425818c15dad1f0 Mon Sep 17 00:00:00 2001
From: Diana Payton <52059945+oddlittlebird@users.noreply.github.com>
Date: Mon, 11 May 2020 12:12:04 -0700
Subject: [PATCH] Docs: Added Alert list visualization (#24453)

* added alert list panel topic

* Update alert-list-panel.md
---
 .../panels/visualizations/alert-list-panel.md | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 docs/sources/panels/visualizations/alert-list-panel.md

diff --git a/docs/sources/panels/visualizations/alert-list-panel.md b/docs/sources/panels/visualizations/alert-list-panel.md
new file mode 100644
index 00000000000..e961d013d9a
--- /dev/null
+++ b/docs/sources/panels/visualizations/alert-list-panel.md
@@ -0,0 +1,56 @@
++++
+title = "Alert list panel"
+keywords = ["grafana", "alert list", "documentation", "panel", "alertlist"]
+type = "docs"
+aliases = ["/docs/grafana/latest/reference/alertlist/", "/docs/grafana/latest/features/panels/alertlist/"]
+[menu.docs]
+name = "alert-list-panel"
+parent = "visualizations"
+weight = 750
+draft = "true"
++++
+
+
+# Alert list panel
+
+The alert list panel 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 [Alerting rules](http://docs.grafana.org/alerting/rules).
+
+{{< docs-imagebox img="/img/docs/v45/alert-list-panel.png" max-width="850px" >}}
+
+## Options
+
+Use these settings to refine your visualization.
+
+### Options
+
+- **Show -** Choose whether the panel should display the current alert state or recent alert state changes.
+- **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
+    - no_data: 2
+    - pending: 3
+    - ok: 4
+    - paused: 5
+- **Alerts from this dashboard -** Shows alerts only from the dashboard the alert list is in.
+
+### Filter
+
+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.
+- **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.
+
+### State filter
+
+Choose what alert states to display in this panel.
+- Ok
+- Paused
+- No data
+- Execution error
+- Alerting
+- Pending