指标异常分析 Skill:从时间窗口与影响范围定位异常信号

告警阈值被触发并不自动说明故障;季节性、流量变化和采样偏差都可能造成异常。指标分析要先区分信号、基线和业务影响。

指标异常分析 Skill 将突增与历史、关联指标和用户影响对照,在升级告警前验证其实际意义。

本文通过具体场景说明如何收集、连接和解释证据,让结论能够服务下一步的工程或业务决定。

指标异常分析 Skill 用来做什么

指标异常分析适合需要判断“这次波动是否真的影响用户”的监控和运营团队。它把基线、时间窗口、关联信号和候选原因排成验证路径,避免告警一响就开始归因。

先回到源 Skill

这个 Skill 的完整执行规则在 指标异常分析 提示词。源目录还包含 3 个评测用例,用于验证输出是否遵守契约。

它要求特别注意:

  • 不要仅凭同步变化断言因果
  • 检查指标口径和采集缺口
  • 明确统计异常与业务异常的差别

用一份项目材料开始

先把当前拿得到的材料摆上来。缺口可以保留,状态必须说实话。

材料这次填什么缺失时的处理
目标与范围识别结账成功率与延迟异常,验证异常窗口、指标口径、影响范围和候选原因标出不在本轮判断内的链路
版本与环境指标定义、采样粒度、异常窗口、服务版本和用户分群口径不明时先补指标说明
证据原始时间序列、发布事件、日志、trace 和同环比基线没有基线时把异常标为待确认
决策边界影响阈值、排查顺序、升级条件和响应 Owner区分相关变化与已证实原因

可以这样调用:

请使用 metrics-anomaly-analysis Skill。

任务:识别结账成功率与延迟异常,验证异常窗口、指标口径、影响范围和候选原因
输入材料:[版本、链接、日志或报告路径]
范围:[本次包含和排除的对象]
限制:[时间、数据、权限、合规要求]

先审计输入,再按风险和证据强度排序。材料没有证明的内容标为假设,并列出验证方法。

指标异常分析要把异常变成可验证假设

产物要回答的问题最低证据
基线当前值相对哪个历史窗口异常查询、聚合方式和基线区间
时间窗口异常从何时开始,是否持续时区、开始结束时间和版本
关联信号哪些指标、日志或 Trace 同时变化同窗口对照图和样本
候选原因哪个假设值得下一步验证验证动作、Owner 和预期结果

没有基线和时间窗口时,异常只能作为观察,不能写成事故原因。

在项目里跑一轮

先用一个边界清楚的小回合启动——识别结账成功率与延迟异常,验证异常窗口、指标口径、影响范围和候选原因。别急着把结果写成报告。先把输入版本、时间窗口和负责人贴到同一处;然后把每个判断连回具体材料;最后只安排一项能改变结论的验证动作。

先排除采集与口径变化,再评估业务异常,所有候选原因都要标证据强度。这一轮交付应当包含:可复查的证据索引、仍然成立的假设、以及下一位同事可以直接执行的动作。这样做很朴素,也很有效。

进阶使用:把一次分析变成持续机制

先排除采集与口径变化,再评估业务异常,所有候选原因都要标证据强度。

每次指标异常分析都保存查询、聚合方式、时区和部署版本。阈值、指标定义或采样变化时,重算基线并标记不可直接比较的窗口。

三段式 Skill 链

metrics-anomaly-analysisdistributed-trace-analysisproduction-incident-analysis

交接传递内容接收方要检查什么
上游到 metrics-anomaly-analysis来源版本、范围、风险、未决项输入是否过期,冲突是否标记
metrics-anomaly-analysis 到下游判断、证据索引、残余风险、待办产物是否可执行,Owner 是否明确
下游回写 metrics-anomaly-analysis执行结果、缺陷、事实变化是否更新基线与回归范围

交接时传摘要、证据索引和原始材料的位置。信息量足够,结论出了问题也能回到来源。

团队门禁

门禁检查内容未满足时
metrics-anomaly-analysis 输入门禁版本、环境、证据来源和 Owner停止生成,列出缺口
metrics-anomaly-analysis 产物门禁关键结论带依据、状态和影响退回补证据
metrics-anomaly-analysis 执行门禁命令、查询或验证路径可复现标记基础设施或测试问题
metrics-anomaly-analysis 决策门禁残余风险有接受人与日期不进入下一阶段

容易踩的坑

  1. 只看一条曲线,忽略相关指标和业务影响。
  2. 直接套固定阈值,没说明季节性、活动或流量变化。
  3. 把相关性写成根因,跳过日志、Trace 或实验验证。
  4. 告警恢复后删除窗口和样本,下一次无法复盘。

相关 Skill

指标异常需要和日志、Trace 及性能结果互相验证:

交付前复核:把判断落到证据

Skill 输出拿到手后,先核对四件事:输入版本是否明确,范围是否完整,每条结论能否回到证据,下一步由谁执行。少一项,报告就容易变成漂亮的猜测。

项目需要留下缺失时
输入边界版本、环境、时间窗口和本次范围标记假设,不写成事实
证据索引日志、报告、Trace、截图或命令输出标记 evidence_pending
结论状态verifiedassumptionblockedpending停止扩大结论
后续动作最小验证命令、负责人和截止时间交付为待办,不进入门禁
source_version: [版本或提交]
scope: [本次包含和排除的对象]
evidence: [日志、报告、Trace 或命令输出]
status: pending
owner: [负责人]
next_action: [最小验证动作]

分析类 Skill 要保留查询条件和时间窗口;执行类 Skill 要保留命令、退出码和失败产物。人工修改也要记录,下一次复核才知道结论从哪里变化。

安装与调用

安装这个 Skill:

npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/zh/testing-types/metrics-anomaly-analysis -g

安装后,直接使用下文的 metrics-anomaly-analysis 调用词,并附上本次的真实材料。

常见问题

输入还不完整,能开始吗?

能。先交付受限初版:列出已知事实、假设、缺口和最小验证动作。环境、数据或权限缺失时,不写执行结论。

什么时候需要人工确认?

范围取舍、风险接受、生产操作、数据权限和发布决定必须由对应负责人确认。Skill 负责整理证据与选项,不替团队做授权决定。

先用一份真实材料跑通 指标异常分析,把输入、产物、人工修改和验证证据留在同一个工作链里。下一次变化发生时,才有东西可以复用。

参考

分享