资源描述
中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
中国移动统一DPI设备技术规范-LTE数据合成服务器接口规范
Technical Specification of Deep Packet Inspection Equipment for CMCC
(LTE Data Combining Server Interface Part)
版本号:2.0.9
╳╳╳╳-╳╳-╳╳实施
╳╳╳╳-╳╳-╳╳发布
中国移动通信集团公司 发布
目 录
前 言 VI
1 范围 7
2 规范性引用文件 7
3 术语、定义和缩略语 7
4 接口在网络中的位置 9
4.1 系统架构 9
4.2 接口功能 9
5 数据上报接口 10
5.1 概述 10
5.1.1 合成XDR数据 10
5.1.2 单接口XDR数据 10
5.1.3 原始码流数据 11
5.1.4 KPI数据 11
5.2 接口协议 11
5.2.1 消息类型 12
5.2.2 消息结构 12
5.2.3 连接管理流程 13
5.2.4 连接管理消息 14
5.2.4.1 版本协商verNego 14
5.2.4.1.1 请求 14
5.2.4.1.2 应答 14
5.2.4.2 链路认证linkAuth 14
5.2.4.2.1 请求 14
5.2.4.2.2 应答 15
5.2.4.3 链路检测linkCheck 15
5.2.4.3.1 请求 15
5.2.4.3.2 应答 16
5.2.4.4 链路数据发送校验linkDataCheck 16
5.2.4.4.1 请求 16
5.2.4.4.2 应答 16
5.2.4.5 链路释放linkRel 17
5.2.4.5.1 请求 17
5.2.4.5.2 应答 17
5.2.5 数据通知消息 17
5.2.5.1 XDR对应原始数据传输XDRRawDataSend 17
5.2.5.1.1 请求 17
5.2.5.1.2 应答 17
5.2.5.2 XDR数据通知notifyXDRData 18
5.2.5.2.1 请求 18
5.2.5.2.2 应答 18
5.2.5.3 KPI数据通知notifyKpiData 18
5.2.5.3.1 请求 18
5.2.5.3.2 应答 18
5.2.6 数据查询消息 19
5.2.6.1 XDR对应原始数据反查XDRRawDataQuery 19
5.2.6.1.1 请求 19
5.2.6.1.2 应答 19
5.3 数据格式 20
5.3.1 单接口XDR格式 20
5.3.2 合成信令XDR格式 20
5.3.2.1 概述 20
5.3.2.2 公共信息格式 20
5.3.2.3 通用信令信息格式 21
5.3.2.4 单接口信令信息格式 24
5.3.2.5 通用信令信息中Keyword 1字段的定义 26
5.3.2.6 通用信令信息中Keyword 2字段的定义 27
5.3.2.7 单接口流程类型的定义 27
5.3.3 合成业务XDR格式 31
5.3.3.1 概述 31
5.3.3.2 公共信息格式 31
5.3.3.3 通用业务信息格式 31
5.3.3.4 单小区业务信息格式 32
5.3.4 合成UE_MR XDR格式 33
5.3.4.1 概述 33
5.3.4.2 公共信息格式 33
5.3.4.3 MR信息格式 33
5.3.5 原始码流数据格式 35
5.3.6 KPI数据格式 35
6 KPI数据订阅接口 36
6.1 概述 36
6.2 KPI数据订阅流程 36
6.3 KPI数据订阅消息 38
6.3.1 授权获取getLinkAuth 38
6.3.1.1 请求 38
6.3.1.2 应答 39
6.3.1.3 鉴权 39
6.3.2 释放授权authRel 39
6.3.2.1 请求 39
6.3.2.2 应答 41
6.3.3 查询MME列表getMMEInfo 41
6.3.3.1 请求 41
6.3.3.2 应答 41
6.3.4 查询TAC列表getTACInfo 41
6.3.4.1 请求 41
6.3.4.2 应答 41
6.3.5 查询eNB列表getENBInfo 42
6.3.5.1 请求 42
6.3.5.2 应答 42
6.3.6 查询小区列表getCellInfo 42
6.3.6.1 请求 42
6.3.6.2 应答 42
6.3.7 查询终端列表getIMEIList 43
6.3.7.1 请求 43
6.3.7.2 应答 43
6.3.8 查询用户列表getUserList 43
6.3.8.1 请求 43
6.3.8.2 应答 43
6.3.9 创建订阅createSubscription 43
6.3.9.1 请求 44
6.3.9.2 应答 44
6.3.10 修改订阅updateSubscription 44
6.3.10.1 请求 44
6.3.10.2 应答 44
6.3.11 查询订阅getSubscription 44
6.3.11.1 请求 44
6.3.11.2 应答 45
6.3.12 取消订阅cancelSubscription 45
6.3.12.1 请求 45
6.3.12.2 应答 45
6.4 数据格式 45
6.4.1 订阅标识OrderID 45
6.4.2 服务端口ServicePort 45
6.4.3 MME信息MMEInfo 46
6.4.4 TAC信息TACInfo 46
6.4.5 eNB信息eNBInfo 46
6.4.6 小区信息CellInfo 46
6.4.7 终端信息IMEIInfo 46
6.4.8 用户信息UserInfo 47
6.4.9 KPI参数信息KPIParamsInfo 47
6.4.10 时间粒度Time Granularity 47
6.4.11 日期时间DateTime 48
6.4.12 KPI订阅信息KpiOrderInfo 48
7 至经分系统(经上报网关)接口 49
7.1 接口协议 49
7.2 文件命名规则 50
7.3 消息结构 50
7.4 文件格式 51
8 至指定系统(经上报网关)接口 51
8.1 日志上报接口 52
8.1.1 接口协议 52
8.1.1.1 概述 52
8.1.1.2 上报日志文件命名规则 52
8.1.1.3 数据校验文件格式 53
8.1.1.4 校验规则 53
8.1.1.5 FTP文件管理 54
8.1.2 用户上网日志格式 54
8.1.2.1 用户上下线日志 54
8.1.2.2 用户访问信息日志 55
8.2 日志重报接口 56
8.2.1 接口协议 56
8.2.2 接口流程 56
8.2.3 消息结构 57
8.3 用户在线状态查询及上传接口 58
8.3.1 接口协议 58
8.3.2 接口流程 58
8.3.3 消息结构 59
8.3.3.1 用户在线状态查询请求消息(URMRequest) 59
8.3.3.2 用户在线状态查询响应(URMResponse) 60
8.3.3.3 查询请求接收效果信息上报消息 60
8.3.3.4 用户上线信息上报消息(URMUpload) 61
8.3.3.5 用户上线信息上报响应消息(URMUploadResponse) 62
8.4 告警事件上报接口 62
8.4.1 接口协议 62
8.4.2 接口流程 62
8.4.3 消息结构 63
9 至上网日志查询系统接口 64
9.1 接口流程 65
9.2 接口协议 65
9.2.1 IF_ QUERY(用户信息查询接口) 65
9.2.2 IF_UPLOAD(用户信息上报接口) 66
9.2.3 IF_NOTIFY(用户信息上报完毕通知接口) 66
9.3 消息结构 67
9.3.1 用户信息查询请求消息(UDRQueryRequest) 67
9.3.2 用户信息查询响应消息(UDRQueryResponse) 68
9.3.3 用户信息上报完毕通知消息(UDRNotifyRequest) 68
9.3.4 用户信息上报完毕响应消息(UDRNotifyResponse) 70
9.4 文件格式 70
9.4.1 文件命名规则 70
9.4.2 文件格式规则 71
9.4.3 文件生成规则 71
10 至手机恶意软件监测系统样本监测采集模块(DA)上报及重报接口 71
11 与防火墙日志采集前置机接口(南向接口) 71
12 编制历史 72
附录A 合成信令流程的起止时间说明 72
附录B WebService结果取值定义 73
附录C KPI指标定义 74
附录D 省份代码表 74
附录E 网关设备代码表 75
前 言
本规范对中国移动网内使用的深度包检测(DPI)设备的功能和性能提出要求,是部署统一DPI设备需要遵从的技术文件。
本规范定义了LTE数据合成服务器的接口要求,主要包括以下几方面内容:系统结构、数据上报接口、KPI数据订阅接口、至指定系统的上报接口等要求。
本规范是中国移动统一DPI设备技术系列规范之一,该系列规范的结构、名称或预计的名称如下:
序号
标准编号
标准名称
发布单位
[1]
中国移动统一DPI设备技术规范-LTE数据合成服务器设备规范
中国移动通信集团公司
[2]
中国移动统一DPI设备技术规范-LTE数据合成服务器接口规范
中国移动通信集团公司
[3]
中国移动统一DPI设备技术规范-LTE信令采集解析服务器接口规范
中国移动通信集团公司
[4]
中国移动统一DPI设备技术规范-LTE信令采集解析服务器设备规范(软采分册)
中国移动通信集团公司
[5]
中国移动统一DPI设备技术规范-LTE信令采集解析服务器设备规范(硬采分册)
中国移动通信集团公司
[6]
中国移动统一DPI设备技术规范
中国移动通信集团公司
[7]
[8]
[9]
[10]
本规范由中移技 号印发。
本规范由中国移动通信集团计划部提出。
本规范起草单位:中国移动通信研究院。
本规范主要起草人:张欢、梁燕萍、余立、祖国英、郗卓宁、邢喆
本规范解释权:中国移动通信研究院。
1 范围
本规范适用于中国移动的深度报文检测(DPI)设备,供中国移动内部和厂家共同使用。
本规范是中国移动进行DPI设备采购的技术依据。
本规范定义了LTE数据合成服务器接口规范及要求,主要包括以下几方面内容:系统结构、数据上报接口、至指定服务器的上报接口等要求。
2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。
序号
标准编号
标准名称
发布单位
[1]
《中国移动统一DPI设备技术规范》
中国移动通信集团公司
[2]
TS 29.272
3GPP Evolved Packet System(EPS); Mobility Management Entity(MME) and Serving GPRS Support Node(SGSN) related interface based on Diameter Protocol
3GPP
[3]
TS 36.331
Evolved Universal Terrestrial Radio Access(E-UTRA); Radio Resource Control(RRC) Protocol Specification
3GPP
[4]
TS 36.413
Evolved Universal Terrestrial Radio Access(E-UTRA); S1 Application Protocol(S1AP)
3GPP
[5]
TS 36.423
Evolved Universal Terrestrial Radio Access(E-UTRA); X2 Application Protocol(X2AP)
3GPP
[6]
TS 29.274
3GPP Evolved Packet System(EPS); Evolved General Packet Radio Service(GPRS) Tunnelling Protocol for Control Plane(GTPv2-C)
3GPP
3 术语、定义和缩略语
“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。
- “必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求;对应于RFC2119 MUST,REQUIRED,SHALL。
- “推荐”/“建议”/“应”项是指在标准中未作强制要求,若业务、产品和设备提供的功能或性能要求被认为更佳;对应于RFC2119 RECOMMENDED,SHOULD。
- “可选”/“可”项指参考性要求,是业务、产品和设备在目前阶段可不提供的功能或性能要求;对应于RFC2119 MAY,OPTIONAL。
- 必不能,不能,不得:表示绝对的禁止;对应于RFC2119 MUST NOT,SHALL NOT。
- 不推荐,不建议:表示若业务、产品和设备按照所述内容制作,被认为略次;对应于RFC2119 SHOULD NOT,NOT RECOMMENDED。
- 规范中除了明确指明为 “推荐”/“建议”、“可选”外,均为必须要求。
词语
解释
ECI
E-UTRAN Cell Identifier,E-UTRAN小区标识
eNB
Evolved Node B,演进型节点B
EPS
Evolved Packet System,演进型分组系统
E-UTRAN
Evolved Universal Terrestrial Radio Access Network,演进型通用陆地无线接入网
GTP
GPRS Tunneling Protocol,GPRS隧道协议
IE
Information Element,信令消息中的信息单元
IMEI
International Mobile Equipment Identity,国际移动设备标识
IMSI
International Mobile Subscriber Identity,国际移动用户标识
IP
Internet Protocol,IP协议
LTE
Long Term Evolution,长期演进
MME
Mobility Management Entity,移动性管理实体
MSC
Mobile Switching Center,移动交换中心
MSISDN
Mobile Station Integrated Services Digital Number,移动用户ISDN号码
NAS
Non-Access Stratum,非接入层
PCI
Physical Cell Identifier,物理小区标识
SDTP
Shared Data Transfer Protocol,共享数据传输协议
S1-MME
S1 for the control plane,控制平面S1接口
S1-U
S1 for the user plane,用户平面S1接口
SGW
Serving Gateway,服务网关
TAC
Tracking Area Code,跟踪区域码
TEID
Tunnel Endpoint Identifier,隧道端点标识
全量数据
全量数据包含了被采集链路的全部内容,包括控制面的全量信令数据及用户面的全量业务数据
XDR数据
XDR数据是指基于全量数据进行处理后,生成的供应用系统使用的信令及业务的详细记录。
信令XDR
基于所采集的控制面信令而生成的信令过程的详细记录
业务XDR
基于所采集的用户面业务数据而生成的业务传输过程的详细记录
指标数据
指标数据是根据数据合成服务器生成的XDR或者信令消息统计生成的各类KPI指标数据,例如:接通率、位置更新成功率等
4 接口在网络中的位置
4.1 系统架构
中国移动统一DPI系统架构图如下图所示。
图1.统一DPI系统架构图
1. 数据采集层
数据采集层包含采集解析服务器,主要功能是实现LTE系统Uu、X2、S1、S11、S10、SGs、S6a、S5/S8等接口及防火墙数据的接入和采集,对采集数据进行解析,生成各接口的原始XDR。
数据采集层需要将原始XDR及原始码流数据上报给数据解码层。
2. 数据解码层
数据解码层包含数据合成服务器,主要功能是对数据采集层上报的原始XDR进行分析、关联、回填及合成,并输出所需的目标XDR及日志文件及原始码流数据到应用层。
数据解码层需要对原始码流数据进行存储,存储时长至少2天。
数据解码层需要对用户
3. 应用层
应用层包含各应用系统及指定系统。
4.2 接口功能
数据采集层与数据解码层之间的接口为IF1接口,采用SDTP协议,用于传输各接口原始XDR及XDR对应的原始数据。IF1接口定义请参考《中国移动统一DPI设备技术规范-LTE信令采集解析服务器接口规范》。
数据解码层与应用层之间的接口为IF2接口,实现的功能包括:
l 数据解码层向应用层上传处理后的单接口XDR、新生成的合成XDR及单接口XDR对应的原始码流数据。
l 应用层向数据解码层反查单接口XDR对应的原始码流数据。
l 数据解码层向日志上报网关及上网日志查询系统上传用户上网日志文件。
本规范定义IF2接口。
5 数据上报接口
5.1 概述
数据合成服务器使用数据上报接口中的数据通知消息向应用层上报以下类型数据:
- 数据合成服务器生成的用于关联多个单接口XDR的合成XDR;
- 数据合成服务器回填后的完整单接口XDR;
- 原始码流数据,这包括原始信令数据及原始业务包头数据;
- KPI数据。
此外,应用层可使用数据上报接口中的数据查询消息向数据合成服务器反查单接口XDR对应的原始码流数据。
数据上报接口使用SDTP协议进行传输,所传输的XDR数据及原始码流数据采用二进制编码方式(具体格式和要求参考第5.3.1/5.3.2/5.3.3/5.3.4/5.3.5节),KPI数据采用标准csv编码方式(具体格式和要求参考第5.3.6节)。
5.1.1 合成XDR数据
数据合成服务器需要根据采集解析服务器上报的单接口XDR来生成合成XDR,这包括合成信令XDR,合成业务XDR及合成UE_MR XDR。
对于一个端到端信令流程,采集解析服务器会采集并上报多个接口上的信令XDR,数据合成服务器会根据这些XDR来生成合成信令XDR,用于反映整个端到端信令流程的关键信息,并在其中指示每个接口信令XDR的XDR ID,从而可以通过合成信令XDR来检索各个接口的信令XDR。
对于一个业务传输过程,由于该过程可能会持续较长时间,因此采集解析服务器会上报多个S1-U接口的业务XDR,数据合成服务器会根据这些XDR来生成合成业务XDR,用于反映整个业务传输过程,并在其中指示对应的多个S1-U接口XDR的XDR ID,从而可以通过合成业务XDR来检索S1-U接口XDR。
对于采集解析服务器上报的UE_MR XDR,数据合成服务器要对其进行用户身份标识回填操作,并根据定位算法计算该MR对应的位置信息并进行回填,之后生成合成UE_MR XDR。
对于采集解析服务器上报的Cell_MR XDR,数据合成服务器并不进行任何处理,只是将其转发给应用层。
需要说明的是,数据合成服务器只对UE相关XDR进行合成,对于非UE相关XDR并不进行合成处理。
5.1.2 单接口XDR数据
数据合成服务器需要对采集解析服务器上报的单接口XDR进行回填操作,从而补全单接口XDR中的空缺字段,形成完整的单接口XDR并上报给应用层。
5.1.3 原始码流数据
数据合成服务器需要对采集解析服务器上报的原始码流数据进行存储,同时支持将原始码流转发给应用层。
5.1.4 KPI数据
数据合成服务器能够根据单接口XDR及合成XDR进行KPI统计,并将统计得到的KPI数据上报给应用层。数据合成服务器需要统计的KPI指标及相关要求请参考附录C文档。
5.2 接口协议
数据上报接口使用SDTP协议进行数据传输。SDTP协议为实时数据共享传输协议,具有数据传输量大、实时性要求高、过程简单、不需要握手鉴权过程等特点。
SDTP以TCP/IP作为底层通信承载,具体协议结构如下图所示:
图2.数据上报接口协议栈
协议栈分为3层,分别为承载层、传输层和应用层,如图2所示。其中,承载层为IP协议,它提供可靠的数据传输通道;传输层(SDTP+TCP)为上层应用提供通用的数据传输协议;应用层封装XDR数据及原始数据。数据合成服务器通过SDTP协议将XDR数据及原始数据传送给应用层。
数据提供方与数据接受方之间进行信息交互时,采用长连接方式:
l 通信双方以Client-Server方式建立TCP连接,用于双方信息的交互。在数据合成服务器与应用层的连接中,请求的发起方作为连接的客户端。
l 当连接断开后,客户端以反复重试的方式连接服务端。
l 在一个连接上可以连续发送多个数据包,在连接保持期间,如果没有数据包发送,由客户端发送链路检测,服务器端发送应答消息以维持此连接。当信道上没有数据传输时,客户端应每隔时间C发送链路检测包以维持此连接,当链路检测包发出超过时间T后未收到响应,应立即再发送链路检测包,再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N可灵活配置,现阶段建议取值为:C=3分钟,T=60秒,N=3。
l 数据提供点与数据订阅点之间的消息发送后等待T秒后未收到响应,应立即重发,再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为:T=60秒,N=3。
l 消息采用并发方式发送,加以滑动窗口流量控制,窗口大小参数W可配置,现阶段建议为16,即接收方在应答前一次收到的消息最多不超过16条。
l 考虑到数据的安全性,建议在应用层和数据合成服务器间采用链路安全机制(如TLS、VPN等方式),可根据实际需求选择开启。
5.2.1 消息类型
SDTP协议的消息类型定义如下表所示:
消息名
MessageType值
说明
verNego_Req
0x0001
版本协商请求
verNego_Resp
0x8001
版本协商应答
linkAuth_Req
0x0002
鉴权请求
linkAuth_Resp
0x8002
鉴权响应
linkCheck_Req
0x0003
链路检测请求
linkCheck_Resp
0x8003
链路检测应答
linkRel_Req
0x0004
连接释放请求
linkRel_Resp
0x8004
连接释放应答
linkDataCheck_Req
0x0007
链路数据发送校验请求
linkCheck_Resp
0x8007
链路数据发送校验应答
notifyXDRData_Req
0x0005
XDR数据通知请求
notifyXDRData_Resp
0x8005
XDR数据通知应答
XDRRawDataSend_Req
0x0006
XDR对应原始数据传输请求
XDRRawDataSend_Resp
0x8006
XDR对应原始数据传输应答
XDRRawDataQuery_Req
0x0008
XDR数据反查请求
XDRRawDataQuery_Resp
0x8008
XDR数据反查应答
notifyKpiData_Req
0x0009
KPI数据通知请求
notifyKpiData_Resp
0x8009
KPI数据通知应答
5.2.2 消息结构
SDTP消息结构如下所示:
项目
说明
Message Header
消息头(所有消息公共包头)
Message Body
消息体,即各种消息定义的参数,详见后续介绍
消息头(Message Header)包含如下必选字段:
字段名
字节数
类型
描述
TotalLength
2
Unsigned Integer
消息总长度(含消息头及消息体)
MessageType
2
Unsigned Integer
消息类型
SequenceId
4
Unsigned Integer
交互的流水号,顺序累加,步长为1,循环使用(一个交互的一对请求和应答消息的流水号必须相同)
TotalContents
1
Unsigned Integer
消息体中的事件数量(最多40条)
若考虑实时性要求,可每次只填一个事件
5.2.3 连接管理流程
使用SDTP协议通信时,遵照本章的消息交互流程。消息交互的基本流程分为:版本协商,鉴权请求,数据传输,链路检测,连接终止。客户端侧应支持对链路检测周期的灵活设定。
SDTP协议连接管理流程如下图所示:
图3.SDTP协议连接管理流程
SDTP连接建立和通信流程说明如下:
(1) 请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接;
(2) 客户端发起版本协商流程,若协商失败,则转(7)拆除连接;
(3) 客户端向服务端发起链路鉴权请求(使用数据合成服务器与各应用系统间协商好的共享密钥),若服务端鉴权失败,则转(7)拆除连接;
(4) 请求的发起方发送数据,接收方收到数据并处理后回复处理结果;
(5) 在连接保持期间,如果没有数据包发送,客户端发送链路检测/应答包以维持此连接;若发现链路断开,则转(7)拆除连接;
(6) 通信完成后,客户端主动发起链路释放请求;
(7) 双方均可拆除该连接;
5.2.4 连接管理消息
5.2.4.1 版本协商verNego
5.2.4.1.1 请求
版本协商请求,用于在连接的鉴权通过后,客户端与服务器端协商通信协议版本的信息,由连接的建立方主动发起协议版本协商。参数定义如下:
字段名
字节数
类型
描述
Version
1
Unsigned Integer
协议的主版本号
SubVersion
1
Unsigned Integer
协议的子版本号
版本协商的发起方从自身支持的最高版本开始协商,高版本协商失败后再协商低版本。
5.2.4.1.2 应答
版本协商应答,用于返回版本信息的核对结果,参数定义如下:
字段名
字节数
类型
描述
Result
1
Unsigned Integer
返回原因值。
协议协商的结果,各个值代表意义如下:
1: 版本协商通过。
2: 版本过高。
3: 版本过低。
5.2.4.2 链路认证linkAuth
5.2.4.2.1 请求
连接鉴权请求,参数定义如下:
字段名
字节数
类型
描述
LoginID
12
String
账户ID。
由连接的服务端给连接的客户端分配的连接帐号。
Digest
64
String
用于鉴别源用户。其值通过SHA256计算得出。当对端用相同方式加密之后与接收的值比较,如果计算出来的值相同,则通过校验,否则出错。
Digest=
SHA256(LoginID+SHA256(Shared secret)+Timestamp+"rand=”+RAND)
其中Shared secret为与LoginID对应的账户密码,由认证双方实体事先商定;
LoginID为本消息带的LoginID字段,12字节,不足12字节以空格“ ”补齐;
Timestamp为本消息带的Timestamp字段数值,单位为秒(1970年1月1日0时0分0秒起至当前的偏移总秒数);
计算后结果为32位,后32位补零(二进制0);
Timestamp
4
Unsigned Integer
时间戳的明文。
由客户端产生,单位为秒(1970年1月1日0时0分0秒起至当前的偏移总秒数)
RAND
2
Unsigned Integer
由客户端产生的随机数
5.2.4.2.2 应答
连接鉴权应答,参数定义如下:
字段名
字节数
类型
描述
Result
1
Unsigned Integer
鉴权的返回结果。各个值的含义如下定义:
1 代表鉴权通过。
2 代表LoginID不存在。
3 代表SHA256加密结果出错。
Digest
64
String
用于对端对本端进行鉴权,其值通过SHA256计算得出。当对端使用相同方式加密之后与接收的值比较,如果计算出来的值相同,则通过校验,否则出错。
5.2.4.3 链路检测linkCheck
5.2.4.3.1 请求
当信道上没有数据传输时,客户端应每隔时间C发送链路检测包以维持此连接,当链路检测包发出超过时间T后未收到响应,应立即再发送链路检测包。服务端收到链路检测请求包后,立即回复链路检测应答。
无参数。
5.2.4.3.2 应答
链路检测请求的应答,无参数。
5.2.4.4 链路数据发送校验linkDataCheck
5.2.4.4.1 请求
本消息与notifyXDRData_Req和XDRRawDataSend_Req消息同方向。消息的作用是,告知数据接收方,在两个本消息间隔期内发送的notifyXDRData_Req和XDRRawDataSend_Req消息包数量,以便接收方校验是否有丢包情况发生。若有丢包发生时,notifyXDRData_Req和XDRRawDataSend_Req消息的接收方应立即通过返回消息告知发送方有数据丢失。本消息建议5分钟进行数据校验,数据量大时为避免过多的传输缓存,可减少时间间隔,数据接收方应不受校验周期影响。
字段名
字节数
类型
描述
Sendflag
4
Int
检测包顺序标签,1小时内不重复即可。本参数目的是为发现校验包的丢失情况发生。
SendDataInfo
4
int
距离上次发送间发送的数据包数量。(仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量)
5.2.4.4.2 应答
本消息与notifyXDRData_Req和XDRRawDataSend_Req消息方向相反。消息的作用是,告知数据发送方,在两个本消息间隔期内接收了多少个notifyXDRData_Req和XDRRawDataSend_Req消息包,以便告知发送方是否有丢包情况发生。
字段名
字节数
类型
描述
Sendflag
4
Int
检测包顺序标签,1小时内不重复即可。(与请求包相同)
result
1
int
0:数据量正确;1:接收方数据小于发送方数据;2:接收方;数据大于发送方数据。
SendDataInfo
4
int
距离上次发送间发送的数据包数量。(仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量)(与请求包相同)
RecDataInfo
4
int
距离上次发送间接收的数据包数量。(仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量)
5.2.4.5 链路释放linkRel
5.2.4.5.1 请求
连接释放请求,指示连接的某一方由于某些原因而需要断开连接,参数定义如下:
字段名
字节数
类型
描述
Reason
1
Unsigned Integer
连接释放的原因,各个值代表意义如下:
1: 用户正常释放。
2: 数据类型错误。
3: 超出机器处理能力。
5.2.4.5.2 应答
连接释放完成应答,收到本消息之后或者请求超时后,释放本连接的所有资源,参数定义如下:
字段名
字节数
类型
描述
Result
1
Unsigned Integer
连接释放的完成状态
1:释放完成。
其它:释放失败。
5.2.5 数据通知消息
5.2.5.1 XDR对应原始数据传输XDRRawDataSend
该消息用于数据合成服务器将原始码流上报给应用系统,这包括原始信令数据及原始业务包头数据。
5.2.5.1.1 请求
属性
字节数
类型
描述
Load
原始码流数据, 数据格式参考5.3.5
5.2.5.1.2 应答
属性
字节数
类型
描述
Result
1
Unsigned Integer
请求的返回结果:
1 代表成功
其它 代表失败
5.2.5.2 XDR数据通知notifyXDRData
该消息用于数据合成服务器将处理后的单接口XDR及合成XDR上报给应用系统。
5.2.5.2.1 请求
属性
字节数
类型
描述
XDRType
1
Unsigned Integer
XDR数据类型:
1:合成XDR数据
2:单接口XDR数据
Load
具体传输的XDR数据,各种类型XDR的格式参考5.3
5.2.5.2.2 应答
属性
字节数
类型
描述
Result
1
Unsigned Integer
请求的返回结果:
1 代表成功
其它 代表失败
5.2.5.3 KPI数据通知notifyKpiData
应用系统能够通过KPI订阅接口向数据合成服务器订阅KPI数据,KPI订阅接口的详细描述请参考本规范第6章。KPI订阅成功之后,数据合成服务器通过KPI数据通知消息向特定应用系统实时上报所订阅的KPI数据。
5.2.5.3.1 请求
属性
字节数
类型
描述
KpiOrderID
8
Long Integer
应用系统订阅KPI数据后由数据合成服务器生成的全局唯一的订阅标识码
Load
KPI指标的具体数据格式,具体请参见5.3.6节相关定义
5.2.5.3.2 应答
属性
字节数
类型
描述
Result
1
Unsigned Integer
请求的返回结果:
1 代表成功
其它 代表失败
5.2.6 数据查询消息
5.2.6.1 XDR对应原始数据反查XDRRawDataQuery
应用系统能够使用该消息反查数据合成服务器中的原始码流数据,该反查基于单接口XDR来完成。应用系统在请求消息中指示单接口XDR相关信息,数据合成服务器收到请求消息后,将该XDR对应的原始数据上报给应用系统。
5.2.6.1.1 请求
字段名
字节数
类型
描述
Interface
1
展开阅读全文