grafana-util alert preview-route
What this page covers
Preview the managed route inputs without changing runtime behavior.
When to open this page
- Inspect the matcher set you intend to feed into set-route.
- Validate route inputs before writing the managed route document.
Who this page is for
Best for operators who review alert rules, routes, contact points, and staged alert changes.
Purpose
Preview the managed route inputs without changing runtime behavior.
When to use
- Inspect the matcher set you intend to feed into
set-route. - Validate route inputs before writing the managed route document.
Key flags
--desired-dirpoints to the staged alert tree.--labeladds preview matchers inkey=valueform.--severityadds a convenience severity matcher value.
Before / After
- Before: guess whether a matcher set will behave the way you expect when it reaches
set-route. - After: preview the route inputs first so the intended receiver and labels are visible before writing files.
What success looks like
- The preview output matches the matcher set you plan to hand to
set-route. - The route shape is clear enough to review without editing the staged tree first.
Failure checks
- Check the labels and severity value if the preview does not match your intended route.
- Make sure
--desired-dirpoints at the staged tree you expect.
Examples
# Purpose: Preview the managed route inputs without changing runtime behavior.
grafana-util alert preview-route --desired-dir ./alerts/desired --label team=platform --severity critical