用途:该技能面向智能体提供 Grafana 访问能力,用于查询仪表盘、Prometheus 指标、告警规则与触发中的告警实例,适用于服务健康、LLM 延迟和基础设施监控等场景。
连接方式:基础地址为 $GRAFANA_URL(如 https://your-org.grafana.net),认证使用 Authorization: Bearer $GRAFANA_API_TOKEN(服务账号令牌)。凭据 GRAFANA_URL、GRAFANA_API_TOKEN 来自 Settings → Data sources。元数据缓存 10 分钟,查询结果不缓存(时效敏感)。关键数据源为 Prometheus,UID 为 grafanacloud-prom。
主要能力:服务端库 server/lib/grafana.ts 导出 listDashboards(query?)、getDashboard(uid)、getDatasources()、getAlertRules()、getAlertInstances()、queryDatasource(uid, queries[], from?, to?)。对应 API 路由包括 GET /api/grafana/dashboards、GET /api/grafana/dashboard?uid=...、GET /api/grafana/datasources、GET /api/grafana/alerts、POST /api/grafana/query。智能体应使用 grafana 动作而非直接调用 /api/grafana/*,模式有 dashboards(search)、dashboard(uid)、datasources、alerts、query(datasourceUid, queries, from, to)。
使用要点:查询返回帧格式为 { results: { [refId]: { frames: [{ schema: { fields }, data: { values } }] } } },values[0] 为时间戳(epoch 毫秒),values[1+] 为指标值,序列标签位于 schema.fields[i].labels。模板变量 $CodegenMode 默认 quality-v4,$AIModel 默认 .*,$environment 默认 cloud,查询前通过字符串替换插值。常用指标涵盖 Codegen、LLM、Projects、API/Runtime、Fly.io、GitHub 等前缀。
限制与注意:热力图面板以多序列折线/面积呈现;queryDatasource 不缓存,POST 辅助函数默认缓存。生产问题排查建议先查 Grafana/Prometheus,再查 Sentry 与 Cloud Logging。其余细节暂未提供。