SuperAPI AI 工具集

manage-dashboards

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:管理并检查 Grafana 中已存在的仪表盘,包括列表、搜索、查看、审计内容(面板及其类型)、删除、恢复、拉取、推送、校验、提升与快照。新建或重设计仪表盘应使用 create-dashboard,本技能只处理已有资源。

主要能力:gcx dashboards list/search/get/create/update/delete、list-versions 与 versions restore 版本管理;gcx resources pull/push/validate/delete/edit 资源操作;查询 datasources 及 Prometheus、Loki、Tempo、Pyroscope 的标签与元数据;dashboards snapshot 生成 PNG 快照。

使用方式:先运行 gcx config current-context 与 gcx config check 预检,可用 --context 指定环境。写入前先读取当前状态:gcx dashboards get <dashboard-name> -o json、gcx resources get folders -o json。典型更新流程为预检、本地编辑 YAML、gcx resources validate -p <path> -o json、gcx resources push -p <path> --dry-run、正式 push,最后再次 get 验证。快照示例:GCX_AGENT_MODE=true gcx dashboards snapshot <dashboard-name> --output-dir ./snapshots --since 6h,可加 --var cluster=prod。

限制与注意:受其他工具管理的资源会被保护,push 因 grafana.app/managed-by 失败时须先确认再使用 --include-managed;恢复版本需带 --message 并在之后验证,409 冲突需重新拉取;list 不支持 folder 过滤,应改用 search --folder;datasources 选择器报错时改用 gcx datasources list;快照不可用时应报告渲染器或认证阻塞,不得声称已完成视觉审查。仅当专用命令无法完成时才使用 gcx api。