SuperAPI AI 工具集

kubesense-dashboards

智能体与模型

查看项目

更新于 10-16 06:22

技能介绍

用途:为 KubeSense 创建覆盖指标、日志与链路(traces)的仪表盘。有两种交付方式:由智能体调用 create-dashboard MCP 工具(写操作,需审批);或输出预设 JSON,由用户经 Dashboards → Import 导入。用户直接要求创建时用工具;要求 JSON 或希望先审阅时输出预设 JSON。

主要能力:生成仪表盘预设对象,包含 panels、gridLayout、variables、subGrids、subGridLayout 等字段;面板类型有 timeSeries、stat、table、list、bar、pie、topList、treemap、alert、spl、sql、slo 共 12 种;查询按 selectedMode 分为 metrics、logs、traces、formula 四类。

必要用法:提交前先用 validate-dashboard-json 校验预设(不存储数据,可反复调用),直到 valid=true。预设应以对象形式作为 document 传入,而非导入信封中字符串化后的 preset 字段。若已连接 KubeSense MCP 服务,应先用 get-available-metrics、get-metric-labels、get-trace-or-log-fields 发现真实字段名,切勿猜测指标、分组或过滤字段。导入信封格式为 name(必填非空)、description(可选)、preset(字符串化的预设 JSON)。

限制:校验仅检查结构,不检查数据是否存在,查询未采集的指标可通过校验但渲染为空。多个字段设有 .catch(),错误值会静默重置整个数组或对象(如 functions、variables、aggregation 等),因此宁可省略可选字段也不要猜测取值。gridLayout 条目数不得少于 panels 数量,否则渲染时抛 TypeError。formula 表达式仅允许大写字母数字与运算符,不含小数点。日志和链路查询必须包含 columnFields。