SuperAPI AI 工具集

dashboards

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

该技能用于在 Grafana 中编写和维护仪表盘,核心是仪表盘 JSON:面板置于 24 列网格上,由数据源查询驱动,经客户端转换整形,通过标准选项与覆盖项设置样式,用模板变量实现参数化,并以注释和链接建立关联。

范围包括:仪表盘 JSON(Classic 与 V2 模式)、面板选择与配置、标准选项、阈值、值映射、字段覆盖、转换、所有变量类型、重复面板/行/标签页、注释、仪表盘/面板/数据链接、库面板、版本历史、面板编辑器与检查器。不在范围内:数据源查询语言(promql、logsql、metricsql 为同级技能);Grafana 告警(规则、联系人、通知策略为同级技能);预置、文件式仪表盘、仪表盘即代码工具(Terraform、Grizzly、Foundation SDK、Helm 等)。

处理仪表盘文件时建议:先映射结构,用 jq 查看面板 id、类型与标题;按路径精确修改,按 .id 而非标题选择面板;修改后用 jq empty 校验语法并对比前后差异。注意行嵌套:折叠行把面板放在 row.panels[],展开行则作为顶层同级项。仪表盘结构含六个顶层关注点:身份(uid、title、tags 等,不要手动编辑 schemaVersion 或 version)、时间、templating.list、annotations.list、panels、links。

面板选择应依据数据形态:时间戳数值序列用时间序列;分类数值用柱状图;分布用直方图或热力图;离散状态变化用状态时间线;周期性状态快照用状态历史;单一数值用 Stat;比例且分段不超过 7 用饼图。面板 JSON 类型 ID 包括 timeseries、stat、gauge、bargauge、barchart、histogram、heatmap、piechart、table、logs、nodeGraph、traces、flamegraph、canvas、geomap、text、news、dashlist、alertlist、annolist、state-timeline、status-history、candlestick、trend、xychart。

配置需遵循显示管线顺序:查询→转换→标准选项→值映射→阈值→字段覆盖→渲染。标准选项应始终设置基础单位,不要在查询中预先缩放;颜色方案按意图选择。阈值默认 Base 为绿色、80 为红色、模式为 Absolute,应按面板覆盖;仅在比较动态最小/最大时用百分比;时间序列类面板需显式设置阈值显示。值映射会绕过单位格式化,按顺序匹配、先到先得。字段覆盖可按键名、正则、类型、查询 refId 或值匹配,不要用覆盖改字段名,优先级为默认→标准选项→值映射→阈值→覆盖。

转换按列出顺序执行,建议顺序为过滤、类型转换、计算派生、聚合、整理字段。计数器应在查询层先用 rate() 或 increase() 包装。变量可查询、自定义、文本框、常量、数据源、间隔、过滤器、开关等类型,支持多值与多属性,注意 ${var:raw} 绕过转义,父变量排在子变量之前。注释支持原生注释与注释查询,内置 -- Grafana -- 查询始终存在。链接分仪表盘链接、面板链接与数据链接三类;动作会触发未经认证的浏览器来源 API 调用,需自行鉴权。库面板可复用但需注意权限与删除条件。默认保留最近 20 个版本,可用 [dashboards] versions_to_keep 调整。

写作仪表盘时应按数据形态选面板类型,始终设置单位,让 Grafana 负责缩放。