# Grafana Skill

Read current values from any Grafana dashboard without writing queries. The plugin navigates by dashboard and panel name, extracts the panel's existing query configuration, and returns a compact summary — no PromQL, SQL, or datasource knowledge required.

Works with any Grafana datasource (Prometheus, InfluxDB, MySQL, …).

## When to Use

✅ **USE this skill when:**

- Asked about a value that's visible in a Grafana dashboard
- Listing what dashboards or panels are available
- Retrieving the current or recent value of a metric by panel name

## When NOT to Use

❌ **DON'T use this skill when:**

- Writing, modifying, or creating dashboards → use Grafana UI
- Admin operations (users, datasource config, alerts) → use Grafana API directly
- You need to run an arbitrary query not backed by an existing panel

## Setup

Add to your `openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "rpe-grafana": {
        "enabled": true,
        "config": {
          "url": "http://your-grafana:3000",
          "user": "your-username",
          "password": "your-password"
        }
      }
    }
  }
}
```

Or set environment variables:

- `GRAFANA_URL` - Grafana base URL
- `GRAFANA_USER` - Username
- `GRAFANA_PASSWORD` - Password or API key

## Tools

### grafana_list_dashboards

List all available dashboards.

**Parameters:** none

**Returns:** `[{ uid, title }]`

### grafana_list_panels

List all panels in a dashboard.

**Parameters:**
- `dashboard_uid` (required) - Dashboard UID from `grafana_list_dashboards`

**Returns:** `[{ id, title }]`

### grafana_query_panel

Read the current data for a specific panel. Fetches the panel's query configuration from the dashboard and executes it via Grafana's datasource API — no query language knowledge needed.

**Parameters:**
- `dashboard_uid` (required) - Dashboard UID
- `panel_id` (required) - Panel ID from `grafana_list_panels`
- `from` (optional) - Start of time range (default: `now-1h`)
- `to` (optional) - End of time range (default: `now`)

**Returns:** `[{ refId, name, lastValue, unit }]`

## Typical Workflow

1. `grafana_list_dashboards` → find the dashboard UID
2. `grafana_list_panels` → find the panel ID by title
3. `grafana_query_panel` → get the current value

## Notes

- Requires a Grafana user with read access (Viewer role is sufficient)
- Dashboard UIDs are stable identifiers; panel IDs are unique within a dashboard
- Row panels are flattened automatically