grafana-insepction

Grafana 自动化巡检技能。支持浏览器截图 + API 数据巡检，多仪表盘批量巡检，自动发现仪表盘。

Grafana 自动化巡检技能

快速开始

# 1. 配置
cd skills/grafana-inspector/scripts
cp config.example.json config.json
# 编辑 config.json

# 2. 执行
python main.py config.json

# 或在 OpenClaw 中输入
执行 Grafana 巡检

配置说明

{
  "grafana_url": "http://localhost:3000",
  "api_key": "",
  "dashboard_uids": [],
  "auto_discover": true,
  "discover_limit": 10,
  "inspection_mode": "hybrid",
  "screenshot_dir": "./screenshots"
}

参数	说明	必填
grafana_url	Grafana 地址	✅
api_key	API Key（API 巡检用）	✅
dashboard_uids	仪表盘 UID 列表	❌
auto_discover	自动发现仪表盘	❌
discover_limit	最多巡检数量	❌

使用方式

方式 1：命令行

cd skills/grafana-inspector/scripts
python inspect.py config.json

方式 2：OpenClaw

执行 Grafana 巡检

输出

• inspection_*.json - JSON 结果
• inspection_*.md - Markdown 报告

获取 Dashboard UID

1. 打开 Grafana 仪表盘
2. 查看 URL: https://grafana/d/{UID}/{name}
3. 复制 UID 部分

获取 API Key

1. Grafana → Configuration → API keys
2. 创建 Viewer 权限的 Key
3. 复制到配置

文件结构

grafana-inspector/
├── scripts/
│   ├── api_inspect.py    # API 巡检
│   ├── main.py        # 主脚本
│   └── config.json       # 配置
├── screenshots/          # 截图
├── SKILL.md             # 技能定义
└── README.md            # 说明文档

故障排查

API 连接失败

• 检查 API Key 是否正确
• 验证网络连接
• 确认 Grafana 服务正常
• 检查飞书授权状态