中国移动上网日志留存系统数据合成服务器接口规范DOC 40页.docx
《中国移动上网日志留存系统数据合成服务器接口规范DOC 40页.docx》由会员分享，可在线阅读，更多相关《中国移动上网日志留存系统数据合成服务器接口规范DOC 40页.docx（51页珍藏版）》请在冰豆网上搜索。
中国移动上网日志留存系统数据合成服务器接口规范DOC40页
中国移动上网日志留存系统数据合成服务器接口规范（DOC40页）
中国移动通信企业标准
QB-╳╳-╳╳╳-╳╳╳╳
中国移动上网日志留存系统数据合成服务器接口规范（CS域）
InterfaceSpecificationofChinaMobile
NetlogSystem
（DataCombiningServerPart）
版本号：
1.0.0
╳╳╳╳-╳╳-╳╳实施
╳╳╳╳-╳╳-╳╳发布
中国移动通信集团公司发布
1
2
3
前言
本标准规定了中国移动上网日志留存系统数据合成服务器与其他相关网元设备和应用系统连接的接口标准，以及系统内部需要公开定义的各种接口。
本标准原则上在中国移动通信集团公司内部使用，为业务开展、招标选型、工程建设及运行维护提供技术依据，适用于2G/3G网络环境。
本标准主要包括以下几方面内容：
系统结构、接口协议。
本标准是中国移动上网日志留存系统三期系列标准之一，该系列标准的结构、名称或预计名称如下：
序号
标准编号
标准名称
发布单位
[1]
中国移动上网日志留存系统总体技术要求
中国移动通信集团公司
[2]
中国移动上网日志留存系统Gn采集解析设备规范
中国移动通信集团公司
[3]
中国移动上网日志留存系统Gb/Iu-Ps采集解析设备规范
中国移动通信集团公司
[4]
中国移动上网日志留存系统防火墙日志采集前置机数据传递要求
中国移动通信集团公司
[5]
中国移动上网日志留存系统数据合成服务器设备规范（CS域）
中国移动通信集团公司
[6]
中国移动上网日志留存系统数据合成服务器设备规范（PS域）
中国移动通信集团公司
[7]
中国移动上网日志留存系统数据合成服务器接口规范（CS域）
中国移动通信集团公司
[8]
中国移动上网日志留存系统数据合成服务器接口规范（PS域）
中国移动通信集团公司
[9]
中国移动上网日志留存系统网络日志服务器设备规范
中国移动通信集团公司
[10]
中国移动上网日志留存系统网络日志服务器接口规范
中国移动通信集团公司
[11]
中国移动上网日志留存系统用户上网日志查询系统设备规范
中国移动通信集团公司
[12]
中国移动上网日志留存系统用户上网日志查询系统接口规范
中国移动通信集团公司
[13]
中国移动上网日志留存系统日志上报网关系统设备规范
中国移动通信集团公司
[14]
中国移动数据流量DPI识别能力规范
中国移动通信集团公司
[15]
中国移动信令监测系统接口规范—信令采集网关分册
中国移动通信集团公司
[16]
中国移动IDC/ISP信息安全管理系统接口规范
中国移动通信集团公司
[17]
中国移动手机恶意软件监测系统接口规范
中国移动通信集团公司
[18]
中国移动性能管理系统数据接口规范－数据业务监测与分析系统分册
中国移动通信集团公司
[19]
中国移动性能管理系统数据接口规范－信令监测系统分册
中国移动通信集团公司
[20]
《中国移动性能管理系统数据源接口规范》
中国移动通信集团公司
[21]
集中化经分系统与日志上报网关接口规范
中国移动通信集团公司
[22]
中国移动上网日志留存系统“金库模式”实施指导意见
中国移动通信集团公司
本标准由中国移动通信集团公司网络部提出，集团公司技术部归口。
本标准起草单位：
中国移动通信集团网络部
本标准主要起草人：
邢喆、赵辉、赵恒、刘坤、柏洪涛、周维、卫涛、韦薇、李心恬
1范围
本标准规定了中国移动上网日志留存系统数据合成服务器与其他相关网元设备和应用系统连接的接口标准，以及系统内部需要公开定义的各种接口，是开展上网日志留存系统三期建设的技术规范，为业务开展、招标选型、工程建设及运行维护提供技术依据。
本标准原则上在中国移动通信集团公司内部和厂商共同使用，适用于2G/3G网络环境。
2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本标准。
表2-1规范性引用文件
序号
标准编号
标准名称
发布单位
[1]
总体技术要求
中国移动通信集团公司
[2]
Gb/Iu-Ps采集解析设备规范
中国移动通信集团公司
[3]
数据合成服务器接口规范
中国移动通信集团公司
[4]
数据合成服务器设备规范（含与Gn/Gb/Iu-Ps/LTE的接口规范）
中国移动通信集团公司
[5]
客户信息保密管理规定
中国移动通信集团公司
[6]
GSM通信网路由组织与局数据设置原则（第二分册：
GSM通信网网元数据设置原则）
中国移动通信集团公司
[7]
新业务系统通用技术要求
中国移动通信集团公司
[8]
防火墙部署总体技术要求V1.0.0
中国移动通信集团公司
[9]
中国移动网管系统监控平台需求规范
中国移动通信集团公司
[10]
中国移动网管系统监控平台推广阶段技术规范
中国移动通信集团公司
[11]
中国移动网管支撑系统总体规划
中国移动通信集团公司
[12]
中国移动综合网络资源管理系统技术规范
中国移动通信集团公司
[13]
YD/T1303-2004
No.7信令监测系统技术要求
中华人民共和国信息产业部
[14]
TS08.08v8.15.0
Mobile-servicesSwitchingCentre-BaseStationSystem（MSC-BSS）Interface，Layer3Specification
3GPP
[15]
TS09.02v7.14.0
MobileApplicationPart（MAP）Specification
3GPP
[16]
TS44.018
Mobile radio interface layer 3 specification;
Radio Resource Control （RRC） protocol
3GPP
[17]
TS24.008
Mobile radio interface Layer 3 specification;
Core network protocols; Stage 3
3GPP
[18]
TS24.011
Point-to-Point （PP） Short Message Service （SMS）
support on mobile radio interface
3GPP
[19]
TS48.008
Mobile Switching Centre - Base Station System（MSC-BSS） interface;Layer 3 specification
3GPP
[20]
TS48.006
Signalling transport mechanism specification
for the Base Station System -Mobile-services Switching Centre （BSS - MSC） interface
3GPP
[21]
TS52.008
GSM subscriber and equipment trace
3GPP
[22]
TS52.021
Network Management （NM） procedures and messages
on the A-bis interface
3GPP
[23]
TS49.031
Base Station System Application Part
LCS Extension （BSSAP-LE）
3GPP
[24]
TS25.413
UTRAN Iu interface
Radio Access Network Application Part （RANAP） signalling
3GPP
[25]
ITU-TQ.752
MonitoringandMeasurementsforSignallingSystemNo.7Networks
ITU
3术语、定义和缩略语
“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。
-“必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求；对应于RFC2119MUST，REQUIRED，SHALL。
-“推荐”/“建议”/“应”项是指在标准中未作强制要求，若业务、产品和设备提供的功能或性能要求被认为更佳；对应于RFC2119RECOMMENDED，SHOULD。
-“可选”/“可”项指参考性要求，是业务、产品和设备在目前阶段可不提供的功能或性能要求；对应于RFC2119MAY，OPTIONAL。
-必不能，不能，不得：
表示绝对的禁止；对应于RFC2119MUSTNOT，SHALLNOT。
-不推荐，不建议：
表示若业务、产品和设备按照所述内容制作，被认为略次；对应于RFC2119SHOULDNOT，NOTRECOMMENDED。
-规范中除了明确指明为“推荐”/“建议”、“可选”外，均为必须要求。
表3-1词语解释
词语
解释
应用层
对获取信令监测系统提供数据的信令应用系统的统称
CDR/TDR信令数据数据
CDR/TDR信令数据是指基于全量信令数进行处理后，生成的供上网日志留存及信令监测类应用使用的呼叫及事务详细记录。
AD
ApplicationDomain，应用层
CC
CallControl，呼叫控制
DDU
DataDispatchUnit，数据分发单元
DXC
DigitalCrossConnect，数字交叉设备
GRSAP
GRSApplicationPart，漫游欢迎系统应用部分
HDLC
High-LevelDataLinkControl，高级数据链路控制规程
IE
InformationElement，信令消息中的信息单元
IP
InternetProtocol，IP协议
MCIP
MobileCell，小区短信应用部分
MM
MobilityManagement，移动性管理
ODBC
OpenDatabaseConnectivity，开放数据库连接
OMC
OperationManagementCenter，系统管理单元
RR
RadioResource，无线资源管理
SAU
SignalAnalysisUnit，信令分析单元
SCG
SignalCollectionGateway，信令采集网关
SDTP
SharedDataTransferProtocol，共享数据传输协议
SDU
SharedDataUnit，共享数据单元
SMU
ServiceManagementUnit，业务/服务管理单元
SNMP
SimpleNetworkManagementProtocol，简单网络管理协议
SOA
Service-OrientedArchitecture，面向服务的体系架构
SPU
SignalPreprocessUnit，信令预处理单元
SU
StoreUnit，存储单元
TAP
TestAccessPoint，测试接入端口
CDR
CallDetailRecord，呼叫详细记录
TDR
TransactionDetailRecord，事务详细记录
MSISDN
MobileStationIntegratedServicesDigitalNumber，移动用户ISDN号码
4接口在网络中的位置
4.1系统描述及系统结构图
系统分为四层：
数据采集层：
数据采集层的主要功能是实现Gn、防火墙、Gb/Iu-PS等接口数据的采集，并完成对采集数据的解析，生成原始XDR。
数据解析层:
数据解析层的主要功能是对采集的Mc接口原始信令进行解码，生成XDR等；对Gn、防火墙、Gb/Iu-PS等接口采集生成的原始XDR进行分析，合成相关系统所需的目标XDR。
共享层:
共享层的主要功能是完成日志数据的存储、查询等，并面向应用层提供灵活的转发接口。
应用层：
应用层包含各应用系统。
图4-1系统架构图
4.2接口功能
本规范重点定义了中国移动上网日志留存系统数据数据合成服务器与其他网元的数据通信机制。
图4-2系统接口示意图
接口功能描述如下：
●IF1-0：
可以兼容上网日志留存系统已有的业务接口，包括（文件接口、用户在线状态查询接口）。
命名规则：
IF1-0（IF1-0.1、IF1-0.2、IF1-0.3）用户在线状态查询请求接口：
基于HTTP承载XML的方式，应采用SSL方式保证信息传输的安全性，用户在线状态查询请求接口用于接收数据合成服务器转发的用户在线状态查询请求（URMRequest），请求中携带监测的入口参数；采集解析设备处理后向数据合成服务器返回对应的响应（URMResponse）。
为了向数据合成服务器反馈布控效果，采集解析设备还应发送布控效果上报信息至数据合成服务器。
⏹IF1-0.1：
文件接口：
采用FTP协议实现数据交换
⏹IF1-0.2数据合成服务器通过IF_USERSCOUT接：
转发共享层下发的用户在线状态查询请求给采集解析设备，请求中携带必要的监测入口参数
⏹IF1-0.3IF_URMUpload接口：
向数据合成服务器上传满足监测条件的用户上线信息文件，由数据合成服务器转发给共享层。
●IF1-1：
CS域数据采集层与解码层间的接口，主要用于传输全量信令数据（原始信令经IP化后的数据），该接口所采用的协议为SDTP（共享数据传输协议）。
数据合成服务器的MC链路数据来源为各省采集网关汇聚点，具体规范请参见《中国移动信令监测系统接口规范-信令采集网关分册v1.0.0》。
●IF1-2：
数据采集层与解码层间的接口，主要用于传输XDR记录以及XDR原始信令数据，该接口所采用的协议为SDTP（共享数据传输协议）。
●IF1-3：
数据采集层与解码层的交互式接口，可传输指定用户、设备或全量的原始数据。
本接口不对历史数据生效。
●IF2-0：
可以兼容上网日志留存系统已有的上网日志查询接口。
具体接口规范参考《用户上网日志查询系统接口规范》。
⏹IF2-0.1：
IF_QUERY，基于HTTP协议的用户信息查询接口
⏹IF2-0.2：
IF_UPLOAD,基于FTP/SFTP协议的用户信息上报接口
⏹IF2-0.3：
IF_NOTIFY，基于HTTP协议的用户信息上报完毕通知接口
●IF2-1：
共享层与应用系统之间的接口，主要用于传输全量信令数据（原始信令经IP化后的数据），该接口所采用的协议为SDTP（共享数据传输协议）或FTP。
●IF2-2：
共享层与应用系统之间的接口，主要用于传输XDR记录以及XDR原始信令数据，该接口所采用的协议为SDTP（共享数据传输协议）。
●IF6-1：
基于SDTP实现，上传CS域原始码流。
●IF6-2：
基于FTP/SDTP实现，上传CS域合成后的XDR数据及XDR对应的原始数据。
●IF6-3：
基于FTP/SDTP实现，上传PS域合成后的XDR文件。
5接口协议
5.1SDTP实时通信协议
SDTP为实时数据共享传输协议。
该协议是采集层与解码层的接口传输协议，也是解码层和共享层之间的接口传输协议。
其传输特点是数据传输量大，实时性要求高，过程简单，不需要握手鉴权过程。
SDTP实时数据共享传输协议应用于以下场景：
●解码层将合成后的PS域XDR数据封装后传送到共享层；
●解码层将CS域MC口XDR数据封装后传送到共享层；
●解码层将CS域MC原始码流封装后传送到共享层；
共享数据传输协议（SDTP）以TCP/IP作为底层通信承载，具体协议结构如下图所示：
图5-1信令数据传输协议栈
协议栈分为3层，分别为承载层、传输层和应用层。
其中，承载层为IP协议，它提供可靠的数据传输通道；传输层（SDTP+TCP）为上层应用提供通用的数据传输协议；应用层封装适合于各应用系统的原始信令数据、CDR/TDR数据。
数据合成服务器通过SDTP协议适配各应用系统所需的特定协议。
图5-2SDTP协议栈
数据提供方与数据接受方之间进行信息交互时，采用长连接方式：
●通信双方以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条。
●数据合成服务器需支持应用系统与接入模块之间的多个并发连接。
●考虑到数据的安全性，建议在应用系统和数据合成服务器间采用链路安全机制（如TLS、VPN等方式），可根据实际需求选择开启。
信令采集网关与数据合成服务器间基于SDTP传输全量信令数据时，SDTP层的重传机制和滑动窗口控制机制为可选，但客户端与服务器端的实现机制需保持一致。
5.1.1消息类型
SDTP协议的消息类型定义如下表所示：
表5-1消息类型定义
消息名
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
连接释放应答
notifyCDR/TDRData_Req
0x0005
CDR/TDR信令数据通知请求
notifyCDR/TDRData_Resp
0x8005
CDR/TDR信令数据通知应答
XDRRawDataSend_Req
0x0006
XDR对应原始数据传输
XDRRawDataSend_Resp
0x8006
XDR对应原始数据传输应答
linkDataCheck_Req
0x0007
链路数据发送校验请求
linkCheck_Resp
0x8007
链路数据发送校验应答
5.1.2消息结构
SDTP消息结构如下所示：
表5-2SDTP消息结构
项目
说明
MessageHeader
消息头（所有消息公共包头）
MessageBody
消息体，即各类参数
消息头（MessageHeader）的包含如下字段：
（对SDTP接口，下述所有字段必填）
表5-3消息头
字段名
字节数
类型
描述
TotalLength
2
UnsignedInteger
消息总长度（含消息头及消息体）
MessageType
2
UnsignedInteger
消息类型
SequenceId
4
UnsignedInteger
交互的流水号，顺序累加，步长为1，循环使用（一个交互的一对请求和应答消息的流水号必须相同）
TotalContents
1
UnsignedInteger
消息体中的事件数量（最多40条）
若考虑实时性要求，可每次只填一个事件
5.1.3连接管理流程
使用SDTP协议通信时，遵照本章的消息交互流程。
消息交互的基本流程分为：
版本协商，鉴权请求，数据传输，链路检测，连接终止。
客户端侧应支持对链路检测周期的灵活设定.
SDTP协议连接管理流程如下图所示：
图5-3SDTP数据传输协议流程
SDTP连接建立和通信流程说明如下：
（1）请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接；
（2）客户端发起版本协商流程，若协商失败，则转（7）拆除连接；
（3）客户端向服务端发起链路鉴权请求（使用数据合成服务器与各应用系统间协商好的共享密钥），若服务端鉴权失败，则转（7）拆除连接；
（4）请求的发起方发送数据，接收方收到数据并处理后回复处理结果；
（5）在连接保持期间，如果没有数据包发送，客户端发送链路检测/应答包以维持此连接；若发现链路断开，则转（7）拆除连接；
（6）通信完成后，客户端主动发起链路释放请求；
（7）双方均可拆除该连接；
5.1.4连接管理消息
5.1.4.1版本协商verNego
5.1.4.1.1请求
版本协商请求，用于在连接的鉴权通过后，客户端与服务器端协商通信协议版本的信息，由连接的建立方主动发起协议版本协商。
参数定义如下：
表5-4参数定义
字段名
字节数
类型
描述
Version
1
UnsignedInteger
协议的主版本号
SubVersion
1
UnsignedInteger
协议的子版本号
版本协商的发起方从自身支持的最高版本开始协商，高版本协商失败后再协商低版本。
5.1.4.1.2应答
版本协商应答，用于返回版本信息的核对结果，参数定义如下：
表5-5参数定义
字段名
字节数
类型
描述
Result
1
UnsignedInteger
返回原因值。
协议协商的结果，各个值代表意义如下：
1:
版本协商通过。
2:
版本过高。
3:
版本过低。
5.1.4.2链路认证linkAuth
5.1.4.2.1请求
连接鉴权请求，参数定义如下：
表5-6参数定义
字段名
字节数
类型
描述
Login
升级会员 