时延排查报告该写什么
时延排查报告要有固定字段，结论才能被复核、被交接。骨架很明确：现象与影响范围、时间窗与样本量、分位数指标、抓包文件与过滤条件、结论与置信度、待验证项。缺了任何一项，别人就只能把工作重做一遍，报告的价值也大打折扣。
基本信息
| 必填字段 | 时间窗、样本量、P50/P95/P99、文件引用、置信度 |
|---|---|
| 引用方式 | 抓包文件名加帧号，可直接跳转核对 |
| 结论要求 | 明确区分已证实与推断 |
| 交接要点 | 过滤条件与统计口径一并给出 |
典型使用场景
- 跨团队交接故障分析结论
- 复盘材料中的量化支撑
- 优化前后的对比报告
- 用户投诉的复现过程与解释
- 长期延迟基线的更新记录
模板骨架
模板骨架
# 现象：何时开始、影响范围、具体表现
# 数据：抓包文件、过滤条件、统计口径、样本量
# 分析：分段耗时表 + 异常帧引用（文件名与帧号）
# 结论：指向 + 置信度 + 待验证项
tshark -r a.pcap -Y "http.time > 1" -T fields -e frame.number -e http.request.uri -e http.time | head -20
# 引用的帧号要与交付的文件一一对应，复核者能直接定位字段要求
| 字段 | 内容 | 为什么必须写 |
|---|---|---|
| 时间窗 | 起止时刻与时区 | 不同窗口的数据不可直接比较 |
| 样本量 | 参与统计的请求数 | 样本太少时分位数不可信 |
| 分位数 | P50 / P95 / P99 | 均值会掩盖长尾 |
| 文件引用 | 文件名与帧号 | 复核者可直接定位核对 |
| 置信度 | 高、中、低及理由 | 避免把推断写成定论 |
引用具体帧时要带文件名与帧号，复核者能直接跳转核对。这比只给结论和截图有效得多，也是报告能不能被信任、能不能被交接的关键。
没有口径的统计数字无法复核。模板强制保留字段，就是为了避免出现「某接口延迟偏高」这类既不能验证也无法行动的表述，这类结论在复盘里等于零。
交付前检查
- 时间窗是否写清时区与起止时刻
- 分位数是否给出，样本量是否足够
- 抓包文件与帧号引用是否可对应
- 结论是否区分了证实与推断
- 待验证项是否列出，便于后续跟进