grafana-util-dashboard-publish.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-publish - Publish one local dashboard JSON file through the existing dashboard import pipeline.
SYNOPSIS
grafana-util dashboard publish [OPTIONS]
DESCRIPTION
Publish one local dashboard JSON file through the existing dashboard import pipeline.
Use this when a local draft is ready to go live and you want the command to stage or push it through the same import path used by the CLI.
COMMON OPTIONS
- --input
- dashboard JSON file to publish. Use - to read one wrapped or bare dashboard JSON document from standard input.
- --replace-existing
- update an existing dashboard when the UID already exists.
- --folder-uid
- override the destination folder UID. The built-in General folder is normalized back to the default root publish path instead of sending a literal general folder UID.
- --message
- revision message stored in Grafana.
- --dry-run
- preview the publish without changing Grafana.
- --watch
- rerun publish or dry-run whenever the local input file changes. Use this with a local file path, not --input -. The watcher reports change detection, transient failures, and reruns, and keeps watching until you stop it.
- --table, --json
- dry-run output modes.
EXAMPLES
Publish one local dashboard JSON file through the existing dashboard import pipeline.
grafana-util dashboard publish --url http://localhost:3000 --basic-user admin --basic-password admin --input ./drafts/cpu-main.json --folder-uid infra --message 'Promote CPU dashboard'SEE ALSO
grafana-util(1), grafana-util-dashboard(1)