grafana-util-alert-apply.1

NAME

grafana-util-alert-apply - Apply a reviewed alert management plan.

SYNOPSIS

grafana-util alert apply [OPTIONS]

DESCRIPTION

Apply a reviewed alert management plan.

• Execute a plan that was reviewed outside the live Grafana connection.
• Require explicit acknowledgement before touching Grafana.

BEFORE / AFTER

• Before: a reviewed alert plan still leaves one risky question open: what actually happens when someone presses go against live Grafana?
• After: alert apply turns that final step into an explicit command with approval, reproducible auth, and machine-readable output.

COMMON OPTIONS

• --plan-file points to the reviewed plan document.
• --approve is required before execution is allowed.
• --output-format renders apply output as text or json.

SUCCESS CRITERIA

• a reviewed alert plan can be applied without hand-editing YAML or replaying a sequence of UI clicks
• the live apply step keeps approval explicit instead of hiding it in shell history
• JSON output is stable enough to feed into CI, change records, or a post-apply verification step

FAILURE CHECKS

• if apply refuses to run, confirm that the plan file is the reviewed artifact and that --approve is present
• if the live result differs from the expected plan, re-check credentials, org scope, and whether the reviewed plan matches the current target Grafana
• if automation reads the output, prefer --output-format json and validate the result shape before treating the apply as successful

EXAMPLES

Apply a reviewed alert management plan.

grafana-util alert apply --plan-file ./alert-plan-reviewed.json --approve

SEE ALSO

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