中国移动上网日志留存系统网络日志服务器接口规范标准详.docx

1、中国移动上网日志留存系统网络日志服务器接口规范标准详中国移动通信企业标准中国移动上网日志留存系统网络日志服务器接口规范Interface Specification of China MobileNetlog System（Netlog Server Part） 版本号：1.0.0前 言本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准，以及系统部需要公开定义的各种接口。本标准原则上在中国移动通信集团公司部使用，为业务开展、招标选型、工程建设及运行维护提供技术依据，适用于GSM/3G网络环境。本标准主要包括以下几方面容：系统结构、接口协议、业务信令数据

2、共享接口、CDR/TDR信令数据共享接口以及全量信令数据反查接口。本标准是中国移动上网日志留存系统系列标准之一，该系列标准的结构、名称或预计名称如下：序号标准编号标准名称发布单位1中国移动上网日志留存系统总体技术要求中国移动通信集团公司2中国移动上网日志留存系统Gn采集解析设备规中国移动通信集团公司3中国移动上网日志留存系统Gb/Iu-Ps采集解析设备规中国移动通信集团公司4中国移动上网日志留存系统防火墙日志采集前置机数据传递要求中国移动通信集团公司5中国移动上网日志留存系统数据合成服务器设备规（CS域）中国移动通信集团公司6中国移动上网日志留存系统数据合成服务器设备规（PS域）中国移动通信集

3、团公司7中国移动上网日志留存系统数据合成服务器接口规（CS域）中国移动通信集团公司8中国移动上网日志留存系统数据合成服务器接口规（PS域）中国移动通信集团公司9中国移动上网日志留存系统网络日志服务器设备规中国移动通信集团公司10中国移动上网日志留存系统网络日志服务器接口规中国移动通信集团公司11中国移动上网日志留存系统用户上网日志查询系统设备规中国移动通信集团公司12中国移动上网日志留存系统用户上网日志查询系统接口规中国移动通信集团公司13中国移动上网日志留存系统日志上报网关系统设备规中国移动通信集团公司14中国移动数据流量DPI识别能力规中国移动通信集团公司15中国移动信令监测系统接口规信令

4、采集网关分册中国移动通信集团公司16QB-W-026-2011中国移动IDC/ISP信息安全管理系统接口规中国移动通信集团公司17中国移动手机恶意软件监测系统接口规中国移动通信集团公司18中国移动性能管理系统数据接口规数据业务监测与分析系统分册中国移动通信集团公司19中国移动性能管理系统数据接口规信令监测系统分册中国移动通信集团公司20中国移动性能管理系统数据源接口规中国移动通信集团公司21集中化经分系统与日志上报网关接口规 中国移动通信集团公司22中国移动上网日志留存系统“金库模式”实施指导意见 中国移动通信集团公司本标准由中国移动通信集团公司网络部提出，集团公司技术部归口。本标准起草单位：

5、中国移动通信集团网络部本标准主要起草人：邢喆、辉、恒、坤、柏洪涛、周维、卫涛、韦薇、心恬1 围本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准，以及系统部需要公开定义的各种接口，是开展上网日志留存系统建设的技术规，为业务开展、招标选型、工程建设及运行维护提供技术依据。本标准原则上在中国移动通信集团公司部和厂商共同使用，适用于GSM/3G网络环境。2 规性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件

6、的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。表2-1 规性引用文件序号标准编号 标准名称发布单位1 TS 24.008MobileradiointerfaceLayer3specification;Corenetworkprotocols;Stage33GPP2 TS 24.011Point-to-Point(PP)ShortMessageService(SMS)supportonmobileradiointerface3GPP3 TS 48.008MobileSwitchingCentre- BaseStationSystem (MSC- BSS)interface;Laye

7、r3specification3GPP4 TS 48.006SignallingtransportmechanismspecificationfortheBaseStationSystem- Mobile- servicesSwitchingCentre(BSS-MSC)interface 3GPP5 TS 52.008GSMsubscriberandequipmenttrace3GPP6 TS 52.021NetworkManagement(NM)proceduresandmessagesontheA-bisinterface3GPP7 TS 49.031BaseStationSystemA

8、pplicationPartLCSExtension(BSSAP-LE)3GPP8 TS 25.413UTRANIuinterfaceRadioAccessNetworkApplicationPart(RANAP)signalling3GPP9 ITU-T Q.752Monitoring and Measurements for Signalling System No.7 NetworksITU3 术语、定义和缩略语“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。- “必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求；对应于RFC2119 MUS

9、T，REQUIRED，SHALL。- “推荐”/“建议”/“应”项是指在标准中未作强制要求，若业务、产品和设备提供的功能或性能要求被认为更佳；对应于RFC2119 RECOMMENDED，SHOULD。- “可选”/“可”项指参考性要求，是业务、产品和设备在目前阶段可不提供的功能或性能要求；对应于RFC2119 MAY，OPTIONAL。- 必不能，不能，不得：表示绝对的禁止；对应于RFC2119 MUST NOT，SHALL NOT。- 不推荐，不建议：表示若业务、产品和设备按照所述容制作，被认为略次；对应于RFC2119 SHOULD NOT，NOT RECOMMENDED。- 规中除了明

10、确指明为 “推荐”/“建议”、“可选”外，均为必须要求。表3-1 词语解释词语解释应用层对获取信令监测系统提供数据的信令应用系统的统称全量信令数据全量信令数据包含了被采集信令链路的全部信令容CDR/TDR信令数据数据CDR/TDR信令数据是指基于全量信令数进行处理后，生成的供信令监测类应用使用的呼叫及事务详细记录。业务信令数据业务信令数据是根据应用的需要对CDR/TDR信令数据进行解析、处理，从中提取出对业务应用所需的信令事件数据，例如：呼叫事件、位置更新事件、漫游事件等指标数据指标数据是根据信令监测系统生成的CDR/TDR或者信令消息统计生成的各类Kpi指标数据，例如：接通率、位置更新成功率

11、等ADApplication Domain，应用层CCCall Control，呼叫控制DDUData Dispatch Unit，数据分发单元DXCDigital Cross Connect，数字交叉设备GRSAPGRS Application Part，漫游欢迎系统应用部分HDLCHigh-Level Data Link Control，高级数据链路控制规程IEInformation Element，信令消息中的信息单元IPInternet Protocol，IP协议MCIPMobile Cell，小区短信应用部分MMMobility Management，移动性管理ODBCOpen Da

12、tabase Connectivity，开放数据库连接OMCOperation Management Center，系统管理单元RRRadio Resource，无线资源管理SAUSignal Analysis Unit，信令分析单元SCGSignal Collection Gateway，信令采集网关SDTPShared Data Transfer Protocol，共享数据传输协议SDUShared Data Unit，共享数据单元SMUService Management Unit，业务/服务管理单元SNMPSimple Network Management Protocol，简单网络管

13、理协议SOAService-Oriented Architecture，面向服务的体系架构SPUSignal Preprocess Unit，信令预处理单元SUStore Unit，存储单元TAPTest Access Point，测试接入端口CDRCall Detail Record，呼叫详细记录TDRTransaction Detail Record，事务详细记录MSISDNMobile Station Integrated Services Digital Number，移动用户ISDN4 接口在网络中的位置5 系统描述及系统结构图系统架构图如下图所示。图4-1 系统架构图网络日志服务器

14、是中国移动日志留存系统的四层架构中的第三层。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：共享层与应用系统之间的接口，主要用于传输全量信令数据（原始信令

15、经IP化后的数据），该接口所采用的协议为SDTP（共享数据传输协议）或FTP。 IF2-2：共享层与应用系统之间的接口，主要用于传输XDR记录以及XDR原始信令数据，该接口所采用的协议为SDTP（共享数据传输协议）。7 接口协议7.1 SDTP实时通信协议SDTP为实时数据共享传输协议。该协议是采集层与解码层的接口传输协议，也是解码层和共享层之间的接口传输协议。其传输特点是数据传输量大，实时性要求高，过程简单，不需要握手鉴权过程。SDTP实时数据共享传输协议应用于以下场景： 解码层将合成后的PS域XDR数据封装后传送到共享层； 解码层将CS域MC口XDR数据封装后传送到共享层； 解码层将CS域

16、MC原始码流封装后传送到共享层；共享数据传输协议（SDTP）以TCP/IP作为底层通信承载，具体协议结构如下图所示：图5-1 信令数据传输协议栈协议栈分为3层，分别为承载层、传输层和应用层。其中，承载层为IP协议，它提供可靠的数据传输通道；传输层（SDTP+TCP）为上层应用提供通用的数据传输协议；应用层封装适合于各应用系统的原始信令数据、CDR/TDR数据。数据合成服务器通过SDTP协议适配各应用系统所需的特定协议。图5-2 SDTP协议栈数据提供方与数据接受方之间进行信息交互时，采用长连接方式： 通信双方以Client-Server方式建立TCP连接，用于双方信息的交互。其中：在网络日志服

17、务器与应用系统的连接中，请求的发起方作为连接的客户端；在网络日志服务器与数据合成服务器的连接中，网络日志服务器作为连接的服务端，数据合成服务器作为连接的客户端。 当连接断开后，客户端以反复重试的方式连接服务端。 在一个连接上可以连续发送多个数据包，在连接保持期间，如果没有数据包发送，由客户端发送链路检测，服务器端发送应答消息以维持此连接。当信道上没有数据传输时，客户端应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包，再连续发送N-1次后仍未得到响应则断开此连接。参数C、T、N可灵活配置，现阶段建议取值为：C=3分钟，T=60秒，N=3。 数

18、据提供点与数据接收点之间的消息发送后等待T秒后未收到响应，应立即重发，再连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数W可配置，现阶段建议为16，即接收方在应答前一次收到的消息最多不超过16条。 数据合成服务器需支持应用系统与接入模块之间的多个并发连接。 考虑到数据的安全性，建议在应用系统和数据合成服务器间采用链路安全机制（如TLS、VPN等方式），可根据实际需求选择开启。数据合成服务器与网络日志服务器间基于SDTP传输全量信令数据时，SDTP层的重传机制和滑动窗口控制机制为可选，但客户端与服务器端的实现机

19、制需保持一致。7.1.1 消息类型SDTP协议的消息类型定义如下表所示：表5-1 消息类型定义消息名MessageType值说明verNego_Req0x0001版本协商请求verNego_Resp0x8001版本协商应答linkAuth_Req0x0002鉴权请求linkAuth_Resp0x8002鉴权响应linkCheck_Req0x0003链路检测请求linkCheck_Resp0x8003链路检测应答linkRel_Req0x0004连接释放请求linkRel_Resp0x8004连接释放应答notifyCDR/TDRData_Req0x0005CDR/TDR信令数据通知请求noti

20、fyCDR/TDRData_Resp0x8005CDR/TDR信令数据通知应答XDRRawDataSend_Req0x0006XDR对应原始数据传输XDRRawDataSend_Resp0x8006XDR对应原始数据传输应答linkDataCheck_Req0x0007链路数据发送校验请求linkCheck_Resp0x8007链路数据发送校验应答7.1.2 消息结构SDTP消息结构如下所示：表5-2 SDTP消息结构项目说明Message Header消息头(所有消息公共)Message Body消息体，即各类参数消息头（Message Header）的包含如下字段：（对SDTP接口，下述所

21、有字段必填）表5-3 消息头字段名字节数类型描述TotalLength2Unsigned Integer消息总长度(含消息头及消息体)MessageType2Unsigned Integer消息类型SequenceId4Unsigned Integer交互的流水号，顺序累加，步长为1，循环使用（一个交互的一对请求和应答消息的流水号必须相同）TotalContents1Unsigned Integer消息体中的事件数量（最多40条）若考虑实时性要求，可每次只填一个事件7.1.3 连接管理流程使用SDTP协议通信时，遵照本章的消息交互流程。消息交互的基本流程分为：版本协商，鉴权请求，数据传输，链路

22、检测，连接终止。客户端侧应支持对链路检测周期的灵活设定. SDTP协议连接管理流程如下图所示：图5-3 SDTP数据传输协议流程SDTP连接建立和通信流程说明如下：（1） 请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接；（2） 客户端发起版本协商流程，若协商失败，则转（7）拆除连接；（3） 客户端向服务端发起链路鉴权请求（使用数据合成服务器与各应用系统间协商好的共享密钥），若服务端鉴权失败，则转（7）拆除连接；（4） 请求的发起方发送数据，接收方收到数据并处理后回复处理结果；（5） 在连接保持期间，如果没有数据包发送，客户端发送链路检测/应答包以维持此连接；若发现链路断开，

23、则转（7）拆除连接；（6） 通信完成后，客户端主动发起链路释放请求；（7） 双方均可拆除该连接；7.1.4 连接管理消息版本协商verNego7.1.4.1.1 请求版本协商请求，用于在连接的鉴权通过后，客户端与服务器端协商通信协议版本的信息，由连接的建立方主动发起协议版本协商。参数定义如下：表5-4 参数定义字段名字节数类型描述Version1Unsigned Integer协议的主版本号SubVersion1Unsigned Integer协议的子版本号版本协商的发起方从自身支持的最高版本开始协商，高版本协商失败后再协商低版本。7.1.4.1.2 应答版本协商应答，用于返回版本信息的核对结

24、果，参数定义如下：表5-5 参数定义字段名字节数类型描述Result1Unsigned Integer返回原因值。协议协商的结果，各个值代表意义如下：1: 版本协商通过。2: 版本过高。3: 版本过低。链路认证linkAuth7.1.4.1.3 请求连接鉴权请求，参数定义如下：表5-6 参数定义字段名字节数类型描述LoginID12String账户ID。由连接的服务端给连接的客户端分配的连接。字段名字节数类型描述Digest64String用于鉴别源用户，其值通过SHA256计算得出，当对端用相同方式加密之后与接收值 比较，如果计算出来的值相同，则通过校验，否则出错。Timestamp4Uns

25、igned Integer时间戳的明文。由客户端产生,单位为秒（1970年1月1日0时0分0秒起至当前的偏移总秒数）RAND2Unsigned Integer由客户端产生的随机数7.1.4.1.4 应答连接鉴权应答，参数定义如下：表5-7 参数定义字段名字节数类型描述Result1Unsigned Integer鉴权的返回结果。各个值的含义如下定义：1 代表鉴权通过。2 代表LoginID不存在。3 代表SHA256加密结果出错。Digest64String用于对端对本端进行鉴权，其值通过SHA256计算得出，当对端用相同方式加密之后与接收值 比较，如果计算出来的值相同，则通过校验，否则出错。

26、链路检测linkCheck7.1.4.1.5 请求当信道上没有数据传输时，客户端应每隔时间C发送链路检测包以维持此连接，当链路检测包发出超过时间T后未收到响应，应立即再发送链路检测包。服务端收到链路检测请求包后，立即回复链路检测应答。无参数。7.1.4.1.6 应答链路检测请求的应答，无参数。链路数据发送校验linkDataCheck7.1.4.1.7 请求本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息同方向。消息的作用是，告知数据接收方，在两个本消息间隔期发送的notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包

27、数量，以便接收方校验是否有丢包情况发生。若有丢包发生时，notifyCDR/TDRData_Req和XDRRawDataSend_Req消息的接收方应立即通过返回消息告知发送方有数据丢失。本消息建议5分钟进行数据校验，数据量大时为避免过多的传输缓存，可减少时间间隔，数据接收方应不受校验周期影响。表5-6 参数定义字段名字节数类型描述Sendflag4Int检测包顺序标签，1小时不重复即可。本参数目的是为了发现校验包的丢失，可以通过该参数判断出校验包的丢包。SendDataInfo4int距离上次发送间发送的数据包数量。（仅仅包含notifyCDR/TDRData_Req和XDRRawDataS

28、end_Req包的数量）7.1.4.1.8 应答本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息方向相反。消息的作用是，告知数据发送方，在两个本消息间隔期接收了多少个notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包，以便告知发送方是否有丢包情况发生。表5-6 参数定义字段名字节数类型描述Sendflag4Int检测包顺序标签，1小时不重复即可。（与请求包相同）本参数目的是为了发现校验包的丢失，可以通过该参数判断出校验包的丢包。result1int0：数据量正确；1：接收方数据小于发送方数据；2：接收方；数据大于发送方数据。SendDataInfo4int距离上次发送间发送的数据包数量。（仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量）（与请求包相同）RecDataInfo4int距离上次发送间接收的数据包数量。（仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量）链路释放linkRel7.1.4.1.9 请求连接释放请求，指示连接的某一方由于某些原因而需要断开连接，参数定义如下：表5-8 参数定义字段名字节数类型描述Reason1Unsigned Integer连接