解决什么问题
测试做完以后,如果只留一页 PPT,后面很难复盘。设备版本升级后结果变了,没人知道原来配置是什么;论文读到类似指标,也无法对照自己的测试;现场出问题时,报告无法帮助定位。
可复现报告解决的是信任和复盘。别人不必相信你的口头判断,可以沿着材料重新理解测试条件、执行过程和结论边界。
背景与直觉
科学实验要保留方法和数据,工程验证也一样。TSN 的结论依赖很多条件:拓扑、配置、时间同步、背景流量、测量精度、故障动作。缺任何一项,结论都会变成不可复现的经验。
怎么解决
一份可复现报告可以按这个目录组织。
| 目录 | 内容 |
|---|---|
| 01_topology | 拓扑图、端口表、链路速率、故障域 |
| 02_devices | 型号、固件、TSN 能力、时间源 |
| 03_config | gPTP、GCL、CBS、抢占、FRER、Qcc 输出 |
| 04_traffic | 关键流和背景流脚本、参数、持续时间 |
| 05_raw | 抓包、计数器、日志、时间戳原始数据 |
| 06_stats | 统计脚本、最大值、分位数、miss count |
| 07_faults | 故障注入步骤和恢复结果 |
| 08_conclusion | 结论、适用范围、未覆盖风险 |
最好把统计脚本也保存下来。这样别人能确认图表如何从原始数据生成,而不是只看到最终图。
带来了什么新问题
可复现报告会增加工作量和数据管理成本。抓包可能很大,设备配置可能包含敏感信息,报告需要脱敏和归档策略。
但如果目标是证明确定性,这些成本是必要的。没有原始证据的报告,很难支撑长期维护和跨团队协作。
检查点
- 如果一年后设备固件升级导致延迟变差,你希望旧报告里保留哪些材料?
- 为什么统计图不能替代原始抓包和配置快照?