grafana-util docs

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 critical

SEE ALSO

grafana-util(1), grafana-util-alert(1)