mcpField
G
grafana-platform-dashboard

grafana-platform-dashboard

github.com/boshu2云与 DevOps450151 次安装今天更新
代码仓库

关于 grafana-platform-dashboard

Grafana Platform Dashboard 是用于设计和更新平台运维仪表板的技能，优先呈现影响租户的风险，再展示服务级细节。它提供编辑仪表板 JSON、验证 PromQL、应用更改和检查同步状态的流程。

主要功能

  1. 01优先呈现租户影响信号
  2. 02按细节层级组织仪表板
  3. 03基于已知查询库构建查询
  4. 04应用前扫描 PromQL
  5. 05验证仪表板同步状态

适用场景

  1. 01安全更新运维仪表板
  2. 02部署前检查 PromQL 查询
  3. 03更改后核对仪表板同步状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/boshu2/agentops --skill grafana-platform-dashboard

安装后在 Claude Code 中输入/grafana-platform-dashboard确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
grafana-platform-dashboard.feature
layout-guidelines.md
platform-contract.md
promql-library.md
scripts/
grafanadashboard_roundtrip.sh
promql_scan_thanos.sh
validate.sh

详细介绍

Grafana 平台仪表板

设计平台运维仪表板，让运维人员优先看到影响租户的风险，然后再深入查看特定服务的健康状况，避免信息过载。

快速开始

当用户要求更新平台仪表板并检查可靠性时，使用此技能。

  1. 确认仪表板目标：
oc --context <ctx> get grafanadashboard -A | rg -i '<dashboard-name-or-theme>'
  1. 导出仪表板和 JSON：
skills/grafana-platform-dashboard/scripts/grafanadashboard_roundtrip.sh export \
  --context <ctx> \
  --namespace <ns> \
  --name <grafanadashboard-name> \
  --out-dir /tmp/<workspace>
  1. 编辑 JSON 并验证所有 PromQL：
skills/grafana-platform-dashboard/scripts/promql_scan_thanos.sh \
  --context <ctx> \
  --dashboard-json /tmp/<workspace>/<name>.json
  1. 安全地应用到线上：
skills/grafana-platform-dashboard/scripts/grafanadashboard_roundtrip.sh apply \
  --context <ctx> \
  --namespace <ns> \
  --name <grafanadashboard-name> \
  --json /tmp/<workspace>/<name>.json

工作流

1) 根据平台契约锁定范围

编辑面板前，使用 platform-contract.md 中的平台契约。

  1. 将 L1 指挥视图限定为租户受影响前的关键信号。
  2. 优先使用与门控对齐的组件（关键 CO 门控、节点、MCP、核心 API/etcd/ingress）。
  3. 将特定服务的部分（Crossplane、Keycloak）放在 L1 以下。
2) 遵循信息架构

使用 layout-guidelines.md：

  1. L1：仅包含关键内容、可立即采取行动的内容，并将面板数量控制在最低限度。
  2. L2：按依赖域展示平台服务。
  3. L3：深入分析（例如未来的 GPU 仪表板），不纳入 L1。
3) 使用已知查询库构建查询

使用 promql-library.md：

  1. 从已知可用的查询开始，并尽量少地调整标签。
  2. 优先使用计数和行动表，而非装饰性图表。
  3. 按需明确过滤告警噪声（例如 ArgoCD/GitOps）。
4) 应用前验证

编辑后务必运行扫描脚本：

skills/grafana-platform-dashboard/scripts/promql_scan_thanos.sh \
  --context <ctx> \
  --dashboard-json <file.json> \
  --output <scan.tsv>

通过标准：所有查询均报告 success，且没有错误或解析错误。

5) 应用并验证同步

仅在验证成功后应用：

skills/grafana-platform-dashboard/scripts/grafanadashboard_roundtrip.sh apply ...
oc --context <ctx> -n <ns> get grafanadashboard <name> \
  -o jsonpath='{.status.conditions[?(@.type=="DashboardSynchronized")].status}{"|"}{.status.conditions[?(@.type=="DashboardSynchronized")].reason}{"\n"}'
6) 以面向运维人员的摘要收尾

报告：

  1. 变更内容（面板名称和用途）。
  2. 验证结果（查询数量和失败数）。
  3. 同步状态和任何残余风险。
  4. 后续步骤：将线上变更纳入 GitOps 管理的源代码。

设计规则

  1. 优先展示影响租户的关键预测指标。
  2. 每个红色面板都必须对应一条行动路径。
  3. 避免使用含义模糊的面板名称（例如，将“平台 Pod”替换为明确的命名空间范围）。
  4. 保持 L1 低噪声；将详细信息下移或放到专用仪表板中。
  5. 将 GPU 深度诊断放在专用 GPU 仪表板中，不要混入 L1。

参考资料

  1. 平台契约
  2. PromQL 面板库
  3. 布局指南
  4. references/grafana-platform-dashboard.feature — 可执行规范：根据契约锁定范围和 IA，使用已知查询库构建查询，应用前验证，并验证同步（soc-qk4b）

评论

支持 Markdown