From 1f012871b422c52348a3688e9668cc9564eb6583 Mon Sep 17 00:00:00 2001 From: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Date: Mon, 7 Jun 2021 13:07:06 -0400 Subject: [PATCH] Fix alerting docs (#35340) * First commit. * More changes, to make sure all alert information flows. * Updated a title --- docs/sources/alerting/_index.md | 52 +++++-------------- docs/sources/alerting/difference-old-new.md | 2 +- docs/sources/alerting/old-alerting/_index.md | 19 ++++--- .../alerting/unified-alerting/_index.md | 2 +- .../unified-alerting/alerting-rules/_index.md | 7 +-- .../alerting/unified-alerting/opt-in.md | 4 +- docs/sources/whatsnew/whats-new-in-v8-0.md | 4 +- 7 files changed, 34 insertions(+), 56 deletions(-) diff --git a/docs/sources/alerting/_index.md b/docs/sources/alerting/_index.md index 14e43b82a1a..20599a1953d 100644 --- a/docs/sources/alerting/_index.md +++ b/docs/sources/alerting/_index.md @@ -4,51 +4,23 @@ aliases = ["/docs/grafana/latest/alerting/rules/", "/docs/grafana/latest/alertin weight = 110 +++ -# Alerts overview +# Grafana alerts -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. +Alerts allow you to know about problems in your systems moments after they occur. Robust and actionable alerts help you identify and resolve issues quickly, minimizing disruption to your services. -Alerts consists of two parts: +Grafana 8.0 has new and improved alerts. The new alerting system are an [opt-in]({{< relref "./unified-alerting/opt-in.md" >}}) feature that centralizes alerting information for Grafana managed alerts and alerts from Prometheus-compatible data sources in one UI and API. -- 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. +Alerts have four main components: -Currently only the graph panel visualization supports alerts. +- Alerting rule - One or more query and/or expression, a condition, the frequency of evaluation, and the (optional) duration that a condition must be met before creating an alert. +- Contact point - A channel for sending notifications when the conditions of an alerting rule are met. +- Notification policy - A set of matching and grouping criteria used to determine where, and how frequently, to send notifications. +- Silences - Date and matching criteria used to silence notifications. -## Alert tasks +You can create and edit alerting rules for Grafana managed alerts, Cortex alerts, and Loki alerts as well as see alerting information from prometheus-compatible data sources in a single, searchable view. For more information, on how to create and edit alerts and notifications, refer to [Overview of Grafana 8.0 alerts]({{< relref "../alerting/unified-alerting/_index.md" >}}). -You can perform the following tasks for alerts: +As part of the new alert changes, we have introduced a new data source, Alertmanager, which includes built-in support for Prometheus Alertmanager. It is presently in alpha and it not accessible unless alpha plugins are enabled in Grafana settings. For more information, refer to [Alertmanager data source]({{< relref "../datasources/alertmanager.md" >}}). -- [Add or edit an alert notification channel]({{< relref "./old-alerting/notifications.md" >}}) -- [Create an alert rule]({{< relref "./old-alerting/create-alerts.md" >}}) -- [View existing alert rules and their current state]({{< relref "./old-alerting/view-alerts.md" >}}) -- [Test alert rules and troubleshoot]({{< relref "./old-alerting/troubleshoot-alerts.md" >}}) +> **Note:** Out of the box, Grafana still supports old Grafana alerts. They are legacy alerts at this time, and will be deprecated in a future release. For more information, refer to [Legacy Grafana alerts]({{< relref "./old-alerting/_index.md" >}}). -## Clustering - -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. - -## Notifications - -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. - -The actual notifications are configured and shared between multiple alerts. - -## Alert execution - -Alert rules are evaluated in the Grafana backend in a scheduler and query execution engine that is part -of core Grafana. Alert rules can query only backend data sources with alerting enabled. Such data sources are: -- builtin or developed and maintained by grafana, such as: `Graphite`, `Prometheus`, `Loki`, `InfluxDB`, `Elasticsearch`, - `Google Cloud Monitoring`, `Cloudwatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle`, and `Azure Data Explorer` -- any community backend data sources with alerting enabled (`backend` and `alerting` properties are set in the [plugin.json]({{< relref "../developers/plugins/metadata.md" >}})) - -## Metrics from the alert engine - -The alert engine publishes some internal metrics about itself. You can read more about how Grafana publishes [internal metrics]({{< relref "../administration/view-server/internal-metrics.md" >}}). - -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` +To learn more about the differences between new alerts and the legacy alerts, refer to [What's New with Grafana 8 Alerts]({{< relref "../alerting/difference-old-new.md" >}}). \ No newline at end of file diff --git a/docs/sources/alerting/difference-old-new.md b/docs/sources/alerting/difference-old-new.md index 56a7732fb97..aaae68ea737 100644 --- a/docs/sources/alerting/difference-old-new.md +++ b/docs/sources/alerting/difference-old-new.md @@ -5,7 +5,7 @@ keywords = ["grafana", "alerting", "guide"] weight = 112 +++ -# Differences between Grafana 8 alerts and legacy alerts +# What's New with Grafana 8 Alerts The Alerts released with Grafana 8.0 are an opt-in feature that centralizes alerting information for Grafana managed alerts and alerts from Prometheus-compatible datasources in one UI and API. You are able to create and edit alerting rules for Grafana managed alerts, Cortex alerts, and Loki alerts as well as see alerting information from prometheus-compatible datasources in a single, searchable view. ## Multi-dimensional alerting diff --git a/docs/sources/alerting/old-alerting/_index.md b/docs/sources/alerting/old-alerting/_index.md index d7f127896ec..9dc61318ad7 100644 --- a/docs/sources/alerting/old-alerting/_index.md +++ b/docs/sources/alerting/old-alerting/_index.md @@ -1,19 +1,22 @@ +++ -title = "Old Grafana Alerts" +title = "Legacy Grafana Alerts" aliases = ["/docs/grafana/latest/alerting/rules/", "/docs/grafana/latest/alerting/metrics/"] weight = 114 +++ -# Old Grafana alerts +# Legacy Grafana alerts -Alerts allow you to know about problems in your systems moments after they occur. Robust and actionable alerts help you identify and resolve issues quickly, minimizing disruption to your services. +Legacy Grafana alerts consists of two parts: -Alerts have four main components: +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. -- Alert rule - One or more conditions, the frequency of evaluation, and the (optional) duration that a condition must be met before notifying. -- Contact point - A channel for sending notifications when the conditions of an alert rule are met. -- Notification policy - A set of matching and grouping criteria used to determine where, and how frequently, to send notifications. -- Silences - Date and matching criteria used to silence notifications. +Currently only the graph panel visualization supports alerts. + +Legacy aerts have two main components: + +- Alert rule - 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. ## Alert tasks diff --git a/docs/sources/alerting/unified-alerting/_index.md b/docs/sources/alerting/unified-alerting/_index.md index d0d6b5584de..df985c730b2 100644 --- a/docs/sources/alerting/unified-alerting/_index.md +++ b/docs/sources/alerting/unified-alerting/_index.md @@ -4,7 +4,7 @@ aliases = ["/docs/grafana/latest/alerting/metrics/"] weight = 113 +++ -# Grafana 8 alerts +# Overview of Grafana 8 alerts Alerts allow you to know about problems in your systems moments after they occur. Robust and actionable alerts help you identify and resolve issues quickly, minimizing disruption to your services. >**Note:** This information is for the new, Grafana 8 Alerts. This is an [opt-in]({{< relref"./opt-in.md" >}}) feature released in Grafana 8.0. Grafana still supports [dashboard alerts]({{< relref "../old-alerting/_index.md" >}}) out of the box diff --git a/docs/sources/alerting/unified-alerting/alerting-rules/_index.md b/docs/sources/alerting/unified-alerting/alerting-rules/_index.md index 5e85cb36592..9a165cbae70 100644 --- a/docs/sources/alerting/unified-alerting/alerting-rules/_index.md +++ b/docs/sources/alerting/unified-alerting/alerting-rules/_index.md @@ -1,12 +1,13 @@ +++ -title = "Alerting Rules" +title = "Create and manage rules" aliases = ["/docs/grafana/latest/alerting/rules/"] +weight = 130 +++ -# Alerting Rules +# Create and manage alerting Rules One or more queries and/or expressions, a condition, the frequency of evaluation, and the (optional) duration that a condition must be met before creating an alert. Alerting rules are how you express the criteria for creating an alert. Queries and expressions select and can operate on the data you wish to alert on. A condition sets the threshold that an alert must meet or exceed to create an alert. The interval specifies how frequently the rule should be evaluated. The duration, when configured, sets a period that a condition must be met or exceeded before an alert is created. Alerting rules also can contain settings for what to do when your query does not return any data, or there is an error attempting to execute the query. -- [View existing alert rules and their current state]({{< relref "./rule-list.md" >}}) - [Create Cortex or Loki managed alert rule]({{< relref "./create-cortex-loki-managed-rule.md" >}}) - [Create Grafana managed alert rule]({{< relref "./create-grafana-managed-rule.md" >}}) - [State and Health of alerting rules]({{< relref "./state-and-health.md" >}}) +- [View existing alert rules and their current state]({{< relref "./rule-list.md" >}}) diff --git a/docs/sources/alerting/unified-alerting/opt-in.md b/docs/sources/alerting/unified-alerting/opt-in.md index 846b191a58a..5ea95b747a5 100644 --- a/docs/sources/alerting/unified-alerting/opt-in.md +++ b/docs/sources/alerting/unified-alerting/opt-in.md @@ -1,9 +1,11 @@ +++ title = "Opt-in to Grafana 8 Alerts" -description = "How to enable Grafana 8 Alerts" +description = "Enable Grafana 8 Alerts" +weight = 128 +++ # Enable Grafana 8 Alerts + Setting the `ngalert` feature toggle enables the new Grafana 8 Alerting system. >**Note:** It is recommended to backup Grafana's database before enabling this feature. If you are using PostgreSQL as the backend data source, then the minimum required version is 9.5. diff --git a/docs/sources/whatsnew/whats-new-in-v8-0.md b/docs/sources/whatsnew/whats-new-in-v8-0.md index 7b021c2dae5..729c567edf3 100644 --- a/docs/sources/whatsnew/whats-new-in-v8-0.md +++ b/docs/sources/whatsnew/whats-new-in-v8-0.md @@ -24,9 +24,9 @@ The new alerts in Grafana 8.0 are an opt-in feature that centralizes alerting in As part of the new alert changes, we have introduced a new data source, Alertmanager, which includes built-in support for Prometheus Alertmanager. It is presently in alpha and it not accessible unless alpha plugins are enabled in Grafana settings. For more information, refer to [Alertmanager data source]({{< relref "../datasources/alertmanager.md" >}}). -> **Note:** Out of the box, Grafana still supports old Grafana alerts. They are legacy alerts at this time, and will be deprecated in a future release. +> **Note:** Out of the box, Grafana still supports old Grafana alerts. They are legacy alerts at this time, and will be deprecated in a future release. -To learn more about the differences between new alerts and the legacy alerts, refer to [Differences between Grafana 8.0 alerts and legacy alerts]({{< relref "../alerting/difference-old-new.md" >}}). +To learn more about the differences between new alerts and the legacy alerts, refer to [What's New with Grafana 8 Alerts]({{< relref "../alerting/difference-old-new.md" >}}). ### Library panels