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

链路释放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页