\r \r

Grafana 自动化巡检技能\r

\r

快速开始\r

\r

# 1. 配置\r
cd skills/grafana-inspector/scripts\r
cp config.example.json config.json\r
# 编辑 config.json\r
\r
# 2. 执行\r
python main.py config.json\r
\r
# 或在 OpenClaw 中输入\r
执行 Grafana 巡检\r
```\r
\r
## 配置说明\r
\r
```json\r
{\r
  "grafana_url": "http://localhost:3000",\r
  "api_key": "",\r
  "dashboard_uids": [],\r
  "auto_discover": true,\r
  "discover_limit": 10,\r
  "inspection_mode": "hybrid",\r
  "screenshot_dir": "./screenshots"\r
}\r
```\r
\r
| 参数 | 说明 | 必填 |\r
|------|------|------|\r
| `grafana_url` | Grafana 地址 | ✅ |\r
| `api_key` | API Key（API 巡检用） | ✅ |\r
| `dashboard_uids` | 仪表盘 UID 列表 | ❌ |\r
| `auto_discover` | 自动发现仪表盘 | ❌ |\r
| `discover_limit` | 最多巡检数量 | ❌ |\r
\r
## 使用方式\r
\r
### 方式 1：命令行\r
\r
```bash\r
cd skills/grafana-inspector/scripts\r
python inspect.py config.json\r
```\r
\r
### 方式 2：OpenClaw\r
\r
```\r
执行 Grafana 巡检\r
```\r
\r
## 输出\r
\r
- `inspection_*.json` - JSON 结果\r
- `inspection_*.md` - Markdown 报告\r
\r
## 获取 Dashboard UID\r
\r
1. 打开 Grafana 仪表盘\r
2. 查看 URL: `https://grafana/d/{UID}/{name}`\r
3. 复制 UID 部分\r
\r
## 获取 API Key\r
\r
1. Grafana → Configuration → API keys\r
2. 创建 Viewer 权限的 Key\r
3. 复制到配置\r
\r
## 文件结构\r
\r
```\r
grafana-inspector/\r
├── scripts/\r
│   ├── api_inspect.py    # API 巡检\r
│   ├── main.py        # 主脚本\r
│   └── config.json       # 配置\r
├── screenshots/          # 截图\r
├── SKILL.md             # 技能定义\r
└── README.md            # 说明文档\r
```\r
\r
## 故障排查\r
\r
### API 连接失败\r
- 检查 API Key 是否正确\r
- 验证网络连接\r
- 确认 Grafana 服务正常\r
- 检查飞书授权状态\r