用途:在需要借助 trace、span 和服务拓扑定位跨服务延迟、错误传播与依赖异常时使用,也适用于对现有分析方案或结果做风险评审并形成可执行改进项。
主要能力:固定 trace/span ID、parent ID、异步 links、服务与部署版本、起止时刻和采样范围;核对父子包含关系与时钟偏差,link 不自动视为同步父子。同一时钟域内按区间并集扣除同步子 span 得 observed exclusive time,重叠子 span 不能相加;缺 span 时只报可见区间。按真实依赖顺序和阻塞等待识别关键路径,queue time 需 enqueue/dequeue 证据。最慢 span 仅作调查候选,根因需日志、指标或故障实验佐证。
使用方式:先阅读并遵循 prompts/distributed-trace-analysis.md 的输入、执行规则、最低覆盖清单和输出顺序;补充影响判断的范围、环境、版本、限制、证据和成功标准;先做输入审计,区分已确认事实、合理假设和待确认问题,再按风险与证据强度排序输出。默认输出 Markdown,用户要求表格、CSV、JSON 或工单格式时保留同样的风险、证据、优先级和边界字段;进入自动化流程前先确认字段 schema、枚举值和必填项。信息不足时先交付受限初版并说明哪些结论暂不能成立。
适用场景:跨服务延迟与错误传播排查、依赖异常分析、发布阻塞或业务损失路径评审、证据缺口校准。
限制:相关性不等于根因;需标明采样和时钟偏差;不能只盯总耗时而忽略重试与排队;不编造输入中不存在的系统行为、字段、数据、指标或根因;关键结论必须关联证据,证据不足时标记为假设并给出验证方法;不得执行未经授权的生产写操作或破坏性动作。