SuperAPI AI 工具集

signoz-managing-views

通用与其它

查看项目

更新于 10-15 23:23

技能介绍

用途:通过 SigNoz MCP 服务器工具管理 Explorer 已保存视图(Saved View),即针对 Logs、Traces、Metrics 或 Cost Meter 页面的可复用查询快照(名称+过滤器+面板类型,限定单一来源)。它们不是仪表盘,也不是告警。

主要能力与工具:调用 signoz_create_view、signoz_list_views、signoz_get_view、signoz_update_view、signoz_delete_view,以及 signoz_get_field_keys、signoz_get_field_values。底层使用 v2 /api/v2/saved_views API,采用 v2 类型化结构(source + spec),不接受已废弃的 v1 compositeQuery/category/tags/extraData,旧参数 sourcePage 已更名 source。

使用方式:前置条件是确认 signoz_* 工具可用,否则先运行 signoz-mcp-setup;不要退回原始 HTTP 调用或凭空构造载荷。创建或更新前必须先读取两个资源:signoz://view/instructions 与 signoz://view/examples。source 必须为 traces、logs、metrics、meter 之一,含义不清时应询问。构建查询须通过 signoz-generating-queries 子技能完成字段发现与校验,并将其成功验证的 query.compositeQuery.queries 无损转换为保存 spec.queries。更新为整体替换,机器名不可变,重命名需改 spec.displayName。删除前必须先用 signoz_get_view 确认,再请求确认。

限制与注意:创建及修改 spec.queries 时必须执行保存前采样探测(按目标信号 1 行;meter 用 24h);保存前须展示预览。列表分页需检查 pagination.hasMore,无来源时逐个来源查询后合并。字段键按信号隔离,跨信号搬移属性易导致空视图。不用于构建仪表盘、运行临时查询或创建告警。其余细节暂未提供。