SuperAPI AI 工具集

signoz-explaining-dashboards

部署与运维

查看项目

更新于 10-15 21:06

技能介绍

用途:解释已有 SigNoz 仪表盘,说明其面板、查询、变量以及每块面板应关注的内容,帮助用户理解仪表盘结构与含义。不用于修改仪表盘(应使用 signoz-modifying-dashboards)。

前置条件:该技能调用 SigNoz MCP 服务器工具 signoz_get_dashboard、signoz_list_dashboards。运行前需确认 signoz_* 工具可用;若不可用,说明 MCP 服务器未安装或未配置,需先运行 signoz-mcp-setup 初始化或修复连接。不得仅凭标题猜测仪表盘内容。

使用方式:先确定目标仪表盘,若有 id 直接使用;仅有名称时调用 signoz_list_dashboards,按 spec.display.name 匹配解析出 id,需翻遍全部页面(用 filter 缩小范围,为空时重跑无过滤查询,按 offset 与 limit 翻页直到覆盖 total),不得把名称直接传给 signoz_get_dashboard,也不得因第一页没有就判定不存在。多个匹配时列出候选并询问。随后必须调用 signoz_get_dashboard 获取完整 JSON 配置,检查 spec.display.name、description、tags、spec.variables、spec.panels、spec.layouts 及各 Grid 的 spec.display.title。

解释结构:1)概述仪表盘用途、监控对象与数据来源(指标、追踪、日志);2)变量与过滤器,说明名称、类型(DynamicVariable、QueryVariable、CustomVariable、TextVariable)、是否多选及 ALL 选项,并指出未被任何面板引用的变量;3)按 Grid 分区逐面板讲解,说明面板类型(TimeSeriesPanel、NumberPanel、TablePanel、BarChartPanel、PieChartPanel、HistogramPanel、ListPanel、AreaChartPanel、TextPanel)、查询含义(BuilderQuery 的信号、聚合、过滤、分组;CompositeQuery 各成员与公式;ClickHouse SQL 或 PromQL 的意图)、应关注什么及单位;4)仪表盘健康观察,如无查询面板、未被引用的面板、未引用变量、缺阈值、计数器未用 rate、步长过大、高基数分组等;5)覆盖缺口,仅针对该仪表盘所涉技术领域提出建议。最后可给出最多 3 个后续意图,用户仅入门时可跳过。

限制:默认不运行实时查询,除非用户要求;不向用户展示原始查询 JSON,除非明确要求;应基于实际指标给出关注建议,不套用无关领域知识;按 Grid 标题分组而非坐标;解释后如需修改应转向 signoz-modifying-dashboards。