grafana

What This Skill Does

The grafana skill allows the OpenClaw AI agent to interact with Grafana instances via the official HTTP API. It provides a robust interface for querying observability data, managing dashboards, auditing data sources, and configuring alerting rules. By leveraging this skill, the agent can programmatically bridge the gap between raw infrastructure metrics and actionable insights, enabling automated health checks, environment monitoring, and incident response automation without requiring manual intervention in the Grafana UI.

Installation

To integrate this skill into your environment, use the OpenClaw CLI package manager: clawhub install openclaw/skills/skills/mrgoodb/grafana

Once installed, you must configure your environment variables to allow the agent to authenticate with your Grafana instance. Ensure the following variables are set in your execution context:

• GRAFANA_URL: The base URL of your Grafana server.
• GRAFANA_API_KEY: A valid Service Account token or API Key with appropriate permissions for the actions you intend to perform.

Use Cases

• Automated Incident Response: The agent can periodically poll dashboard states and trigger investigation workflows if specific latency or error thresholds are breached.
• Dashboard Inventory Auditing: Quickly list and search all dashboards in a complex organization to ensure naming conventions and tagging standards are met.
• Provisioning: Programmatically deploy standardized alert rules across multiple environments to ensure consistent monitoring coverage.
• Reporting: Fetch JSON dashboard definitions to generate summary reports or backup dashboard configurations to version control systems.

Example Prompts

1. "List all active alert rules configured in the system and let me know if any are currently in a firing state."
2. "Find the UID for the 'Production Kubernetes Cluster' dashboard and retrieve its full JSON configuration."
3. "Show me a list of all configured data sources and confirm that the Prometheus endpoint is reachable."

Tips & Limitations

• Security: Always use restricted Service Account tokens rather than admin-level API keys whenever possible to follow the principle of least privilege.
• Rate Limiting: Be aware of Grafana's API rate limits if you are writing custom loops or high-frequency polling scripts through the agent.
• JSON Complexity: Some complex dashboard objects are highly nested. When editing or creating alerts via the agent, ensure your JSON payloads are schema-compliant with the target Grafana version to avoid provisioning errors.