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

中国移动通信企业标准

中国移动上网日志留存系统网络

日志服务器接口规范

Interface Specification of China Mobile

Netlog System (Netlog Server Part)

版本号:1.0.0

╳╳╳╳╳╳╳╳-╳╳-╳╳实施 -╳╳-╳╳发布

中国移动通信集团公司 发布

I

前 言 ............................................................................................................................................ IV 1 范围........................................................................................................................................... 6 2 规范性引用文件 ....................................................................................................................... 6 3 术语、定义和缩略语 ............................................................................................................... 7 4 接口在网络中的位置 ............................................................................................................... 8

4.1 系统描述及系统结构图 ........................................................................................... 8 4.2 接口功能 ................................................................................................................... 9 5 接口协议 ................................................................................................................................. 10

5.1 SDTP实时通信协议 .............................................................................................. 10

5.1.1 消息类型 ......................................................................................................... 11 5.1.2 消息结构 ......................................................................................................... 12 5.1.3 连接管理流程 ................................................................................................. 12 5.1.4 连接管理消息 ................................................................................................. 14

版本协商verNego ................................................................................................... 14

5.1.4.1.1 请求 ................................................................................. 14 5.1.4.1.2 应答 ................................................................................. 14 链路认证linkAuth................................................................................................... 14

5.1.4.1.3 请求 ................................................................................. 14 5.1.4.1.4 应答 ................................................................................. 15 链路检测linkCheck ................................................................................................ 15

5.1.4.1.5 请求 ................................................................................. 15 5.1.4.1.6 应答 ................................................................................. 15 链路数据发送校验linkDataCheck ......................................................................... 15

5.1.4.1.7 请求 ................................................................................. 15 5.1.4.1.8 应答 ................................................................................. 16 链路释放linkRel ..................................................................................................... 17

5.1.4.1.9 请求 ................................................................................. 17 5.1.4.1.10 应答 ................................................................................. 17 XDR对应原始数据传输XDRRawDataSend ...................................................... 17

5.1.4.1.11 XDR对应原始数据传输请求 ......................................... 17 5.1.4.1.12 XDR对应原始数据传输应答 ......................................... 18 CDR/TDR信令数据通知notifyCDR/TDRData ..................................................... 18

5.1.4.1.13 通知请求 ......................................................................... 18 5.1.4.1.14 通知应答 ......................................................................... 18

5.2 FTP文件传输协议 ................................................................................................. 19

5.2.1 接口说明 ......................................................................................................... 19 5.2.2 应用场景 ......................................................................................................... 19 5.2.3 数据校验文件格式 ......................................................................................... 19 5.2.4 校验规则 ......................................................................................................... 20 5.2.5 FTP文件管理 .................................................................................................. 20 5.2.6 全量信令数据传输接口 ................................................................................. 20

II

接口和数据结构要求 ............................................................................................. 21 5.3.1 至数据合成服务器接口(南向) ................................................................. 21 5.3.2 至IDC信息安全管理系统接口(南向) ...................................................... 21 5.3.3 至上网日志查询平台接口(北向) ............................................................. 21 5.3.4 至指定系统(经上报网关)接口(北向) ................................................. 21 5.3.5 至性能管理系统接口(北向) ..................................................................... 21 5.3.6 至手机恶意软件监控系统接口(北向) ..................................................... 21 5.3.7 至经营分析系统(经上报网关)接口(北向) ......................................... 21 5.3.8 至IDC信息安全管理系统接口(北向) ...................................................... 21

6 编制历史 ................................................................................................................................. 22 附录A 省市编号 ........................................................................................................................... 22 A.1. 省编号 .................................................................................................................................... 22 A.2. 市编号 .................................................................................................................................... 23

5.3

III

前 言

本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准,以及系统内部需要公开定义的各种接口。

本标准原则上在中国移动通信集团公司内部使用,为业务开展、招标选型、工程建设及运行维护提供技术依据,适用于GSM/3G网络环境。

本标准主要包括以下几方面内容:系统结构、接口协议、业务信令数据共享接口、CDR/TDR信令数据共享接口以及全量信令数据反查接口。

本标准是中国移动上网日志留存系统系列标准之一,该系列标准的结构、名称或预计名称如下: 序号 [1] [2] 标准编号 标准名称 发布单位 中国移动上网日志留存系统总体技术要求 中国移动通信集团公司 中国移动上网日志留存系统Gn采集解析设中国移动通信集团公司 备规范 [3] 中国移动上网日志留存系统Gb/Iu-Ps采集中国移动通信集团公司 解析设备规范 [4] 中国移动上网日志留存系统防火墙日志采中国移动通信集团公司 集前置机数据传递要求 [5] 中国移动上网日志留存系统数据合成服务中国移动通信集团公司 器设备规范(CS域) [6] 中国移动上网日志留存系统数据合成服务中国移动通信集团公司 器设备规范(PS域) [7] 中国移动上网日志留存系统数据合成服务中国移动通信集团公司 器接口规范(CS域) [8] 中国移动上网日志留存系统数据合成服务中国移动通信集团公司 器接口规范(PS域) [9] 中国移动上网日志留存系统网络日志服务中国移动通信集团公司 器设备规范 [10] 中国移动上网日志留存系统网络日志服务中国移动通信集团公司 IV

器接口规范 [11] 中国移动上网日志留存系统用户上网日志中国移动通信集团公司 查询系统设备规范 [12] 中国移动上网日志留存系统用户上网日志中国移动通信集团公司 查询系统接口规范 [13] 中国移动上网日志留存系统日志上报网关中国移动通信集团公司 系统设备规范 [14] [15] 中国移动数据流量DPI识别能力规范 中国移动通信集团公司 中国移动信令监测系统接口规范—信令采中国移动通信集团公司 集网关分册 [16] 011 [17] [18] QB-W-026-2中国移动IDC/ISP信息安全管理系统接口中国移动通信集团公司 规范 中国移动手机恶意软件监测系统接口规范 中国移动通信集团公司 中国移动性能管理系统数据接口规范-数中国移动通信集团公司 据业务监测与分析系统分册 [19] 中国移动性能管理系统数据接口规范-信中国移动通信集团公司 令监测系统分册 [20] 《中国移动性能管理系统数据源接口规范》 中国移动通信集团公司 [21] [22] 集中化经分系统与日志上报网关接口规范 中国移动上网日志留存系统“金库模式”实施指导意见 中国移动通信集团公司 中国移动通信集团公司

本标准由中国移动通信集团公司网络部提出,集团公司技术部归口。 本标准起草单位:中国移动通信集团网络部

本标准主要起草人:邢喆、赵辉、赵恒、刘坤、柏洪涛、周维、卫涛、韦薇、李心恬

V

1 范围

本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用系统连接的接口标准,以及系统内部需要公开定义的各种接口,是开展上网日志留存系统建设的技术规范,为业务开展、招标选型、工程建设及运行维护提供技术依据。

本标准原则上在中国移动通信集团公司内部和厂商共同使用,适用于GSM/3G网络环境。

2 规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。

表2-1 规范性引用文件 序号 [1] 标准编号 TS 24.008 标准名称 Mobile radio interface Layer 3 specification; Core network protocols; Stage 3 Point-to-Point (PP) Short Message Service (SMS) support on mobile radio interface Mobile Switching Centre - Base Station System (MSC- BSS) interface;Layer 3 specification Signalling transport mechanism specification for the Base Station System - Mobile- services Switching Centre (BSS - MSC) interface GSM subscriber and equipment trace Network Management (NM) procedures and messages on the A-bis interface Base Station System Application Part LCS Extension (BSSAP-LE) UTRAN Iu interface Radio Access Network Application Part (RANAP) signalling Monitoring and Measurements for 发布单位 3GPP [2] TS 24.011 3GPP [3] TS 48.008 3GPP [4] TS 48.006 3GPP [5] [6] TS 52.008 TS 52.021 3GPP 3GPP [7] [8] TS 49.031 TS 25.413 3GPP 3GPP [9]

ITU-T Q.752 ITU 第6页

Signalling System No.7 Networks 3 术语、定义和缩略语

- - - - - -

“必须”、“推荐”/“建议”、和“可选”等词语在本标准中的使用需遵循以下指导。

“必选”/“必须”项是指业务、产品和设备所必须提供的功能或性能要求;对应于RFC2119 MUST,REQUIRED,SHALL。

“推荐”/“建议”/“应”项是指在标准中未作强制要求,若业务、产品和设备提供的功能或性能要求被认为更佳;对应于RFC2119 RECOMMENDED,SHOULD。

“可选”/“可”项指参考性要求,是业务、产品和设备在目前阶段可不提供的功能或性能要求;对应于RFC2119 MAY,OPTIONAL。

必不能,不能,不得:表示绝对的禁止;对应于RFC2119 MUST NOT,SHALL NOT。 不推荐,不建议:表示若业务、产品和设备按照所述内容制作,被认为略次;对应于RFC2119 SHOULD NOT,NOT RECOMMENDED。

规范中除了明确指明为 “推荐”/“建议”、“可选”外,均为必须要求。

表3-1 词语解释 词语 应用层 解释 对获取信令监测系统提供数据的信令应用系统的统称 全量信令数据包含了被采集信令链路的全部信令内容 CDR/TDR信令数据是指基于全量信令数进行处理后,生成的供信令监测类应用使用的呼叫及事务详细记录。 业务信令数据是根据应用的需要对CDR/TDR信令数据进行解析、处理,从中提取出对业务应用所需的信令事件数据,例如:呼叫事件、位置更新事件、漫游事件等 指标数据是根据信令监测系统生成的CDR/TDR或者信令消息统计生成的各类Kpi指标数据,例如:接通率、位置更新成功率等 Application Domain,应用层 Call Control,呼叫控制 Data Dispatch Unit,数据分发单元 Digital Cross Connect,数字交叉设备 GRS Application Part,漫游欢迎系统应用部分 High-Level Data Link Control,高级数据链路控制规程 Information Element,信令消息中的信息单元 Internet Protocol,IP协议 Mobile Cell,小区短信应用部分 Mobility Management,移动性管理 Open Database Connectivity,开放数据库连接 Operation Management Center,系统管理单元 Radio Resource,无线资源管理 Signal Analysis Unit,信令分析单元 Signal Collection Gateway,信令采集网关 第7页

全量信令数据 CDR/TDR信令数据数据 业务信令数据 指标数据 AD CC DDU DXC GRSAP HDLC IE IP MCIP MM ODBC OMC RR SAU SCG

SDTP SDU SMU SNMP SOA SPU SU TAP CDR TDR MSISDN Shared Data Transfer Protocol,共享数据传输协议 Shared Data Unit,共享数据单元 Service Management Unit,业务/服务管理单元 Simple Network Management Protocol,简单网络管理协议 Service-Oriented Architecture,面向服务的体系架构 Signal Preprocess Unit,信令预处理单元 Store Unit,存储单元 Test Access Point,测试接入端口 Call Detail Record,呼叫详细记录 Transaction Detail Record,事务详细记录 Mobile Station Integrated Services Digital Number,移动用户ISDN号码 4 接口在网络中的位置

4.1 系统描述及系统结构图

系统架构图如下图所示。

图4-1 系统架构图

网络日志服务器是中国移动日志留存系统的四层架构中的第三层。

第8页

4.2 接口功能

本规范重点定义了中国移动上网日志留存系统网络日志服务器与应用层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(共享数据传输协议)。

第9页

5 接口协议

5.1 SDTP实时通信协议

SDTP为实时数据共享传输协议。该协议是采集层与解码层的接口传输协议,也是解码层和共享层之间的接口传输协议。其传输特点是数据传输量大,实时性要求高,过程简单,不需要握手鉴权过程。

SDTP实时数据共享传输协议应用于以下场景:

? 解码层将合成后的PS域XDR数据封装后传送到共享层; ? 解码层将CS域MC口XDR数据封装后传送到共享层; ? 解码层将CS域MC原始码流封装后传送到共享层;

共享数据传输协议(SDTP)以TCP/IP作为底层通信承载,具体协议结构如下图所示:

APPSDTP应用层传输层TCPIP承载层

图5-1 信令数据传输协议栈

协议栈分为3层,分别为承载层、传输层和应用层。其中,承载层为IP协议,它提供可靠的数据传输通道;传输层(SDTP+TCP)为上层应用提供通用的数据传输协议;应用层封装适合于各应用系统的原始信令数据、CDR/TDR数据。数据合成服务器通过SDTP协议适配各应用系统所需的特定协议。

第10页

数据订阅点数据提供点SDTPTCPIP数据链路层SDTPTCPIP数据链路层物理层物理层 图5-2 SDTP协议栈

数据提供方与数据接受方之间进行信息交互时,采用长连接方式:

? 通信双方以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 消息类型定义 消息名 verNego_Req MessageType值 0x0001 说明 版本协商请求 第11页

verNego_Resp linkAuth_Req linkAuth_Resp linkCheck_Req linkCheck_Resp linkRel_Req linkRel_Resp notifyCDR/TDRData_Req notifyCDR/TDRData_Resp XDRRawDataSend_Req XDRRawDataSend_Resp linkDataCheck_Req linkCheck_Resp 5.1.2

消息结构

0x8001 0x0002 0x8002 0x0003 0x8003 0x0004 0x8004 0x0005 0x8005 0x0006 0x8006 0x0007 0x8007 版本协商应答 鉴权请求 鉴权响应 链路检测请求 链路检测应答 连接释放请求 连接释放应答 CDR/TDR信令数据通知请求 CDR/TDR信令数据通知应答 XDR对应原始数据传输 XDR对应原始数据传输应答 链路数据发送校验请求 链路数据发送校验应答 SDTP消息结构如下所示:

表5-2 SDTP消息结构

项目 Message Header Message Body 说明 消息头(所有消息公共包头) 消息体,即各类参数 消息头(Message Header)的包含如下字段:(对SDTP接口,下述所有字段必填)

表5-3 消息头 字段名 TotalLength MessageType SequenceId 字节数 2 2 4 类型 Unsigned Integer Unsigned Integer Unsigned Integer 消息类型 交互的流水号,顺序累加,步长为1,循环使用(一个交互的一对请求和应答消息的流水号必须相同) 消息体中的事件数量(最多40条) 若考虑实时性要求,可每次只填一个事件 描述 消息总长度(含消息头及消息体) TotalContents 1 Unsigned Integer 5.1.3 连接管理流程

使用SDTP协议通信时,遵照本章的消息交互流程。消息交互的基本流程分为:版本协商,鉴权请求,数据传输,链路检测,连接终止。客户端侧应支持对链路检测周期的灵活设定.

SDTP协议连接管理流程如下图所示:

第12页

客户端服务端1. TCP/HTTP连接建立2. 版本协商请求verNego_Req2. 版本协商应答verNego_Resp3. 链路鉴权请求linkAuth_Req3. 链路鉴权应答linkAuth_Resp4. 数据发送请求4. 数据发送应答5. 链路检测请求linkCheck_Req5. 链路检测应答linkCheck_Resp6.链路数据发送校验linkDataCheck_Req6.链路数据发送校验应答linkDataCheck_Resp7.链路释放请求linkRel_Req7.链路释放应答linkRel_Resp8. TCP/HTTP连接拆除

图5-3 SDTP数据传输协议流程

SDTP连接建立和通信流程说明如下:

(1) 请求的发起方作为客户端向服务端指定的IP地址和端口建立TCP长连接; (2) 客户端发起版本协商流程,若协商失败,则转(7)拆除连接;

(3) 客户端向服务端发起链路鉴权请求(使用数据合成服务器与各应用系统间协商

好的共享密钥),若服务端鉴权失败,则转(7)拆除连接;

(4) 请求的发起方发送数据,接收方收到数据并处理后回复处理结果;

(5) 在连接保持期间,如果没有数据包发送,客户端发送链路检测/应答包以维持此

连接;若发现链路断开,则转(7)拆除连接;

(6) 通信完成后,客户端主动发起链路释放请求;

第13页

(7) 双方均可拆除该连接; 5.1.4

连接管理消息

版本协商verNego

5.1.4.1.1 请求

版本协商请求,用于在连接的鉴权通过后,客户端与服务器端协商通信协议版本的信息,由连接的建立方主动发起协议版本协商。参数定义如下:

表5-4 参数定义 字段名 Version SubVersion 字节数 1 1 类型 Unsigned Integer Unsigned Integer 描述 协议的主版本号 协议的子版本号 版本协商的发起方从自身支持的最高版本开始协商,高版本协商失败后再协商低版本。 5.1.4.1.2

应答

版本协商应答,用于返回版本信息的核对结果,参数定义如下:

表5-5 参数定义 字段名 Result 字节数 1 类型 Unsigned Integer 描述 返回原因值。 协议协商的结果,各个值代表意义如下: 1: 版本协商通过。 2: 版本过高。 3: 版本过低。 链路认证linkAuth

5.1.4.1.3 请求

连接鉴权请求,参数定义如下:

表5-6 参数定义 字段名 LoginID 字节数 12 类型 String 描述 账户ID。 由连接的服务端给连接的客户端分配的连接帐号。 描述 用于鉴别源用户,其值通过SHA256计算得出,当对端用相同方式加密之后与接收值 比较,如果计算出来的值相同,第14页

字段名 Digest 字节数 64 类型 String

则通过校验,否则出错。 Timestamp 4 Unsigned Integer 时间戳的明文。 由客户端产生,单位为秒(1970年1月1日0时0分0秒起至当前的偏移总秒数) 由客户端产生的随机数 RAND 5.1.4.1.4

应答

2 Unsigned Integer 连接鉴权应答,参数定义如下:

表5-7 参数定义 字段名 Result 字节数 1 类型 Unsigned Integer 描述 鉴权的返回结果。各个值的含义如下定义: 1 代表鉴权通过。 2 代表LoginID不存在。 3 代表SHA256加密结果出错。 用于对端对本端进行鉴权,其值通过SHA256计算得出,当对端用相同方式加密之后与接收值 比较,如果计算出来的值相同,则通过校验,否则出错。 Digest 64 String 链路检测linkCheck

5.1.4.1.5 请求

当信道上没有数据传输时,客户端应每隔时间C发送链路检测包以维持此连接,当链路

检测包发出超过时间T后未收到响应,应立即再发送链路检测包。服务端收到链路检测请求包后,立即回复链路检测应答。

无参数。 5.1.4.1.6

应答

链路检测请求的应答,无参数。 链路数据发送校验linkDataCheck

5.1.4.1.7 请求

本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息同方向。消息的作用是,告知数据接收方,在两个本消息间隔期内发送的notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包数量,以便接收方校验是否有丢包情况发生。若有丢包发生时,

第15页

notifyCDR/TDRData_Req和XDRRawDataSend_Req消息的接收方应立即通过返回消息告知发送方有数据丢失。本消息建议5分钟进行数据校验,数据量大时为避免过多的传输缓存,可减少时间间隔,数据接收方应不受校验周期影响。

表5-6 参数定义

字段名 数 Sendflag 4 Int 检测包顺序标签,1小时内不重复即可。本参数目的是为了发现校验包的丢失,可以通过该参数判断出校验包的丢包。 距离上次发送间发送的数据包数量。(仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量) 字节类型 描述 SendDataInfo 5.1.4.1.8

应答

4 int 本消息与notifyCDR/TDRData_Req和XDRRawDataSend_Req消息方向相反。消息的作用是,告知数据发送方,在两个本消息间隔期内接收了多少个notifyCDR/TDRData_Req和XDRRawDataSend_Req消息包,以便告知发送方是否有丢包情况发生。

表5-6 参数定义

字段名 Sendflag 字节数 4 类型 Int 描述 检测包顺序标签,1小时内不重复即可。(与请求包相同)本参数目的是为了发现校验包的丢失,可以通过该参数判断出校验包的丢包。 0:数据量正确;1:接收方数据小于发送方数据;2:接收方;数据大于发送方数据。 距离上次发送间发送的数据包数量。(仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量)(与请求包相同) 距离上次发送间接收的数据包数量。(仅仅包含notifyCDR/TDRData_Req和XDRRawDataSend_Req包的数量) result 1 int SendDataInfo 4 int RecDataInfo 4 int

第16页

链路释放linkRel

5.1.4.1.9 请求

连接释放请求,指示连接的某一方由于某些原因而需要断开连接,参数定义如下:

表5-8 参数定义 字段名 Reason 字节数 1 类型 Unsigned Integer 描述 连接释放的原因,各个值代表意义如下: 1: 用户正常释放。 2: 数据类型错误。 3: 超出机器处理能力。 5.1.4.1.10 应答

连接释放完成应答,收到本消息之后或者请求超时后,释放本连接的所有资源,参数定义如下:

表5-9 参数定义

字段名 Result 字节数 1 类型 Unsigned Integer 描述 连接释放的完成状态 1:释放完成。 其它:释放失败。

XDR对应原始数据传输XDRRawDataSend

基于SDTP协议,用于在数据合成服务器向上网日志服务器发送指定XDR数据的原始数据,原始数据的多条消息,可以全部放在一个消息包里,也可以每个消息分开发送。 5.1.4.1.11 XDR对应原始数据传输请求

属性 CDRID 字节数 8 类型 Long Integer 描述 根据这个ID来关联原始数据。每个CDR的原始数据可以分多个包传输,但需要保证每个包的本字段唯一,用于上层进行关联。 原始数据,二进制码流,数据结构详见第7章节 Load

第17页

5.1.4.1.12 XDR对应原始数据传输应答

属性 Result 字节数 1 类型 描述 Unsigned Integer 请求的返回结果: 1 代表成功 其它 代表失败 CDR/TDR信令数据通知notifyCDR/TDRData

CDR/TDR信令数据通知接口基于SDTP协议,用于数据合成服务器向上网日志服务器传输CDR/TDR数据。 5.1.4.1.13 通知请求

表5-12 通知请求

属性 CDRType CDRID Load 字节数 2 8 类型 Unsigned Integer Long Integer 描述 CDR数据类型,详见表5-11 根据这个ID来关联原始数据 CDR/TDR的具体数据内容,具体请参见6.1.1节相关定义

表5-11 CDR数据类型定义 CDR类型 AIU语音事件 切换事件 开关机事件 位置更新事件 短信呼叫事件 接入网事件 寻呼事件 NC口呼叫事件 5.1.4.1.14 通知应答

表5-13 通知应答 属性 Result

字节数 1 类型 Unsigned Integer 描述 请求的返回结果: 第18页

Type值 1 2 3 4 5 6 7 8

1 代表成功 其它 代表失败 5.2 FTP文件传输协议

FTP文件传输协议为非实时接口,包括:

? 数据合成服务器向共享层提供话单数据; ? 数据合成服务器向共享层提供信令数据; ? 数据合成服务器共享层提供用户监控数据(特定用户的上网日志,以话单数据文件

形式上传); 5.2.1

接口说明

该接口用于数据合成服务器向共享层传输话单数据及信令数据时使用,需要数据合成服务器开发厂商按照此协议完成接口通讯软件的开发工作。

该接口使用FTP协议, 规则约定如下:

1) 采用FTP方式进行数据传输,共享层向数据合成服务器开放文件存储服务器及路

径,采集层定时将话单数据上传;

2) 数据合成服务器生成的FTP文件应以csv或xml文本方式保存数据,并遵循csv或xml

格式规则;

3) 数据文件命名采用SSS_HW_XXXXYYYYMMDDHHMI_NN.AVL方式,其中SSS代

表省编号,具体编号请参看附录A.1省编号,HW代表设备编号,用于唯一标识系统设备,要求在各省系统中唯一。

4) XXXX代表数据名称,具体命名由解码层提供;YYYYMMDDHHMI代表数据为这

段时间的数据,时间HH从00开始到23结束;MI 为分钟,推荐5分钟为最小时间单位,NN为文件编号,从00开始,如果文件分隔周期内写满一个文件,文件编号NN顺序递增。

5) 为了检查是否有文件丢失,解码层生成完一个数据文件后即生成一个校验文件,文

件名也需要包含生成时间信息(如SSS_HW_XXXXYYYYMMDDHHMI.CHK) 6) 当没有数据也要按照时间间隔生成文件,表示系统工作正常。 5.2.2

应用场景

对实时性要求不高的应用场景,可用于定时传输话单数据时使用。 5.2.3

数据校验文件格式

表5-77 数据校验文件格式 抽取方式及周期 校验文件名 属性编码 01 02 03

属性名称 file_name row_num file_time 可根据具体应用需求进行订阅 SSS_HW_XXXXYYYYMMDDHHMI.CHK 属性描述 数据文件名 记录行数 文件生成时间 类型 string string string 备注 其中XXXX应包含话单类型信息。 YYYY-MM-DD 第19页

HH:MM:SS 校验文件内容示例如下:

file_name:100_23_2423_VoiceCall_Event201007232100.AVL row_num:1506

file_time:2010-7-23 21:05:01 5.2.4

校验规则

文件级校验是指根据解码层提供的接口校验文件信息,数据合成服务器对需要传输的接口文件进行校验,校验内容如下:

1. 接口数据文件名称

1)根据接口校验文件中记录的文件,查找“接口数据文件目录”下该接口数据文件是否存在;

2)检查接口数据文件的名称是否遵守规范中的命名规范; 2. 文件中包含的记录数

验证接口校验文件中记载的文件记录数与实际接口数据文件中的记录行数是否一致;

3. 文件的生成日期

验证接口校验文件中记载的文件生成日期与实际接口数据文件的生成日期是否一致; 5.2.5

FTP文件管理

根据预先设定信令数据文件的分割时间、文件缓存时间,共享层管理应用系统数据文件,当数据文件超过设定的缓存时间,共享层可删除相应的数据文件和对应的校验文件。 5.2.6

全量信令数据传输接口

数据合成服务器向共享层传送符合条件的数据,采用文件方式存储,按时间(默认为10S)结合大小(默认为100M)进行分文件,并支持压缩,采用FTP方式传送。

文件总体说明:

? 数据文件采用ASCII编码,文本格式。

? 文件以一定周期生成,周期可设,缺省为1小时,如可设为5分钟、10分钟、15

分钟、30分钟、1小时。

? 每天生成的所有文件存储在同一个目录下。目录名采用yyyymmdd格式,如在

20110510目录下存储所有2011年05月10日全天24小时生成的文件。 ? 对同一周期内生成的文件如果超过设定门限,自动分割生成新的文件,通过文件名

标识同一周期及生成顺序。门限缺省为100M。

? 支持文件压缩,是否压缩可设,压缩格式为gzip(.gz)。

? 文件存储在共享层设备的接口机上,在接口机侧打开FTP服务(接口机可能有多

台)。接口机上的文件由接口机侧维护,保留时间可以设置。

第20页

5.3 接口和数据结构要求

网络日志服务器至应用层接口,原则上要求网络日志服务器根据应用层接口规范,进行开发。 5.3.1

至数据合成服务器接口(南向)

该接口消息流程、文件格式及命名规则参见《中国移动上网日志留存系统数据合成服务器接口规范(CS域)》和《中国移动上网日志留存系统数据合成服务器接口规范(PS域)

》。 5.3.2

至IDC信息安全管理系统接口(南向)

具体接口要求参见《中国移动IDC/ISP信息安全管理系统接口规范》及附录。 5.3.3

至上网日志查询平台接口(北向)

网络日志服务器采用多点组网,用户上网日志查询系统需通过CMNET承载网络,连接全网范围内的所有网络日志服务器。网络日志服务器负责向用户日志上网查询系统提供查询接口。

该接口消息流程、文件格式及命名规则参见《中国移动上网日志留存系统用户上网日志查询系统接口规范》。 5.3.4

至指定系统(经上报网关)接口(北向)

具体接口规范参考《中国移动上网日志留存系统日志上报网关系统设备规范》。

接口主要包含:日志上报接口、用户在线状态查询接口、用户上网日志重报接口、告警事件上报接口。 5.3.5

至性能管理系统接口(北向)

网络日志服务器与性能管理系统的接口同数据合成服务器至网络日志间的接口,CS域方面具体数据要求和结构请参见《中国移动上网日志留存系统数据合成服务器接口规范(CS域)》,PS域方面具体数据要求和结构请参见《中国移动上网日志留存系统数据合成服务器接口规范(PS域)》。 5.3.6 向)

网络日志服务器与手机恶意软件监控系统接口同数据合成服务器至网络日志间的接口,具体接口规范参考《中国移动手机恶意软件监测系统接口规范》。 5.3.7

至经营分析系统(经上报网关)接口(北向) 至手机恶意软件监控系统日志检测模块(SCA)接口(北

具体接口规范参考《中国移动上网日志留存系统日志上报网关系统设备规范》。 5.3.8

至IDC信息安全管理系统接口(北向)

具体接口规范参考《中国移动IDC/ISP信息安全管理系统接口规范》。

第21页

6 编制历史

表7-1 编制历史

版本号 更新时间 主要内容或重大修改 附录A 省市编号

A.1. 省编号

省编号 551 100 591 931 200 771 851 898 311 371 451 270 731 431 250 791 240 省名称 安徽 北京 福建 甘肃 广东 广西 贵州 海南 河北 河南 黑龙江 湖北 湖南 吉林 江苏 江西 辽宁

第22页

471 951 971 531 351 290 210 280 220 891 991 871 571 230 内蒙古 宁夏 青海 山东 山西 陕西 上海 四川 天津 西藏 新疆 云南 浙江 重庆 A.2. 市编号

省编号 551 551 551 551 551 551 551 551 551 551 551 551 省名称 安徽 安徽 安徽 安徽 安徽 安徽 安徽 安徽 安徽 安徽 安徽 安徽 市名称 安庆 蚌埠 巢湖 池州 滁州 阜阳 合肥 淮北 淮南 黄山 六安 马鞍山 市编号 0556 0552 0565 0566 0550 0558 0551 0561 0554 0559 0564 0555

第23页

551 551 551 551 100 591 591 591 591 591 591 591 591 591 931 931 931 931 931 931 931 931 931 931 931 931 200 200 200 安徽 安徽 安徽 安徽 北京 福建 福建 福建 福建 福建 福建 福建 福建 福建 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 甘肃 广东 广东 广东 宿州 铜陵 芜湖 宣城 北京 福州 龙岩 南平 宁德 莆田 泉州 三明 厦门 漳州 白银 定西 甘南 金昌武威 酒泉嘉峪关 兰州 临夏 陇南 平凉 庆阳 天水 张掖 潮州 东莞 佛山 0557 0562 0553 0563 010 0591 0597 0599 0593 0594 0595 0598 0592 0596 0943 0932 0941 0935 0937 0931 0930 0939 0933 0934 0938 0936 0768 0769 0757

第24页

200 200 200 200 200 200 200 200 200 200 200 200 200 200 200 200 200 200 771 771 771 771 771 771 771 771 771 771 851 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广东 广西 广西 广西 广西 广西 广西 广西 广西 广西 广西 贵州 广州 河源 惠州 江门 揭阳 茂名 梅州 清远 汕头 汕尾 韶关 深圳 阳江 云浮 湛江 肇庆 中山 珠海 百色 北海 防城港 桂林 河池 柳州 南宁 钦州 梧州 玉林 安顺 020 0762 0752 0750 0663 0668 0753 0763 0754 0660 0751 0755 0662 0766 0759 0758 0760 0756 0776 0779 0770 0773 0778 0772 0771 0777 0774 0775 0853

第25页

851 851 851 851 851 851 851 851 898 311 311 311 311 311 311 311 311 311 311 311 371 371 371 371 371 371 371 371 371 贵州 贵州 贵州 贵州 贵州 贵州 贵州 贵州 海南 河北 河北 河北 河北 河北 河北 河北 河北 河北 河北 河北 河南 河南 河南 河南 河南 河南 河南 河南 河南 毕节 都匀 贵阳 凯里 六盘水 铜仁 兴义 遵义 海口 保定 沧州 承德 邯郸 衡水 廊坊 秦皇岛 石家庄 唐山 邢台 张家口 安阳 鹤壁 焦作 开封 洛阳 南阳 平顶山 三门峡 商丘 0857 0854 0851 0855 0858 0856 0859 0852 0898 0312 0317 0314 0310 0318 0316 0335 0311 0315 0319 0313 0372 0392 0391 0378 0379 0377 0375 0398 0370

第26页

371 371 371 371 371 371 371 371 371 451 451 451 451 451 451 451 451 451 451 451 451 451 270 270 270 270 270 270 270 河南 河南 河南 河南 河南 河南 河南 河南 河南 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 黑龙江 湖北 湖北 湖北 湖北 湖北 湖北 湖北 新乡 信阳 许昌 郑州 周口 驻马店 潢川 漯河 濮阳 大庆 大兴安岭 哈尔滨 鹤岗 黑河 鸡西 佳木斯 牡丹江 七台河 齐齐哈尔 双鸭山 绥化 伊春 鄂州 恩施 黄冈 黄石 江汉 荆门 荆州 0373 0376 0374 0371 0394 0396 0376 0395 0393 0459 0456 0451 0454 0456 0453 0454 0453 0453 0452 0454 0458 0458 0711 0718 0713 0714 0728 0724 0716

第27页

270 270 270 270 270 270 270 731 731 731 731 731 731 731 731 731 731 731 731 731 731 431 431 431 431 431 431 431 431 湖北 湖北 湖北 湖北 湖北 湖北 湖北 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 湖南 吉林 吉林 吉林 吉林 吉林 吉林 吉林 吉林 十堰 随州 武汉 咸宁 襄樊 孝感 宜昌 常德 长沙 郴州 衡阳 怀化 吉首 娄底 邵阳 湘潭 益阳 永州 岳阳 张家界 株洲 白城 白山 长春 吉林 辽源 梅河口 四平 松原 0719 0722 027 0715 0710 0712 0717 0736 0731 0735 0734 0745 0743 0738 0739 0732 0737 0746 0730 0744 0733 0436 0439 0431 0432 0437 0435 0434 0438

第28页

431 431 431 250 250 250 250 250 250 250 250 250 250 250 250 250 791 791 791 791 791 791 791 791 791 791 791 240 240 吉林 吉林 吉林 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江苏 江西 江西 江西 江西 江西 江西 江西 江西 江西 江西 江西 辽宁 辽宁 通化 延吉 珲春 常州 淮安 连云港 南京 南通 苏州 宿迁 泰州 无锡 徐州 盐城 扬州 镇江 抚州 赣州 吉安 景德镇 九江 南昌 萍乡 上饶 新余 宜春 鹰潭 鞍山 本溪 0435 0433 0433 0519 0517 0518 025 0513 0512 0527 0523 0510 0516 0515 0514 0511 0794 0797 0796 0798 0792 0791 0799 0793 0790 0795 0701 0412 0414

第29页

240 240 240 240 240 240 240 240 240 240 240 240 471 471 471 471 471 471 471 471 471 471 471 471 951 951 951 951 951 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 辽宁 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 内蒙古 宁夏 宁夏 宁夏 宁夏 宁夏 朝阳 大连 丹东 抚顺 阜新 葫芦岛 锦州 辽阳 盘锦 沈阳 铁岭 营口 巴彦浩特 包头 赤峰 鄂尔多斯 海拉尔 呼和浩特 集宁 临河 通辽 乌海 乌兰浩特 锡林浩特 固原 石嘴山 吴忠 银川 中卫 0421 0411 0415 0413 0418 0429 0416 0419 0427 024 0410 0417 0483 0472 0476 0477 0470 0471 0474 0478 0475 0473 0482 0479 0954 0952 0953 0951 0955

第30页

971 971 971 971 971 971 971 971 971 531 531 531 531 531 531 531 531 531 531 531 531 531 531 531 531 531 351 351 351 青海 青海 青海 青海 青海 青海 青海 青海 青海 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山东 山西 山西 山西 德令哈 格尔木 共和 果洛 海东 海晏 黄南 西宁 玉树 滨州 德州 东营 菏泽 济南 济宁 莱芜 聊城 临沂 青岛 日照 泰安 威海 潍坊 烟台 枣庄 淄博 长治 大同 晋城 0977 0979 0974 0975 0972 0970 0973 0971 0976 0543 0534 0546 0530 0531 0537 0634 0635 0539 0532 0633 0538 0631 0536 0535 0632 0533 0355 0352 0356

第31页

351 351 351 351 351 351 351 351 290 290 290 290 290 290 290 290 290 290 210 280 280 280 280 280 280 280 280 280 280 山西 山西 山西 山西 山西 山西 山西 山西 陕西 陕西 陕西 陕西 陕西 陕西 陕西 陕西 陕西 陕西 上海 四川 四川 四川 四川 四川 四川 四川 四川 四川 四川 晋中 临汾 吕梁 朔州 太原 忻州 阳泉 运城 安康 宝鸡 汉中 商洛 铜川 渭南 西安 咸阳 延安 榆林 上海 阿坝 巴中 成都 达州 德阳 甘孜 广安 广元 乐山 凉山 0354 0357 0358 0349 0351 0350 0353 0359 0915 0917 0916 0914 0919 0913 029 029 0911 0912 021 0837 0827 028 0818 0838 0836 0826 0839 0833 0834

第32页

280 280 280 280 280 280 280 280 280 280 280 220 891 891 891 891 891 891 891 991 991 991 991 991 991 991 991 991 991 四川 四川 四川 四川 四川 四川 四川 四川 四川 四川 四川 天津 西藏 西藏 西藏 西藏 西藏 西藏 西藏 新疆 新疆 新疆 新疆 新疆 新疆 新疆 新疆 新疆 新疆 眉山 绵阳 南充 内江 攀枝花 遂宁 雅安 宜宾 资阳 自贡 泸州 天津 阿里 昌都 拉萨 林芝 那曲 日喀则 山南 阿克苏 阿勒泰 博乐 昌吉 哈密 和田 喀什 克拉玛依 克州 库尔勒 0833 0816 0817 0832 0812 0825 0835 0831 0832 0813 0830 022 0897 0895 0891 0894 0896 0892 0893 0997 0906 0909 0994 0902 0903 0998 0990 0908 0996

第33页

991 991 991 991 991 991 871 871 871 871 871 871 871 871 871 871 871 871 871 871 871 871 571 571 571 571 571 571 571 新疆 新疆 新疆 新疆 新疆 新疆 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 云南 浙江 浙江 浙江 浙江 浙江 浙江 浙江 奎屯 石河子 塔城 吐鲁番 乌鲁木齐 伊犁 版纳 保山 楚雄 大理 德宏 迪庆 红河 昆明 丽江 临沧 怒江 曲靖 思茅 文山 玉溪 昭通 杭州 湖州 嘉兴 金华 丽水 宁波 绍兴 0992 0993 0901 0995 0991 0999 0691 0875 0878 0872 0692 0887 0873 0871 0888 0883 0886 0874 0879 0876 0877 0870 0571 0572 0573 0579 0578 0574 0575

第34页

571 571 571 571 230 230 230 230 0

浙江 浙江 浙江 浙江 重庆 重庆 重庆 重庆 未知省 台州 温州 舟山 衢州 涪陵 黔江 万州 重庆 未知地市 0576 0577 0580 0570 023 023 023 023 000

第35页

联系客服:779662525#qq.com(#替换为@)