SuperAPI AI 工具集

signoz-investigating-alerts

部署与运维

查看项目

更新于 10-15 22:09

技能介绍

用途:诊断某个 SigNoz 告警为何触发,是 signoz-explaining-alerts 的配套技能——后者静态解读规则,本技能诊断具体事件。

主要能力:以告警为锚点,重跑告警主查询量化越阈幅度与持续时长;对比前一日同时段基线,拉取同资源范围的邻近信号(服务级:错误率、p95/p99 延迟、吞吐、依赖错误率;主机级:CPU、内存、磁盘/网络 I/O;K8s:Pod 重启、容器限额、节点压力、近期发布);再按需下钻链路(has_error=true,最多 20 条)与日志(ERROR/FATAL,最多 20 条),交叉印证后给出最多 3 条排序原因、已排除项与下一步建议。

使用方式:需先配置 SigNoz MCP 服务器(signoz_* 工具可用,否则先运行 signoz-mcp-setup)。必需输入为告警标识(规则 ID 或名称),时间窗可选,默认取最近一次触发。流程分三层并设强制早停:Tier 1 始终运行,确认是否真实触发;越阈不足 10% 且持续短于一个评估周期则判为“边缘触发”,跳过后续层。Tier 2 仅在 Tier 1 确认真实越阈时运行,若无邻近信号偏离基线 ≥25% 则判为“孤立触发”并跳过 Tier 3。Tier 3 仅在 Tier 2 发现相关异常时运行。

适用场景:排查近期由告警触发的故障根因、区分真实信号与抖动或阈值失准、关联指标/链路/日志。

限制:只读,不修改任何告警;不做部署/配置变更关联、跨服务爆炸半径遍历、长期季节性基线;不编造标识符;证据不足时如实降低置信度。相关但不适用:解读规则用 signoz-explaining-alerts,创建告警用 signoz-creating-alerts,无告警锚点的自由排查用 signoz-generating-queries。