update triage slo burn rate breaches page

elastic · Sep 25, 2024 · 3953fd8 · 3953fd8
1 parent dfe4232
commit 3953fd8
Show file tree

Hide file tree

Showing 3 changed files with 22 additions and 11 deletions.
diff --git a/docs/en/observability/images/slo-burn-rate-breach.png b/docs/en/observability/images/slo-burn-rate-breach.png
diff --git a/docs/en/observability/triage-slo-burn-rate-breaches.asciidoc b/docs/en/observability/triage-slo-burn-rate-breaches.asciidoc
@@ -18,15 +18,23 @@ You can follow the links to navigate to the source SLO or rule definition.
 
 Explore charts on the page to learn more about the SLO breach:
 
+* *Burn rate chart*. The first chart shows the burn rate during the time range when the alert was active.
+The line indicates how close the SLO came to breaching the threshold.
++
 [role="screenshot"]
 image::images/slo-burn-rate-breach.png[Alert details for SLO burn rate breach]
++
+[TIP]
+====
+The timeline is annotated to show when the threshold was breached.
+You can hover over an alert icon to see the timestamp of the alert.
+====
 
-* The first chart shows the burn rate during the time range when the alert was active.
-The line indicates how close the SLO came to breaching the threshold.
-* The next chart shows the alerts history over the last 30 days.
+* *Alerts history chart*. The next chart shows the alerts history over the last 30 days.
 It shows the number of alerts that were triggered and the average time it took to recover after a breach.
-* Both timelines are annotated to show when the threshold was breached.
-You can hover over an alert icon to see the timestamp of the alert.
++
+[role="screenshot"]
+image::images/log-threshold-breach-alert-history-chart.png[Alert history chart in alert details for SLO burn rate breach]
 
 The number, duration, and frequency of these breaches over time gives you an indication of how severely the service is degrading so that you can focus on high severity issues first.
 

diff --git a/docs/en/observability/triage-threshold-breaches.asciidoc b/docs/en/observability/triage-threshold-breaches.asciidoc
@@ -22,7 +22,14 @@ Explore charts on the page to learn more about the threshold breach:
 * *Charts for each condition*. The page includes a chart for each condition specified in the rule.
 These charts help you understand when the breach occurred and its severity.
 +
+[role="screenshot"]
 image::images/log-threshold-breach-condition-chart.png[Chart for a condition in alert details for log threshold breach]
++
+[TIP]
+====
+The timeline is annotated to show when the threshold was breached.
+You can hover over an alert icon to see the timestamp of the alert.
+====
 
 * *Log rate analysis chart*. If your rule is intended to detect log threshold breaches
 (that is, it has a single condition that uses a count aggregation),
@@ -32,20 +39,16 @@ Notice that you can adjust the baseline and deviation, and then run the analysis
 For more information about using the log rate analysis feature,
 refer to the {kibana-ref}/xpack-ml-aiops.html#log-rate-analysis[AIOps Labs] documentation.
 +
+[role="screenshot"]
 image::images/log-threshold-breach-log-rate-analysis.png[Log rate analysis chart in alert details for log threshold breach]
 
 * *Alerts history chart*. The page may also include an alerts history chart that shows the number of
 triggered alerts per day for the last 30 days.
 This chart is currently only available for rules that specify a single condition.
 +
+[role="screenshot"]
 image::images/log-threshold-breach-alert-history-chart.png[Alert history chart in alert details for log threshold breach]
 
-[TIP]
-====
-Timelines on the page are annotated to show when the threshold was breached.
-You can hover over an alert icon to see the timestamp of the alert.
-====
-
 Analyze these charts to better understand when the breach started, it's current
 state, and how the issue is trending.