grafana-util docs
Home / Manpages / grafana-util-dashboard-impact.1

grafana-util-dashboard-impact.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-dashboard-impact - Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

SYNOPSIS

grafana-util dashboard impact [OPTIONS]

DESCRIPTION

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

Use this when you are about to change, migrate, or troubleshoot one datasource and need to know which dashboards and alert resources depend on it before you touch the live system. Prefer direct live or local inputs for the common path; keep governance artifacts for reuse.

BEFORE / AFTER

  • Before: datasource risk is inferred from memory, naming conventions, or manual Grafana searches.
  • After: one impact run tells you which dashboards and alert-linked resources are downstream of a datasource UID.

COMMON OPTIONS

--url
analyze live Grafana directly.
--input-dir
analyze a local export tree directly.
--input-format
choose raw or provisioning when analyzing local exports.
--governance
dashboard governance JSON input (governance-json artifact).
--datasource-uid
datasource UID to trace.
--alert-contract
optional alert contract JSON input.
--output-format
render text or json.
--interactive
open the interactive terminal browser.

SUCCESS CRITERIA

  • you can name the dashboards affected by one datasource change before you modify the datasource itself
  • alert resources appear in the same report when alert contract data is available
  • the result is concrete enough to use in a review ticket, migration plan, or incident response handoff

FAILURE CHECKS

  • if the result is empty, confirm the datasource UID matches the governance artifact instead of the display name you remember from Grafana
  • if alert-linked resources are missing, check whether you supplied --alert-contract
  • if the JSON is going into CI or an external tool, validate the top-level shape before you assume a zero-impact result is real

EXAMPLES

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

grafana-util dashboard impact \

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

  --url http://localhost:3000 \

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

  --basic-user admin \

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

  --basic-password admin \

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

  --datasource-uid prom-main \

Estimate the blast radius of one datasource directly from live Grafana, a local export tree, or reusable dashboard governance artifacts.

  --output-format text

SEE ALSO

grafana-util(1)