[Observability/Kibana][Alerting] Document per-alert snooze - #7522
Conversation
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
🔍 Preview links for changed docs |
Elastic Docs Style Checker (Vale)Summary: 9 suggestions found 💡 Suggestions (9): Optional style improvements. Apply when helpful.
The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale. |
The custom-threshold-warning-threshold anchor now lives in the warning-severity PR (#7643), which broke the docs build for this PR. Link to the page instead until that PR merges.
The snooze-alerts anchor lives in the per-alert snooze PR (#7522), not yet merged. Link to the page instead until that PR merges.
These sentences referenced the snooze-alert-options anchor, which lives in the per-alert snooze PR (#7522) and doesn't exist yet, so the docs build had auto-commented them out. Link to the page instead until that PR merges.
js-jankisalvi
left a comment
There was a problem hiding this comment.
Content looks good, maybe some screenshots could be helpful.
|
|
||
| To snooze an active alert, open its action menu ({icon}`boxes_vertical`) from the Alerts table or the alert details page, then select **Snooze**. Choose **Quick Snooze** when you know how long it should stay quiet, or **Condition based** when you'd rather the alert itself, not the clock, decide when actions resume. Configure your snooze, then select **Snooze alert** to apply it. | ||
|
|
||
| ### Quick Snooze [quick-snooze] |
There was a problem hiding this comment.
nit: Should we add a screenshot for quick snnoze?
There was a problem hiding this comment.
Screenshots are pretty expensive in terms of maintenance so the Elastic style guide recommends only including them when UIs are so complex that they can't be clearly described using text.
|
|
||
| Pick **Indefinitely** when you have no fixed window in mind, such as an alert you've triaged and will follow up on yourself. It stays snoozed until you unsnooze it manually, and is also what existing muted alerts show as. | ||
|
|
||
| ### Condition based snooze [condition-based-snooze] |
There was a problem hiding this comment.
nit: Should we a screenshot for condition based snooze?
mdbirnstiehl
left a comment
There was a problem hiding this comment.
LGTM! I had a few suggestions/comments, do with them what you will!
Summary
Documents per-alert snooze: snooze a single alert instance for a duration, until a condition is met, or indefinitely, without silencing the whole rule. Snooze replaces Mute going forward; alerts muted on earlier versions keep working and show as snoozed indefinitely. To avoid duplicating this explanation across pages, the Observability Alerts page now links to the canonical Snooze/Mute reference in the Kibana alerting docs instead of repeating it.
Fixes #7334.
Previews
Note: The "Snooze options" tip in
view-alerts.mdlinks to the custom/metric threshold rule pages without the specific#custom-threshold-warning-thresholdanchor, since that section lives in #7643 (still open). Once #7643 merges, that anchor can be added back.Generative AI disclosure