中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
中国移动统一DPI设备技术规范-LTE数据合成服务器接口规
范
Technical Specification of Deep Packet Inspection Equipment for CMCC
(LTE Data Combining Server Interface Part)
版本号：2.0.9
╳╳╳ ╳-╳╳-╳╳发布 ╳╳╳╳-╳╳-╳╳实施
中国移动通信集团公司 发布
QB-╳╳-╳╳╳-╳╳╳╳
目 录
前言 ................................................................................................................................................ 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
I
QB-╳╳-╳╳╳-╳╳╳╳
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 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
II
QB-╳╳-╳╳╳-╳╳╳╳
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 至经分系统（经上报网关）接口 ......................................................................................... 49 7.1 接口协议 ................................................................................................................. 49 7.2 文件命名规则 ......................................................................................................... 50 7.3 消息结构 ................................................................................................................. 50 7.4 文件格式 ................................................................................................................. 51 至指定系统（经上报网关）接口 ......................................................................................... 51 8.1 日志上报接口 ......................................................................................................... 52
8.1.1 接口协议 ......................................................................................................... 52
7
8
III
QB-╳╳-╳╳╳-╳╳╳╳
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 至上网日志查询系统接口 .....................................................................................................
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) ................................... 69 9.4 文件格式 ................................................................................................................. 70
9.4.1 文件命名规则 ................................................................................................. 70 9.4.2 文件格式规则 ................................................................................................. 70 9.4.3 文件生成规则 ................................................................................................. 71
10 至手机恶意软件监测系统样本监测采集模块（DA）上报及重报接口 ................... 71 11 与防火墙日志采集前置机接口（南向接口） ............................................................. 71 12 编制历史 ......................................................................................................................... 72 附录A 合成信令流程的起止时间说明 ....................................................................................... 72
IV
QB-╳╳-╳╳╳-╳╳╳╳
附录B WebService结果取值定义 ................................................................................................ 72 附录C KPI指标定义..................................................................................................................... 73 附录D 省份代码表 ....................................................................................................................... 74 附录E 网关设备代码表 ............................................................................................................... 74
V
QB-╳╳-╳╳╳-╳╳╳╳
前言
本规范对中国移动网内使用的深度包检测（DPI）设备的功能和性能提出要求，是部署统一DPI设备需要遵从的技术文件。
本规范定义了LTE数据合成服务器的接口要求，主要包括以下几方面内容：系统结构、数据上报接口、KPI数据订阅接口、至指定系统的上报接口等要求。
本规范是中国移动统一DPI设备技术系列规范之一，该系列规范的结构、名称或预计的名称如下： 序号 [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]
本规范由中移技号印发。
本规范由中国移动通信集团计划部提出。 本规范起草单位：中国移动通信研究院。
本规范主要起草人：张欢、梁燕萍、余立、祖国英、郗卓宁、邢喆 本规范解释权：中国移动通信研究院。
标准编号 标准名称 中国移动统一DPI设备技术规范-LTE数据合成服务器设备规范 中国移动统一DPI设备技术规范-LTE数据合成服务器接口规范 中国移动统一DPI设备技术规范-LTE信令采集解析服务器接口规范 中国移动统一DPI设备技术规范-LTE信令采集解析服务器设备规范（软采分册） 中国移动统一DPI设备技术规范-LTE信令采集解析服务器设备规范（硬采分册） 中国移动统一DPI设备技术规范 发布单位 中国移动通信集团公司 中国移动通信集团公司 中国移动通信集团公司 中国移动通信集团公司 中国移动通信集团公司 中国移动通信集团公司
VI
1 范围
本规范适用于中国移动的深度报文检测（DPI）设备，供中国移动内部和厂家共同使用。 本规范是中国移动进行DPI设备采购的技术依据。
本规范定义了LTE数据合成服务器接口规范及要求，主要包括以下几方面内容：系统结构、数据上报接口、至指定服务器的上报接口等要求。
2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。 序号 [1] 标准编号 标准名称 《中国移动统一DPI设备技术规范》 发布单位 中国移动通信集团公司 [2] TS 29.272 3GPP Evolved Packet System(EPS); Mobility Management Entity(MME) and Serving GPRS 3GPP Support Node(SGSN) related interface based on Diameter Protocol Evolved Universal Terrestrial Radio Access(E-UTRA); Radio Resource Control(RRC) 3GPP Protocol Specification Evolved Universal Terrestrial Radio 3GPP Access(E-UTRA); S1 Application Protocol(S1AP) Evolved Universal Access(E-UTRA); Protocol(X2AP) Terrestrial Radio X2 Application 3GPP [3] TS 36.331 [4] TS 36.413 [5] TS 36.423 [6] TS 29.274 3GPP Evolved Packet System(EPS); Evolved General Packet Radio Service(GPRS) Tunnelling 3GPP Protocol for Control Plane(GTPv2-C) 3 术语、定义和缩略语
“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。
第7页
- - - - - - 词语 ECI eNB EPS E-UTRAN GTP IE IMEI IMSI IP LTE MME MSC MSISDN NAS PCI SDTP S1-MME S1-U SGW TAC TEID 全量数据 XDR数据 信令XDR 业务XDR 指标数据 解释 E-UTRAN Cell Identifier，E-UTRAN小区标识 Evolved Node B，演进型节点B Evolved Packet System，演进型分组系统 Evolved Universal Terrestrial Radio Access Network，演进型通用陆地无线接入网 GPRS Tunneling Protocol，GPRS隧道协议 Information Element，信令消息中的信息单元 International Mobile Equipment Identity，国际移动设备标识 International Mobile Subscriber Identity，国际移动用户标识 Internet Protocol，IP协议 Long Term Evolution，长期演进 Mobility Management Entity，移动性管理实体 Mobile Switching Center，移动交换中心 Mobile Station Integrated Services Digital Number，移动用户ISDN号码 Non-Access Stratum，非接入层 Physical Cell Identifier，物理小区标识 Shared Data Transfer Protocol，共享数据传输协议 S1 for the control plane，控制平面S1接口 S1 for the user plane，用户平面S1接口 Serving Gateway，服务网关 Tracking Area Code，跟踪区域码 Tunnel Endpoint Identifier，隧道端点标识 全量数据包含了被采集链路的全部内容，包括控制面的全量信令数据及用户面的全量业务数据 XDR数据是指基于全量数据进行处理后，生成的供应用系统使用的信令及业务的详细记录。 基于所采集的控制面信令而生成的信令过程的详细记录 基于所采集的用户面业务数据而生成的业务传输过程的详细记录 指标数据是根据数据合成服务器生成的XDR或者信令消息统计生成的各类KPI指标数据，例如：接通率、位置更新成功率等 “必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求；对应于RFC2119 MUST，REQUIRED，SHALL。
“推荐”/“建议”/“应”项是指在标准中未作强制要求，若业务、产品和设备提供的功能或性能要求被认为更佳；对应于RFC2119 RECOMMENDED，SHOULD。
“可选”/“可”项指参考性要求，是业务、产品和设备在目前阶段可不提供的功能或性能要求；对应于RFC2119 MAY，OPTIONAL。
必不能，不能，不得：表示绝对的禁止；对应于RFC2119 MUST NOT，SHALL NOT。 不推荐，不建议：表示若业务、产品和设备按照所述内容制作，被认为略次；对应于RFC2119 SHOULD NOT，NOT RECOMMENDED。
规范中除了明确指明为 “推荐”/“建议”、“可选”外，均为必须要求。
第8页
4 接口在网络中的位置
4.1 系统架构
中国移动统一DPI系统架构图如下图所示。
指定系统人员其他应用系统性能管理系统优化管理系统…...集中化经分系统指定系统应用层日志查询平台日志上报网关IF2接口数据合成服务器数据解码层IF1接口防火墙日志采集前置机软采采集解析服务器Uu/X2软采数据硬采采集解析服务器S1-MME/S6a/SGs原始码流MME统一DPI设备S1-U/S11等原始码流数据采集层出口防火墙SCA设备SGW图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接口，实现的功能包括：
数据解码层向应用层上传处理后的单接口XDR、新生成的合成XDR及单接口XDR
对应的原始码流数据。
第9页
应用层向数据解码层反查单接口XDR对应的原始码流数据。
数据解码层向日志上报网关及上网日志查询系统上传用户上网日志文件。
本规范定义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并上报给应用层。
第10页
5.1.3
原始码流数据
数据合成服务器需要对采集解析服务器上报的原始码流数据进行存储，同时支持将原始码流转发给应用层。 5.1.4
KPI数据
数据合成服务器能够根据单接口XDR及合成XDR进行KPI统计，并将统计得到的KPI数据上报给应用层。数据合成服务器需要统计的KPI指标及相关要求请参考附录C文档。 5.2 接口协议
数据上报接口使用SDTP协议进行数据传输。SDTP协议为实时数据共享传输协议，具有数据传输量大、实时性要求高、过程简单、不需要握手鉴权过程等特点。
SDTP以TCP/IP作为底层通信承载，具体协议结构如下图所示：
APPSDTP应用层传输层TCPIP承载层
图2.数据上报接口协议栈
协议栈分为3层，分别为承载层、传输层和应用层，如图2所示。其中，承载层为IP协议，它提供可靠的数据传输通道；传输层（SDTP+TCP）为上层应用提供通用的数据传输协议；应用层封装XDR数据及原始数据。数据合成服务器通过SDTP协议将XDR数据及原始数据传送给应用层。
数据提供方与数据接受方之间进行信息交互时，采用长连接方式：
通信双方以Client-Server方式建立TCP连接，用于双方信息的交互。在数据合成服
务器与应用层的连接中，请求的发起方作为连接的客户端。 当连接断开后，客户端以反复重试的方式连接服务端。
在一个连接上可以连续发送多个数据包，在连接保持期间，如果没有数据包发送，
由客户端发送链路检测，服务器端发送应答消息以维持此连接。当信道上没有数据传输时，客户端应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N可灵活配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。
数据提供点与数据订阅点之间的消息发送后等待T秒后未收到响应，应立即重发，
再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段
建议为16，即接收方在应答前一次收到的消息最多不超过16条。
第11页
考虑到数据的安全性，建议在应用层和数据合成服务器间采用链路安全机制（如
TLS、VPN等方式），可根据实际需求选择开启。 5.2.1
消息类型
SDTP协议的消息类型定义如下表所示： 消息名 verNego_Req verNego_Resp linkAuth_Req linkAuth_Resp linkCheck_Req linkCheck_Resp linkRel_Req linkRel_Resp linkDataCheck_Req linkCheck_Resp notifyXDRData_Req notifyXDRData_Resp XDRRawDataSend_Req XDRRawDataSend_Resp XDRRawDataQuery_Req XDRRawDataQuery_Resp notifyKpiData_Req notifyKpiData_Resp 5.2.2
消息结构
MessageType值 0x0001 0x8001 0x0002 0x8002 0x0003 0x8003 0x0004 0x8004 0x0007 0x8007 0x0005 0x8005 0x0006 0x8006 0x0008 0x8008 0x0009 0x8009
说明 版本协商请求 版本协商应答 鉴权请求 鉴权响应 链路检测请求 链路检测应答 连接释放请求 连接释放应答 链路数据发送校验请求 链路数据发送校验应答 XDR数据通知请求 XDR数据通知应答 XDR对应原始数据传输请求 XDR对应原始数据传输应答 XDR数据反查请求 XDR数据反查应答 KPI数据通知请求 KPI数据通知应答 SDTP消息结构如下所示： 项目 Message Header Message Body 说明 消息头(所有消息公共包头) 消息体，即各种消息定义的参数，详见后续介绍 消息头（Message Header）包含如下必选字段： 字段名 TotalLength MessageType SequenceId 字节数 2 2 4 类型 Unsigned Integer Unsigned Integer Unsigned Integer 描述 消息总长度(含消息头及消息体) 消息类型 交互的流水号，顺序累加，步长为1，循环使用（一个交互的一对请求和应答消息的流水号必须相同） 消息体中的事件数量（最多40条） 若考虑实时性要求，可每次只填一个事件 TotalContents 1 Unsigned Integer
第12页
5.2.3
连接管理流程
使用SDTP协议通信时，遵照本章的消息交互流程。消息交互的基本流程分为：版本协商，鉴权请求，数据传输，链路检测，连接终止。客户端侧应支持对链路检测周期的灵活设定。
SDTP协议连接管理流程如下图所示：
客户端服务端1. TCP连接建立2. 版本协商请求verNego_Req2. 版本协商应答verNego_Resp3. 链路鉴权请求linkAuth_Req3. 链路鉴权应答linkAuth_Resp4. 数据发送请求4. 数据发送应答5. 链路检测请求linkCheck_Req5. 链路检测应答linkCheck_Resp6.链路数据发送校验linkDataCheck_Req6.链路数据发送校验应答linkDataCheck_Resp7.链路释放请求linkRel_Req7.链路释放应答linkRel_Resp8. TCP连接拆除
图3.SDTP协议连接管理流程
SDTP连接建立和通信流程说明如下：
（1） 请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接； （2） 客户端发起版本协商流程，若协商失败，则转（7）拆除连接；
第13页
（3） 客户端向服务端发起链路鉴权请求（使用数据合成服务器与各应用系统间协商
好的共享密钥），若服务端鉴权失败，则转（7）拆除连接；
（4） 请求的发起方发送数据，接收方收到数据并处理后回复处理结果；
（5） 在连接保持期间，如果没有数据包发送，客户端发送链路检测/应答包以维持此
连接；若发现链路断开，则转（7）拆除连接；
（6） 通信完成后，客户端主动发起链路释放请求； （7） 双方均可拆除该连接； 5.2.4
连接管理消息
5.2.4.1 版本协商verNego
5.2.4.1.1 请求
版本协商请求，用于在连接的鉴权通过后，客户端与服务器端协商通信协议版本的信息，由连接的建立方主动发起协议版本协商。参数定义如下： 字段名 Version SubVersion 字节数 1 1 类型 Unsigned Integer 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。 由连接的服务端给连接的客户端分配的连接帐号。 用于鉴别源用户。其值通过SHA256计算得第14页
Digest
String
出。当对端用相同方式加密之后与接收的值比较，如果计算出来的值相同，则通过校验，否则出错。 Digest= SHA256(LoginID+SHA256(Sharedsecret)+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 Unsigned Integer 时间戳的明文。 由客户端产生,单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数） 由客户端产生的随机数 RAND 2 5.2.4.2.2 应答
连接鉴权应答，参数定义如下： 字段名 Result 字节数 1 类型 Unsigned Integer 描述 鉴权的返回结果。各个值的含义如下定义： 1 代表鉴权通过。 2 代表LoginID不存在。 3 代表SHA256加密结果出错。 用于对端对本端进行鉴权，其值通过SHA256计算得出。当对端使用相同方式加密之后与接收的值比较，如果计算出来的值相同，则通过校验，否则出错。 Digest String 5.2.4.3 链路检测linkCheck
5.2.4.3.1 请求
当信道上没有数据传输时，客户端应每隔时间C发送链路检测包以维持此连接，当链路
检测包发出超过时间T后未收到响应，应立即再发送链路检测包。服务端收到链路检测请求包后，立即回复链路检测应答。
无参数。
第15页
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小时内不重复即可。本参数目的是为发现校验包的丢失情况发生。 距离上次发送间发送的数据包数量。（仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量） SendDataInfo 4 int 5.2.4.4.2
应答
本消息与notifyXDRData_Req和XDRRawDataSend_Req消息方向相反。消息的作用是，告知数据发送方，在两个本消息间隔期内接收了多少个notifyXDRData_Req和XDRRawDataSend_Req消息包，以便告知发送方是否有丢包情况发生。 字段名 Sendflag result 字节数 4 1 类型 Int int 描述 检测包顺序标签，1小时内不重复即可。（与请求包相同） 0：数据量正确；1：接收方数据小于发送方数据；2：接收方；数据大于发送方数据。 距离上次发送间发送的数据包数量。（仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量）（与请求包相同） 距离上次发送间接收的数据包数量。（仅仅包含notifyXDRData_Req和XDRRawDataSend_Req包的数量） 第16页
SendDataInfo 4 int RecDataInfo 4 int
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 代表成功 第17页
其它代表失败 5.2.5.2
XDR数据通知notifyXDRData
该消息用于数据合成服务器将处理后的单接口XDR及合成XDR上报给应用系统。 5.2.5.2.1
属性 XDRType 请求
字节数 1 类型 Unsigned Integer 描述 XDR数据类型： 1：合成XDR数据 2：单接口XDR数据 具体传输的XDR数据，各种类型XDR的格式参考5.3 Load
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 Load 请求
字节数 8 类型 Long Integer 描述 应用系统订阅KPI数据后由数据合成服务器生成的全局唯一的订阅标识码 KPI指标的具体数据格式，具体请参见5.3.6节相关定义 5.2.5.3.2
属性
应答
字节数 类型 描述 第18页
Result 1 Unsigned Integer 请求的返回结果： 1 代表成功 其它代表失败 5.2.6
数据查询消息
5.2.6.1 XDR对应原始数据反查XDRRawDataQuery
应用系统能够使用该消息反查数据合成服务器中的原始码流数据，该反查基于单接口XDR来完成。应用系统在请求消息中指示单接口XDR相关信息，数据合成服务器收到请求消息后，将该XDR对应的原始数据上报给应用系统。 5.2.6.1.1
字段名 请求
字节数 类型 接口类型： 1. Uu 2. X2 3. UE_MR 4. Cell_MR 5. S1-MME 6. S6a 7. S11 8. S10 9. SGs 10. S5/S8 11. S1-U 12. Gn-C 单接口XDR的XDR ID XDR中记录的开始时间，定义为距1970年1月1日0时0分0秒的偏移量，单位为秒 描述 Interface 1 Unsigned Integer XDRID StartTime 16 8 Long Integer dateTime 5.2.6.1.2 字段名 应答 字节数 类型 描述 查询返回结果： 1 代表成功。 其他代表失败。 如失败则Load字段长度为0。 原始码流数据, 数据格式参考5.3.5 Result 1 Unsigned Integer Load
第19页
5.3 数据格式
5.3.1 单接口XDR格式
数据合成服务器需要对采集解析服务器上报的单接口XDR进行回填操作，从而补全单接口XDR中的空缺字段，形成完整的单接口XDR并上报给应用系统。具体的单接口XDR格式可参考《中国移动统一DPI设备技术规范-LTE信令采集解析服务器接口规范》。 5.3.2
合成信令XDR格式
5.3.2.1 概述
合成信令XDR由一个公共信息、一个通用信令信息和多个单接口信令信息组成。通用信令信息中会指示后续的单接口信令信息的数量。
合成信令XDR的组成如图4所示。单接口信令信息包括S1-MME、Uu、X2、S6a、S11、S10、SGs、S5/S8等接口信息。合成信令XDR的流程类型以S1-MME的流程类型作为主要的合成基准，将该过程涉及的多接口XDR关键信息进行关联呈现，并能指示合成XDR所涉及的各接口XDR ID，以满足应用层针对单接口关注信息进行重点查询和分析。单接口信令信息根据每个接口信令过程的开始时间进行排序，开始时间越早，该单接口信令信息的排序越靠前。此外，对于Attach/TAU/Service requsest/Detach等较大的流程，若其过程中还包含其他流程（如Identity Acquisition、Authentication、Security Activation、PDN connectivity、EPS bearer resource modify等），只需要输出Attach/TAU/Service requsest/Detach流程的合成XDR，其他流程产生的单接口XDR都包含在以上合成XDR中。
对同一个端到端流程，若某一接口产生多个XDR，如一个Attach流程会产生多个Uu接口XDR，需要将该接口的多个XDR信息都包含在合成XDR中。
不同端到端信令过程的起止时间说明请参考附录A。
公共信息通用信令信息单接口信令信息1„„单接口信令信息N
图4. 合成信令XDR结构
5.3.2.2 字段名 Length 公共信息格式
字段类型 unsigned int 长度（Byte） 默认值 参数描述 2 全F 指示整个XDR所占用字节数 城市区号，如010代表北京 采用TBCD编码，每4个比特表示一个十进制数字 1：UTRAN 2：GERAN 3：WLAN 第20页
City byte 2 全F RAT unsigned int 1 全F
4：GAN 5：HSPA Evolution 6：EUTRAN XDR type unsigned int 1 全F 1：合成信令XDR 2：合成业务XDR 3：合成UE_MR XDR 数据合成服务器生成的唯一XDR编号，与采集解析服务器上报的单接口XDR ID相互；一个大流程生成一个XDR ID，关联流程内各接口的XDR，因此一个合成XDR ID可对应同一UE在不同接口上的多个XDR记录。 用户IMSI（TBCD编码） 终端IMEI（TBCD编码） 用户号码（TBCD编码） XDR ID byte 16 全F IMSI IMEI MSISDN 5.3.2.3
byte byte byte 8 8 16 全F 全F 全F 通用信令信息格式
长度默认（Byte） 值 字段名 字段类型 参数描述 流程类型编码，具体取值如下： 1：Attach 2：Sevice Request 3：Paging 4：TAU 5：Detach 6：PDN connectivity 7：PDN disconnection； 8：EPS bearer resource allocation； 9：EPS bearer resource modify； 10：EPS bearer context deactivation； 11：EPS bearer context modification； 12：Dedicated EPS bearer context activation； 13：X2 handover； 14：S1 handover； 15：UE Context Release； 16：EPS bearer Release 17：CSFB 18：SMS 第21页
Procedure Type byte 1 全F
以上流程的具体说明，如流程开始信令及流程结束信令如何确定，请参考附录A。 Procedure Start dateTime Time Procedure End dateTime Time 8 8 全0 全0 业务流程开始时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 业务流程结束时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 取距离procedure start time最近的一个MR对应位置的经度。 本规范中的经度及纬度字段均遵循IEEE 754标准所规定的Double类型数据的存储格式 取距离procedure start time最近的一个MR对应位置的纬度 取距离procedure end time最近的一个MR对应位置的经度 取距离procedure end time最近的一个MR对应位置的纬度 流程状态 0：成功； 1：失败； 255：超时，或未收到相关的结束流程信令 重用S1-MME单接口XDR中的“Request Cause”字段 如果Procedure Status字段为0，则为全F； 如果Procedure Status字段为1，则指示发生错误的接口类型： 1. Uu 2. X2 3. UE_MR 4. Cell_MR 5. S1-MME 6. S6a 7. S11 8. S10 9. SGs 10. S5/S8 11. S1-U 12. Gn-C 需要说明的是，如果多个接口上发生失败，则此时标识第一个发生失败的接口 第一个发生失败的接口上所进行的流程类型，重用该单接口XDR中的“Procedure Type”字段 如果Procedure Status字段为0，则为全F； 第22页
StartLocation-longitude Double 8 全F StartLocation-latitude EndLocation-longitude EndLocation-latitude Double Double Double 8 8 8 全F 全F 全F Procedure Status byte 1 全F Request Cause byte 2 全F Failure Interface unsigned int 1 全F Failure Procedure Type Failure Cause
byte Unsigned 1 2 全F 全F
int 如果Procedure Status字段为1，则重用对应Failure interface接口的单接口XDR中的“Failure Cause”字段。 需要说明的是，如果多个接口上发生失败，则此时标识第一个发生失败的接口的原因码； 1 1 1 1 4 4 2 1 2 4 16 4 4 2 1 2 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 全F 用于指示对应不同流程的关键信息，具体定义请参考5.3.2.5节 用于指示对应不同流程的关键信息，具体定义请参考5.3.2.6节 预留字段，当前版本中填全F 预留字段，当前版本中填全F 业务流程发生eNB的eNB ID，ECI的前20个bit（宏站）或与ECI相同（家庭基站） 流程发生小区的Cell ID，要求为ECI信息 UE当前连接的MME组标识 UE当前连接的MME编码 UE当前所处的TAC 终端用户的IPv4地址，如无则填全F 终端用户的IPv6地址，如无则填全F 只针对切换过程，否则填全F 只针对切换过程，否则填全F 只针对切换过程，否则填全F 只针对切换过程，否则填全F 只针对TAU过程，否则填全F 整数值N，指示后续跟随的承载信息的个数，每个承载信息与一个承载相对应，其中包括多个字段：承载ID，承载类型，QCI，操作结果，用户面传输的GTP-TEID。如果该信令过程不涉及对任何承载的操作，则该字段取值为0，此时该字段之后承载信息的个数为0 承载1的EPS bearer ID，取值范围从0到15 承载1的类型： 1：default bearer 2：dedicated bearer 承载1的QCI，取值范围从1到9 承载1的操作结果： 1：建立成功 2：建立失败 第23页
Keyword 1 Keyword 2 Keyword 3 Keyword 4 eNB ID Cell ID MME Group ID MME Code TAC USER_IPv4 USER_IPv6 New eNB ID New Cell ID byte byte byte byte byte byte byte byte byte byte byte byte byte New MME byte Group ID New MME Code byte New TAC byte EPS Bearer Unsigned Number int 1 全F Bearer 1 ID Unsigned int Unsigned int Unsigned int Unsigned int 1 全F Bearer 1 Type 1 全F Bearer 1 QCI 1 全F Bearer 1 Status 1 全F
3：修改成功 4：修改失败 5：释放成功 6：释放失败 Bearer 1 Request byte Cause Bearer 1 Failure byte Cause Bearer 1 eNB byte GTP-TEID Bearer 1 SGW byte GTP-TEID …… Bearer N ID Unsigned int Unsigned int Unsigned int 2 2 4 4 1 全F 全F 全F 全F 全F 承载1操作请求消息中的Cause值，重用S1-MME单接口XDR中该字段 承载1操作失败消息中的Cause值，重用S1-MME单接口XDR中该字段 承载1对应的eNB侧GTP-TEID。 承载1对应的SGW侧GTP-TEID。 承载N的EPS bearer ID，取值范围从0到15 承载N的类型： 1：default bearer 2：dedicated bearer 承载N的QCI，取值范围从1到9 承载N的操作结果： 1：建立成功 2：建立失败 3：修改成功 4：修改失败 5：释放成功 6：释放失败 承载N操作请求消息中的Cause值，重用S1-MME单接口XDR中该字段 承载N操作失败消息中的Cause值，重用S1-MME单接口XDR中该字段 承载N对应的eNB侧GTP-TEID 承载N对应的SGW侧GTP-TEID 该合成信令XDR中包含的单接口信令信息个数 Bearer N Type 1 全F Bearer N QCI 1 全F Bearer N Status Unsigned int 1 全F Bearer N byte Request Cause Bearer N Failure byte Cause Bearer N eNB byte GTP-TEID Bearer N SGW byte GTP-TEID XDRnumber 5.3.2.4 字段名 Interface
Unsigned int 2 2 4 4 1 全F 全F 全F 全F 全0 单接口信令信息格式 字段类型 unsigned 长度（Byte） 1 默认值 参数描述 全F 接口类型： 第24页
int 1. Uu 2. X2 5. S1-MME 6. S6a 7. S11 8. S10 9. SGs 10. S5/S8 11. S1-U 12. Gn-C 16 1 全F 全F 采集解析服务器上报的各接口内部的XDR编号； 各接口流程类型，重用各接口XDR中的“Procedure Type”字段 业务流程开始时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 业务流程结束时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 取距离procedure start time最近的一个MR对应位置的经度，只针对Uu及S1-MME接口，对于其他接口填全F 取距离procedure start time最近的一个MR对应位置的纬度，只针对Uu及S1-MME接口，对于其他接口填全F 取距离procedure end time最近的一个MR对应位置的经度，只针对Uu及S1-MME接口，对于其他接口填全F 取距离procedure end time最近的一个MR对应位置的纬度，只针对Uu及S1-MME接口，对于其他接口填全F 流程状态 0：成功； 1：失败； 255：超时，或未收到相关的结束流程信令 重用各接口XDR中的“Request Cause”字段 重用各接口XDR中的“Failure Cause”或“Cause”字段 XDR ID Procedure Type byte byte Procedure Start dateTime Time Procedure End dateTime Time 8 全0 8 全0 StartLocation-longitude Double 8 全F StartLocation-latitude Double 8 全F EndLocation-longitude EndLocation-latitude Double 8 全F Double 8 全F Procedure Status int 1 全F Request Cause Failure Cause byte byte 2 2 全F 全F
第25页
5.3.2.5
通用信令信息中Keyword 1字段的定义
通用信令信息中Keyword 1字段的定义如下： 流程编码 1 流程类型 Attach 关键字段取值 8070605040321EPS attach type value EPS attach type value的取值参见3GPP 24.301第9.9.3.11节 3 Paging 寻呼类型： 0：IMSI, 1：S-TMSI 80706050403214 TAU EPS update type value EPS update type value的取值参见3GPP 24.301第9.9.3.14节 5 Detach 807060504Switchoff32Type of detach 1 Type of detach及Switch off的取值参见3GPP 24.301第9.9.3.7节 6 PDN connectivity 8070605040321Request type value Request type value的取值参见3GPP TS 24.008第10.5.6.17节 13、14 切换流程 切换类型： 1：IntraLTE； 2：LTEtoUTRAN； 3：LTEtoGERAN； 4：UTRANtoLTE； 5：GERANtoLTE 80706050432117 CSFB Service type value Service type value的取值参见3GPP 24.301第9.9.3.27节 18 SMS 短信传输方向： 0：下行方向 1：上行方向 该字段为全F； 其他编码
—— 第26页
5.3.2.6
通用信令信息中Keyword 2字段的定义
通用信令信息中Keyword 2字段的定义如下： 流程编码 1 流程类型 Attach 关键字段取值 8070605040321EPS attach result value EPS attach result value的取值参见3GPP 24.301第9.9.3.10节 4 TAU 8070605040321EPS update result value EPS updateresult value的取值参见3GPP 24.301第9.9.3.13节 5 Detach 触发方式： 0：流程由UE发起 1：流程由网络侧发起 该字段为全F； 其他编码 5.3.2.7
—— 单接口流程类型的定义
单接口流程类型的定义如下，该字段可沿用单接口XDR中的“Procedure Type”字段。 接口类型 流程类型 Uu 1：RRC连接建立 RRC_CONN_STP 2：安全模式激活 RRC_SMC 3：RRC连接重配 RRC_RE_CFG 4：RRC连接重建 RRC_RE_EST 5：RRC连接释放 RRC_REL 6：小区内部切换 RRC_HO_interCELL 7：基站内切换 RRC_HO_interENB 8：基站间切换 RRC_HO_interLTE 9：从其它RAT切入 RRC_HO_IN 10：切出至其他RAT RRC_HO_OUT_RAT 11：PS寻呼 RRC_PAGING_PS 12：CS寻呼 RRC_PAGING_CS 13：其它事件类型 RRC_OTHER
第27页
1：X2 handover
2：X2 handover cancel 3：X2 setup 4：Reset
5：eNB configuration update X2
6：Resource status reporting 7：Mobility setting change 8：Cell activation 9：Load indication 10：Error indication
1： Attach
2： Sevice Request
3： Extended Service Request 4： Paging 5： TAU 6： Detach
7： PDN connectivity 8： PDN disconnection
9： EPS bearer resource allocation 10：EPS bearer resource modify 11：EPS bearer context deactivation 12：EPS bearer context modification
13：Dedicated EPS bearer context activation 14：X2 handover 15：S1 handover in S1-MME
16：S1 handover out 17：S1 handover cancel 18：Initial context setup 19：UE context modification 20：UE context release 21：E-RAB release 22：Reset
23：Error indication 24：S1 setup
25：ENB configuration update 26：MME configuration update 27：Overload start 28：Overload stop
29：Identity Acquisition 30：Authentication 31：Security Activation 32：SMS
S10/S11 1：Create Session
第28页
2：Modify Bearer 3：Delete Session 4：Modify Bearer Command 5：Delete Bearer Command 6：Bearer Resource Command 7：Create Bearer 8：Update Bearer 9：Delete Bearer 10：Release Access Bearers 11：Modify Access Bearers 12：Echo Request 13：Version Not Supported Indication 14：Change Notification 15：Downlink Data Notification Failure Indication 16：Trace Session Activation 17：Trace Session Deactivation 18：Stop Paging Indication 19：Delete PDN Connection Set 20：PGW Downlink Triggering Notification 21：Identification Request 22：Context Request 23：Forward Relocation Request 24：Forward Relocation Complete Notification 25：Forward Access Context Notification 26：Relocation Cancel Request 27：Configuration Transfer Tunnel 28：Suspend Notification 29：Create Forwarding Tunnel 30：Resume Notification 31：Create Indirect Data Forwarding Tunnel 32：Delete Indirect Data Forwarding Tunnel 33：Downlink Data Notification 34：PGW Restart Notification 1：SGsAP-PAGING 2：SGsAP-SERVICE-REQUEST 3：SGsAP-DOWNLINK-UNITDATA 4：SGsAP-UPLINK-UNITDATA 5：SGsAP-LOCATION-UPDATE SGs 6：SGsAP-TMSI-REALLOCATION 7：SGsAP-ALERT 8：SGsAP-UE-ACTIVITY-INDICATION 9：SGsAP-EPS-DETACH 10：SGsAP-IMSI-DETACH 11：SGsAP-RESET
第29页
12：SGsAP-SERVICE-ABORT 13：SGsAP-MM-INFORMATION 14：SGsAP-RELEASE 15：SGsAP-STATUS 16：SGsAP-UE-UNREACHABLE 1、Update_Location 2、Cancel_Location 3、Purge_UE S6a 4、Insert_Subscriber_Data 5、Delete_Subscriber_Data 6、Authentication_Information 7、Reset 8、Notification 1：Echo request 2：Version Not Supported Indication 3：Create Session 4：Modify Bearer 5：Delete Session 6：Change Notification 7：Resume Notification 8：Modify Bearer Command 9：Modify Bearer Failure Indication 10：Delete Bearer Command S5/S8 11：Delete Bearer Failure Indication 12：Bearer Resource Command 13：Bearer Resource Failure Indication 14：Trace Session Activation 15：Trace Session Deactivation 16：Create Bearer 17：Update Bearer 18：Delete Bearer 19：Delete PDN Connection Set 20：Suspend Notification 21：Update PDN Connection Set 1：Routing Area Update(4G—>2G/3G)； Gn 2：Gn/Gp SGSN to MME Tracking Area Update(2G/3G—>4G) 3：E-UTRAN Initial Attach
第30页
5.3.3
合成业务XDR格式
5.3.3.1 概述
合成业务XDR由一个公共信息、一个通用业务信息和多个单小区业务信息组成，一个单小区业务信息对应该业务传输过程中生成的一个S1-U单接口XDR。需要特别说明的是，由于同一个业务可能在同一个小区中持续较长时间，从而针对该小区会产生多个S1-U单接口XDR，此时合成业务XDR要把这些S1-U单接口XDR都合成到一起。通用业务信息中会指示单小区业务信息的个数。单小区业务信息根据业务过程的开始时间进行排序，开始时间越早，该单小区业务信息的排序越靠前。
合成业务XDR的组成如下图所示。
公共信息通用业务信息单小区业务信息1„„单小区业务信息n
图5. 合成业务XDR结构
5.3.3.2 公共信息格式
参考5.3.2.2节合成信令XDR的公共信息格式。 5.3.3.3
通用业务信息格式
字段名 字段类型 byte 字段长度 2 默认值 全F 说明 应用大类 App Type 业务类型，集团规定的18种大类 应用小类 根据集团定义的识别规则识别出来的小类,例如新浪微博和腾讯微博如果属于不同的应用，则有不同的ID。 集团未定义的各厂家根据自己的DPI进行识别 TCP/UDP流开始时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 TCP/UDP流结束时间，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 取距离procedure start time最近的一个MR对应位置的经度 取距离procedure start time最近的一个MR对应位置的纬度 取距离procedure end time最近的一个MR对应位置的经度 第31页
App Sub-type byte 2 全F Procedure Start Time Procedure End Time StartLocation-longitude StartLocation-latitude EndLocation-longitude
dateTime dateTime 8 8 全0 全0 全F 全F 全F Double 8 Double 8 Double 8
EndLocation-latitude USER_IPv4 USER_IPv6 XDRnumber 5.3.3.4
字段 XDR ID Procedure Time Procedure Time Start End 单小区业务信息格式
类型 byte dateTime dateTime Double 长度 默认值 说明 16 8 8 8 全F 全0 全0 全F 采集解析服务器上报的S1-U接口XDR的XDR ID。 TCP/UDP流开始时间，UTC时间），从1970/1/1 00:00:00开始到当前的毫秒数。 TCP/UDP流结束时间，UTC时间），从1970/1/1 00:00:00开始到当前的毫秒数。 取距离procedure start time最近的一个MR对应位置的经度 取距离procedure start time最近的一个MR对应位置的纬度 取距离procedure end time最近的一个MR对应位置的经度 取距离procedure end time最近的一个MR对应位置的纬度 eNB ID 小区的ECI eNB侧用户面GTP-TEID SGW侧用户面GTP-TEID 上行流量 按照3GPP SGSN话单的统计方式进行计算，单位：字节 下行流量 按照3GPP SGSN话单的统计方式进行计算，单位：字节 Double 8 byte byte unsigned int 4 16 1 全F 全F 全F 全0 取距离procedure end time最近的一个MR对应位置的纬度 终端用户的IPv4地址，如无则填全F 终端用户的IPv6地址，如无则填全F 该合成业务XDR中包含的单小区业务信息个数 StartLocation-longitude StartLocation-latitude EndLocation-longitude EndLocation-latitude eNB ID Cell ID eNB GTP-TEID SGW GTP-TEID UL Data Double 8 全F Double 8 全F Double byte byte byte byte byte 8 4 4 4 4 4 全F 全F 全F 全F 全F 全F DL Data byte 4 全F
第32页
5.3.4
合成UE_MR XDR格式
5.3.4.1 概述
合成UE_MR XDR由一个公共信息和一个MR信息组成，如下图所示。公共信息中需要回填用户身份标识信息，MR信息中需要回填MR定位后经度和纬度信息。
公共信息MR信息
图6. 合成UE_MR XDR结构
5.3.4.2 公共信息格式
参考5.3.2.2节合成信令XDR的公共信息格式。 5.3.4.3 字段名 Location-longitude Location-latitude eNB ID Cell ID Time MR信息格式 类型 Double Double byte byte dateTime 长度 8 8 4 4 8 默认值 全F 全F 全F 全F 全0 说明 该MR对应位置的经度信息 该MR对应位置的纬度信息 流程发生的eNB ID，软采包头上报 流程发生小区的Cell ID，要求为ECI信息，软采包头上报 该MR对应的时间戳，UTC时间，从1970/1/1 00:00:00开始到当前的毫秒数。 本条测量报告的类型，由采集解析设备通过解析measurement configuration和 MR的meas ID后获得： 1：周期测量 2：A1事件 3：A2事件 4：A3事件 5：A4事件 6：A5事件 7：B1事件 8：B2事件 9：其他 MR type Unsigned int 1 全F PHR Unsigned int 1 全F UE相对于配置的最大发射功率的余量。在headroom type 1中，此余量表示服务小区的UL-SCH发射功率与配置的最大发射第33页
功率的差值。在headroom type 2中，此余量表示每个激活的服务小区UL-SCH发射功率或者是PCell的PUSCH和PUCCH发射功率值和与配置的最大发射功率的差值。 若MR type为事件性测量报告，该字段取全F。 eNB接收UE的总功率 UE的PUSCH占用的所有PRB的总功率； 若MR type为事件性测量报告，该字段取全F。 用户上行信噪比 具体计算方法：计算用户占用的每个物理资源块（PRB）带宽上的信号功率S和干扰功率I的比值，然后取所有PRB信噪比的平均值。 若MR type为事件性测量报告，该字段取全F。 服务小区的EARFCN 服务小区RSRP 服务小区RSRQ 整数值N，指示后续跟随的邻区信息的个数，每个邻区信息与一个邻小区相对应，其中包括四个字段：PCI、EARFCN、RSRP、RSRQ 第一个邻小区的PCI 第一个邻小区的EARFCN 第一个邻小区的RSRP测量值 第一个邻小区的RSRQ测量值 第N个邻小区的PCI 第N个邻小区的EARFCN 第N个邻小区的RSRP测量值 第N个邻小区的RSRQ测量值 第34页
eNB Received Unsigned Power int 2 全F UL SINR Unsigned int 1 全F Serving Freq Serving RSRP Serving RSRQ Unsigned int Unsigned int Unsigned int 2 1 1 全F 全F 全F Neighbor Cell Unsigned Number int Neighbor Cell ID Neighbor Freq Neighbor RSRP Neighbor RSRQ …… Neighbor Cell ID Neighbor Freq Neighbor RSRP Neighbor
1 Unsigned int 1 Unsigned int 1 Unsigned int 1 Unsigned int N Unsigned int N Unsigned int N Unsigned int N Unsigned 1 全F 2 2 1 1 2 2 1 1 全F 全F 全F 全F 全F 全F 全F 全F
RSRQ 5.3.5
原始码流数据格式
int 数据合成服务器接收采集解析服务器上报的原始码流数据包，并不对其进行处理，只是通过数据上报接口转发给应用层，因此原始码流数据包的格式与采集解析服务器所上报的格式相同，可参考《中国移动统一DPI设备技术规范-LTE信令采集解析服务器接口规范》中的第17章。
可以看到，原始码流数据包是基于每个单接口XDR生成的，其中包含了对应一个单接口XDR的原始数据。根据单接口XDR类型的不同，原始码流的内容不同。如果是单接口信令XDR，则原始码流为原始信令；如果是业务XDR，则原始码流为原始业务数据中的包头部分，并不包含payload部分。 5.3.6
KPI数据格式
KPI数据的编码统一采用标准csv格式。
针对选定区域内的每个分析维度的每个时间粒度的指标数据用一行表示，如下： 指标名称，分析维度取值1，时间粒度，指标取值 指标名称，分析维度取值2，时间粒度，指标取值 …
指标名称，分析维度取值N，时间粒度，指标取值
举实例说明，订单ID为12345，订阅了两个指标，参数如下： 指标名称 KPI1 KPI2 分析维度 CELL CELL 分析粒度 1分钟 5分钟 所选区域 （C1，C2，C3，C4） （C1，C2，C5，C6） 起止时间 2011-4-10 11:00～12:00 2011-4-10 11:00～12:00
11:01时，发送KPI1的第一个分析粒度的数据，如下：
KPI1,C1,2011-4-10 11:01,A11 KPI1,C2,2011-4-10 11:01,B11 KPI1,C3,2011-4-10 11:01,C11 KPI1,C4,2011-4-10 11:01,D11
11:02时，发送KPI1的第二个分析粒度的数据，如下：
KPI1,C1,2011-4-10 11:02,A12 KPI1,C2,2011-4-10 11:02,B12 KPI1,C3,2011-4-10 11:02,C12 KPI1,C4,2011-4-10 11:02,D12
11:03、11:04分时，发送KPI1的第三和第四个分析粒度的数据，与上面两个粒度类似。 当11:05时，除了要发送KPI1的第五个分析粒度的数据，还要发送KPI2的第一个分析粒度的数据，如下：
KPI1,C1,2011-4-10 11:05,A15 KPI1,C2,2011-4-10 11:05,B15 KPI1,C3,2011-4-10 11:05,C15 KPI1,C4,2011-4-10 11:05,D15 KPI2,C1,2011-4-10 11:05,A21
第35页
KPI2,C2,2011-4-10 11:05,B21 KPI2,C5,2011-4-10 11:05,C21 KPI2,C6,2011-4-10 11:05,D21
后面的时间粒度依上例类推，直到12:00结束。
指标数据中，类型为String的按ASCII填写，其它类型按照十进制填写。
6 KPI数据订阅接口
6.1 概述
应用系统通过KPI数据订阅接口向数据合成服务器订阅KPI指标数据，也可修改和取消订阅。KPI数据订阅接口使用WebService协议，此时数据合成服务器作为WebService服务端，应用系统作为WebService客户端。数据合成服务器需要统计的KPI指标及相关要求请参考附录C文档。
6.2 KPI数据订阅流程
KPI数据订阅的管理流程如下图所示：
第36页
应用层共享层0GETLINKAUTH_REQ0GETLINKAUTH_RESP1GETMMEINFO_REQ1GETMMEINFO_RESP2GETTACINFO_REQ2GETTACINFO_RESP3GETENBINFO_REQ3GETENBINFO_RESP4GETCELLINFO_REQ4GETCELLINFO_RESP获取鉴权资源查询5GETUSERLIST_REQ5GETUSERLIST_RESP6CREATESubscription_REQ6CREATESubscription_RESP7UPDATESubscription_REQ7UPDATESubscription_RESP8GETSubscription_REQ8GETSubscription_RESP9CANCELSubscription_REQ9CANCELSubscription_RESP10AUTHREL_REQ10AUTHREL_RESP订阅操作释放鉴权
图7. KPI订阅管理流程
说明如下：
（1） 图中0步骤是获取授权，应用层向数据合成服务器提出授权申请，返回授权结果，
如果授权失败，则该应用层用户没有得到授权。客户端向服务端发起链路鉴权请求（使用数据合成服务器与各应用系统间协商好的共享密钥），若服务端鉴权失败，则拆除连接； （2） 图中1到8说明：
a) 图中1到9分别为MME资源查询、位置区资源查询、eNB资源查询、小区资源
查询、用户信息查询、创建订单、修改订单、查询订单、取消订单过程，均属于订阅服务中的几个过程； b) 图中1到5这些过程无先后顺序，在流程中都不是必须的过程，可由应用层软件
根据自身需求，进行一次或多次查询； c) 6到9过程是对业务订阅的操作，6过程创建订单后，可以通过8过程查询得到该
订单，并对查询订单进行7过程修改操作和9过程取消操作； d) 共享平台有鉴权，1到9过程中的每条请求消息，在共享平台都要进行鉴
权，如果鉴权失败，则返回鉴权失败错误码，应用系统则转到0步骤重新获取授权。
第37页
（3） 图中10步骤是释放授权，应用系统向数据合成服务器提出释放授权申请，返回
释放授权结果。 6.3 KPI数据订阅消息
6.3.1 授权获取getLinkAuth
注：授权获取方法对应不同的服务流程，按规范中的服务流程定义可分为订阅服务授权和查询服务授权，不同的服务流程都有相对应的授权管理。
应用系统与数据合成服务器之间的订阅服务操作都必须先得到授权，授权通过授权过程获取。授权操作由应用系统发起请求，应用系统需要向提供应用系统的永久帐户用户名、密码，数据合成服务器返回根据请求信息计算的密钥，后续应用系统向数据合成服务器发送请求信息的操作都需要携带该密钥。
密钥的有效期限由数据合成服务器定义，如果超过该期限，密钥失效。为避免二次授权，在密钥失效前，不得进行二次授权，因应用系统异常退出等导致密钥无法释放时，应用系统可以通过发起授权释放流程进行密钥的释放。
应用系统不能在无授权下直接对数据合成服务器进行操作，必须通过本过程，得到数据合成服务器授权后的密钥，在订阅服务中每一个过程，需要在该过程的请求消息的消息头中携带授权的密钥。 6.3.1.1
字段名 LoginID 请求
类型 string 描述 账户ID。 应用系统的用户标识，可以唯一表示具体的应用系统。 应用系统向数据合成服务器发起数据订阅请求时，使用应用系统的平台标识 用于鉴别源用户。其值通过单向MD5 Hash计算得出。当对端用相同方式加密之后与接收Digest值比较，如果计算出来的值相同，则通过校验，否则出错。 MD5计算方法： Digest = MD5(LoginID+MD5(shared secret)+Timestamp+”rand=”+RAND) 其中Shared secret为与LoginID对应的账户密码，由认证双方实体事先商定； Timestamp为：本消息带的Timestamp字段数值，单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数）。 RAND为：本消息带的RAND字段取值。 举例说明： 应用系统的 LoginID = “user” shared secret=“passwd” 第38页
Digest string
Timestamp=12959463 RAND=99 则 MD5(shared secret)=76a2173be6393254e72ffa4d6df1030a 加密前字符串：“user76a2173be6393254e72ffa4d6df1030a12959463rand=99” 加密：Md5(user76a2173be6393254e72ffa4d6df1030a12959463rand=99) Digest结果： 405155e09aadf0bfbd521e2c82b5bbb3 Timestamp string 时间戳的明文。 由应用系统产生,单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数） 由应用系统产生的随机数。 RAND 6.3.1.2
应答 属性 resultType key 6.3.1.3
鉴权
string 类型 Integer String 描述 处理结果，参见附录B. 结果取值定义 授权密钥，为共享平台分配 得到授权后，应用系统与数据合成服务器之间的业务操作都需要鉴权。
鉴权信息为授权得到的密钥，并且放在soap消息头中，以后的每次webservice请求都需要携带该密钥。
鉴权失败，应用系统则应重新获取授权。 Soap如下所示： 6.3.2 注：释放授权方法对应不同的服务流程，按规范中的服务流程定义可分为订阅服务释放授权和查询服务释放授权，不同的服务流程都有相对应的授权管理。 订阅服务操作结束，应用系统用户退出订阅服务，释放掉授权。 6.3.2.1 字段名 请求 类型 描述 第39页 LoginID String 账户ID。 应用系统的用户标识，可以唯一表示具体的应用系统。 应用系统向数据合成服务器发起数据订阅请求时，使用应用系统的平台标识 用于鉴别源用户。其值通过单向MD5 Hash计算得出。当对端用相同方式加密之后与接收Digest值比较，如果计算出来的值相同，则通过校验，否则出错。 MD5计算方法： Digest = MD5(LoginID+MD5(shared secret)+Timestamp+”rand=”+RAND) 其中Shared secret为与LoginID对应的账户密码，由认证双方实体事先商定； Timestamp为：本消息带的Timestamp字段数值，单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数）。 RAND为：本消息带的RAND字段取值。 举例说明： 应用系统的 LoginID = “user” shared secret=“passwd” Timestamp=12959463 RAND=99 则 MD5(shared secret)=76a2173be6393254e72ffa4d6df1030a 加密前字符串：“user76a2173be6393254e72ffa4d6df1030a12959463rand=99” 加密：Md5(user 76a2173be6393254e72ffa4d6df1030a12959463rand=99) Digest结果： 405155e09aadf0bfbd521e2c82b5bbb3 时间戳的明文。 由应用系统产生,单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数） 由应用系统产生的随机数。 Digest String Timestamp String RAND String 第40页 6.3.2.2 属性 resultType 6.3.3 查询MME列表getMMEInfo 应答 类型 Integer 描述 处理结果，参见附录B. 结果取值定义 6.3.3.1 请求 属性 类型 DateTime DateTime 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 startTime endTime 6.3.3.2 应答 属性 resultType MMEInfo 6.3.4 类型 Integer MMEInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的MME集合 查询TAC列表getTACInfo 6.3.4.1 请求 属性 类型 DateTime DateTime MMEInfo [1..unbounded] 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 选择一个或多个MME startTime endTime MME 6.3.4.2 应答 属性 resultType Tacs 类型 Integer TacsInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的TAC集合 第41页 6.3.5 查询eNB列表getENBInfo 6.3.5.1 请求 属性 类型 DateTime DateTime MMEInfo [1..unbounded] TacsInfo [1..unbounded] 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 选择一个或多个MME 选择一个或多个TAC startTime endTime MME Tac 备注：MME和Tac只能填写其一。 如果查询内容为空，则返回全网所有eNB的信息。 6.3.5.2 应答 属性 resultType eNBs 类型 Integer eNBInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的eNB集合 6.3.6 查询小区列表getCellInfo 6.3.6.1 请求 属性 类型 DateTime DateTime eNBInfo [1..unbounded] 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 选择一个或多个基站 startTime endTime eNB 6.3.6.2 应答 属性 resultType cell 类型 Integer CellInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的小区集合 第42页 6.3.7 查询终端列表getIMEIList 6.3.7.1 请求 属性 类型 DateTime DateTime CellInfo [1..unbounded] 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 选中一个或多个小区 startTime endTime cell 6.3.7.2 应答 属性 resultType IMEIlist 类型 Integer IMEIInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的终端信息集合 6.3.8 查询用户列表getUserList 6.3.8.1 请求 属性 类型 DateTime DateTime CellInfo [1..unbounded] 描述 获取网元信息有效时间段的起始时间 获取网元信息有效时间段的终止时间 选中一个或多个小区 startTime endTime cell 6.3.8.2 应答 属性 resultType userlist 6.3.9 类型 Integer UserInfo [1..unbounded] 描述 查询处理结果，参见附录B 所查询的用户信息集合 创建订阅createSubscription 应用业务系统管理员通过界面，通过此消息创建订阅。 第43页 6.3.9.1 请求 一个订单可以包含多个KPI指标的订阅，但是同一KPI指标不同分析维度或者不同分析粒度的订阅，不能放在一个订单中。 属性 kpiorders 6.3.9.2 属性 resultType orderId 应答 类型 Integer orderId 描述 处理结果，参见附录B 订阅标识 类型 KpiOrderInfo[0..unbounded] 描述 订阅内容 6.3.10 修改订阅updateSubscription 修改订阅由应用平台发起，支持对订阅起止时间的修改，请求消息携带订阅标识，以及更改的起止时间，通过鉴权后，数据合成服务器返回订阅修改结果。 6.3.10.1 属性 orderId startTime 请求 类型 orderId DateTime 描述 订阅标识 订阅开始时间 若在更新该订阅时，此订阅已经生效(即为该订阅此前规定的开始时间小于当前时间)，则不能修改订阅有效期的开始时间 订阅截止时间 若在更新该订阅时，此订阅已经结束（即为该订阅此前规定的结束时间小于当前时间），则不能修改该订阅 endTime DateTime 6.3.10.2 属性 应答 类型 Integer 描述 处理结果，参见附录B resultType 6.3.11 查询订阅getSubscription 应用平台通过此接口查询订阅的具体内容，当参数为0时则查询该应用平台所订阅的所有订单信息。 6.3.11.1 属性 请求 类型 描述 第44页 orderId orderId 订阅标识 若在查询该订阅时，此订阅已经结束（即为该订阅结束时间小于当前时间），则不能查询该订阅 若orderId填0，则查询本应用系统的所有有效订阅 6.3.11.2 属性 应答 类型 Integer KpiOrderInfo[1..unbounded] 描述 处理结果，参见附录B 订阅内容的集合 resultType kpiOrderInfo 6.3.12 取消订阅cancelSubscription 取消订阅由应用系统发起，请求消息携带订阅标识，通过鉴权后，数据合成服务器返回处理结果。 6.3.12.1 属性 orderId 请求 类型 orderId 描述 订阅标识 若在取消该订阅时，此订阅已经结束（即为该订阅结束时间小于当前时间），则不能取消该订阅 6.3.12.2 属性 应答 类型 Integer 描述 处理结果，参见附录B resultType 6.4 数据格式 6.4.1 属性 订阅标识OrderID 类型 Long Int 长度 8 是否必填 是 描述 订阅的唯一编号，由数据合成服务器分配 orderID 6.4.2 属性 ip port 服务端口ServicePort 类型 Byte Int 长度 4 2 是否必填 是 是 描述 IP地址（默认采用IPv4） 端口 第45页 6.4.3 属性 MMEName MME Group ID MME Code 6.4.4 属性 TACInfo MME信息MMEInfo 类型 String Byte 长度 20 2 1 是否必填 否 是 是 描述 MME的名称 MME组标识 MME标识 Byte TAC信息TACInfo 类型 Byte 长度 2 是否必填 是 描述 Tracking Area Code 6.4.5 属性 eNB信息eNBInfo 类型 String MMEInfo TACInfo Byte 小区信息CellInfo 类型 String MMEInfo TACInfo Byte Byte Integer 长度 20 / / 4 4 2 是否必填 否 是 是 是 是 是 描述 小区名称 小区所属的MME信息 小区所属的TA 小区所属的基站标识 小区标识，取值为ECGI的后28个bit 小区PCI 长度 20 / / 4 是否必填 否 是 是 是 描述 eNB名称 基站所属的MME信息 基站所属的TA 基站标识 （按照3GPP协议规定，宏站是20bit，微站是28bit，高位用0补齐） eNBName MME TA eNBID 6.4.6 属性 CellName MME TA eNBID CellID PCI 6.4.7 属性 终端信息IMEIInfo 类型 长度 是否必填 描述 第46页 CellID IMEI type IMEI type Name 6.4.8 BitString Byte String 4 8 20 是 是 否 小区标识 （按照3GPP协议规定为28bit） 终端型号，指本基站下出现过的终端型号，取值为IMEI前八位 终端型号名称 用户信息UserInfo 类型 BitString Byte Byte Byte 长度 4 8 16 8 是否必填 是 是 是 否 描述 用户当前时刻所属的小区标识 用户IMSI（TBCD编码） 用户号码（TBCD编码） 用户IMEI（TBCD编码） 属性 CellId IMSI MSISDN IMEI 6.4.9 KPI参数信息KPIParamsInfo 类型 长度 1 是否必填 是 描述 该KPI指标所属接口编号： 1. Uu 2. X2 3. UE_MR 4. Cell_MR 5. S1-MME 6. S6a 7. S11 8. S10 9. SGs 10. S5/S8 11. S1-U 12. Gn-C 该KPI指标编号，参考附录C文档的第一列 字段上阀值 字段下阀值 属性 Interface Byte KpiParamCode Integer 2 2 2 是 否 否 UpperThreshold Integer LowerThreshold Integer 注：如果字段上阀值和下阀值填写相同的值，则默认统计该字段等于阀值的KPI。 6.4.10 时间粒度Time Granularity 属性 TimeLength TimeType 类型 Byte Byte 长度 1 1 是否必填 是 是 描述 时间长度，例如15分钟，填写“15”；一周则填写“1” 时间类型 第47页 1- 毫秒 2- 秒 3- 分钟 4- 小时 5- 日 6- 周 7- 月 8- 年 6.4.11 日期时间DateTime 属性 Year Month Day Hour Minute Second 类型 Integer Byte Byte Byte Byte Byte 长度 2 1 1 1 1 1 是否必填 是 是 是 是 是 是 分 秒 日 时 描述 年 月 注：如果是整点，则Minute和Second字段填0，依此类推。 6.4.12 KPI订阅信息KpiOrderInfo 属性 KPI order type 类型 Byte 长度 1 是否必填 是 描述 订阅KPI的空间粒度： 1：MME 2：TAC 3：eNB 4：Cell 5：终端型号 6：用户 选中的MME信息，若订阅的空间粒度为MME时填写，否则该字段长度为0 选中的TA列表，若订阅的空间粒度为TAC时填写，否则该字段长度为0 选中的eNB列表，若订阅的空间粒度为eNB时填写，否则该字段长度为0 选中的小区列表，若订阅的空间粒度为cell时填写，否则该字段长度为0 选中的终端型号列表，若订阅的空间粒度为终端时填写，否则该字段长度第48页 mme tac eNB Cell MMEInfo [1..unbounded] TACInfo [1..unbounded] eNBInfo [1..unbounded] CellInfo [1..unbounded] IMEIInfo [1..unbounded] / / / / 否 否 否 否 IMEI / 否 为0 User KPIParamsOrder Granularity dataNotifyPort startTime UserInfo [1..unbounded] KPIParamsInfo [1..unbounded] Time Granularity ServicePort DateTime / / / / / 否 是 是 否 是 选中的用户列表，若订阅的空间粒度为用户时填写，否则该字段长度为0 订阅的KPI参数 时间颗粒度 数据通知端口 数据订阅的有效开始时间 （对于历史数据的查询，则该字段为过去的时间） 数据订阅的有效结束时间 （对于历史数据的查询，则该字段为过去的时间） endTime DateTime / 是 7 至经分系统（经上报网关）接口 本节定义数据合成服务器与日志上报网关之间的接口，日志上报网关收到数据合成服务器上报的经分数据后，需将该数据转发给经分系统。 该接口所传输的数据包括以下两种XDR数据： 1、经过回填之后完整的S1-U接口XDR，具体格式请参考《中国移动统一DPI设备技术规范》； 2、合成业务XDR，具体格式请参考本规范第5.3.3节。 需要说明的是，数据合成服务器需要将XDR数据先转换为txt格式文件，之后再通过该接口传输给日志上报网关。 7.1 接口协议 该接口包括文件接口和消息接口两种接口方式： 文件接口 文件接口用于传输XDR文件，采用SFTP传输协议。 日志上报网关提供SFTP服务器，为数据合成服务器分配文件上传FTP目录及用户名和密码。数据合成服务器作为Client端，使用日志上报网关分配的用户名和密码，通过FTP PUT方式将文件传送到指定的位置。 传输文件最大为100M，文件传输前需要进行压缩，压缩方式采用gz文件压缩。 消息接口 消息接口用于传输文件重传消息及其响应消息，采用HTTP短连接的方式。 数据合成服务器作为服务器端开启Web服务，日志上报网关作为客户端。 第49页 日志上报网关以Http的POST方法发送重报请求消息给数据合成服务器，数据合成服务器收到重发消息后，使用文件接口发送XDR数据文件给日志上报网关，同时向日志上报网关返回响应消息。 消息接口访问形式为： http://UserLog_GATEWAY_IP:Port/IF_ReUpload_IPTrace/ 说明如下表所示： 名称 说明 UserLog_GATEWAY_IP 数据合成服务器提供接收文件重报请求的IP地址 Port IF_ReUpload_IPTrace 7.2 文件命名规则 传输文件的命名规则为：LTE_<省编码>_<设备编码>_<信息ID号>_<文件生成时间>.xml。 各字段的说明如下表所示。 字段名 省编码 设备编码 信息ID号 文件生成时间 7.3 消息结构 日志上报网关下发的文件重报请求消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 名称 id beginFilename 说明 数字，保证在对应业务内的全局唯一性 重发开始文件 说明 省份的代码表，具体见附录D 网关设备的代码表，具体见附录E 由数据合成服务器自动生成，使用固定12字符长度，从1开始，采取自增方式，超过12位后可以重复开始 精确到秒，采用YYYYMMDDHH24MISS格式 数据合成服务器提供接收文件重报请求的端口号（可配置，建议为80） 文件重报接口的名称 第50页 endFilename 重发结束文件 数据合成服务器接收到该请求消息后，向日志上报网关返回响应消息，同时通过文件接口传送重报文件，文件传输完毕后传输文件名.ok文件。 数据合成服务器发送响应消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 名称 id resultCode 说明 数字，和文件重报请求消息的id相同 1：成功 2：失败 failReason 7.4 文件格式 该接口所传输的数据包括以下两种XDR数据： 1、经过回填之后完整的S1-U接口XDR，具体格式请参考《中国移动统一DPI设备技术规范》； 2、合成业务XDR，具体格式请参考本规范第5.3.3节。 需要说明的是，数据合成服务器需要将XDR数据转换为txt格式文件再进行传输。txt格式文件采用utf-8格式编码，以行区分不同记录，即一行代表一个XDR记录。同一个XDR记录中的各字段之间以符号“|”分隔。文件中的“|”符号无需转义，每行以“回车”+“换行”结束。XDR中所定义的字段类型是双方约定的数据入库存储格式，实际传输时格式都是txt文本里的string类型。 字符串格式，描述失败原因 8 至指定系统（经上报网关）接口 至指定系统（经上报网关）接口包含：日志上报接口、日志重报接口、用户在线状态查询接口、告警事件上报接口。 数据合成服务器可根据采集解析服务器实时上报的单接口XDR及原始码流数据生成指定系统所需要的数据格式并进行上报。 第51页 8.1 日志上报接口 日志上报接口用于数据合成服务器向日志上报网关传输用户上网日志文件。数据合成服务器可根据采集解析设备实时上报的单接口XDR及原始码流数据生成用户上网日志文件。 需要说明的是，数据合成服务器针对指定系统的日志上报需求，需要支持以下应用协议（包含但不限于）：http、https、ftp、smtp、imap、pop3、dns、snmp等。 8.1.1 接口协议 8.1.1.1 概述 数据合成服务器使用FTP协议向日志上报网关传输用户上网日志文件。 日志上报网关通过IF_UPLOAD接口接收数据合成服务器上传的用户上网日志文件，此时数据合成服务器作为FTP Client，日志上报网关作为FTP Server，日志上报网关为数据合成服务器提供以下日志上报路径： FTP:// IPTrace_GateWay_IP:Port/IF_UPLOAD/PS_Log_Server/ Province/Equ_No； 上报路径中各字段含义如下： - IPTrace_GateWay _IP：标识日志上报网关的IP地址； - Port：标识日志上报网关接收用户上网日志的端口号； - IF_UPLOAD：标识日志上报网关接收用户上网日志的名称； - PS_Log_Server：标识此路径下为数据合成服务器上报的数据； - Province：省份代码； - Equ_No：省内设备编号； 为了检查是否有文件丢失，解码层生成完一个数据文件后即生成一个校验文件，文件名也需要包含生成时间信息（如SSS_HW_XXXXYYYYMMDDHHMI.CHK） 如果没有数据也要按照时间间隔生成文件，表示系统工作正常。 8.1.1.2 上报日志文件命名规则 IPv4网络环境下命名规则为：<业务功能简写><文件前缀>-<信息ID号>- 字段名 业务功能简写 文件前缀 信息ID号 YYYYMMDDHH24MISS 第52页 说明 1. 非地址转换类溯源信息上报：LU 2. 地址转换类溯源信息上报：NU 用户上下线日志文件为U 用户访问信息日志为A 由数据合成服务器自动生成，使用固定12字符长度，从1开始，采取自增方式，超过12位后可以重复开始 表示生成文件的时刻，取4字符年、2字符月份、2字符天、24小时制的小时、2字符分钟、2字符秒 IPv6网络环境下命名规则为：<业务功能简写><文件前缀>-<信息ID号>- 字段名 业务功能简写 文件前缀 信息ID号 YYYYMMDDHH24MISS IPv6 8.1.1.3 数据校验文件格式 说明 3. 非地址转换类溯源信息上报：LU 4. 地址转换类溯源信息上报：NU 用户上下线日志文件为U 用户访问信息日志为A 由数据合成服务器自动生成，使用固定12字符长度，从1开始，采取自增方式，超过12位后可以重复开始 表示生成文件的时刻，取4字符年、2字符月份、2字符天、24小时制的小时、2字符分钟、2字符秒 标识为IPv6用户上网日志，便于日志上报网关根据上端网元要求判断是否进行IPv6地址上报。 数据校验文件的格式如下表所示： 抽取方式及周期 校验文件名 属性编码 01 02 03 属性名称 file_name row_num file_time 可根据具体应用需求进行订阅 SSS_HW_XXXXYYYYMMDDHHMI.CHK 属性描述 数据文件名 记录行数 文件生成时间 类型 string string string 备注 其中XXXX应包含话单类型信息。 YYYY-MM-DD HH:MM:SS 校验文件内容示例如下： file_name:100_23_2423_VoiceCall_Event201007232100.CHK row_num:1506 file_time:2010-7-23 21:05:01 8.1.1.4 校验规则 文件级校验是指根据解码层提供的接口校验文件信息，数据合成服务器对需要传输的接口文件进行校验，校验内容如下： 1. 接口数据文件名称 - 根据接口校验文件中记录的文件，查找“接口数据文件目录”下该接口数据文件 是否存在； 第53页 - 检查接口数据文件的名称是否遵守规范中的命名规范； 2. 文件中包含的记录数 验证接口校验文件中记载的文件记录数与实际接口数据文件中的记录行数是否一致； 3. 文件的生成日期 验证接口校验文件中记载的文件生成日期与实际接口数据文件的生成日期是否一致； 8.1.1.5 FTP文件管理 数据合成服务器需要根据预先设定的文件分割时间及文件缓存时间对用户上网日志文件进行管理，当文件的缓存时间超过设定的缓存时间时，数据合成服务器可删除相应的日志文件和对应的校验文件。 8.1.2 用户上网日志格式 用户上网日志包括两类：用户上下线日志和用户访问信息日志，以下将详细说明这两种日志的格式。 8.1.2.1 用户上下线日志 用户上下线日志文件采用XML格式，文件结构如下： 其中各个字段的说明如下： 字段名 resultnum id accout accoutType loginType 说明 十进制数字，表示一个文件中log消息的个数，取值范围1至40000 使用固定12字符长度，保证在对应业务内的全局唯一性 用户上网使用的帐号或上网使用的手机号 1:固网 2:移动网 1:拨号上网方式 第54页 2:移动上网方式 3:WLAN上网方式 4:其它上网方式 priIpAddr pubIpAddr LineTimeType LineTime LAC SAC 8.1.2.2 用户访问信息日志 用户私网IP地址，采用点分十进制表示 用户公网IP地址，采用点分十进制表示；置为空 上下线类型，以数字表示，其中， 1:用户上线时间，即用户面业务开始时间 2:用户下线时间，即用户面业务结束时间 用户上线或下线时间，格式为yyyy-MM-dd hh:mm:ss 对于4G系统该字段填充TAC信息 服务区域码信息，对于4G系统该字段置为空 用户访问信息日志文件采用XML格式，文件结构如下： dstIp=\"NAT后公网目的IP地址\" dstPort=\"NAT后目的端口\" accessTime=\"访问时间\" url=“访问url” LAC=“位置区域码信息” SAC=“服务区域码信息” /〉 其中各个字段的说明如下： 字段名 id resultnum accout accoutType loginType 说明 使用固定12字符长度，保证在对应业务内全局唯一性 十进制数字，表示一个文件中log消息的个数，取值范围1至40000 用户上网使用的帐号或上网使用的手机号 1.固网 2.移动网 上网方式： 1. 拨号上网方式 第55页 2. 移动上网方式 3. WLAN上网方式 4. 其它上网方式 priIP srcIp srcPort dstIp dstPort accessTime URL LAC SAC 8.2 日志重报接口 日志重报接口用于日志上报网关以特定条件向数据合成服务器查询用户上网日志文件，数据合成服务器收到该查询请求后，将符合特定条件的用户上网日志文件通过本规范8.1节定义的日志上报接口上报给日志上报网关。用户上网日志文件的格式请参考本规范8.1.2节。 8.2.1 接口协议 用户私网IP，点分十进制表示 NAT后公网源IP地址，点分十进制表示 NAT后源端口，十进制表示 NAT后公网目的IP地址，点分十进制表示 NAT后目的端口，十进制表示 使用yyyy-MM-dd hh:mm:ss表示 访问的URL，对于http、https之外的协议，该字段为空 对于4G系统该字段填充TAC信息 服务区域码信息，对于4G系统该字段置为空 该接口采用HTTP协议，要求HTTP的版本为1.1以上。日志上报网关以HTTP的POST方法下发重报请求消息给数据合成服务器，数据合成服务器收到该请求消息之后向日志上报网关返回重报响应消息，同时通过日志上报接口传送重报文件 数据合成服务器应开放Web服务完成协议流程，Web服务端口为80. 接口访问形式为： Http://UserLog_GATEWAY_IP:Port/IF_ReUpload_IPTrace / 其中： - Userlog_GATEWAY_IP：标识数据合成服务器接收用户上网日志重报请求的IP地址。 - Port：标识数据合成服务器接收用户上网日志重报请求的端口号。 - IF_ReUpload_IPTrace：标识用户上网日志重报接口的名称，指定本接口为用户上网日志重报接口。 8.2.2 接口流程 接口消息流程如下图所示： 第56页 日志上报网关 数据合成服务器 用户上网日志重报请求消息 用户上网日志重报响应消息 图8. 日志重报接口消息流程 流程说明如下： 1) 日志上报网关使用HTTP协议将重报请求发送给数据合成服务器； 2) 数据合成服务器收到请求后应在10秒内给日志上报网关回复响应消息，并指明 是否能够进行重报； 3) 数据合成服务器执行重报，将规定时间段的用户上网日志文件按照上网日志上 报接口上传到日志上报网关。 8.2.3 消息结构 用户上网日志重报请求消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 字段名 id beginFilename endFilename 用户上网日志重报响应消息采用XML格式，消息结构定义如下： 第57页 说明 数字，保证在对应业务内的全局唯一性 重报开始文件，必填 重报结束文件，必填 各字段说明如下表所示： 字段名 id resultCode failReason 8.3 用户在线状态查询及上传接口 网络日志服务器通过HTTP协议向数据合成服务器下发用户在线状态查询请求，数据合成服务器接收到请求，对满足在线状态查询条件的用户进行用户在线状态查询，一旦用户上线，通过用户在线状态信息上传接口将用户上线信息通过HTTP协议上报给网络日志服务器。 数据合成服务器可根据采集解析设备实时上报的单接口XDR及原始码流数据判断用户是否在线。 8.3.1 接口协议 1：成功 2：失败 失败原因 说明 数字，和用户上网日志重报请求消息的id相等 该接口基于HTTP协议，要求HTTP的版本为1.1以上，接口传递的数据以XML的形式进行封装。 对于用户在线状态查询接口，日志上报网关通过POST方法下发用户在线状态查询请求消息。 用户在线状态查询接口访问形式为： Http://Network_Element_IP:port/IF_USERSCOUT/ 其中： - Network_Element_IP：标识数据合成服务器用于用户在线状态查询服务的IP地址； - Port：标识数据合成服务器用于用户在线状态查询服务的端口号； - IF_USERSCOUT：标识用户在线状态查询接口的名称。 日志上报网关通过该接口下发用户在线状态查询请求。 对于用户在线状态上传接口，数据合成服务器以POST方法上报用户上线信息。 用户在线状态上传接口访问形式为： Http://UserLog_GATEWAY_IP:Port/IF_URMUpload/ 其中： - Userlog_GATEWAY_IP：标识日志上报网关用于接收用户上线消息的IP地址； - Port：标识日志上报网关用于接收用户上线消息的端口号； - IF_URMUpload：标识用户上线消息上报接口的名称。 数据合成服务器通过该接口上报用户上线信息。 8.3.2 接口流程 用户在线状态查询及上传接口的消息流程如下图所示： 第58页 数据合成服务器日志上报网关1. 用户在线状态查询请求(URMRequest)IF_USERSCOUT2. 用户在线状态查询响应(URMResponse)3.用户在线状态查询请求接收效果上报信息4. 用户上线信息(URMUpload)IF_URMUpload5. 用户上线信息接收响应(URMUploadResponse) 图9. 用户在线状态查询及上传接口消息流程 流程说明如下： 1) 数据合成服务器接收到日志上报网关下发的用户在线状态查询请求，请求中携带必 要的在线状态查询入口参数； 2) 数据合成服务器接收到的用户在线状态查询请求之后，解析在线状态查询请求，得 到相应的在线状态查询条件，构造用户在线状态查询响应消息返回至日志上报网关； 3) 数据合成服务器上报用户在线状态查询请求接收效果信息至日志上报网关； 4) 数据合成服务器依据在线状态查询条件，在线状态查询用户上线信息，用户一旦上 线，就将满足在线状态查询条件的用户上网日志文件上传给日志上报网关； 5) 接收到用户上线信息后，日志上报网关向数据合成服务器服务器返回用户上线信息 上报响应消息。 8.3.3 消息结构 8.3.3.1 用户在线状态查询请求消息（URMRequest） URMRequest消息采用XML格式，消息结构定义如下： 第59页 string 可选 用户在线状态查询响应（URMResponse） URMResponse消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 字段名 id resultCode failReason 8.3.3.3 查询请求接收效果信息上报消息 类型 int string string 约束 必选 必选 必选 1：成功 2：失败 失败原因 说明 和用户在线状态查询请求消息中的id相等 查询请求接收效果信息上报消息采用XML格式，消息结构定义如下： 第60页 各字段说明如下表所示： 字段名 id resultCode 类型 int int 约束 必选 必选 1：成功 2：失败 3：部分成功 当resultCode为3时，把失败网元通过failist上报，网元通过逗号分割 说明 和用户在线状态查询请求消息中的id相等 failList 8.3.3.4 string 可选 用户上线信息上报消息（URMUpload） URMUpload消息采用XML格式，消息结构定义如下： 字段名 resultnum id account accountType onlineTime loginType 类型 int int string int string int 约束 必选 必选 必选 必选 必选 必选 说明 十进制数字，表示userOnline消息的个数，取值范围1至100。 需保证在对应业务内的全局唯一性 被监测用户账号 用户账号类型： 1：固网账号 2：手机号码 使用yyyy-MM-dd hh:mm:ss表示 1. 拨号上网方式 2. 移动上网方式 3. WLAN上网方式 第61页 4. 其它上网方式 IpAddr 8.3.3.5 用户上线信息上报响应消息（URMUploadResponse） string 必选 点分十进制表示，互联网用户使用NAT转换方式上网的填写私有IP地址、否则填写公网IP地址 URMUploadResponse消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 字段名 id 类型 int 约束 必选 说明 和对应的用户上线信息上报消息中的id相等 1：成功 2：失败 错误原因，当resultCode=1时为空 resultCode failReason 8.4 int string 必选 必选 告警事件上报接口 数据合成服务器使用告警事件上报接口向日志上报网关上报告警事件。 8.4.1 接口协议 日志上报网关提供Web服务，接收数据合成服务器以HTTP协议的POST方法上报告警事件消息，Web服务端口暂定80。 该接口采用基于HTTP协议，要求HTTP的版本为1.1以上。数据合成服务器通过HTTP的POST方法以XML文件上报告警事件消息给日志上报网关。 接口访问形式为： Http://IPTrace_GateWay_IP:Port/IF_WIUPLOAD / WAP_GW /Province/Equ_No 其中： - IPTrace_GateWay_IP：标识日志上报网关用于接收告警事件信息的IP地址； - Port：标识日志上报网关用于接收告警事件信息的端口号； - IF_WIUPLOAD：标识告警事件上报接口的名称。 数据合成服务器通过该接口上报告警事件信息。 8.4.2 接口流程 流程如下图所示： 第62页 日志上报网关 数据合成服务器 告警事件消息 告警事件响应消息 图10. 告警事件上报接口消息流程 流程说明如下： 1) 数据合成服务器在检测到告警事件时，应在60秒内，发送告警事件消息到日志上报 网关，如果失败或没有收到响应消息则进行重传，重传的最大次数是3次。 2) 日志上报网关收到告警事件消息后应该在10秒内反馈告警事件响应消息给数据合 成服务器。 8.4.3 消息结构 告警事件消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 字段名 id 0：其它情况 1：硬件 2：软件 alarmType 3：网络 4：系统启动（主要是用于系统启动后日志上报网关把在线状态查询列表重新下发） 使用yyyy-MM-dd hh:mm:ss表示 非空字符串，应使用有意义的文字描述告第63页 说明 数字，保证在对应业务内的全局唯一性； alarmTime alarmDesc 警事件 数据合成服务器上报的告警信息包括： a) CPU使用率过高告警，暂定阈值80%，即alarmType为1、alarmDesc为“CPU使 用率85%超过阈值” （85%为具体值）； b) 内存剩余可用空间小于阈值告警，暂定阈值200MB，即alarmType为1、alarmDesc为“内存剩余可用空间为190MB低于阈值” （190MB为具体值）； c) 系统空闲率过低告警，暂定阈值15%，即alarmType为1、alarmDesc为“系统Idle值为12%低于阈值” （12%为具体值）； d) 磁盘分区使用率大于阈值告警，暂定阈值90%，即alarmType为1、alarmDesc为“磁盘分区：具体名称 使用率91%大于阈值”（91%为具体值）； 告警事件响应消息采用XML格式，消息结构定义如下： 各字段说明如下表所示： 字段名 id resultCode failReason 0：其它情况 1：成功 2：失败 错误原因 说明 数字，和对应的告警事件消息的id相等 9 至上网日志查询系统接口 数据合成服务器能够根据采集解析服务器实时上报的单接口XDR及原始码流数据生成用户查询日志并进行保存。上层的上网日志查询系统能够向数据合成服务器下发对用户查询日志的查询请求，之后数据合成服务器将用户查询日志上报给上网日志查询系统。 数据合成服务器针对上网日志查询系统的查询日志需求，需要支持以下应用协议（包含但不限于）：http、https、ftp、smtp、imap、pop3、dns、snmp等。此外，本节定义的用户查询日志与本规范第8节中定义的用户上网日志是两种不同的日志文件，两者所面向的应用系统是不同的。 第页 9.1 接口流程 用户上网日志查询系统数据合成服务器1.用户信息查询请求（UDRQueryRequest）IF_QUERY2.用户信息查询响应（UDRQueryResponse）IF_UPLOAD3.用户查询日志传输（FTP方式）4.用户信息上报完毕通知（UDRNotifyRequest）IF_NOTIFY5.用户信息上报完毕响应（UDRNotifyResponse） 图11. 至上网日志查询系统接口消息流程 流程说明： 1) 用户上网日志查询系统通过IF_QUERY接口，向数据合成服务器发起用户信息查询请 求，请求中携带必要的查询入口参数； 2) 数据合成服务器接收并解析接收到的用户信息查询请求，构造响应消息返回至用户 上网日志查询系统； 3) 数据合成服务器依据查询条件检索本地存储的用户查询日志记录数据，通过 IF_UPLOAD接口，向用户上网日志查询系统上传满足查询条件的用户查询日志文件； 4) 数据合成服务器上传完满足查询条件的用户查询日志文件后，通过IF_NOTIFY接口 向用户上网日志查询系统发送用户查询日志上报完毕通知请求，通知对端已经完成查询操作； 5) 用户上网日志查询系统接收到用户查询日志上报完毕通知请求后，向数据合成服务 器返回响应消息。 9.2 接口协议 9.2.1 IF_ QUERY（用户信息查询接口） 用户上网日志查询系统通过IF_QUEREY接口，向数据合成服务器发送用户信息查询请求（UDRQueryRequest），请求中携带查询的入口参数；数据合成服务器处理后向用户上网日志查询系统返回对应的响应信息（UDRQueryResponse）。 第65页 该接口基于HTTPS协议，要求HTTP的版本为1.1以上，接口传递的数据以XML的形式进行封装，以HTTP承载XML的方式通信。 接口访问形式为： Https://Network_Element_IP:Port/IF_QUERY/ 其中： - Network_Element_IP：标识数据合成服务器提供查询服务的IP地址； - Port：标识数据合成服务器提供查询服务的端口号； - IF_QUERY:标识查询接口的名称，指定本接口为用户信息查询接口； 要求数据合成服务器在访问控制白名单中预先配置用户上网日志查询系统的有效IP地址。在接收查询请求时，需对请求消息的源IP地址进行合法性判断，满足访问控制白名单内的源IP地址予以查询处理和应答；对于源IP地址不在访问控制白名单内的查询请求，要求数据合成服务器不进行查询处理和应答，以保证用户查询日志数据的安全性。 9.2.2 IF_UPLOAD（用户信息上报接口） 数据合成服务器通过IF_UPLOAD接口，向用户上网日志查询系统上报满足查询条件的用户查询日志数据。 接口基于FTP协议。数据合成服务器作为FTP Client，用户上网日志查询系统开启FTP Server功能。接口访问URL形式为 FTP://UserLog_Platform_IP:Port/IF_UPLOAD/ServiceType/ 其中： - Userlog_Platform_IP：标识用户上网日志查询系统提供用户上网查询日志数据上 传服务的IP地址； - Port：标识用户上网日志查询系统提供用户上网查询日志数据上传服务的端口号； - IF_UPLOAD：标识查询接口的名称，指定本接口为用户日志上报接口； - ServiceType：标识上传数据来源的业务系统，需要根据不同的业务系统进行区分， 其取值如下： WAP_GW： 表明此路径下为WAP网关上报的数据 PS_Log_Server：表明此路径下为数据合成服务器上报的数据 WLAN_Radius：表明此路径下为WLAN Radius服务器上报的数据 在发起上传操作之前，数据合成服务器应通过系统分配的用户名和密码登录用户上网日志查询系统的FTP服务器。 9.2.3 IF_NOTIFY（用户信息上报完毕通知接口） 数据合成服务器通过IF_UPLOAD接口，向用户上网日志查询系统上传完满足查询条件的用户信息后，需基于IF_NOTIFY接口发送用户信息上报完毕通知消息(UDRNotifyRequest)通知用户上网日志查询系统用户数据的上传状态，通知消息中携带相关参数，用户上网日志查询系统向数据合成服务器返回对应用户信息上报完毕响应(UDRNotifyResponse)。 该接口采用HTTPS协议，要求HTTP的版本为1.1以上，接口传递的数据以XML的形式进行封装，以HTTP承载XML的方式通信。 接口访问形式为： Https://UserLog_Platform_IP:Port/IF_NOTIFY/ 其中 第66页 - - - Userlog_Platform_IP：标识用户上网日志查询系统提供接收上报完毕通知消息的IP地址； Port：标识用户上网日志查询系统提供接收上报完毕通知消息的端口号； IF_NOTIFY：标识查询接口的名称，指定本接口为用户信息上报完毕通知接口。 9.3 消息结构 9.3.1 用户信息查询请求消息（UDRQueryRequest） UDRQueryRequest消息的协议数据单元（PDU）由消息头（Header）和消息体（body）组成，其中消息头满足标准HTTP1.1协议的HTTP Header要求。 UDRQueryRequest消息的XML格式如下： UDRQueryRequest消息字段定义如下所示： 字段名 类型 约束 说明 查询请求的序列号标识，由用户上网日志查询系统生成，格式为 yyyy-mm-dd-hh-mi-ss-nnnnn 其中nnnnn标识位的序号，由00000起始依次递增 用户使用的公网IP地址 用户使用的公网端口号 第67页 EventID string 必选 SourceIP SourcePort string string 可选 可选 StartTime Endtime DestinationURL DestinationIP DestinationPort MSISDN 9.3.2 用户信息查询响应消息（UDRQueryResponse） string string string string string string 必选 必选 可选 可选 可选 可选 查询起始时间，格式为 yyyy-mm-dd-hh-mi-ss 查询结束时间，格式为 yyyy-mm-dd-hh-mi-ss 用户访问的目标网站URL 用户访问的目标IP地址 用户访问的目标端口号 被查询用户的手机号码 UDRQueryResponse消息的XML格式如下： UDRQueryResponse消息字段定义如下所示： 字段名 类型 约束 说明 查询请求的序列号标识，由”用户上网日志查询系统”生成，格式为 yyyy-mm-dd-hh-mi-ss-nnnnn 其中nnnnn标识5位的序号，由00000起始依次递增 用户查询信息接收结果： 00：查询条件正确； 01：查询条件错误； 02：解析错误； 03：系统繁忙； 04：其他 EventID string 必选 AcceptResult string 必选 9.3.3 用户信息上报完毕通知消息(UDRNotifyRequest) UDRNotifyRequest消息的XML格式如下： 第68页 UDRNotifyRequest消息字段定义如下所示： 字段名 类型 约束 说明 查询请求的序列号标识，由用户上网日志查询系统生成，格式为 yyyy-mm-dd-hh- mi-ss-nnnnn 其中nnnnn标识5位的序号，由00000起始依次递增 用户信息查询结果： 00：查询到满足查询条件的用户信息，用户信息上传完毕； 01：未查询到满足查询条件的用户信息； 02：上传失败； 03：其他 仅在SearchResult=00时生效，表示查询所有文件中用户信息记录的条数； 仅在SearchResult=00时生效，表示返回的文件数目； 数据合成服务器向用户上网日志查询系统上传用户数据的路径，仅在SearchResult=00时生效，包含服务器绝对路径、文件名等信息，例如FTP://UserLog_Platform_IP:port/IF_UPLOAD/ServiceType/XXXX，XXXX为文件名 该文件名不包含序列号SEQ。 EventID string 必选 SearchResult string 必选 RecordNumber FileNumber string string 可选 可选 FTPPath string 可选 9.3.4 用户信息上报完毕响应消息(UDRNotifyResponse) UDRNotifyResponse消息的XML格式如下。 第69页 UDRNotifyResponse消息字段定义如下所示： 字段名 类型 约束 说明 查询请求的序列号标识，由”用户上网日志查询系统”生成，格式为 yyyy-mm-dd-hh-mi-ss-nnnnn 其中nnnnn标识5位的序号，由00000起始依次递增 用户上网日志查询系统返回的通知消息的结果： 00：成功； 01：失败； EventID string 必选 NotifyResult string 必选 9.4 文件格式 9.4.1 文件命名规则 用户查询日志文件需命名为PSLogServer_EventID.SEQ。 其中各字段的说明如下： 字段名 说明 代表用户上网日志查询系统查询的序列号标识，对应“用户信息查询请求消息”中的EventID字段 描述同一个查询返回的文件顺序号，若查询结果被分割成多个文件则其流水号必须不同，并且从001依次递增，如： 001、002、003 PSLogServer 代表用户信息上报来源为4G系统数据合成服务器，固定值为PSLogServer EventID SEQ 9.4.2 文件格式规则 用户查询日志采用文本文件格式，文件编码格式统一为UTF-8编码。以行区分不同记录，即一行代表一个用户的一条记录，各字段之间以符号“|”分隔。 用户查询日志的格式如下表所示： 第70页 字段名 StartTime EndTime MsId NAT_CleintIP NAT_CleintPort DestinationURL DestinationIP DestinationPort ClientMAC ClientIP ClientPort ApId APN 9.4.3 文件生成规则 说明 用户访问SP的时间，格式为 Yyyymmddhhmiss（24小时制） 用户收到SP响应的时间，格式为 Yyyymmddhhmiss（24小时制） 用户手机号码MSISDN 经过NAT转换后的用户公网IP地址 经过NAT转换后的用户公网端口号 表示用户访问的目标网站的URL。对于http、https之外的协议，该字段为空 用户访问的目标IP地址 用户访问的目标端口号 为空 用户的私网IP地址 用户的私网端口号 为空 接入的APN信息，如CMNET、CMTDS 数据合成服务器在向用户上网日志查询系统上报用户查询日志文件时，可根据配置的文件大小门限或记录条数触发产生上报文件。即文件可以按照记录条数、预设的文件大小触发，例如5000条记录生成一个用户查询日志文件，或数据文件超过2M时生成一个用户查询日志文件。 要求文件大小门限和记录条数可根据需求灵活配置。 用户查询日志文件在上传之前须进行压缩，压缩格式为gzip。 10 至手机恶意软件监测系统样本监测采集模块（DA）上报及重报接口 具体接口要求需遵循《中国移动手机恶意软件监测系统接口规范》。 11 与防火墙日志采集前置机接口（南向接口） 数据合成服务器支持通过FTP协议接收防火墙日志采集前置机主动上传的防火墙NAT日志文件。此时，数据合成服务器为Server端，防火墙日志采集前置机为客户端。要求上传周期可配置。 同时，数据合成服务器支持通过FTP协议从防火墙日志采集前置机下载防火墙NAT日志文件。数据合成服务器能够周期性访问防火墙，下载约定目录的文件。此时，数据合成服务器为客户端，防火墙日志采集前置机为Server端。要求访问周期可配置。 第71页 数据合成服务器可以依据XDR中用户的私网IP地址、起至时间等信息来关联对应的防火墙NAT日志文件，从而可以获得NAT后的用户IP地址和端口信息。 记录类型 防火墙NAT日志 关键信息 时间；源私网IP、源私网端口；目标IP、目标端口；NAT后的IP地址和端口 12 编制历史 更新时间 2014.3.31 2014.5.20 主要内容或重大修改 完成初稿 修改规范名称，修改系统架构图，增加至指定系统接口要求，增加与手机恶意软件监测系统样本监测采集模块（DA）上报及重报接口要求 增加第5章数据上报接口中的KPI数据通知消息，增加第6章的KPI数据订阅接口，增加附录A/B/C 增加第7章至经分系统接口 增加第9章至上网日志查询系统接口 增加基于http、https、ftp、smtp、imap、pop3、dns、snmp等协议的用户上网日志上报及查询的要求，对第7、8、9章的接口定义增加了详细说明 合成信令XDR中增加SMS流程类型，修改系统架构图，修改合成UE_MR XDR格式，修改合成信令XDR中部分字段，更新附录C文档 版本号 1.0.0 2.0.0 2.0.2 2014.6.4 2.0.3 2.0.4 2.0.6 2014.6.10 2014.6.13 2014.7.21 2.0.7 2014.8.11 附录A 合成信令流程的起止时间说明 合成信令事件流程说明.docx 附录B WebService结果取值定义 下表为WebService相关结果取值定义： 第72页 结果名称 成功 鉴权失败 格式错误 内容错误 用户名错误 码值 1 2 3 4 5 描述 代表成功。 授权密钥失效或者没有得到授权时，返回此值。 请求消息格式错误时，返回此值。 请求消息内容错误时，返回此值。 授权请求消息中携带的用户名在共享平台中不存在时，返回此值。 密码错误 6 授权请求消息中携带的密码在共享平台中错误时，返回此值。 资源查询失败 订单编号错误 订单过期 7 8 9 资源查询请求时，如果失败，则返回此值。 修改、查询、取消操作输入的订单编号错误时返回此值。 修改、查询、取消订单请求时，若此订阅已经结束（即为该订阅结束时间小于当前时间、应用系统或信令监测系统已经取消该订阅），则返回此值。 系统故障 10 共享平台系统故障，此时无法处理应用系统的请求消息时，返回此值。 重复请求授权 KPI指标反查数据量超出范围 <待补充指标订阅相关原因值> 11 12 密钥未失效时，返回此值 查询的指标数据量超出平台定义的上限时，返回此值 附录C KPI指标定义 LTE信令采集指标规LTE信令采集指标规范(第一册 跨接口面范(第二册 基于单接 第73页 附录D 省份代码表 代号 AH BJ CQ FJ GD GS GX GZ HA HB HE HI HL HN JL JS JX LN NM NX QH SC SD SH SN SX TJ XJ XZ YN ZJ 名称 安徽 北京 重庆 福建 广东 甘肃 广西 贵州 河南 湖北 河北 海南 黑龙江 湖南 吉林 江苏 江西 辽宁 内蒙古 宁夏 青海 四川 山东 上海 陕西 山西 天津 云南 浙江 附录E 网关设备代码表 网关设备名称 网关设备代号举例 YDTJWXXXXX 说明 第一二位为运营商代号；第三第74页 移动某网关设备 YDSHPXXXXX 四位为省份代号；第五位为设备类型（W-wap网关，P-PDSN网关，G-GGSN网关，Q-其他）；后五位为网关设备编号，必须为大写字母或数字，或者组合，保证唯一性。 第75页 网元1,网元2,…,网元N
因篇幅问题不能全部显示，请点此查看更多更全内容
Copyright © 2019- fenyunshixun.cn 版权所有 湘ICP备2023022495号-9
违法及侵权请联系：TEL:199 18 7713 E-MAIL:2724546146@qq.com
本站由北京市万商天勤律师事务所王兴未律师提供法律服务