YD∕T 3872-2021 互联网业务质量监测系统接口技术要求(通信).pdf

《YD∕T 3872-2021 互联网业务质量监测系统接口技术要求(通信).pdf》由会员分享，可在线阅读，更多相关《YD∕T 3872-2021 互联网业务质量监测系统接口技术要求(通信).pdf（56页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、 ICS 33.040.40 L 78 YD 中华人民共和国通信行业标准 YD/T XXXXXXXXX 互联网业务质量监测系统接口技术要求 Technical specification of internet service monitoring system interface 报批稿 XXXX-XX-XX 发布 XXXX-XX-XX 实施 中华人民共和国工业和信息化部 发布 YD/T XXXXXXXXXI目 次 前言.III 1 范围.1 2 规范性引用文件.1 3 术语、定义和缩略语.1 3.1 术语和定义.1 3.2 缩略语.1 4 概述.2 4.1 互联网业务质量监测系统概述.2

2、4.2 接口概述.2 5 接口技术要求.3 5.1 接口技术原则.3 5.2 接口通信协议.3 6 接口功能要求.4 6.1 接口功能概述.4 6.2 探针注册接口.5 6.3 探针心跳接口.5 6.4 任务下发接口.5 6.5 测试数据上报接口.5 6.6 状态及告警上报接口.6 6.7 探针升级接口.6 7 接口格式要求.6 7.1 接口格式要求概述.6 7.2 探针注册接口.6 7.2.1 接口概述.6 7.2.2 接口交互过程.6 7.2.3 消息格式定义.7 7.3 探针心跳接口.10 7.3.1 接口概述.10 7.3.2 接口交互过程.10 7.3.3 消息格式定义.11 7.4

3、 任务下发接口.12 7.4.1 接口概述.12 7.4.2 接口交互过程.12 7.4.3 消息格式定义.13 7.5 测试数据上报接口.15 7.5.1 接口概述.15 7.5.2 接口交互过程.15 YD/T XXXXXXXXXII7.5.3 消息格式定义.16 7.6 状态及告警上报接口.17 7.6.1 接口概述.17 7.6.2 接口交互过程.17 7.6.3 消息格式定义.17 7.7 探针升级接口.19 7.7.1 接口概述.19 7.7.2 接口交互过程.19 7.7.3 消息格式定义.19 8 任务下发与数据上报格式要求.22 8.1 任务下发与数据上报格式要求概述.22

4、8.2 网络层质量测试.22 8.2.1 Ping 测试.22 8.2.2 Traceroute 测试.24 8.3 传输层质量测试.27 8.3.1 TCP 测试.27 8.3.2 UDP 测试.28 8.4 应用层质量测试.31 8.4.1 DNS 业务测试.31 8.4.2 网站业务测试.33 8.4.3 FTP 业务测试.35 8.4.4 MAIL 业务测试.39 8.4.5 视频业务测试.43 8.4.6 宽带接入测试.45 8.4.7 WLAN 业务测试.47 YD/T XXXXXXXXXIII前 言 本标准按照GB/T 1.1-2009给出的规则起草。注意本文件的某些内容可能涉及

5、专利，本文件的发布机构不承担识别这些专利的责任。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国联合网络通信集团有限公司。本标准主要起草人：刘永生、夏俊杰、徐东、杨艳松、何晓峰、刘畅、张学茹、任梦璇、文湘江、朱鹏 YD/T XXXXXXXXX1互联网业务质量监测系统互联网业务质量监测系统接口技术要求接口技术要求 1范围 本标准规定了互联网业务质量监测系统用于异厂家设备间的互通接口技术要求，主要包括互通接口的信息交互流程和报文格式。本标准适用于互联网业务质量监测系统的异厂家设备互通工作，具体是分别属于不同厂家的探针和平台之间的互通工作。2规范性引用文件 下列文件对于本文件的应用是必不可

6、少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。YD/T 1641-2007 互联网业务服务质量技术要求 YD/T 1642-2007 互联网业务服务质量测试方法 YDB 118-2012 宽带速率测试方法 用户上网体验 3术语、定义和缩略语 3.1术语和定义 下列术语和定义适用于本文件。3.1.1 连接建立时间 connection establishment time TCP连接的建立时间，以发出第一个SYN报文到收到第一个SYN ACK报文的时间计算。3.1.2 首包到达时间 first packet arri

7、val time 网站业务中，从发送get请求到收到第一个数据包的时间。3.1.3 文本页面 html page 网站业务中，主html文件。3.1.4 首屏 first screen 网站业务中，处在首个浏览器窗口区域内的页面内容。3.1.5 完整下载时间 complete download time 网站业务中，完整网页内容的下载时间。3.1.6 卡顿 lagging 视频业务中，由于缓冲引起的播放暂停现象。3.2缩略语 YD/T XXXXXXXXX2下列缩略语适用于本文件。DNS 域名系统 Domain Name System FTP 文件传输协议 File Transfer Proto

8、col HTTP 超文本传送协议 Hyper Text Transfer Protocol ICMP Internet 控制报文协议 Internet Control Message Protocol NTP 网络时间协议 Network Time Protocol SOAP 简单对象访问协议 Simple Object Access Protocol TCP 传输控制协议 Transmission Control Protocol TWAMP 双向主动测量协议 Two-Way Active Measurement Protocol UDP 用户数据报协议 User Datagram Prot

9、ocol WLAN 无线局域网 Wireless Local Area Networks WS Web 服务 Web Services WSDL Web 服务定义语言 Web Service Definition Language XML 可扩展标记语言 eXtensible Markup Language 4概述 4.1互联网业务质量监测系统概述 互联网业务质量监测系统是一种主动的监测模式，通过网络中部署监测探针设备和管理平台，模拟用户的上网行为，实时地感知网络承载业务的质量，在 IP 网络用户发现问题之前将网络出现的质量下降情况报告给监测系统。突破了从传统的以网络三层以下的指标来评价网络质

10、量的范围，以应用层的服务质量直接反映网络的质量，监测所用的探针部署于网络接入层，做到了全程全网的质量监测。本标准适用于互联网业务质量监测系统的异厂家设备互通工作，具体是分别属于不同厂家的探针和平台之间的互通工作。4.2接口概述 互联网业务质量监测系统由管理平台和探针两部分组成，管理平台部署在企业总部，通过交换机接入管理网络，探针根据需要测量的网络层次部署在网络的各个层次、各个地点或各种终端中，探针可以通过 3G/WLAN、PPPoE、Ethernet 等多种方式接入网络。监测系统需要在管理平台和探针之间建立网络连接，使得探针和管理平台之间能够实现注册、心跳交互、任务下发、数据上报、告警上报和软

11、件升级等功能。如果管理平台和探针属于相同的厂家，管理平台和探针之间的通信可以使用私有协议；如果管理平台和探针属于不同的厂家，如图 1 所示，B 厂探针、C 厂探针和 A 厂管理平台，要实现探针和平台之间的通信，需要规定通信接口标准，本标准就是规范了分别属于不同厂家的探针和管理平台之间的通信接口技术要求。YD/T XXXXXXXXX3 图 1 拓扑环境 5接口技术要求 5.1接口技术原则 管理平台和探针应满足以下的原则：a）互通性：管理平台部署在企业总部机房，处于防火墙的后方，探针部署位置灵活多变，通信协议需要保证探针能够与管理平台进行互联互通，通信协议在互通性方面需要满足以下要点：1)能够穿透

12、防火墙；2)能够在 VPN 内传输；3)对中间设备透明，不需要改变中间设备组网方式和配置。b）标准性：为保证多种厂家设备的相互兼容性，各设备必须支持使用本规范中定义的标准接口进行信息传递，通信协议在规范性方面需要满足以下要点：1)业务流程定义必须遵循国际标准，保证可移植性；2)交互的信息应遵循本规范中定义的 XML 格式，且设备应能够从该信息格式中正确的读取交互信息接口和业务流程的命名应遵循本规范中定义，并应确保对规范中定义命名的可读性。对于规范中未定义的项目命名，应保证命名清晰明了；3)管理平台与探针接口建议采用统一技术实现，尽量避免采用多种不同技术。c）高效性：互联网测试指标较多，测试任务

13、数多，通信协议需要有较高的通信效率。d）数据管理性：探针上报测试数据到管理平台后，管理平台应能够对测试数据进行数据管理，需要满足以下要点：1)探针应按照指定的格式生成测试数据上报文件；2)管理平台应能够读取探针上报的测试数据文件，并通过数据库形式对测试数据进行管理和存储。5.2接口通信协议 本规范建议优先采用Web Service作为接口协议，并采用SOAP(版本1.2)定义消息格式。本规范中规定，对于大数据量的数据交互，采用Web Service来传递其控制信息，而采用FTP+XML文件的方式传递大数据；对于小数据量或实时性要求高的数据交互，则直接采用WebService+XML的方式。We

14、b Service以主从式架构(Client-server)通过SOAP协议传递XML格式的消息。Web Service过程中会由服务器提供一个机器可读的WSDL以辨识服务器所提供的Web Service。YD/T XXXXXXXXX4因此，简单对象访问协议(Simple Object Access Protocol，SOAP)为本接口规范规定的消息格式，其数据包封装格式如图2所示。图 2 SOAP 数据包封装格式 WSDL(Web Services Description Language)用于定义Web Service中规定的具体接口。在管理平台端，将使用Web Service定义具体的接

15、口方法，并将这些接口方法生成为一个机器可读的WSDL文件(例如：webservice.wsdl)。探针端通过加载该WSDL文件来获得已定义的接口方法，并根据其中定义好的接口方法调用方式，来对管理平台端发起接口请求。接口的实现如图3所示。图 3 互通接口实现 6接口功能要求 6.1接口功能概述 本规范定义的接口包括探针注册、探针心跳、任务下发、测试数据上报、状态及告警上报、探针升级接口。接口交互流程概括如图4所示。YD/T XXXXXXXXX5 图 4 接口交互流程 6.2探针注册接口 探针注册接口用于实现探针自动注册到管理平台的功能，该认证过程中探针需向管理平台提供探针的基础信息，管理平台需对

16、接入探针进行认证。探针注册信息应该至少包含探针名称、探针管理地址、探针软件版本、探针硬件型号、探针运行参数、探针认证等信息。管理平台也能够通过注册回复对探针进行参数配置。探针侧在得知管理平台有新配置下发时，应立即调用注册请求，从而从注册回复中获取新配置信息。6.3探针心跳接口 探针心跳接口用于处理管理平台与探针之间的定期心跳交互，主要功能包括检测探针是否在线，以及向探针通告管理平台侧有新配置、新任务或新版本需要下发。6.4任务下发接口 任务下发接口用于从管理平台侧向指定探针下发测试任务，或是更新测试任务。任务下发或任务更新过程中，管理平台需将测试任务的具体参数设置通过该接口传递给指定探针。6.

17、5测试数据上报接口 YD/T XXXXXXXXX6测试数据上报接口用于从探针侧向管理平台上报测试任务的测试结果数据。上报的测试数据应至少包括测试ID、测试端口、测试类型、具体测试结果数据等信息。6.6状态及告警上报接口 状态及告警上报接口用于由探针向管理平台上报工作状态信息，以及在异常或危险状态时向管理平台上报告警信息。状态上报应至少支持CPU、内存、硬盘以及端口的使用情况上报。告警类型应至少支持CPU、内存、硬盘告警，以及未知错误告警，且告警信息中应至少包含告警类型、告警级别、告警描述等信息。6.7探针升级接口 探针升级接口用于由管理平台向指定探针下发软件升级命令，并用于传递升级所需的升级文

18、件列表。7接口格式要求 7.1接口格式要求概述 本章具体规定了管理平台与探针之间信息交互的接口格式，具体包括探针注册接口、探针心跳接口、任务下发接口、测试数据上报接口、状态及告警上报接口、探针升级接口。7.2探针注册接口 7.2.1接口概述 探针注册接口用于实现探针自动注册到管理平台的功能，探针通过WebService上报注册XML到管理平台请求注册，管理平台解析注册XML确定注册类型，做相应的注册处理，注册处理后向该探针下发注册回复XML。管理平台也能够通过注册回复对探针进行参数配置。探针注册信息应该至少包含探针名称、探针管理地址、探针软件版本、探针硬件型号、探针运行参数、探针认证等信息。探

19、针注册在探针新接入网络，或者重新上线时会立即触发。在收到带有config_update标志位的心跳回复后，探针也会立即触发注册报文，使得管理平台通过注册回复来下发更新的配置。7.2.2接口交互过程 探针注册接口是基于 WEBSERVICE技术实现的，它的组成如图5所示。图 5 探针注册交互过程 该接口采用WEBSERVICE实现，数据采用XML格式，归属于管理平台管理。接口交互过程如下：a）探针端主动收集探针名称、探针管理地址、探针软件版本、探针硬件型号、探针运行参数等信息，YD/T XXXXXXXXX7并添加认证信息组成 XML 文件格式，请求管理平台的探针注册接口；b）管理平台收到注册信息

20、后，做相应的处理，并更新数据库中的信息。处理成功或失败均返回状态信息。7.2.3消息格式定义 该接口由SOAP方式实现，返回数据采用XML格式。接口方法：probeRegister 输入参数：XML格式的字符串 标签的下属标签分别为状态信息、探针属性、探针运行参数、授权测试模块、探针网络接口信息。，状 态 信 息，包 含 子 标 签：、见 表 1。，探针属性，包含子标签说明见表2。，探针运行参数属性，包含子标签说明见表3。，探针网络接口信息，可根据探针开启的实际物理网口个数生成对应个数的子标签。子标签包含、属性值，说明见表4。表 1 状态信息子标签说明 XML 标签 数据类型 数据描述 sta

21、tus_code Long 状态码，在请求注册时无效，注册回复时有效，0：成功；1：失败 description String 状态描述，在请求注册时无效，注册回复时有效，“Success!”成功描述，其他为错误描述信息 表 2 探针属性子标签说明 XML 标签 数据类型 数据描述 probe_id Long 探针 ID，在请求注册时无效，注册回复时有效，ID 为管理平台为此探针分配的唯一标识整数值 ip_addr String 探针管理地址，内容为点分十进制 IP 地址，为探针端配置的地址 software_version String 探针软件版本号，版本号 3 节标识法，如 3.3.0

22、probe_name String 探针名称，探针名称为字符串格式中英文名称均可。最长为32 个字符 serial_num String 探针序列号，探针硬件的唯一标识，前 4 位为厂家标号XXX-。如 001-000002001 authentication String 认证号，用于管理平台验证探针身份。计算方法为 serial_num与登陆密码拼接后做 32 位 MD5，取结果的后 8 位字符 hardware_version String 硬件型号，硬件型号为厂家硬件型号的标识 表 3 探针运行参数属性子标签说明 XML 标签 数据类型 数据描述 enable_test Long 是否

23、测试，0：探针暂停所有测试任务，1：探针按照下发的YD/T XXXXXXXXX8任务正常执行 heartbeat_interval Long 探针心跳间隔，单位为秒，默认值为 30 status_interval Long 状态上报间隔，单位为秒，默认值为 180 all_task_interval Long 全任务下发间隔，单位为秒，默认值为 3600 data_delay Long 数据推迟上报时间，单位为秒，默认值为 10。0 表示测试完成数据立即上报，不进行推迟上报 ntp String NTP 时间同步指定地址。内容为点分十进制 IP 地址 表 4 探针网络接口信息子标签说明 XML

24、 标签 数据类型 数据描述 interface_name String 网络接口名称，该名称为操作系统中对应网口的名称，如eth0、ppp0 等。Vlan 如 eth0.1。ADSL 端口与物理端口对应，如 eth1 拨号则显示 ppp1。3G 端口统一标记，ppp20 为联通，ppp21 为移动，ppp22 为电信 interface_ip String 网络接口 IP 地址，值为点分十进制 IP 地址 interface_mac String 网络接口 MAC 地址，值为 MAC 地址，如：00:1b:eb:01:f4:f9 注册请求 XML 格式示例如下：0 Success!0 192.

25、168.1.32 1.0.0 XXXX 001-000002001 12345678 S-E3U2 1 20 180 3600 10 192.168.0.1 YD/T XXXXXXXXX9 eth0 eth1 wlan0 ppp12 注册回复 XML 格式示例如下：0 Success!58 192.168.1.32 1.0.0 XXXX 001-000002001 S-E3U2 1 20 180 3600 10 192.168.0.1 YD/T XXXXXXXXX10 eth0 eth1 wlan0 ppp12 说明：a）探针 ID，首次注册请求或探针重启时 probe_id 为 0，注册成功

26、后回复 XML 中探针 ID 被填充为管理平台为探针分配的 ID；b）探针重启时，注册请求中的 probe_id 填为 0，管理平台通过探针 serial_num 判别是否为已有探针，若为已有探针则返回其原 probe_id 而不重新分配新的 probe_id；c）收到 probe_id 为 0 的注册请求时，管理平台自行判定是否采纳探针侧的配置信息，并返回注册回复；而探针侧则必须采纳注册回复中的配置信息；d）注册成功后，管理平台可以通过注册回复对探针运行参数进行了修改，实现配置探针的功能。其中和为允许修改的配置项。7.3探针心跳接口 7.3.1接口概述 该接口用于探针定期向管理平台发送心跳信

27、息，用于测试探针与管理平台间的网络连通性，管理平台可通过心跳信息判断探针是否在线，以及在有新配置、新任务或新版本需要下发时通告探针。探针使用探针ID通过WebService请求心跳服务，管理平台判断探针ID合法性，判断合法后将该探针的最后一次心跳时间更新为系统当前时间，并回复探针操作状态XML格式的数据。7.3.2接口交互过程 图 6 探针心跳交互过程 探针心跳的交互过程如图6所示，包括：a）探针向管理平台发送探针 ID；YD/T XXXXXXXXX11b）管理平台根据探针 ID 查询数据库判断探针 ID 是否合法，如 ID 合法在管理平台中更新探针最后心跳时间。7.3.3消息格式定义 该接口

28、由 SOAP 方式实现，返回数据采用 XML 格式。接口方法：probeHeartbeat 输入参数：XML 格式的字符串 XML 格式的数据为探针 ID，定义如表 5。表 5 探针 ID 子标签说明 XML 标签 数据类型 数据描述 probe_id Long 探针 ID 心跳请求 XML 格式示例如下：58 输出参数：XML 格式的字符串 XML 格 式 的 数 据 为 状 态 信 息 ，包 含 子 标 签：、见表 6。表 6 状态信息子标签说明 XML 标签 数据类型 数据描述 status_code Long 状态码，在请求注册时无效，注册回复时有效，0：成功；1：失败 descrip

29、tion String 状态描述，在请求注册时无效，注册回复时有效，“Success!”成功描述，其他为错误描述信息 task_update Long 0:无任务更新 1：有任务更新 config_update Long 0:无配置更新 1：有配置更新 probe_update Long 0：无版本升级 1：有新版本需要升级 extend String 扩展字段，暂无定义。字符串格式方便扩展 操作成功返回格式：0 Success!0 0 0 string YD/T XXXXXXXXX12 操作失败 xml 参见如下：1 Failure!说明：a）管理平台在对探针有了新的配置后，设置为 1，通过

30、心跳回复通告探针有配置更新，探针再通过探针注册接口请求具体的配置；b）探针重启被视为是一种配置更新，通过设置为 1 且设置为 REBOOT 进行通告；c）在有了新的测试任务或者修改了测试任务参数时，设置为 1，通过心跳回复通告探针有任务更新，探针再通过任务下发接口请求具体的任务；d）在需要对探针进行版本更新时，设置为 1，通过心跳回复通告探针有软件更新，探针再通过探针升级接口请求具体升级软件版本。7.4任务下发接口 7.4.1接口概述 探针新注册、新上线、以及全任务下发周期满时，探针通过任务下发接口向管理平台请求其全部任务。在收到带有task_update标志位的心跳回复后，探针通过任务下发接

31、口向管理平台请求更新的任务。管理平台收到请求后，根据探针ID遍历任务文件夹，查找该探针的任务XML文件。若存在任务更新，则下发给该探针任务的更新操作；若不存在任务更新，则下发给该探针其全部任务。如果不存在该探针的任务XML文件，管理平台将给该探针回复操作失败信息(XML)。7.4.2接口交互过程 图 7 任务下发交互过程 接口交互过程如图 7，过程包括：a）在收到带有 task_update 标志位的心跳回复后，探针向管理平台接口发送探针 ID；b）探针在新注册、新上线、以及按照 all_task_interval 周期进行全任务下发，探针向管理平台接YD/T XXXXXXXXX13口发送探针

32、 ID；c）管理平台根据探针 ID 查询数据库判断探针 ID 是否合法，收到请求后根据探针 ID 遍历任务文件夹，查找该探针的任务 XML 文件。若管理平台存在任务更新，则下发给该探针任务的更新操作；若管理平台不存在任务更新，则下发给该探针其全部任务。如果不存在该探针的任务XML 文件，管理平台将给该探针回复操作失败信息(XML)。说明：全任务下发周期 all_task_interval 可以通过注册回复对探针进行配置。7.4.3消息格式定义 该接口使用 SOAP 方式实现，返回数据采用 XML 格式。接口方法：probeTaskDownload 输入参数：XML 格式的字符串 XML 格式的

33、数据为探针 ID，定义如表 7。表 7 探针 ID 子标签说明 XML 标签 数据类型 数据描述 probe_id Long 探针 ID 任务请求 XML 格式示例如下：58 输出参数：XML 格式的字符串 任务文件中每一个为一个任务字段。、与为的属性字段，分别为任务 ID、任务类型名称和操作类型。其他子标签说明见附录 A。任务下发 XML 格式示意如下：0 Success!eth0 1 64 10 10 23:00 YD/T XXXXXXXXX14 00:00 24:00 300 10 eth0 16 1 1 1 23:00 00:00 24:00 300 说明：a）执行次数为可选项，若未设

34、置执行次数，则认为该任务没有执行次数上限；b）执行次数与结束时间的优先级相同，任一指标符合后都将终止任务；c）数据上报时间为可选项，能够指定该任务测试数据的上报时间，而不是测试结束立即上报；d）若任务已经开始，则不会由于结束时间到期而强制中断，而是会完成该次任务，以避免出现错误的测试结果；YD/T XXXXXXXXX15e）跨天任务通过多个时间段来进行拼接，结束时间允许设置为 24:00；f）即时任务的执行时段统一设定为 00:0024:00，接到任务后立即执行，并通过执行次数控制即时任务的终止；g）执行时段设定为 00:0024:00 并设定有执行次数的任务统一判定为即时任务；h）opera

35、tion_type 字段包含 4 种类型NULL、ADD、DELETE和MODIFY。NULL 用于全任务下发时，标明为未修改过的任务；ADD 用于表示新增 task_id 对应任务；DELETE 用于表示删除 task_id 对应任务；MODIFY 用于表示修改 task_id 对应任务中的测试参数；i）触发全任务下发时，由探针主动发起全任务请求，任务请求与正常的任务请求相同；管理平台在收到任务请求时，若发现管理平台未对该探针进行任务修改，则进行全任务下发。j）全任务下发时，操作符 operation_type 字段统一为NULL；即时任务仅进行增量式下发，即通过操作符ADD、DELETE和

36、MODIFY进行下发，而在全任务下发时并不包括即时任务。7.5测试数据上报接口 7.5.1接口概述 探针测试完成后以XML格式保存数据文件到探针上，探针定期通过测试数据上报接口上报数据文件。管理平台收到后将文件保存到管理平台上，由其他模块解析数据等后续操作。7.5.2接口交互过程 图 8 测试数据上报交互过程 测试数据上报接口交互过程如下：a）探针通过 WebService 请求数据上报服务，将数据 xml 上传到管理平台；b）管理平台接到请求后，判断探针上报的数据 xml 格式是否正确，如果不空且格式正确，将数据 xml 保存到数据文件夹下，等待后台程序处理，否则拒绝服务；c）管理平台给探针

37、回复上报数据文件状态信息。说明：测试结束后，并不立即触发数据上报，而是等待一个推迟上报时间(默认 10 秒，可在注册回复中通过 data_delay 设定)。若等待时间内没有新任务完成，则进行数据上报；若有新任务完成，则重置上报推迟时间，继续等待，触发数据上报后，累积的数据将一起上报。7.5.3消息格式定义 YD/T XXXXXXXXX16该接口使用 SOAP 方式实现，返回数据采用 XML 格式。接口方法：probeDataUpload 输入参数：XML 格式的字符串 数据上报 xml 格式如下：1328870817 104427 8755 0 1328870817 119.167.228.

38、15 8755 104427 4638463 0 0 各种测试类型测试数据格式详见第 6 章 说明：1)在测试任务发生错误时，错误项的上报数据填充为-1，以表示为无效数据。测试时间 test_time 为测试结束的时间。输出参数：XML 格式的字符串 操作成功返回 xml 格式如下：0 Success!操作失败返回 xml 格式如下：1 Failure!YD/T XXXXXXXXX17说明：一个数据上报xml中允许包含多个测试任务的结果数据，因此返回消息中不包含特定的task_id值。7.6状态及告警上报接口 7.6.1接口概述 状态及告警上报接口用于由探针向管理平台上报工作状态信息，以及在异

39、常或危险状态时向管理平台上报告警信息。探针工作状态信息的上报支持CPU、内存、硬盘以及端口的使用情况。告警类型支持CPU、内存、硬盘告警，以及未知错误告警。在正常状态下，探针周期性上报其工作状态信息，上报周期通过注册回复中的status_interval设置。在异常或危险状态时，探针需立即上报告警信息，并且在异常或危险恢复后，立即上报正常的工作状态信息。7.6.2接口交互过程 图 9 状态及告警上报交互过程 状态及告警上报接口交互过程如下：a）在正常状态下，探针周期性上报其工作状态信息。在异常或危险状态时，探针立即上报告警信息。在异常或危险恢复后，探针立即上报正常的工作状态信息；b）管理平台给

40、探针返回状态上报回复信息。7.6.3消息格式定义 该接口使用 SOAP 方式实现，返回数据采用 XML 格式。接口方法：probeStatusUpload 输入参数：XML 格式的字符串 标签包含版本号 template_ver 和 probe_id 属性，的下属标签为一个或多个信息。信息包含三个属性：type_id、probe_id、type_name、occur_time 和子标签：、见表 8。表 8 状态信息子标签说明 XML 标签 数据类型 数据描述 probe_id Long 探针 ID type_id Long 类型，0：状态上报，1：CPU 告警，2：内存告警，3：磁盘告警，4：

41、其它 type_name String 类型名称，包括 CPU、MEM、DISK、ETHn occur_time Long 测试结束时间，该测试时间使用整数表示，该值为采用跨平YD/T XXXXXXXXX18台通用时间表示法，1970 年 1 月 1 日的 UTC 时间从 0 时 0分 0 秒算起到现在所经过的秒数 value String 类型为 CPU、MEM、DISK 时为使用百分比，单位为%；类型为ETHn 时为端口入、出流量速率，其为上报间隔时间内的平均速率，单位为 Kbps，数值中间用英文|分隔 alarm_level Long 告警级别：0：非警告，1：提示，2：次要，3：一般，

42、4：重要，5：严重，可选项 description String 告警描述信息，状态信息描述或告警信息描述，可选项 状态及告警上报 XML 格式示例如下：30 0 CPU USED 30%1000|100 0 ETH0 IN 1000Kbps;OUT 100Kbps 说明：a）正常的工作状态信息上报的统一设置为 0；b）温度和风扇的告警类型为 4(其它)，告警级别有探针决定，具体信息在字段进行描述；c）所有未定义的告警类型统一为 4(其它)，告警级别统一设置为 5(严重)，具体信息在字段进行描述。输出参数：XML 格式的字符串 XML 格式的数据为状态信息，包含子标签：、见表 9。表 9 状态

43、信息子标签说明 XML 标签 数据类型 数据描述 status_code Long 状态码，在请求注册时无效，注册回复时有效，0：成功；1：失败 description String 状态描述，在请求注册时无效，注册回复时有效，“Success!”成功描述，其他为错误描述信息 操作成功返回 xml 格式：0 YD/T XXXXXXXXX19Success!操作失败返回 xml 格式：1 Failure!7.7探针升级接口 7.7.1接口概述 探针的软件升级采用管理平台指定升级的方式。探针在收到带有probe_update标志位的心跳回复后，探针上报当前版本信息并请求软件升级，管理平台根据升级控

44、制文件判断该探针所需的升级文件，并将升级文件的列表返回给探针，探针获取到升级列表后采用FTP或HTTP的方式下载升级文件。探针升级请求上报的信息应该包含：探针ID、探针名称、探针软件版本、探针硬件型号信息。7.7.2接口交互过程 图 10 探针升级交互过程 探针升级接口交互流程如下：a）探针访问管理平台侧的升级请求接口，输入参数为 XML 格式的数据，包含探针 ID、探针名称、探针软件版本、探针硬件型号信息；b）管理平台收到探针升级请求后，根据探针 ID、探针名称、探针软件版本、探针硬件型号信息到升级控制文件中进行查询比对，如符合升级条件，则管理平台下发对应的升级文件列表，以 XML 文件的文

45、件返回；如不符合升级条件，返回 XML 格式的数据，并在状态中说明探针当前已经是最新版本，或其他错误原因。7.7.3消息格式定义 该接口由 SOAP 方式实现，返回数据采用 XML 格式。接口方法：probeUpGrade 输入参数：输入参数：XML 格式的字符串格式的字符串 YD/T XXXXXXXXX20包含它的属性标签，和它的下属标签、。表 10 升级接口子标签说明 XML 标签 数据类型 数据描述 template_ver String 升级请求模板版本号，目前为 1.0.0 probe_hardware_ver String 硬件型号，硬件型号为厂家硬件型号的标识 probe_sof

46、tware_ver String 探针软件版本号，版本号 3 节标识法，如 1.0.0 probe_name String 探针名称，探针名称为字符串格式中英文名称均可。最长为32 个字符 probe_id Long 探针 ID probe_ip String 探针管理地址，点分十进制格式 探针升级接口请求 XML 格式示例如下：XXX-XXXX 1.1.0 ProbeName 416 192.168.11.11 输出参数：XML 格式的字符串 已经是最新版本回复：2013-7-9 0:50:37 1 IS_LATEST_VERSION 需要升级时回复 XML 格式如下：下属标签包括：文件生成

47、信息标签和返回状态信息标签。生成信息标签如表 11。表 11 生成信息子标签说明 XML 标签 数据类型 数据描述 create_time String 时间字符串格式:yyyy-MM-dd HH:mm:ss 状态信息标签包含子标签：状态码、状态描述、探针硬件版本 、探 针 软 件 版 本 、和YD/T XXXXXXXXX21，其中、和 都包含 0 或多个子标签。表 12 状态信息子标签说明 XML 标签 数据类型 数据描述 status_code Long 状态码，在请求注册时无效，注册回复时有效，0：成功；1：失败 description String 状态描述，在请求注册时无效，注册回复

48、时有效，“Success!”成功描述，其他为错误描述信息 hardware_version String 探针硬件版本 software_version String 探针软件版本 update_file_list 需要升级的文件列表 包含多个 create_file_list 需要新创建的文件列表 包含多个 remove_file_list 需要删除的文件列表 包含多个 标签包含：属性 file_name 和下属标签、和。表 13 文件列表子标签说明 XML 标签 数据类型 数据描述 file_name String 创建、修改或删除的文件名 source String 升级文件所在管理平台

49、路径 destination String 升级文件替换探针路径 file_size String 升级文件大小 file_md5 String 升级文件 MD5 值 示例格式如下：2013-6-3 7:14:0 0 Success!S-E3U2 3.3.0 /home/update30/app/TaskRunner /bin/app/TaskRunner 5981234 XXXXXXXXXXXXXXXXX YD/T XXXXXXXXX22 /home/update30/app/DataWriter /bin/app/DataWriter 388412 XXXXXXXXXXXXXXXXXX 8

50、任务下发与数据上报格式要求 8.1任务下发与数据上报格式要求概述 本规范规定了各种测试任务常用配置的下发，以及常用测试结果的上报。对于规范中未定义的高级配置项，测试任务中统一按照默认值进行设置，如TTL、填充内容、分片标志等高级配置项统一按照浏览器(IE)默认值进行配置。对于规范中未定义的高级配置和结果项，允许在同厂家设备之间进行下发和上报。而在异厂家设备之间暂不支持这些高级配置和结果项的交互。8.2网络层质量测试 8.2.1Ping 测试 任务下发格式：标签下属子标签有执行任务物理端口信息与任务类型 ID 值、任务运行参数、任务调度规则。子标签说明见表 14。Ping 测试类型子标签说明见表