# Grafana Setup

> Configure a Grafana environment profile for the `datus grafana` plugin

- Skill: `datus-ai/grafana-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datus-ai/grafana-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datus-ai/grafana-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: datus-ai (https://skillmd.com/u/datus-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/datus-ai/grafana-setup

---


# Grafana Setup

If this deployment cannot edit agent configuration, stop and ask the administrator to configure it server-side.

## `agent.yml`

```yaml
agent:
  plugins:
    grafana:
      prod:
        default: true
        api_base_url: https://grafana.example.com
        auth_mode: token
        token: ${GRAFANA_SERVICE_ACCOUNT_TOKEN}
        # auth_mode: basic
        # username: analyst
        # password: ${GRAFANA_PASSWORD}
        org_id: "1"                    # optional
        api_mode: auto                 # auto, new, or legacy
        namespace: default
        verify_ssl: "true"
        timeout: "30"
        default_datasource_uid: metrics-prod  # optional
        serving_datasource: warehouse_prod   # optional
        serving_database_name: analytics     # optional
```

Ask for the endpoint, auth mode, optional organization, and the environment-variable name holding the token/password. Have the user export it and write only `${VAR}`, never a literal secret. Prefer a least-privilege service-account token. Verify with `datus grafana status health` and `datus grafana status whoami`.