grafana-helper

Automate Grafana dashboards, datasources, alerts, and annotations via REST API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/shepherdjerred/dotfiles --skill grafana-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grafana-helper
Source: https://github.com/shepherdjerred/dotfiles/tree/main/private_dot_claude/skills/grafana-helper
Command: npx skills add https://github.com/shepherdjerred/dotfiles --skill grafana-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates Grafana operational tasks via the REST API, eliminating repetitive UI interactions for dashboards, datasources, alerts, and annotations.

Core Features & Use Cases

  • Dashboard management: Search, retrieve, create, update, and manage dashboards through the Grafana HTTP API.
  • Datasource & metric access: List, get, and query Prometheus/Loki data sources and metrics; access labels and metadata as needed.
  • Alerts & annotations: Create and update alert rules and annotations, manage folders, and orchestrate alerting workflows via API.
  • Cloud and self-hosted workflows: Works with Grafana Cloud and self-hosted deployments to automate monitoring tasks and ready-made Sift/Asserts integrations.
  • Use Case: Automatically inventory dashboards, validate essential dashboards exist, perform health checks, and generate a consolidated report.

Quick Start

  1. Set environment variables export GRAFANA_URL="https://your-grafana" export GRAFANA_API_KEY="your-api-key" AUTH="Authorization: Bearer $GRAFANA_API_KEY"
  2. Test the connection curl -H "$AUTH" "$GRAFANA_URL/api/health"
  3. Example: list dashboards curl -H "$AUTH" "$GRAFANA_URL/api/search?type=dash-db"

Frequently Asked Questions about grafana-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Grafana dashboard management without using the web UI?

Automate Grafana dashboard management by using the Grafana REST API to search, retrieve, create, and update dashboards via curl HTTP requests. This eliminates repetitive UI interactions for monitoring workflows.

Can I query Prometheus and Loki datasources in Grafana via the API?

Query Prometheus and Loki datasources in Grafana via the API by sending curl requests to list datasources, access metrics, retrieve labels, and gather metadata for automated monitoring.

Does this Grafana automation work with both Grafana Cloud and self-hosted deployments?

Grafana API automation works with both Grafana Cloud and self-hosted deployments. You need to set your Grafana URL and API key or token as environment variables to manage dashboards and alerts.

How do I create and manage Grafana alert rules and annotations automatically?

Create and manage Grafana alert rules and annotations automatically by sending HTTP API requests. You can orchestrate alerting workflows, manage folders, and update alert rules via curl.

What do I need to start automating Grafana operations through the REST API?

To start automating Grafana operations, you need your Grafana URL and an API key or basic authentication token. Set these as environment variables, then use curl to test the connection and send HTTP requests.

What is the best way to inventory Grafana dashboards and perform health checks?

The best way to inventory dashboards and perform health checks is automating Grafana API requests. Query the search endpoint to validate essential dashboards exist and generate a consolidated monitoring report.