SuperAPI AI 工具集

kibana-dashboards

数据与分析

查看项目

更新于 10-16 05:07

技能介绍

用途:以声明式 JSON 创建、更新、删除 Kibana 仪表盘和独立 Lens 可视化,便于版本控制与可复现部署。要求 Kibana 9.4+,并通过 elastic CLI 执行操作,不直接调用 HTTP API。

主要能力:支持仪表盘(面板集合,可选默认时间范围)与独立可视化(库图表)两类对象;支持 data_view_reference、data_view_spec、esql 三种数据集类型;支持确定性 id 的 upsert(PUT)与自动生成 id(POST);支持列表、导出、导入和删除。

使用方式:先 GET kbn:/api/status 验证连通性与版本。写入仪表盘用 PUT kbn:/api/dashboards/{id},请求体为扁平结构,含 title、panels(空仪表盘用 [])、可选 time_range(如 {"from":"now-7d","to":"now"})。独立可视化用 PUT kbn:/api/visualizations/{id}。ES|QL 面板需 data_source.type 为 "esql",指标用 column 引用查询中的别名,而非 operation: "count"。写入后必须 GET 回读确认。CLI 对应命令如 elastic kb dashboards update-dashboard-redirect --id '<id>' --input-file '<path.json>',批量可用 post-saved-objects-import。

适用场景:需要将仪表盘与图表纳入代码仓库、按 id 精确管理、或使用 ES|QL 构建指标与时间序列图表的场景。

限制:仅支持 Kibana 9.4+;create-*-redirect 命令暂不接受请求体,新建对象需指定 id 走 update 或通过 saved-objects 导入;仪表盘使用 48 列网格;ES|QL 列名须与 STATS 别名一致,否则报 400;XY 图表的 data_source 需放在每个 layer 内。未提供凭据时不得猜测或绕过。