Home / Manpages / grafana-util-datasource-diff.1

grafana-util-datasource-diff.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-datasource-diff - Compare datasource inventory from a local bundle against live Grafana and print an operator-summary diff report.

SYNOPSIS

grafana-util datasource diff [OPTIONS]

DESCRIPTION

Compare datasource inventory from a local bundle against live Grafana and print an operator-summary diff report.

Use this when you want a concise live-versus-local difference report before import.

BEFORE / AFTER

Before: you had to inspect local and live datasource JSON by hand to find drift.
After: one diff command shows what changed between the bundle and Grafana before you import anything.
JSON mode includes a shared diff envelope plus field-level changes[{field,before,after}].

COMMON OPTIONS

--diff-dir: local datasource bundle to compare.
--input-format: choose inventory or provisioning.
--output-format: choose text or json.

SUCCESS CRITERIA

you can explain the change set before import
inventory and provisioning inputs both produce a readable summary
the output makes it obvious whether the bundle or the live side changed

FAILURE CHECKS

if the diff is unexpectedly empty, verify the bundle path and --input-format
if the live side looks wrong, confirm the target Grafana and org scope before trusting the report
if the diff is noisy, make sure you are comparing the intended inventory bundle rather than an older provisioning tree

EXAMPLES