用途:在审查修改 Kibana 仪表盘 JSON 的 PR、对比分支间仪表盘变更、总结导出内容变化,或检查变更是否符合官方仪表盘规范时使用。不适用于新建或导出仪表盘、命名与文件布局、包级命令编排、测试套件选择等场景。
前置条件:需安装 kbdash,命令为 go install github.com/efd6/kbdash@latest。输出中以 [!] 开头的行表示仪表盘 JSON 可能存在一致性不匹配、提取不完整或解析错误等警告,可用 kbdash -h 查看各警告类型说明。
审查流程:识别新增、删除、修改的仪表盘文件;用 kbdash 提取前后描述;对比描述并将变更分类为实质性或外观性;在报告前对照原始 JSON 核实疑似问题;按每个仪表盘一节、以要点列出变更;对新增或修改的仪表盘检查规范符合性。完整步骤见 references/review-procedure.md。
规范检查项:TSVB 面板(新可视化应使用 Lens);缺少数据集过滤(应限定 data_stream.dataset 等具体范围);按引用嵌入的可视化(应以值嵌入,kbdash 会以 [!] <type> ref 标记,已保存搜索的引用警告除外);已弃用的 input-control-vis 类型;面板标题带包名前缀;未限定的宽泛通配符过滤;面板数量过多(约超过 20 时提示);使用 event.dataset 而非 data_stream.dataset 的查询;YAML 仪表盘源与 JSON 不同步;重新生成 PR 中超出预期键的差异;缺少 Kibana 资产标签;links 面板导航链接不完整。仅报告实际存在的问题,对未变更面板中的既有违规简要提及一次。
完成后可交接给 dashboard-guidelines、package-spec、elastic-package-cli 等技能。