mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 16:22:35 +08:00
139 lines
7.2 KiB
Markdown
139 lines
7.2 KiB
Markdown
---
|
|
aliases:
|
|
- ../../alerting/alerting-rules/view-state-health/ # /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/view-state-health
|
|
- ../../alerting/manage-notifications/view-state-health/ # /docs/grafana/<GRAFANA_VERSION>/alerting/manage-notifications/view-state-health/
|
|
- ../../alerting/manage-notifications/view-alert-state-on-panels/ # /docs/grafana/<GRAFANA_VERSION>/alerting/manage-notifications/view-alert-state-on-panels/
|
|
canonical: https://grafana.com/docs/grafana/latest/alerting/monitor-status/view-alert-state/
|
|
description: View the state and health of alert rules
|
|
keywords:
|
|
- grafana
|
|
- alert rules
|
|
- keep last state
|
|
- guide
|
|
- state
|
|
- health
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
title: View alert state
|
|
weight: 420
|
|
refs:
|
|
time-series-visualizations:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/time-series/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/time-series/
|
|
alert-list-panel:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/alert-list/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/alert-list/
|
|
link-alert-rules-to-panels:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/link-alert-rules-to-panels/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/link-alert-rules-to-panels/
|
|
alert-rule-state:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-rule-state
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-rule-state
|
|
alert-instance-state:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-instance-state
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-instance-state
|
|
alert-instance-state:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-instance-state
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/state-and-health/#alert-instance-state
|
|
alert-rule-health:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rule-evaluation/state-and-health/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/state-and-health/
|
|
---
|
|
|
|
# View alert state
|
|
|
|
An alert rule and its corresponding alert instances can transition through distinct states during the alert rule evaluation.
|
|
|
|
{{< figure src="/media/docs/alerting/alert-state-diagram2.png" alt="A diagram of the distinct alert instance states and transitions." max-width="750px" >}}
|
|
|
|
There are three key components that helps us understand the behavior of our alerts:
|
|
|
|
- [Alert Instance State](ref:alert-instance-state): Refers to the state of the individual alert instances.
|
|
- [Alert Rule State](ref:alert-rule-state): Determined by the "worst state" among its alert instances.
|
|
- [Alert Rule Health](ref:alert-rule-health): Indicates the status in cases of `Error` or `NoData` events.
|
|
|
|
## View alert rule and instance states
|
|
|
|
To view the state and health of your alert rules and the status of alert instances:
|
|
|
|
1. Click **Alerts & IRM** -> **Alerting**.
|
|
1. Click **Alert rules** to view the list of existing alert rules.
|
|
|
|
{{< figure src="/media/docs/alerting/view-alert-rule-list-with-actions.png" max-width="750px" alt="View alert rule state and alert rule health in Grafana Alerting" >}}
|
|
|
|
Each alert rule shows its state, health, summary, next evaluation time, and available actions such as **Pause evaluation**, **Silence notifications**, **Export**, **Delete**, and more.
|
|
|
|
1. Click on an alert rule to view additional details and its resulting alert instances.
|
|
|
|
{{< figure src="/media/docs/alerting/view-alert-instance-state.png" max-width="750px" alt="View alert rule state and alert rule health in Grafana Alerting" >}}
|
|
|
|
### View from the alert rule details page
|
|
|
|
To view more alert rule details, complete the following steps.
|
|
|
|
1. Click **Alerts & IRM** -> **Alerting** -> **Alert rules**.
|
|
1. Click to expand an alert rule.
|
|
1. In **Actions**, click **View** (the eye icon).
|
|
|
|
{{< figure src="/media/docs/alerting/alert-rule-view-page-with-breadcrumb.png" max-width="750px" alt="Alert rule view page in Grafana Alerting" >}}
|
|
|
|
The namespace and group are shown in the breadcrumb navigation. They are interactive and can be used to filter rules by namespace or group.
|
|
|
|
The rest of the alert detail content is split up into tabs:
|
|
|
|
**Query and conditions**
|
|
|
|
View the details of the query that is used for the alert rule, including the expressions and intermediate values for each step of the expression pipeline. A graph view is included for range queries and data sources that return time series-like data frames.
|
|
|
|
**Instances**
|
|
|
|
Explore each alert instance, its status, labels and various other metadata for multi-dimensional alert rules.
|
|
|
|
Use **Search by label** to enter search criteria using label selectors. For example, `environment=production,region=~US|EU,severity!=warning`.
|
|
|
|
**History**
|
|
|
|
Explore the recorded history for an alert rule. You can also filter by alert state.
|
|
|
|
**Details**
|
|
|
|
Debug or audit using the alert rule metadata and view the alert rule annotations.
|
|
|
|
## View alert state on panels
|
|
|
|
When an [alert rule is linked to a time series panel](ref:link-alert-rules-to-panels), the time series panel displays the alert state and alert events.
|
|
|
|
A heart icon near the panel title shows the current alert state:
|
|
|
|
- A broken red heart when the alert is in `Alerting` state.
|
|
- A green heart when the alert is in `Normal` state.
|
|
|
|
Colored annotations indicate changes in alert state, such as pending, alerting, and resolving.
|
|
|
|
{{< figure src="/media/docs/alerting/panel-displays-alert-state.png" max-width="1200px" alt="A panel with a firing alert and annotations that display the pending and alerting state changes." >}}
|
|
|
|
Additionally, Grafana provides an [alert list panel](ref:alert-list-panel) that you can add to a dashboard to display a list of alerts and their states.
|
|
|
|
{{< figure src="/static/img/docs/alert-list-panel/alert-list-panel.png" max-width="850px" alt="Two alert list panels displaying distinct lists of alerts." >}}
|
|
|
|
You can configure the alert list panel with various visualization options and filters to control how alerts are displayed. For more details, refer to the [Alert list documentation](ref:alert-list-panel).
|
|
|
|
{{< docs/play title="this demo dashboard with alert list panels and linked alert rules" url="https://play.grafana.org/d/000000074/" >}}
|