From c4e8f6e809d2c27a534148f66966d0fb3f74149a Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Wed, 18 Sep 2019 19:32:53 +0200 Subject: [PATCH] Docs: Note when using For and No Data in alert rule (#19185) Add a note to documentation regarding using For and No Data. Co-Authored-By: Kyle Brandt --- docs/sources/alerting/rules.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/sources/alerting/rules.md b/docs/sources/alerting/rules.md index 510f466c3eb..eebe7382c1d 100644 --- a/docs/sources/alerting/rules.md +++ b/docs/sources/alerting/rules.md @@ -51,7 +51,9 @@ Here you can specify the name of the alert rule and how often the scheduler shou ### For -> This setting is available in Grafana 5.4 and above. +> **Important note regarding No Data:** +> +> Do not use `For` with the `If no data or all values are null` setting set to `No Data`. The triggering of `No Data` will trigger instantly and not take `For` into consideration. This may also result in that an OK notification not being sent if alert transitions from `No Data -> Pending -> OK`. If an alert rule has a configured `For` and the query violates the configured threshold it will first go from `OK` to `Pending`. Going from `OK` to `Pending` Grafana will not send any notifications. Once the alert rule has been firing for more than `For` duration, it will change to `Alerting` and send alert notifications.