From 295169b94f79af4d8316b9cc3a193fce0706a772 Mon Sep 17 00:00:00 2001
From: Stuart McLean <stuart.mclean@liquidm.com>
Date: Mon, 14 May 2018 20:50:44 +0200
Subject: [PATCH] add useful note to alerting api docs

---
 docs/sources/http_api/alerting.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/sources/http_api/alerting.md b/docs/sources/http_api/alerting.md
index 305bfccebe8..3b9eceddd5e 100644
--- a/docs/sources/http_api/alerting.md
+++ b/docs/sources/http_api/alerting.md
@@ -117,6 +117,13 @@ Content-Type: application/json
 }
 ```
 
+**Important Note**:
+"evalMatches" data is cached in the db when and only when the state of the alert changes
+(e.g. transitioning from "ok" to "alerting" state).
+
+If data from one server triggers the alert first and, before that server is seen leaving alerting state,
+a second server also enters a state that would trigger the alert, the second server will not be visible in "evalMatches" data.
+
 ## Pause alert
 
 `POST /api/alerts/:id/pause`