grafana

Grafana

Query and manage Grafana monitoring dashboards, alert rules, and data sources via HTTP API.

Setup

Configure your Grafana instance:

Variable	Description	Required
GRAFANA_URL	Your Grafana server URL (e.g., https://grafana.example.com)	Yes
GRAFANA_TOKEN	API Key (Settings → API Keys, viewer or editor role)	Yes

Authentication: curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" "$GRAFANA_URL/api/..."

Customize the following for your organization:

• Folder structure: How dashboards are organized (by team, region, service, etc.)
• Tag conventions: What tags are used for filtering (region, environment, service type)
• Alert naming: Your alert naming pattern (e.g., {Service} {Metric} {Condition} [{env}])
• Key dashboards: Which dashboards to check after deployments

Rules

Dashboard Operations

• Search first, then detail: Use search API with tags/query to narrow scope, then fetch by uid
• Never delete production dashboards — archive by moving to an Archive folder
• Write operations require user confirmation before execution (create/modify dashboards, alert rules)

Common Workflows

Find a Dashboard:

curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
  "$GRAFANA_URL/api/search?query=<keyword>&tag=<tag>&type=dash-db" \
  | jq '.[] | {uid, title, folderTitle}'

Get Dashboard Details:

curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
  "$GRAFANA_URL/api/dashboards/uid/<uid>" \
  | jq '.dashboard.panels[] | {title, type}'

Check Active Alerts:

curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
  "$GRAFANA_URL/api/alerts?state=alerting"

List Data Sources:

curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
  "$GRAFANA_URL/api/datasources" \
  | jq '.[] | {id, name, type, url}'

Search by Folder:

curl -s -H "Authorization: Bearer $GRAFANA_TOKEN" \
  "$GRAFANA_URL/api/search?folderIds=<folder_id>&type=dash-db"