grafana/docs/sources/alerting/_index.md

58 lines
2.6 KiB
Markdown
Raw Normal View History

+++
title = "Alerting"
type = "docs"
[menu.docs]
identifier = "alerting"
parent = "features"
weight = 6
+++
2020-05-15 16:33:37 -05:00
# Alerts overview
2020-05-15 16:33:37 -05:00
Alerts allow you to identify problems in your system moments after they occur. By quickly identifying unintended changes in your system, you can minimize disruptions to your services.
2020-05-15 16:33:37 -05:00
Alerts consists of two parts:
2020-05-15 16:33:37 -05:00
- Alert rules - When the alert is triggered. Alert rules are defined by one or more conditions that are regularly evaluated by Grafana.
- Notification channel - How the alert is delivered. When the conditions of an alert rule are met, the Grafana notifies the channels configured for that alert.
2020-05-15 16:33:37 -05:00
Currently only the graph panel visualization supports alerts.
2020-05-15 16:33:37 -05:00
## Alert tasks
2020-05-15 16:33:37 -05:00
You can perform the following tasks for alerts:
2020-05-15 16:33:37 -05:00
- [Add or edit an alert notification channel]({{< relref "notifications.md" >}})
- [Create an alert rule]({{< relref "create-alerts.md" >}})
- [View existing alert rules and their current state]({{< relref "view-alerts.md" >}})
- [Test alert rules and troubleshoot]({{< relref "troubleshoot-alerts.md" >}})
2020-05-15 16:33:37 -05:00
## Clustering
2020-05-15 16:33:37 -05:00
Currently alerting supports a limited form of high availability. Since v4.2.0 of Grafana, alert notifications are deduped when running multiple servers. This means all alerts are executed on every server but no duplicate alert notifications are sent due to the deduping logic. Proper load balancing of alerts will be introduced in the future.
2020-05-15 16:33:37 -05:00
## Notifications
2020-05-15 16:33:37 -05:00
You can also set alert rule notifications along with a detailed message about the alert rule. The message can contain anything: information about how you might solve the issue, link to runbook, and so on.
2020-05-15 16:33:37 -05:00
The actual notifications are configured and shared between multiple alerts.
2020-05-15 16:33:37 -05:00
## Alert execution
2020-05-15 16:33:37 -05:00
Alert rules are evaluated in the Grafana backend in a scheduler and query execution engine that is part
of core Grafana. Only some data sources are supported right now. They include `Graphite`, `Prometheus`, `InfluxDB`, `Elasticsearch`,
`Google Cloud Monitoring`, `Cloudwatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle`, and `Azure Data Explorer`.
2020-05-15 16:33:37 -05:00
## Metrics from the alert engine
2020-05-15 16:33:37 -05:00
The alert engine publishes some internal metrics about itself. You can read more about how Grafana publishes [internal metrics]({{< relref "../administration/metrics/" >}}).
2020-05-15 16:33:37 -05:00
Description | Type | Metric name
---------- | ----------- | ----------
Total number of alerts | counter | `alerting.active_alerts`
Alert execution result | counter | `alerting.result`
Notifications sent counter | counter | `alerting.notifications_sent`
Alert execution timer | timer | `alerting.execution_time`