中国移动上网日志留存系统网络日志服务器接口规范标准详.docx
《中国移动上网日志留存系统网络日志服务器接口规范标准详.docx》由会员分享，可在线阅读，更多相关《中国移动上网日志留存系统网络日志服务器接口规范标准详.docx（41页珍藏版）》请在冰豆网上搜索。
中国移动上网日志留存系统网络日志服务器接口规范标准详
中国移动通信企业标准
中国移动上网日志留存系统网络日志服务器接口规范
InterfaceSpecificationofChinaMobile
NetlogSystem
（NetlogServerPart）
版本号：
1.0.0
前言
本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准，以及系统部需要公开定义的各种接口。
本标准原则上在中国移动通信集团公司部使用，为业务开展、招标选型、工程建设及运行维护提供技术依据，适用于GSM/3G网络环境。
本标准主要包括以下几方面容：
系统结构、接口协议、业务信令数据共享接口、CDR/TDR信令数据共享接口以及全量信令数据反查接口。
本标准是中国移动上网日志留存系统系列标准之一，该系列标准的结构、名称或预计名称如下：
序号
标准编号
标准名称
发布单位
[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]
QB-W-026-2011
中国移动IDC/ISP信息安全管理系统接口规
中国移动通信集团公司
[17]
中国移动手机恶意软件监测系统接口规
中国移动通信集团公司
[18]
中国移动性能管理系统数据接口规－数据业务监测与分析系统分册
中国移动通信集团公司
[19]
中国移动性能管理系统数据接口规－信令监测系统分册
中国移动通信集团公司
[20]
《中国移动性能管理系统数据源接口规》
中国移动通信集团公司
[21]
集中化经分系统与日志上报网关接口规
中国移动通信集团公司
[22]
中国移动上网日志留存系统“金库模式”实施指导意见
中国移动通信集团公司
本标准由中国移动通信集团公司网络部提出，集团公司技术部归口。
本标准起草单位：
中国移动通信集团网络部
本标准主要起草人：
邢喆、辉、恒、坤、柏洪涛、周维、卫涛、韦薇、心恬
1围
本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准，以及系统部需要公开定义的各种接口，是开展上网日志留存系统建设的技术规，为业务开展、招标选型、工程建设及运行维护提供技术依据。
本标准原则上在中国移动通信集团公司部和厂商共同使用，适用于GSM/3G网络环境。
2规性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件，其随后所有的修改单（不包括勘误的容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件，其最新版本适用于本标准。
表2-1规性引用文件
序号
标准编号
标准名称
发布单位
[1]
TS24.008
Mobile radio interface Layer 3 specification;
Core network protocols; Stage 3
3GPP
[2]
TS24.011
Point-to-Point （PP） Short Message Service （SMS）
support on mobile radio interface
3GPP
[3]
TS48.008
Mobile Switching Centre - Base Station System（MSC-BSS） interface;Layer 3 specification
3GPP
[4]
TS48.006
Signalling transport mechanism specification
for the Base Station System -Mobile-services Switching Centre （BSS - MSC） interface
3GPP
[5]
TS52.008
GSM subscriber and equipment trace
3GPP
[6]
TS52.021
Network Management （NM） procedures and messages
on the A-bis interface
3GPP
[7]
TS49.031
Base Station System Application Part
LCS Extension （BSSAP-LE）
3GPP
[8]
TS25.413
UTRAN Iu interface
Radio Access Network Application Part （RANAP） signalling
3GPP
[9]
ITU-TQ.752
MonitoringandMeasurementsforSignallingSystemNo.7Networks
ITU
3术语、定义和缩略语
“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。
-“必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求；对应于RFC2119MUST，REQUIRED，SHALL。
-“推荐”/“建议”/“应”项是指在标准中未作强制要求，若业务、产品和设备提供的功能或性能要求被认为更佳；对应于RFC2119RECOMMENDED，SHOULD。
-“可选”/“可”项指参考性要求，是业务、产品和设备在目前阶段可不提供的功能或性能要求；对应于RFC2119MAY，OPTIONAL。
-必不能，不能，不得：
表示绝对的禁止；对应于RFC2119MUSTNOT，SHALLNOT。
-不推荐，不建议：
表示若业务、产品和设备按照所述容制作，被认为略次；对应于RFC2119SHOULDNOT，NOTRECOMMENDED。
-规中除了明确指明为“推荐”/“建议”、“可选”外，均为必须要求。
表3-1词语解释
词语
解释
应用层
对获取信令监测系统提供数据的信令应用系统的统称
全量信令数据
全量信令数据包含了被采集信令链路的全部信令容
CDR/TDR信令数据数据
CDR/TDR信令数据是指基于全量信令数进行处理后，生成的供信令监测类应用使用的呼叫及事务详细记录。
业务信令数据
业务信令数据是根据应用的需要对CDR/TDR信令数据进行解析、处理，从中提取出对业务应用所需的信令事件数据，例如：
呼叫事件、位置更新事件、漫游事件等
指标数据
指标数据是根据信令监测系统生成的CDR/TDR或者信令消息统计生成的各类Kpi指标数据，例如：
接通率、位置更新成功率等
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接口在网络中的位置
5系统描述及系统结构图
系统架构图如下图所示。
图4-1系统架构图
网络日志服务器是中国移动日志留存系统的四层架构中的第三层。
6接口功能
本规重点定义了中国移动上网日志留存系统网络日志服务器与应用层IF2相关接口的数据通信机制。
图4-2系统接口示意图
接口功能描述如下：
●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（共享数据传输协议）。
7接口协议
7.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层的重传机制和滑动窗口控制机制为可选，但客户端与服务器端的实现机制需保持一致。
7.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
链路数据发送校验应答
7.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条）
若考虑实时性要求，可每次只填一个事件
7.1.3连接管理流程
使用SDTP协议通信时，遵照本章的消息交互流程。
消息交互的基本流程分为：
版本协商，鉴权请求，数据传输，链路检测，连接终止。
客户端侧应支持对链路检测周期的灵活设定.
SDTP协议连接管理流程如下图所示：
图5-3SDTP数据传输协议流程
SDTP连接建立和通信流程说明如下：
（1）请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接；
（2）客户端发起版本协商流程，若协商失败，则转（7）拆除连接；
（3）客户端向服务端发起链路鉴权请求（使用数据合成服务器与各应用系统间协商好的共享密钥），若服务端鉴权失败，则转（7）拆除连接；
（4）请求的发起方发送数据，接收方收到数据并处理后回复处理结果；
（5）在连接保持期间，如果没有数据包发送，客户端发送链路检测/应答包以维持此连接；若发现链路断开，则转（7）拆除连接；
（6）通信完成后，客户端主动发起链路释放请求；
（7）双方均可拆除该连接；
7.1.4连接管理消息
版本协商verNego
7.1.4.1.1请求
版本协商请求，用于在连接的鉴权通过后，客户端与服务器端协商通信协议版本的信息，由连接的建立方主动发起协议版本协商。
参数定义如下：
表5-4参数定义
字段名
字节数
类型
描述
Version
1
UnsignedInteger
协议的主版本号
SubVersion
1
UnsignedInteger
协议的子版本号
版本协商的发起方从自身支持的最高版本开始协商，高版本协商失败后再协商低版本。
7.1.4.1.2应答
版本协商应答，用于返回版本信息的核对结果，参数定义如下：
表5-5参数定义
字段名
字节数
类型
描述
Result
1
UnsignedInteger
返回原因值。
协议协商的结果，各个值代表意义如下：
1:
版本协商通过。
2:
版本过高。
3:
版本过低。
链路认证linkAuth
7.1.4.1.3请求
连接鉴权请求，参数定义如下：
表5-6参数定义
字段名
字节数
类型
描述
LoginID
12
String
账户ID。
由连接的服务端给连接的客户端分配的连接。
字段名
字节数
类型
描述
Digest
64
String
用于鉴别源用户，其值通过SHA256计算得出，当对端用相同方式加密之后与接收值比较，如果计算出来的值相同，则通过校验，否则出错。
Timestamp
4
UnsignedInteger
时间戳的明文。
由客户端产生,单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数）
RAND
2
UnsignedInteger
由客户端产生的随机数
7.1.4.1.4应答
连接鉴权应答，参数定义如下：
表5-7参数定义
字段名
字节数
类型
描述
Result
1
UnsignedInteger
鉴权的返回结果。
各个值的含义如下定义：
1代表鉴权通过。
2代表LoginID不存在。
3代表SHA256加密结果出错。
Digest
64
String
用于对端对本端进行鉴权，其值通过SHA256计算得出，当对端用相同方式加密之后与接收值比较，如果计算出来的值相同，则通过校验，否则出错。
链路检测linkCheck
7.1.4.1.5请求
当信道上没有数据传输时，客户端应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包。
服务端收到链路检测请求包后，立即回复链路检测应答。
无参数。
7.1.4.1.6应答
链路检测请求的应答，无参数。
链路数据发送校验linkDataCheck
7.1.4.1.7请求
本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息同方向。
消息的作用是，告知数据接收方，在两个本消息间隔期发送的notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包数量，以便接收方校验是否有丢包情况发生。
若有丢包发生时，notifyCDR/TDRData_Req和XDRRawDataSend_Req消息的接收方应立即通过返回消息告知发送方有数据丢失。
本消息建议5分钟进行数据校验，数据量大时为避免过多的传输缓存，可减少时间间隔，数据接收方应不受校验周期影响。
表5-6参数定义
字段名
字节数
类型
描述
Sendflag
4
Int
检测包顺序标签，1小时不重复即可。
本参数目的是为了发现校验包的丢失，可以通过该参数判断出校验包的丢包。
SendDataInfo
4
int
距离上次发送间发送的数据包数量。
（仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量）
7.1.4.1.8应答
本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息方向相反。
消息的作用是，告知数据发送方，在两个本消息间隔期接收了多少个notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包，以便告知发送方是否有丢包情况发生。
表5-6参数定义
字段名
字节数
类型
描述
Sendflag
4
Int
检测包顺序标签，1小时不重复即可。
（与请求包相同）本参数目的是为了发现校验包的丢失，可以通过该参数判断出校验包的丢包。
result
1
int
0：
数据量正确；1：
接收方数据小于发送方数据；2：
接收方；数据大于发送方数据。
SendDataInfo
4
int
距离上次发送间发送的数据包数量。
（仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量）（与请求包相同）
RecDataInfo
4
int
距离上次发送间接收的数据包数量。
（仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量）
链路释放linkRel
7.1.4.1.9请求
连接释放请求，指示连接的某一方由于某些原因而需要断开连接，参数定义如下：
表5-8参数定义
字段名
字节数
类型
描述
Reason
1
UnsignedInteger
连接
升级会员 