grafana-util-alert-set-route.1
Browser-readable rendering of a generated roff manpage.
This page renders the generated roff manpage into readable HTML for browser use. For richer per-subcommand detail, prefer the command-reference pages.
NAME
grafana-util-alert-set-route - Author or replace the tool-owned staged notification route.
SYNOPSIS
grafana-util alert set-route [OPTIONS]
DESCRIPTION
Author or replace the tool-owned staged notification route.
- Replace the managed route with a new receiver and matcher set.
- Re-run the command to fully replace the managed route instead of merging fields.
BEFORE / AFTER
- Before: edit the managed route tree by hand and keep the matcher shape in your head.
- After: write one staged route document that encodes the receiver and matcher set you want.
COMMON OPTIONS
- --desired-dir points to the staged alert tree.
- --receiver sets the route receiver.
- --label adds route matchers in key=value form.
- --severity adds a convenience severity matcher.
- --dry-run renders the managed route document without writing files.
SUCCESS CRITERIA
- The staged route tree contains the receiver and matcher values you intended.
- A dry-run shows the route document you would write before touching files.
- The route is easy to compare against preview-route output.
FAILURE CHECKS
- Check that --desired-dir points at the correct staged tree before overwriting anything.
- Verify the receiver and matcher labels before trusting the generated route.
- If the dry-run does not match the intended route, stop and correct the matcher set first.
EXAMPLES
Author or replace the tool-owned staged notification route.
grafana-util alert set-route --desired-dir ./alerts/desired --receiver pagerduty-primary --label team=platform --severity criticalSEE ALSO
grafana-util(1), grafana-util-alert(1)