工业通信与现场总线 / 系统课时
输出抓包报告与验收清单
输出抓包报告与验收清单
联合测试结束后,真正能交付的不是一批零散的抓包文件,而是一套可追溯的验收证据。本篇把配置基线、通信数据、时序指标、异常与恢复结果整理成统一报告,并给出现场可直接执行的验收清单。
学习目标
- 建立从配置基线、抓包证据到验收结论的完整对应关系。
- 从抓包文件中提取关键通信与时序指标,并保存可复核结果。
- 编写能够明确判定通过、失败和待整改项的现场验收清单。
先固定测试基线与证据编号
抓包报告的第一原则是任何结论都能追溯到当时的配置和原始证据。仅写“通信正常”没有验收价值,因为后续无法确认使用了哪个固件、哪个网络参数,也无法定位结论对应哪一段报文。
建议每次联合测试至少固定以下信息:设备型号与序列号、固件或工程版本、协议及关键通信参数、网络拓扑版本、测试时间、测试工具版本,以及原始抓包文件名。对于 Modbus RTU、Modbus TCP、PROFINET、EtherCAT 等不同链路,应分别记录与协议直接相关的参数,而不是用一份模糊的“网络配置”代替。
可以采用统一证据编号,例如 E01 表示正常通信抓包、E02 表示断线异常抓包、E03 表示恢复过程抓包。报告中的每个异常、指标和验收条目都引用对应编号,避免截图、表格和原始文件彼此失联。
| 证据编号 | 内容 | 建议文件名 | 用途 |
|---|---|---|---|
| E01 | 稳态正常通信 | E01-normal.pcapng |
核对报文周期、请求响应和错误情况 |
| E02 | 通信中断过程 | E02-link-loss.pcapng |
证明故障检测行为 |
| E03 | 链路恢复过程 | E03-recovery.pcapng |
测量恢复时间并确认数据重新有效 |
从抓包中提取可复核指标
以 Wireshark/TShark 可解析的以太网协议抓包为例,可以先用 tshark 输出逐帧时间戳、协议和摘要,形成报告附件中的明细数据。下面命令可直接执行,<PATH> 替换为实际抓包路径。
tshark -r <PATH>/E01-normal.pcapng -T fields -E header=y -E separator=, -e frame.number -e frame.time_relative -e _ws.col.Protocol -e _ws.col.Info预期输出如下。具体帧号、时间和协议字段取决于实际抓包,因此动态值以占位符表示。
frame.number,frame.time_relative,_ws.col.Protocol,_ws.col.Info
<ID>,<TIME>,<PROTOCOL>,<FRAME_INFO>
<ID>,<TIME>,<PROTOCOL>,<FRAME_INFO>这份 CSV 风格输出适合检查通信是否持续、请求和响应是否成对,以及异常帧发生在哪个时间点。对于现场验收,通常不需要把全部报文正文塞进报告,而应保留原始 pcapng,在正文中记录经过确认的指标和过滤条件。
如果协议具有固定或近似固定的循环周期,还应计算至少三个指标:目标周期、实测周期范围和最大抖动。事件发生前后的时间戳则用于计算故障检测时间与恢复时间。报告中必须注明指标的测量起止帧或过滤条件,否则一个孤立的“恢复时间 180 ms”仍然不可复核。
把异常过程写成证据链
异常测试不要只登记“拔线后恢复正常”,而要按照“触发条件 → 可观察现象 → 协议或设备行为 → 恢复动作 → 恢复结果”记录。这样现场人员才能判断故障机制是否真的符合需求。

一条合格的异常记录可以写成:在 <TIME> 断开被测链路,设备于随后 <TIME> 检测通信异常;恢复物理链路后,于 <TIME> 重新进入有效数据状态;检测和恢复阶段分别对应证据 E02、E03。若恢复需要人工复位,也必须明确记录,不能把“人工恢复成功”描述成“自动恢复成功”。
形成现场可判定的报告
最终报告应让未参与测试的人也能独立判断结果。正文至少包含配置基线、测试项目、证据引用、测量值、验收门限、异常记录和最终结论。门限应来自项目技术要求或双方确认的验收标准,不应在看到测试结果后再反向制定。
验收结果建议只使用三种状态:通过表示证据满足门限;失败表示已证明不满足门限;待确认表示证据不足或外部条件尚未具备。不要用“基本正常”“大致通过”之类无法执行后续动作的描述。
| 验收项 | 验证内容 | 证据 | 判定标准 | 结果 |
|---|---|---|---|---|
| 配置一致性 | 设备、固件、站号、地址及通信参数与基线一致 | 配置记录 | 与批准基线完全一致 | 通过/失败 |
| 正常通信 | 规定观察窗口内通信连续且业务数据有效 | E01 | 满足项目规定的丢帧、错误与数据有效性要求 | 通过/失败 |
| 时序性能 | 周期、抖动或请求响应时间满足要求 | E01 | 不超过项目门限 | 通过/失败 |
| 故障检测 | 断线或设备异常能够被识别 | E02 | 在规定时间内进入预期故障状态 | 通过/失败 |
| 通信恢复 | 故障解除后恢复到有效通信 | E03 | 在规定时间内恢复且无残留错误 | 通过/失败 |
| 证据完整性 | 原始抓包、日志、配置和记录可重新核验 | E01~E03及附件 | 文件齐全且编号可追溯 | 通过/失败 |
交付前执行验收清单
在签字或提交报告前,按下面清单逐项检查。它的目的不是增加文档数量,而是避免最常见的交付缺口。
- 确认报告中的设备、固件、工程版本和通信参数与测试现场一致。
- 确认每个关键结论都引用了抓包、日志或配置记录,不存在只有文字结论而没有原始证据的项目。
- 确认周期、响应时间、故障检测时间和恢复时间均写明测量方法、起止事件与验收门限。
- 确认所有异常测试都记录了触发条件、观察现象、恢复方式和恢复后的最终状态。
- 确认失败项和待确认项都有责任人、整改内容以及重新验证条件。
- 确认原始
pcapng、设备日志、配置导出文件与最终报告使用相同证据编号,并能够从报告反查原文件。
现场验收真正需要的是一条闭合的证据链:基线说明测试在什么条件下进行,抓包和日志证明实际发生了什么,指标把现象转成可比较的数据,异常与恢复记录证明系统面对故障时如何动作,验收清单最终把这些证据转成明确结论。做到这一点,报告才不仅是测试记录,也是后续复验、故障追踪和项目交付的可信依据。