grafana-util docs

grafana-util-alert-preview-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-preview-route - Preview the managed route inputs without changing runtime behavior.

SYNOPSIS

grafana-util alert preview-route [OPTIONS]

DESCRIPTION

Preview the managed route inputs without changing runtime behavior.

  • Inspect the matcher set you intend to feed into set-route.
  • Validate route inputs before writing the managed route document.

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.

COMMON OPTIONS

  • --desired-dir points to the staged alert tree.
  • --label adds preview matchers in key=value form.
  • --severity adds a convenience severity matcher value.

SUCCESS CRITERIA

  • 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-dir points at the staged tree you expect.

EXAMPLES

Preview the managed route inputs without changing runtime behavior.

grafana-util alert preview-route --desired-dir ./alerts/desired --label team=platform --severity critical

SEE ALSO

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