聪明文档网

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

中国移动通信企业标准

I n t e r f a c e Sp e c i f i c a t i o n o f Ch i n a Mo b i l e Ne t l o g Sy s t e m

（ Ne t l o g Se r v e r Pa r t ）

版本号：1.0.0

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

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

前	言 ............................................................................................................................................				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

	5.3	接口和数据结构要求 .............................................................................................		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

III

前言

本标准规定了中国移动上网日志留存系统网络日志服务器与其他相关网元设备和应用

系统连接的接口标准，以及系统内部需要公开定义的各种接口。

本标准原则上在中国移动通信集团公司内部使用，为业务开展、招标选型、工程建设

及运行维护提供技术依据，适用于 GSM/3G网络环境。

本标准主要包括以下几方面内容：系统结构、接口协议、业务信令数据共享接口、

CDR/TDR信令数据共享接口以及全量信令数据反查接口。

本标准是中国移动上网日志留存系统系列标准之一，该系列标准的结构、名称或预计

名称如下：
序号	标准编号	标准名称		发布单位
[1]		中国移动上网日志留存系统总体技术要求		中国移动通信集团公司
[2]		中国移动上网日志留存系统	Gn采集解析设	中国移动通信集团公司
[2]		中国移动上网日志留存系统	Gn采集解析设
		备规范
[3]		中国移动上网日志留存系统	Gb/Iu-Ps 采集	中国移动通信集团公司
[3]		中国移动上网日志留存系统	Gb/Iu-Ps 采集
		解析设备规范
[4]		中国移动上网日志留存系统防火墙日志采		中国移动通信集团公司
		集前置机数据传递要求
[5]		中国移动上网日志留存系统数据合成服务		中国移动通信集团公司
		器设备规范（ CS域）
[6]		中国移动上网日志留存系统数据合成服务		中国移动通信集团公司
[6]		中国移动上网日志留存系统数据合成服务
		器设备规范（ PS域）
[7]		中国移动上网日志留存系统数据合成服务		中国移动通信集团公司
		器接口规范（ CS域）
[8]		中国移动上网日志留存系统数据合成服务		中国移动通信集团公司
		器接口规范（ PS域）

[9]	中国移动上网日志留存系统网络日志服务	中国移动通信集团公司
[9]	中国移动上网日志留存系统网络日志服务
	器设备规范
[10]	中国移动上网日志留存系统网络日志服务	中国移动通信集团公司

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

[22]		中国移动上网日志留存系统“金库模式”
		实施指导意见

中国移动通信集团公司

本标准由中国移动通信集团公司网络部提出，集团公司技术部归口。

本标准起草单位：中国移动通信集团网络部

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

GSM/3G 网络环

1范围

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

建设的技术规范，为业务开展、招标选型、工程建设及运行维护提供技术依据。

本标准原则上在中国移动通信集团公司内部和厂商共同使用，适用于

境。

2规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，

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

最新版本适用于本标准。

		表 2-1	规范性引用文件
序号	标准编号	标准名称		发布单位
[1]	TS 24.008	Mobile radio interface Layer 3 specificati		3GPP
			on;
		Core network protocols; Stage 3
[2]	TS 24.011	Point-to-Point (PP) Short Message Servic		3GPP
		e (SMS)
		support on mobile radio interface
[3]	TS 48.008	Mobile Switching Centre - Base Station		3GPP
		System (MSC-
		BSS) interface;Layer 3 specification
[4]	TS 48.006	Signalling transport mechanism specificat		3GPP
			ion
		for the Base Station System - Mobile-
		services Switching Centre (BSS - MSC) i
		nterface
[5]	TS 52.008	GSM subscriber and equipment trace		3GPP
[6]	TS 52.021	Network Management (NM) procedures a		3GPP
		nd messages
		on the A-bis interface

[7]	TS 49.031	Base Station System Application Part	3GPP
		LCS Extension (BSSAP-LE)
[8]	TS 25.413	UTRAN Iu interface	3GPP
		Radio Access Network Application Part (
		RANAP) signalling
[9]	ITU-T Q.752	Monitoring and Measurements for	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 信令数据进行解析、处
	理，从中提取出对业务应用所需的信令事件数据，例如：呼叫事件、
		位置更新事件、漫游事件等
指标数据	指标数据是根据信令监测系统生成的		CDR/TDR 或者信令消息统计生
		成的各类 Kpi 指标数据，例如：接通率、位置更新成功率等
AD		Application Domain ，应用层
CC		Call Control ，呼叫控制
DDU		Data Dispatch Unit ，数据分发单元
DXC		Digital Cross Connect ，数字交叉设备
GRSAP		GRS Application Part ，漫游欢迎系统应用部分
HDLC		High-Level Data Link Control	，高级数据链路控制规程
IE		Information Element ，信令消息中的信息单元

IP		Internet Protocol ， IP协议
MCIP		Mobile Cell ，小区短信应用部分
MM		Mobility Management ，移动性管理
ODBC		Open Database Connectivity ，开放数据库连接
OMC		Operation Management Center ，系统管理单元
RR		Radio Resource，无线资源管理
SAU		Signal Analysis Unit ，信令分析单元
SCG		Signal Collection Gateway ，信令采集网关

第7 页

SDTP	Shared Data Transfer Protocol ，共享数据传输协议
SDU	Shared Data Unit ，共享数据单元
SMU	Service Management Unit ，业务 / 服务管理单元
SNMP	Simple Network Management Protocol ，简单网络管理协议
SOA	Service-Oriented Architecture ，面向服务的体系架构
SPU	Signal Preprocess Unit ，信令预处理单元
SU	Store Unit ，存储单元
TAP	Test Access Point ，测试接入端口
CDR	Call Detail Record ，呼叫详细记录
TDR	Transaction Detail Record ，事务详细记录
MSISDN	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 作为底层通信承载，具体协议结构如下图所示：

APP 应用层

SDTP

传输层

TCP

IP 承载层

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

协议栈分为 3层，分别为承载层、传输层和应用层。其中，承载层为 IP协议，它提供可

靠的数据传输通道；传输层（ SDTP+TCP ）为上层应用提供通用的数据传输协议；应用层封

装适合于各应用系统的原始信令数据、 CDR/TDR 数据。数据合成服务器通过 SDTP 协议适配

各应用系统所需的特定协议。

第10 页

数据订阅点数据提供点

SDTP SDTP

TCP TCP

IP IP

数据链路层数据链路层

物理层物理层

图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 消息类型定义

消息名 MessageType 说明

值

verNego_Req 0x0001 版本协商请求

第11 页

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-2	SDTP 消息结构
项目		说明
Message Header	消息头 (所有消息公共包头 )
Message Body		消息体，即各类参数

消息头（ Message Header）的包含如下字段：（对 SDTP 接口，下述所有字段必填）

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

5.1.3 连接管理流程

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

定.

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

第12 页

客户端服务端

1.TCP/HTTP 连接建立

2.版本协商请求 verNego_Req

2.版本协商应答 verNego_Resp

3.链路鉴权请求 linkAuth_Req

3.链路鉴权应答 linkAuth_Resp

4.数据发送请求

4.数据发送应答

5.链路检测请求 linkCheck_Req

5.链路检测应答 linkCheck_Resp

6.链路数据发送校验 linkDataCheck_Req

6.链路数据发送校验应答 linkDataCheck_Resp

7.链路释放请求 linkRel_Req

7.链路释放应答 linkRel_Resp

8.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	1	Unsigned Integer	协议的主版本号
SubVersion	1	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 。

由连接的服务端给连接的客户端分配

的连接帐号。

字段名字节数类型描述

Digest 64 String 用于鉴别源用户，其值通过 SHA256 计

算得出，当对端用相同方式加密之后与

接收值比较，如果计算出来的值相同，

第14 页

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

5.1.4.1.4 应答

连接鉴权应答，参数定义如下：

表 5-7 参数定义

字段名字节数类型描述

Result 1 Unsigned Integer 鉴权的返回结果。各个值的含义如下定

义：

1 代表鉴权通过。

2 代表 LoginID 不存在。

3 代表 SHA256 加密结果出错。

Digest 64 String 用于对端对本端进行鉴权，其值通过

SHA256 计算得出，当对端用相同方式

加密之后与接收值比较，如果计算出

来的值相同，则通过校验，否则出错。

链路检测 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小时内不重复
				即可。本参数目的是为了发现校验包的
				丢失，可以通过该参数判断出校验包的
				丢包。
SendDataInf		4	int	距离上次发送间发送的数据包数
o				量。（仅仅包含 notifyCDR/TDRData_Req
				和 XDRRawDataSend_Req包的数量）

5.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包的数量）

第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

的原始数据可以分多个包传输，但需要

保证每个包的本字段唯一，用于上层进

行关联。

Load 原始数据，二进制码流，数据结构详见

第 7章节

第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	2	Unsigned Integer	CDR数据类型，详见表 5-11
CDRID	8	Long Integer	根据这个 ID 来关联原始数据
Load			CDR/TDR 的具体数据内容，具体请参
			见 6.1.1节相关定义

表5-11 CDR 数据类型定义

CDR 类型	Type 值
AIU语音事件	1
切换事件	2
开关机事件	3
位置更新事件	4
短信呼叫事件	5
接入网事件	6
寻呼事件	7
NC口呼叫事件	8

5.1.4.1.14 通知应答

表5-13 通知应答

属性字节数类型描述

Result 1 Unsigned Integer 请求的返回结果：

第18 页

1 代表成功

其它代表失败

5.2 FTP 文件传输协议

FTP文件传输协议为非实时接口，包括：

数据合成服务器向共享层提供话单数据；

数据合成服务器向共享层提供信令数据；

数据合成服务器共享层提供用户监控数据（特定用户的上网日志，以话单数据文件形式上传）；

5.2.1 接口说明

该接口用于数据合成服务器向共享层传输话单数据及信令数据时使用，需要数据合

成服务器开发厂商按照此协议完成接口通讯软件的开发工作。

该接口使用 FTP 协议，规则约定如下：

1)采用 FTP 方式进行数据传输，共享层向数据合成服务器开放文件存储服务器及路径，采集层定时将话单数据上传；

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

3)	数据文件命名采用 SSS_HW_XXXXYYYYMMDDHHMI_NN.A				VL 方式，其中 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 数据校验文件格式

抽取方式可根据具体应用需求进行订阅

及周期

校验文件 SSS_HW_XXXXYYYYMMDDHHMI.CHK

名

属性编码属性名称属性描述类型备注

01 file_name 数据文件名 string 其中 XXXX 应包含话单类

型信息。

02 row_num 记录行数 string

03 file_time 文件生成时间 string YYYY-MM-DD

第19 页

HH:MM:SS

校验文件内容示例如下：

file_name:100_23_2423_V oiceCall_Event201007232100.A VL

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 至手机恶意软件监控系统日志检测模块 (SCA) 接口 (北

向）

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

5.3.7 至经营分析系统（经上报网关）接口（北向）

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

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	安徽	安庆	0556
551	安徽	蚌埠	0552
551	安徽	巢湖	0565
551	安徽	池州	0566
551	安徽	滁州	0550
551	安徽	阜阳	0558
551	安徽	合肥	0551
551	安徽	淮北	0561
551	安徽	淮南	0554
551	安徽	黄山	0559
551	安徽	六安	0564
551	安徽	马鞍山	0555

第23 页

551	安徽	宿州	0557
551	安徽	铜陵	0562
551	安徽	芜湖	0553
551	安徽	宣城	0563
100	北京	北京	010
591	福建	福州	0591
591	福建	龙岩	0597
591	福建	南平	0599
591	福建	宁德	0593
591	福建	莆田	0594
591	福建	泉州	0595
591	福建	三明	0598
591	福建	厦门	0592
591	福建	漳州	0596
931	甘肃	白银	0943
931	甘肃	定西	0932
931	甘肃	甘南	0941
931	甘肃	金昌武威	0935
931	甘肃	酒泉嘉峪关	0937
931	甘肃	兰州	0931

931	甘肃	临夏	0930
931	甘肃	陇南	0939
931	甘肃	平凉	0933
931	甘肃	庆阳	0934
931	甘肃	天水	0938
931	甘肃	张掖	0936
200	广东	潮州	0768
200	广东	东莞	0769
200	广东	佛山	0757

第24 页

200	广东	广州	020
200	广东	河源	0762
200	广东	惠州	0752
200	广东	江门	0750
200	广东	揭阳	0663
200	广东	茂名	0668
200	广东	梅州	0753
200	广东	清远	0763
200	广东	汕头	0754
200	广东	汕尾	0660
200	广东	韶关	0751
200	广东	深圳	0755
200	广东	阳江	0662
200	广东	云浮	0766
200	广东	湛江	0759
200	广东	肇庆	0758
200	广东	中山	0760
200	广东	珠海	0756
771	广西	百色	0776
771	广西	北海	0779

771	广西	防城港	0770
771	广西	桂林	0773
771	广西	河池	0778
771	广西	柳州	0772
771	广西	南宁	0771
771	广西	钦州	0777
771	广西	梧州	0774
771	广西	玉林	0775
851	贵州	安顺	0853

第25 页

851	贵州	毕节	0857
851	贵州	都匀	0854
851	贵州	贵阳	0851
851	贵州	凯里	0855
851	贵州	六盘水	0858
851	贵州	铜仁	0856
851	贵州	兴义	0859
851	贵州	遵义	0852
898	海南	海口	0898
311	河北	保定	0312
311	河北	沧州	0317
311	河北	承德	0314
311	河北	邯郸	0310
311	河北	衡水	0318
311	河北	廊坊	0316
311	河北	秦皇岛	0335
311	河北	石家庄	0311
311	河北	唐山	0315
311	河北	邢台	0319
311	河北	张家口	0313

371	河南	安阳	0372
371	河南	鹤壁	0392
371	河南	焦作	0391
371	河南	开封	0378
371	河南	洛阳	0379
371	河南	南阳	0377
371	河南	平顶山	0375
371	河南	三门峡	0398
371	河南	商丘	0370

第26 页

371	河南	新乡	0373
371	河南	信阳	0376
371	河南	许昌	0374
371	河南	郑州	0371
371	河南	周口	0394
371	河南	驻马店	0396
371	河南	潢川	0376
371	河南	漯河	0395
371	河南	濮阳	0393
451	黑龙江	大庆	0459
451	黑龙江	大兴安岭	0456
451	黑龙江	哈尔滨	0451
451	黑龙江	鹤岗	0454
451	黑龙江	黑河	0456
451	黑龙江	鸡西	0453
451	黑龙江	佳木斯	0454
451	黑龙江	牡丹江	0453
451	黑龙江	七台河	0453
451	黑龙江	齐齐哈尔	0452
451	黑龙江	双鸭山	0454

451	黑龙江	绥化	0458
451	黑龙江	伊春	0458
270	湖北	鄂州	0711
270	湖北	恩施	0718
270	湖北	黄冈	0713
270	湖北	黄石	0714
270	湖北	江汉	0728
270	湖北	荆门	0724
270	湖北	荆州	0716

第27 页

270	湖北	十堰	0719
270	湖北	随州	0722
270	湖北	武汉	027
270	湖北	咸宁	0715
270	湖北	襄樊	0710
270	湖北	孝感	0712
270	湖北	宜昌	0717
731	湖南	常德	0736
731	湖南	长沙	0731
731	湖南	郴州	0735
731	湖南	衡阳	0734
731	湖南	怀化	0745
731	湖南	吉首	0743
731	湖南	娄底	0738
731	湖南	邵阳	0739
731	湖南	湘潭	0732
731	湖南	益阳	0737
731	湖南	永州	0746
731	湖南	岳阳	0730
731	湖南	张家界	0744

731	湖南	株洲	0733
431	吉林	白城	0436
431	吉林	白山	0439
431	吉林	长春	0431
431	吉林	吉林	0432
431	吉林	辽源	0437
431	吉林	梅河口	0435
431	吉林	四平	0434
431	吉林	松原	0438

第28 页

431	吉林	通化	0435
431	吉林	延吉	0433
431	吉林	珲春	0433
250	江苏	常州	0519
250	江苏	淮安	0517
250	江苏	连云港	0518
250	江苏	南京	025
250	江苏	南通	0513
250	江苏	苏州	0512
250	江苏	宿迁	0527
250	江苏	泰州	0523
250	江苏	无锡	0510
250	江苏	徐州	0516
250	江苏	盐城	0515
250	江苏	扬州	0514
250	江苏	镇江	0511
791	江西	抚州	0794
791	江西	赣州	0797
791	江西	吉安	0796
791	江西	景德镇	0798

791	江西	九江	0792
791	江西	南昌	0791
791	江西	萍乡	0799
791	江西	上饶	0793
791	江西	新余	0790
791	江西	宜春	0795
791	江西	鹰潭	0701
240	辽宁	鞍山	0412
240	辽宁	本溪	0414

第29 页

240	辽宁	朝阳	0421
240	辽宁	大连	0411
240	辽宁	丹东	0415
240	辽宁	抚顺	0413
240	辽宁	阜新	0418
240	辽宁	葫芦岛	0429
240	辽宁	锦州	0416
240	辽宁	辽阳	0419
240	辽宁	盘锦	0427
240	辽宁	沈阳	024
240	辽宁	铁岭	0410
240	辽宁	营口	0417
471	内蒙古	巴彦浩特	0483
471	内蒙古	包头	0472
471	内蒙古	赤峰	0476
471	内蒙古	鄂尔多斯	0477
471	内蒙古	海拉尔	0470
471	内蒙古	呼和浩特	0471
471	内蒙古	集宁	0474
471	内蒙古	临河	0478

471	内蒙古	通辽	0475
471	内蒙古	乌海	0473
471	内蒙古	乌兰浩特	0482
471	内蒙古	锡林浩特	0479
951	宁夏	固原	0954
951	宁夏	石嘴山	0952
951	宁夏	吴忠	0953
951	宁夏	银川	0951
951	宁夏	中卫	0955

第30 页

971	青海	德令哈	0977
971	青海	格尔木	0979
971	青海	共和	0974
971	青海	果洛	0975
971	青海	海东	0972
971	青海	海晏	0970
971	青海	黄南	0973
971	青海	西宁	0971
971	青海	玉树	0976
531	山东	滨州	0543
531	山东	德州	0534
531	山东	东营	0546
531	山东	菏泽	0530
531	山东	济南	0531
531	山东	济宁	0537
531	山东	莱芜	0634
531	山东	聊城	0635
531	山东	临沂	0539
531	山东	青岛	0532
531	山东	日照	0633

531	山东	泰安	0538
531	山东	威海	0631
531	山东	潍坊	0536
531	山东	烟台	0535
531	山东	枣庄	0632
531	山东	淄博	0533
351	山西	长治	0355
351	山西	大同	0352
351	山西	晋城	0356

第31 页

351	山西	晋中	0354
351	山西	临汾	0357
351	山西	吕梁	0358
351	山西	朔州	0349
351	山西	太原	0351
351	山西	忻州	0350
351	山西	阳泉	0353
351	山西	运城	0359
290	陕西	安康	0915
290	陕西	宝鸡	0917
290	陕西	汉中	0916
290	陕西	商洛	0914
290	陕西	铜川	0919
290	陕西	渭南	0913
290	陕西	西安	029
290	陕西	咸阳	029
290	陕西	延安	0911
290	陕西	榆林	0912
210	上海	上海	021
280	四川	阿坝	0837

280	四川	巴中	0827
280	四川	成都	028
280	四川	达州	0818
280	四川	德阳	0838
280	四川	甘孜	0836
280	四川	广安	0826
280	四川	广元	0839
280	四川	乐山	0833
280	四川	凉山	0834

第32 页

280	四川	眉山	0833
280	四川	绵阳	0816
280	四川	南充	0817
280	四川	内江	0832
280	四川	攀枝花	0812
280	四川	遂宁	0825
280	四川	雅安	0835
280	四川	宜宾	0831
280	四川	资阳	0832
280	四川	自贡	0813
280	四川	泸州	0830
220	天津	天津	022
891	西藏	阿里	0897
891	西藏	昌都	0895
891	西藏	拉萨	0891
891	西藏	林芝	0894
891	西藏	那曲	0896
891	西藏	日喀则	0892
891	西藏	山南	0893
991	新疆	阿克苏	0997

991	新疆	阿勒泰	0906
991	新疆	博乐	0909
991	新疆	昌吉	0994
991	新疆	哈密	0902
991	新疆	和田	0903
991	新疆	喀什	0998
991	新疆	克拉玛依	0990
991	新疆	克州	0908
991	新疆	库尔勒	0996

第33 页

991	新疆	奎屯	0992
991	新疆	石河子	0993
991	新疆	塔城	0901
991	新疆	吐鲁番	0995
991	新疆	乌鲁木齐	0991
991	新疆	伊犁	0999
871	云南	版纳	0691
871	云南	保山	0875
871	云南	楚雄	0878
871	云南	大理	0872
871	云南	德宏	0692
871	云南	迪庆	0887
871	云南	红河	0873
871	云南	昆明	0871
871	云南	丽江	0888
871	云南	临沧	0883
871	云南	怒江	0886
871	云南	曲靖	0874
871	云南	思茅	0879
871	云南	文山	0876

871	云南	玉溪	0877
871	云南	昭通	0870
571	浙江	杭州	0571
571	浙江	湖州	0572
571	浙江	嘉兴	0573
571	浙江	金华	0579
571	浙江	丽水	0578
571	浙江	宁波	0574
571	浙江	绍兴	0575

第34 页

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

第35 页

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

将本文的Word文档下载，方便收藏和打印