中国移动智能家庭网关软探针北向接口技术规范V1.0.0-发布

中国移动通信企业标准

QB-╳╳-╳╳╳-╳╳╳╳

中国移动智能家庭网关软探

针北向接口技术规范

T e c h n i c a l S p e c i f i c a t i o n s f o r I n t e l l i g e n t

H o m e G a t e w a y S o f t P r o b e a n d

N o r t h-I n t e r f a c e

版本号：1.0.0

╳╳╳╳-╳╳-╳╳发布╳╳╳╳-╳╳-╳╳实施中国移动通信集团公司发布

目录

1. 前言 (3)

2. 范围 (3)

3. 规范性引用文件 (3)

4. 术语、定义和缩略语 (3)

5. 智能家庭网关软探针与监测平台接口定义 (4)

5.1. 接口功能描述 (4)

5.2. 接口结构描述 (5)

5.3. 接口协议说明 (5)

5.3.1. HTTP请求发起 (5)

5.3.2. HTTP请求返回 (6)

5.3.3. FTP文件上传 (7)

5.3.4. 接口JSON数据协议定义 (7)

6. 开机上报接口 (7)

6.1. 开机上报请求 (7)

6.2. 开机上报响应 (10)

7. 周期上报接口 (12)

7.1. 周期上报数据 (12)

7.1.1. 网关信息 (12)

7.1.2. 业务信息 (15)

7.2. 周期上报请求 (19)

7.3. 周期上报响应 (21)

7.4. 周期文件上报接口 (21)

7.4.1. FTP文件格式和参数 (21)

8. 实时上报接口 (22)

8.1. 实时上报数据 (22)

8.1.1. 网络诊断数据 (22)

8.1.2. 网络质量测试功能数据 (24)

8.2. 实时上报请求 (25)

8.3. 实时上报响应 (26)

9. 告警上报接口 (27)

9.1. 告警上报数据 (27)

9.1.1. DNS告警 (27)

9.1.2. TCP连接告警 (27)

9.1.3. HTTP连接告警 (28)

9.1.4. HTTP下载告警 (28)

9.1.5. 视频卡顿告警 (29)

9.1.6. 即时通信/游戏告警 (29)

9.2. 告警上报请求 (29)

9.3. 告警上报响应 (30)

10. 网络探测接口 (31)

10.1. 主动测试请求 (31)

10.2. 主动测试响应 (31)

11. 配置接口 (31)

11.1. 周期上报配置 (31)

11.2. 告警配置 (33)

11.3. 网络探测配置 (34)

11.3.1. 网络诊断配置 (34)

11.3.2. 网络质量测试配置 (34)

12. 编制历史 (35)

附录A常量表 (35)

1.前言

本规范旨在描述智能家庭网关软探针与软探针监测平台（省级数字家庭管理平台软探针前置机）之间的接口协议，用以规范智能家庭网关软探针应用和软探针监测平台的对接与实现，保证整个智能家庭网关软探针中间件及软探针监测平台顺畅运行。

本标准由中国移动通信集团公司网络部提出并归口。

本标准起草单位：中国移动通信集团公司网络部、中国移动通信研究院。

本标准主要起草人：孔庆慧、陈海宁、李颖、陶虹、郭毅峰、王天竹、吴文雯。

本标准解释单位：中国移动通信集团公司网络部。

本标准由中国移动通信集团公司XXX号文发布。

2.范围

本协议规定了中国移动智能家庭网关软探针与软探针监测平台之间的接口协议，是中国移动家庭宽带质量监测平台相关产品开发的依据，适合于智能家庭网关软探针和软探针监测平台的对接。

3.规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是标注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。

4.术语、定义和缩略语

下列术语、定义和缩略语适用于本标准：

表4-1 中英文对照

5.智能家庭网关软探针与监测平台接口定义

5.1.接口功能描述

智能家庭网关软探针通过OSGI API 采集网关信息以及分析通过网关的数据包信息，进行预处理生成上报数据。根据按触发上报的不同的条件，软探针与软探针监测平台的接口可分为：

表5-1 上报接口类型

5.2.接口结构描述

智能家庭网关软探针与软探针监测平台的接口分布如下图：

图5-1智能家庭网关软探针与软探针监测平台的接口示意图

5.3.接口协议说明

智能家庭网关软探针通过HTTP等应用层协议实现智能家庭网关软探针与软探针监测平台之间的远程访问；本协议采用TCP，智能家庭网关软探针作为client向软探针监测平台发起TCP连接，监测平台响应后，即可关闭连接。

5.3.1.HTTP请求发起

数据传输消息由智能家庭网关软探针向软探针监测平台发起访问请求，消息格式如下：

Request URI：默认为“/”

Host：软探针监测平台的域名及端口

Content-Type：application/JSON

Content-Length：表明了消息体长度；

User-Agent：表明了客户端的信息；

Date：发起请求的日期、时间

Accept：终端可以接收的响应消息的媒体类型

：消息体中包含一个JSON文档，详细数据格式请参考具体接口。

5.3.2.HTTP请求返回

数据接收消息由软探针监测平台向智能家庭网关软探针返回数据请求结果，消息格式如下：

Server：服务器软件信息

Content-Type：application/JSON

Content-Length：消息体长度

：消息体中包含一个JSON文档，详细数据格式请参考具体接口。