public/grafana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(alerting): updates Missing series evaluations to resolve option (#106319)

Browse Source 
docs(alerting): correct detailed process of the missingSeriesToEval option
This commit is contained in:
Pepe Cano
2025-06-05 00:05:22 +02:00
committed by GitHub
parent 33298550b4
commit be8d153dc3
2 changed files with 15 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/sources/alerting/best-practices/missing-data.md
+9 -12
View File
@@ -88,8 +88,7 @@ The following tables illustrate both scenarios using the previous example, with
| :---- | :--------- | :--------- | :--------------------------- |
| 00:00 | 1.5s 🟢 | 1s 🟢 | ✅ No Alert |
| 01:00 | No Data ⚠️ | No Data ⚠️ | ⚠️ No Alert (Silent Failure) |
| 02:00 | No Data ⚠️ | No Data ⚠️ | ⚠️ No Alert (Silent Failure) |
| 03:00 | 1.4s 🟢 | 1s 🟢 | ✅ No Alert |
| 02:00 | 1.4s 🟢 | 1s 🟢 | ✅ No Alert |
**MissingSeries Scenario:** Only a specific series (`region2`) disappears:
@@ -97,8 +96,7 @@ The following tables illustrate both scenarios using the previous example, with
| :---- | :------ | :---------------- | :--------------------------- |
| 00:00 | 1.5s 🟢 | 1s 🟢 | ✅ No Alert |
| 01:00 | 1.6s 🟢 | Missing Series ⚠️ | ⚠️ No Alert (Silent Failure) |
| 02:00 | 1.6s 🟢 | Missing Series ⚠️ | ⚠️ No Alert (Silent Failure) |
| 03:00 | 1.4s 🟢 | 1s 🟢 | ✅ No Alert |
| 02:00 | 1.4s 🟢 | 1s 🟢 | ✅ No Alert |
In both cases, something broke silently.
@@ -162,14 +160,13 @@ Grafana marks missing series as [**stale**](ref:stale-alert-instances) after two
If an alert instance becomes stale, you’ll find it in the [alert history](ref:alert-history) as `Normal (Missing Series)` before it disappears. This table shows the eviction process from the previous example:
| Time | region1 | region2 | Alert triggered |
| :---- | :-------------------- | :--------------------------------- | :--------------------------------------------------------------------------------------------- |
| 00:00 | 1.5s 🟢 | 1s 🟢 | 🟢🟢 No Alerts |
| 01:00 | 3s 🔴 <br> `Alerting` | 3s 🔴 <br> `Alerting` | 🔴🔴 Alert instances triggered for both regions |
| 02:00 | 1.6s 🟢 | MissingSeries ⚠️ <br> `Alerting` ️ | 🟢🔴 Region2 missing, state maintained. |
| 03:00 | 1.6s 🟢 | MissingSeries ⚠️ `Alerting`️ | 🟢🔴Region2 missing, state maintained. |
| 04:00 | 1.4s 🟢 | — | 🟢 🟢 `region2` Normal (Missing Series), resolved, and instance evicted; 📩 Notification sent. |
| 05:00 | 1.4s 🟢 | — | 🟢 No Alerts |
| Time | region1 | region2 | Alert triggered |
| :---- | :-------------------- | :------------------------------------ | :----------------------------------------------------------------------- |
| 00:00 | 1.5s 🟢 | 1s 🟢 | 🟢🟢 No Alerts |
| 01:00 | 3s 🔴 <br> `Alerting` | 3s 🔴 <br> `Alerting` | 🔴🔴 Alert instances triggered for both regions |
| 02:00 | 1.6s 🟢 | `(MissingSeries)`⚠️ <br> `Alerting` ️ | 🟢🔴 Region2 missing, state maintained. |
| 03:00 | 1.4s 🟢 | `(MissingSeries)` <br> `Normal` | 🟢🟢 `region2` was resolved, 📩 notification sent, and instance evicted. |
| 04:00 | 1.4s 🟢 | — | 🟢 No Alerts. `region2` was evicted. |
###