当前位置:首页 >> 信息与通信 >>

中国联通增值业务综合网管系统技术规范 第六分册-接口技术规范3.0-正式版本


中 国 联 通 公 司 企 业 标 准
QB/CU XXX-20XX

中国联通增值业务综合网管系统 技术规范 第六分册 接口技术规范 (3.0)
China Unicom General Technical Specification of Network Management Systems for Value Added Servic

e (Version 3.0)

2010-xx-xx 发布

2010-xx-xx 实施

中国联通公司发布

中国联通增值业务综合网管系统技术规范 第六分册 3.0







言 .......................................................................................................................................... 1

1 范围.............................................................................................................................................. 4 2 规范性引用文件 .......................................................................................................................... 4 3 缩略语 .......................................................................................................................................... 4 4 系统接口 ...................................................................................................................................... 6 4.1 综述 .......................................................................................................................................................... 6 4.2 与增值业务系统的接口 .......................................................................................................................... 8 4.2.1 功能说明 ........................................................................................................................................... 8 4.2.2 非实时接口方式 ............................................................................................................................... 9 4.2.3 实时接口方式 ................................................................................................................................. 16 4.3 与主机/数据库代理的接口 ................................................................................................................... 23 4.3.1 功能说明 ......................................................................................................................................... 23 4.3.2 数据上传目录(FTP) .................................................................................................................. 23 4.4 省部接口 ................................................................................................................................................ 25 4.4.1 接口逻辑图 ..................................................................................................................................... 25 4.4.2 接口内容的范围 ............................................................................................................................. 25 4.4.3 接口双方的责任 ............................................................................................................................. 26 4.4.4 FTP/XML 接口方式定义 ................................................................................................................ 27 4.4.5 全网与省份消息交互 ..................................................................................................................... 37 4.5 监控管理两级接口 ................................................................................................................................ 45 4.5.1 上传接口文件说明 ......................................................................................................................... 45 4.5.2 上传接口数据定义 ......................................................................................................................... 64 4.5.3 平台数据集 ..................................................................................................................................... 65 4.5.4 业务数据集 ..................................................................................................................................... 66 4.6 局数据管理平台两级接口 .................................................................................................................... 78 4.6.1 下发标准局数据说明 ..................................................................................................................... 78

I

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.6.2 上传接口文件说明 ......................................................................................................................... 79 4.7 电子运维系统接口 ................................................................................................................................ 87 4.7.1 告警派单接口 ................................................................................................................................. 87 4.8 总部固网增值业务网管接口 ................................................................................................................ 98 4.9 电子运维系统与其他电子运维系统接口(预留) ............................................................................ 98 5 附录............................................................................................................................................ 98 5.1 附录 1------省份、省公司编码 ............................................................................................................. 99 5.2 附录 2------文件校验错误代码表 ....................................................................................................... 100 5.3 附录 3------拓扑节点命名规范 ........................................................................................................... 100 5.3.1 总拓扑节点命名规范 ................................................................................................................... 101 5.3.2 业务系统拓扑节点命名规范 ....................................................................................................... 102 5.4 附录 4 其他接口方式.......................................................................................................................... 102 5.4.1 非实时接口方式 ........................................................................................................................... 102 5.4.2 非实时接口方式 ........................................................................................................................... 107

II

中国联通增值业务综合网管系统技术规范 第六分册 3.0





本标准由中国联通网络公司运维部提出。 本标准由中国联通公司技术部归口。 本标准负责起草单位: 本标准主要起草人: 本标准的修改和解释权属中国联通公司。

第 1 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

文档版本记录
版本号
1.0 初稿 1.0 定稿 1.0 定稿 2010-12-17 2011-01-26 2011-04-19

发布时间

文档变更记录
版本号
1.0 初稿

修订时间
2010-12-17

修订人

修订说明
1、统一了增值业务综合网管与业务厂家、网管间、网管与 电子运维系统、网管与固网业务网管之间的接口方式; 2、 四期及以后项目统一要求了配置和性能数据采用 FTP+XML 方式,告警数据采用 SNMP TRAP 或 WEBSERVICE 方式;并具 体定义了告警指标; 3、新增了全网与省份信息交互部分,将回执文件、文件上 传及时性、重传机制等内容进行定义 4、增加拓扑上传,告警上报方式和格式进行统一 5、增加省部接口间统一要求的业务数据级告警(前期已接 入平台的告警指标) 6、将局数据管理和电子运维系统相关内容纳入该分册中

1.0 定稿

2011-01-26

1、 将其他接口方式移到附录中,正文只保留配置和性能数 据采用 FTP+XML 格式,告警采用 Web service 或 SNMP TRAP 方式, 其他接口方式在联通四期及以后项目中不再
第 2 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

采用 2、 更新实时接口方式中的 Web service 接口内容 1.0 定稿 2011-4-19 1、更新了 4.1 综述中的接口示意图及接口描述文字; 2、增加增电子运维与省网管系统间的接口

第 3 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

1 范围
本技术规范主要规定了增值业务综合网管系统与增值业务系统接口、省部接口等相关接口内容。 本技术规范是中国联通公司进行增值业务综合网管系统的规划与建设、设备制造、工程设计和通 信组织、网络运行、管理等的依据之一。 本规范适用于增值业务综合网管系统的系统提供商、 各增值业务系统设备提供商以及中国联通各 级运行维护人员。

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

3 缩略语
术语及缩写 英文 中文

第 4 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

BSS CORBA CP GSM KBP KPI

Business Support System Common Object Request Broker Architecture Content Provider Global System Mobile Key Business Point Key Performance Indicator

业务支撑系统 公共对象代理架构 内容提供商 全球移动通信系统 被管网元的关键业务点 被管网元的关键性能指标,也 泛指网管指标

KQI QoE SP XML FTP SNMP OMC EMS MSS EOMS HTTP WS NS SOAP

Key Quality Indicator Quality of Experience Service Provider Extensible Markup Language File Transfer Protocol Simple Network Management Protocol Operating Maintenance Center Elementary Management System Management Supporting System Electric Operation Maintenance System Hyper Text Transport Protocol Web Services Naming Space Simple Object Access Protocol

业务质量关键指标 用户体验质量 业务提供商 可扩展性编程语言 文件传输协议 简单网络管理协议 操作维护中心 网元管理系统 管理支撑系统 电子运行维护系统 超文本传输协议 Web 服务 命名空间 简单对象访问协议

第 5 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

WSDL XML

Web Service Definition Language eXtensible Markup Language

Web 服务定义语言 可扩展标记语言

4 系统接口
4.1 综述
增值业务综合网管系统的接口分为系统内部接口和系统外部接口。 系统内部接口主要是个平台或 子系统之间的接口,不做具体定义。系统外部主要包括增值业务综合网管与各增值业务系统间的采集 接口、两级网管系统之间接口和电子工单之间的接口等。并预留与其他业务系统的接口,如与大网网 管接口等。 接口示意图如下:
资源管理系统 总部

IF05

总部固网增值 业务网管

IF04

总部增值业务综 合网管 IF02

IF01

总部增值业务系统

其他电子运维 系统

预留

总部电子 运维系统

IF03 IF02

省分

省分电子运维 系统

IF02

省分增值业务综 合网管 IF05 IF06

IF01

省分增值业务系统

垃圾短信监控系统

资源管理系统

第 6 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

图4-1 系统接口示意图

编号

接口名称

接口标识

接口方 1

接口方 2

接口方式 配置性能接口:FTP+xml

接口描述 用于采集增值业务系统的 业务级数据, 包括业务性能

增值业务 增值业务综 1 数据采集 接口 IF01 合网管 增值业务 系统

告警接口:WEB SERVICE 或 SNMP TRAP

数据、 业务配置数据、 业务 告警数据

省分增值 电子运维 总部电子运 2 系统告警 派单接口 IF02 维系统 增值业务 综合网管 口,用于触发告警工单 网管/总部 Web Service/SOAP 合网管与电子工单系统接 业务综合 省分以及总部增值业务综

省部接口用于省分增值业 务综合网管向总部增值业 务综合网管上传平台数据 (包括主机、 网络设备、 数 省分增值 总部增值业 3 省部接口 IF03 务综合网管 网管 业务综合 告警接口:WEB SERVICE 配置性能接口:FTP+xml 据库等) 、业务数据(配置 数据、性能数据) 、拓扑数 据、 分析数据等; 总部增值 业务综合网管向省分增值 业务综合网管下发标准局 数据; 双方的数据传送消息 交互信息等

第 7 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

用于总部固网增值网管向 总部增值业务综合网管上 总部固网 总部增值业 4 增值业务 网管接口 IF04 务综合网管 网管 增值业务 告警接口:WEB SERVICE 络设备、数据库等) 、拓扑 数据等; 双方的数据传送消 息交互信息等 总部固网 配置性能接口:FTP 传平台数据 (包括主机、 网

垃圾短信 5 IF05 监控接口

省分增值业 务综合网管

垃圾短信 监控系统

传递白名单、 黑名单以及拦 截数据等

资源管理 6 IF06 接口

省分增值业 务综合网管

资源管理 系统

由增值综合网管来提供自 动发现的业务平台数据

注明:其中IF01和IF05接口的接口方式有所变动。前期已接入的系统仍可沿用以前的接口方式,所涉 及的业务系统包括:联通在信网关、短消息中心、短信业务平台、终端管理平台、VAC(增值业务用 户鉴权中心)、SP管理系统、短信互通网关、语音短信系统、炫铃平台、WAP业务平台、WAP网关、彩 信中心、彩信业务平台、行业网关、综合PUSH平台、综合下载平台、EMP(短消息扩展业务平台)、 定位平台、手机邮箱系统、手机支付平台、WAP门户运营支撑平台、彩信互通网关、彩信相册系统、 中央音乐平台及互联网音乐门户;本期新接入的业务系统为了便于管理,统一要求配置、性能数据采 用FTP+XML格式,告警数据采用WEB SERVICE或SNMP TRAP格式,不再采用多种接口方式任选的模式。 所涉及的业务系统包括:流媒体系统、视频运营管理平台及门户、视频IVR系统、视频炫铃系统、视 频上传分享平台、手机电视客户端平台、WO统一门户(移动互联网门户)、iPhone门户、内容管理系 统、视频监控系统、WEB网关、应用商店系统、WAP不良信息监控系统、内容拨测平台、手机号加密透 传平台、手机搜索平台、ENUM DNS平台、国际漫游欢迎短信系统、短信国际互通网关、116114平台。

4.2 与增值业务系统的接口 4.2.1 功能说明
增值业务网管与增值业务系统之间的接口用于采集增值业务系统的业务数据,包括性能数据、配 置数据和告警数据。 所采集的业务级数据指标要求见本系列规范之第二至第五分册。平台级数据指标定义以及指标 (KPI/KBP)编码规则见附录一。

第 8 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

根据移动增值业务网管规范KPI指标的采集周期,将业务系统与网管系统的接口分为两类: 非实 时接口方式和实时接口方式。 实时接口:主要用来处理时延要求较小的告警信息; 非实时接口:主要用来处理配置类和性能类KPI信息。

4.2.2 非实时接口方式
在非实时接口方式中,联通增值业务网管四期及以后项目统一采用FTP+XML方式,其他非实时接 口方式不再采用,原来已接入的系统接口方式不变。

4.2.2.1 XML Over FTP
在网管服务器为业务厂商建立FTP服务,并建立upSendMsg和result两个目录: upSendMsg:该目录用来存放上传指标的XML文件,上传和处理过程如下: (1) 业务厂商定期将业务指标的XML文件upload到该目录,在传输的过程中,在文件命名规 则的基础上,在后面增加字符串“.tmp”作为后缀,代表该文件正在传输过程中,当 文件传输完毕时,再将原文件更改为不带“.tmp”的正式文件名; (2) 网管服务器分析XML文件,在result目录给出回执,并将该XML文件命名为“.old”文 件,代表已处理; (3) 网管服务器定期将“.old”文件转移到其他目录作为备份。

result:该目录用来存放网管的回执XML文件,回执和处理过程如下: (1) 业务厂商上传业务指标XML文件完成一段时间之后(如半小时),主动查看是否生成了回 执文件; (2) 如果网管系统生成了回执,则需要进行分析,如果回执中列出错误,则需要业务厂商自 动进行分析处理,重新生成和上传业务指标XML文件。

4.2.2.1.1 上传业务指标接口的 XML 格式定义
(1)DTD文件格式(upSendMsg.dtd) <?xml version="1.0" encoding="gb2312"?>
第 9 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<!ELEMENT xmlData (head,body)> <!ELEMENT head (fileType,fileName,createFileTime,totalRecordNum)> <!ELEMENT fileType ANY> <!ELEMENT fileName ANY> <!ELEMENT createFileTime ANY> <!ELEMENT totalRecordNum ANY> <!ELEMENT body (kpi*)> <!ELEMENT kpi (kpiId,kbpId,dcTime,value)> <!ELEMENT kpiId ANY> <!ELEMENT kbpId ANY> <!ELEMENT dcTime ANY> <!ELEMENT value ANY> (2)XML数据文件格式 <?xml version="1.0" encoding="gb2312"?> <!DOCTYPE xmlData SYSTEM "upSendMsg.dtd"> <xmlData> <head> <fileType>文件类型</fileType> <fileName>文件名称</fileName> <createFileTime>文件生成时间(精确到分钟)</createFileTime> <totalRecordNum>总记录数</totalRecordNum> </head>
第 10 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<body> <kpi> <kpiId>PM-02-01-01-0</kpiId > <kbpId>01-01-cc-dd</kbpId > <dcTime>YYYYMMDDHHMM</dcTime> <value>1</value> </kpi> </body> </xmlData>

4.2.2.1.2 上传业务指标的回执 XML 格式文件的接口定义 (1)DTD文件格式(result.dtd)
<?xml version="1.0" encoding="gb2312"?> <!ELEMENT xmlData (head,body)> <!ELEMENT head (fileType,fileName,createFileTime, fileErrorCode,totalRecordNum,rightRecordNum, errorRecordNum)> <!ELEMENT fileType ANY> <!ELEMENT fileName ANY> <!ELEMENT createFileTime ANY> <!ELEMENT fileErrorCode ANY> <!ELEMENT totalRecordNum ANY> <!ELEMENT rightRecordNum ANY>

第 11 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<!ELEMENT errorRecordNum ANY> <!ELEMENT body (kpi*)> <!ELEMENT kpi (dcTime,kpiId,kbpId,errorCode)> <!ELEMENT dcTime ANY> <!ELEMENT kpiId ANY> <!ELEMENT kbpId ANY> <!ELEMENT errorCode ANY> (2)XML数据文件格式 <?xml version="1.0" encoding="gb2312"?> <!DOCTYPE xmlData SYSTEM "result.dtd"> <xmlData> <head> <fileType>文件类型</fileType> <fileName>文件名称</fileName> <createFileTime>YYYYMMDDHHMM</createFileTime> <fileErrorCode>文件错误代码</fileErrorCode> <totalRecordNum>总记录数</totalRecordNum> <rightRecordNum>正确记录数</rightRecordNum> <errorRecordNum>错误记录数</errorRecordNum> </head> <body> <kpi>
第 12 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<dcTime>200412180115</dcTime> <kpiId>PM-02-01-01-0</kpiId> <kbpId>01-01-cc-dd</kbpId> <errorCode>001</errorCode> </kpi> </body> </xmlData>

4.2.2.1.3 文件命名规则
文件命名规则:【B】【AAAA】【X】【SS】【KKYY】【YYYYMMDDHH】【NNN】.【TYPE】 规则代码 B 代码说明 按业务系统进行分类,为 KBP 编码中的 AAAA 之前的编号。 01:联通在信网关;02:短消息中心; 03:短信业务平台;04:定位 接入系统; 05:终端管理平台;06:增值业务用户鉴权中心; 07: SP 管理系统;08:短信互通网关;09:语音短信系统;10:炫铃平台; 11:WAP 业务平台;12:WAP 网关;13:彩信中心;14:彩信业务平 台;15:行业网关;16:综合 PUSH 平台;17:综合下载平台;18: 短消息扩展业务平台;19:定位平台;20:手机邮箱系统;21:手机支 付平台;22:WAP 门户运营支撑平台;23:彩信互通网关;24:彩信 相册系统; 25: 中央音乐平台及互联网音乐门户;26: 流媒体系统;27: 视频运营管理平台及门户;28:视频 IVR 系统;29:视频炫铃系统; 30:视频上传分享平台;31:手机电视客户端平台;32:wo 统一门户 (移动互联网门户) ;33:iPhone 门户;34:内容管理系统;35:视频 监控系统;36:WEB 网关;37:应用商店系统;38:WAP 不良信息监 控系统;39:内容拨测平台;40:手机号加密透传平台;41:手机搜索 平台;42:ENUM DNS 平台;43:国际漫游欢迎短信系统;44:短

备注 1 或 2 位

第 13 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

信国际互通网关;45:116114 平台 AAAA AAAA 表示业务系统所在城市的四位长途区号(不足四位的长途区号, 左 对齐,右补零) 具体总部及各省省会城市长途区号请参见附录 5.1 X SS KKYY X 表示 1 位序号,从 1 开始顺延递增,用于区分多个系统 关键业务模块编码,为对应 KPI 编码中二级分类部分(即 7-8 两位) 关键业务模块内的数据类型编码, 长度为 4 位。 编码形式为具体分类及 序号, 其中前两位 KK 为数据类型分类, 后两位 YY 为该数据类型分类中 的文件序号,取对应 KPI 编码中三级分类(即 9-10 两位),编码如下: 配置信息:CMYY 性能信息:PMYY 告警信息:FMYY YYYYMMDDHH 日期信息,表示上报内容的日期。如果是日报,HH 位填写“99”,如: 10 位 2004061299;如果是月报,DDHH 填写“0000”,如:2004060000。 NNN 本小时 (日/月) 文件的实际传送次数, 按类型分别计算。 第一次为 001。 3 位 如果文件内容不变,重传仍为 001;若第一次有错误记录,下一次把错 误记录修改后重新传送,文件序号为 002。且文件名中的序号与首记录 中文件序列号相同。 小时文件、日文件、月文件分别按指定的时间进行上传。要求在每日 3:00 前上报前一天的日文件; 每月 5 日 10:00 之前上报上月的月文件; 小时文件可以按照日文件方式统一集中上传,要求在每日 3:00 前上报 前一天的所有小时文件; TYPE 网管系统传输信息文件的分类,长度 3 位,具体如下: 1. MHI:按小时指标数据,对应的回执文件为:MHO; 2. MDI:按日指标数据,对应的回执文件为:MDO;

6位

1位 2位 4位

3位

第 14 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

3. MMI:按月指标数据,对应的回执文件为:MMO;

4.2.2.1.4 错误信息说明
错误信息包含在回执文件中返回给发起方,用来标识错误种类。 1、错误信息种类 (1)错误类型 错误种类分为以下二类: ? ? 文件错误(F)。当出现文件错误时,回执文件只包含文件头。 记录错误(R)。

对于两种类型的错误,源节点都需要重新上传出错的文件。 (2)错误代码范围划分 以下是错误代码分类及相应的错误代码范围。 ? ? 文件级错误:错误代码范围为001~099; 格式错误:数据类型错误(如:数值域中出现字母字符),这类错误的错误码范围为100~ 199; ? ? ? 无效的字段值:字段中的值不符合值域的定义范围,此类错误的代码范围为:200~299; 指标缺少错误:上传文件中缺少必须上报的指标,这类错误的代码范围为:300~399; 同一指标的采样记录缺少:上传文件中缺少指标的所有采样记录,这类错误的代码范围为: 400~499; ? 其它错误:不属于以上几类的错误为其它错误,错误代码的范围为:500~999。

2、文件错误 字段名 N/A N/A N/A N/A 错误代码 001 002 003 004 代码 文件格式错误 文件名错误 文件名中数据源节点代码错误 文件序列号错误
第 15 页

错误描述

中国联通增值业务综合网管系统技术规范 第六分册 3.0

字段名 N/A

错误代码 099 其它错误

错误描述

3、记录错误 下表中的错误代码的第一位根据错误代码分类确定。如KPI的格式错误时,错误代码为130;内容 代码 无效时,错误代码为230;缺少指定KPI时,错误代码为330;缺少指定KPI的采样记录时,错误代码为 430。 字段名 文件标志 错误代码 X01 X02 X03 X04 X30 X31 X32 X33 错误的文件标志 与文件名中的序列号不同 不符合年/月/日的规定 总记录数与详细记录数不符 错误描述

文件序列号
文件产生日期 总记录数 KPI KBP 采样时间 值

4.2.2.1.5 其他说明
虽然在XML Over FTP接口中,文件不是以“xml”为后缀名,但其内容格式需符合XML规范、即约 定的DTD文件。

4.2.3 实时接口方式
为了保证数据的完整型,对实时上传不成功的指标,业务厂商需结合其他方式上传给网管系统或 提供网管系统进行采集的接口。

第 16 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.2.3.1 SNMP TRAP 接口
SNMP作为目前被广泛使用事实上的简单网络管理协议, 通过其TRAP信息传递实时告警信息能够满 足本次项目的需求。考虑到部分厂商已经有了自己的MIB文件,不再对MIB文件格式进行统一规定,但 业务厂商提供的MIB文件必须包含以下信息:告警发生的KBP、告警的级别、告警的标题、告警类型、 告警发生的时间、告警的恢复、告警对象、告警内容。 其中告警发生KBP:根据告警所属平台、所属模块等信息,给出具体的KBP,KBP编码格式为:平 台缩写—网管侧定义的平台编号-具体第三级分类等; 告警级别对应关系:1—严重告警;2—主要告警;3—次要告警;4—警告告警;5—不确定告警; 6—清除告警(告警恢复); 告警标题:可对应告警指标中的告警ID指标,业务厂家需要在各系统中提供告警列表—告警ID 与告警标题对应关系; 告警类型:用于表明告警所属类型,如:环境告警、设备告警、通讯告警、安全告警等等; 业务厂家提供自己的MIB文件,双方确认oid与KPI-ID的对应关系,由网管厂商解析后按业务规范 定义的告警指标进行分析入库。

4.2.3.2 WEB SERVICE 接口 4.2.3.2.1 接口协议定义

WebServive

WebService client

SOAP

UltraNMS

联通四期业务统一告警接入采用 WebService 接口方式,UltraNMS 作为服务端提供 WebService 服 务,各个业务厂家以及二级网管作为 WebService 客户端,按照下面定义的协议格式,将告警传到 UltraNMS 平台上。

第 17 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

I

告警信息传送服务(AlarmSwitchService)

各接口的详细信息统一使用“opDetail”参数,“opDetail”以 XML 封装,格式如下:
<?xml version="1.0" encoding="gb2312"?>

<opDetail> <recordInfo> <fieldInfo>

//详细信息 //记录内容 //字段内容

<fieldEnName>…</fieldEnName> //字段英文名 <fieldContent>…</fieldContent> </fieldInfo> </recordInfo> </opDetail> <opDetail>中可包括多个<recordInfo>部分,<recordInfo>中可包括多个<fieldInfo>部分。如果没有 详细信息,则仅存“<opDetail></opDetail>”,每一条告警信息使用一个 recordInfo。 注意,每次 opDetail 所包含告警条数不超过 10 条,也就是 recordInfo 数量<=10 注意: <?xml version="1.0" encoding="gb2312"?> 这个不能丢掉,所传送 fieldContent
内容使用 gb2312 编码

//字段内容

II 告警传送接口(transferAlarm)
/** * 告警传递接口 * @param serSupplier * @param serCaller * @param callerPwd * @param callTime * @param opDetail * @return */ public String transferAlarm(String serSupplier,String serCaller,String 服务提供方 服务调用方 口令 服务调用时间 详细信息,采用xml文件格式,包含了告警传递的详细信息 输出为一个字符串,格式为“flag=发送标志;errList=错误描述”

callerPwd,String callTime,String opDetail);

说明:UltraNMS 系统提供该接口来接收第三方厂商告警 服务名称:AlarmSwitchService 接口方法:transferAlarm 输入参数:
第 18 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

参数名称 serSupplier serCaller callerPwd callTime

长度 string(16) string(16) string(32) string(20)

中文名称 服务提供方 服务调用方 口令 服务调用时间 固定为 UltraNMS

说明

调用方名称,例如直真,可以为 ZZNODE 该字段可以为空 按照 yyyy-MM-dd HH:mm:ss 格式 参见“详细信息约定”

opDetail

String

详细信息

输出参数:输出为一个字符串,格式为“flag=发送标志;errList=错误描述”。如果提交告警成功:发送 标志为 true,“错误描述”为空串;如果提交告警失败,发送标志为 false,“错误列表”为错误描述。约 定“flag=”和“errList=”不管提交告警成功与否都必须有。 opDetail 详细信息约定: 下面这里所说册参照章节,是指参照《中国联通增值业务综合网管系统技术规范 第六分册-接口技术 规范 3.0.doc》的 4.4.1.5.1 告警指标 字段英文名 类型(长度) 字段中文名 说明 平台级告警:具体网元设备唯 告 警 对 象 ( 对 应 neName string(256) 4.4.1.5.1 告警指标告 警对象) 系统级告警:对应关键业务点 的 KBP 编码 如果没有实例,该字段可以为 instanceName string(256) 实例对象标识 空 网管告警原始序列号 (便于查告警问题) 告 警 代 码 ( 对 应 4.4.1.5.1 告警指标告 告警流水号,如果没有可以不 添 一标识

alarmSeqId

string(256)

alarmCode

string(256)

能唯一区分一类告警。

第 19 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

警 ID) 系 统 编 号 ( 对 应 systemID string(256) 4.4.1.5.1 告警指标系 统编号) 例如直真传输网管,可以为 ZZNODE_ SDH 这个字段传一个固定值,为服 appSystem string(256) 应用系统 务调用方系统简称(系统英文缩 写 ), 需 要 服 务 调 用 方 告 知 UltraNMS 方 不能为空 yyyy-MM-dd HH:mm:ss 格式 如果当前告警为活动告警,则 该时间记录的是告警产生时 告警产生时间或告警 alarmCreateTime string(128) 恢复时间 如果当前告警为恢复告警 (alarmLevel 等于 ok),则该时 间记录的是告警恢复时间 告警的级别,可选值如下: alarm major alarmLevel string(20) 告警级别 minor warn ok 其它 ——严重告警 ——主要告警 ——次要告警 ——警告告警 ——恢复告警 ——未知告警。 间。 系统编号,不能为空

alarmDetail

string(3000)

告 警 描 述 ( 对 应 4.4.1.5.1 告警指标告
第 20 页

告警对设备的影响; 告警对业务的影响;

中国联通增值业务综合网管系统技术规范 第六分册 3.0

警内容)

告警正文;

以上所定义字段,都必须在 opDetail 中存在,如果某些可为空字段没有值,可将其值置为空串,除了 特殊说明,以上字段都不容许为空 以上 opDetail 中定义的字段为基本传输字段,UltraNMS 可以与服务调用厂商协商,增加需要字 段。也就是基本传输字段必须有,可以双方协商新增字段。 opDetail 样例:
<?xml version="1.0" encoding="gb2312"?> <opDetail> <recordInfo> <fieldInfo> <fieldEnName>neName</fieldEnName> <fieldContent>192.168.5.55</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>instanceName</fieldEnName> <fieldContent>cup1</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmSeqId</fieldEnName> <fieldContent>123443</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmCode</fieldEnName> <fieldContent>3</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>systemID</fieldEnName> <fieldContent>12</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>appSystem</fieldEnName> <fieldContent>ZZNODE_SDH</fieldContent>

第 21 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

</fieldInfo> <fieldInfo> <fieldEnName>alarmCreateTime</fieldEnName> <fieldContent>2010-8-30 18:19:00</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmLevel</fieldEnName> <fieldContent>alarm</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmDetail</fieldEnName> <fieldContent>告警内容_1</fieldContent> </fieldInfo> </recordInfo>

<recordInfo> <fieldInfo> <fieldEnName>neName</fieldEnName> <fieldContent>host1</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>instanceName</fieldEnName> <fieldContent>memeory</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmSeqId</fieldEnName> <fieldContent>666666</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmCode</fieldEnName> <fieldContent>5</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>systemID</fieldEnName> <fieldContent>12</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>appSystem</fieldEnName>
第 22 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<fieldContent>ZZNODE_SDH</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmCreateTime</fieldEnName> <fieldContent>2010-8-30 18:19:00</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmLevel</fieldEnName> <fieldContent>alarm</fieldContent> </fieldInfo> <fieldInfo> <fieldEnName>alarmDetail</fieldEnName> <fieldContent>告警内容_2</fieldContent> </fieldInfo> </recordInfo> </opDetail>

4.3 与主机/数据库代理的接口 4.3.1 功能说明
增值业务网管与主机/数据库之间的接口用于采集主机/数据库提供的平台数据,包括性能数据、 配置数据和告警数据。主机/数据库代理负责采集平台数据并上传至指定目录,网管负责解析数据并 入库展现 平台数据包括:主机、数据库、存储(可选)、备份(可选)。具体采集指标要求见本系列规范 第一分册。

4.3.2 数据上传目录(FTP)
在网管服务器为主机/数据库代理厂商建立FTP服务, 建立host、 database、 storage(可选)、 backup (可选)目录

第 23 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.3.2.1 host 目录
用于存放主机上传数据。 ? 配置文件: ? ? 文件名称格式:HOST_CM_YYYYMMDDHH24MI 文件内容格式:一个指标一个采集点一行数据,行格式:主机名 主机ip 指标ID 资源 参数 数据采样时间点 指标值 ? 性能文件: ? ? 文件名称格式:HOST_PM_YYYYMMDDHH24MI 文件内容格式:一个指标一个采集点一行数据,行格式:主机名 主机ip 指标ID 资源 参数 数据采样时间点 指标值 ? 告警文件: ? ? 文件名称格式:HOST_PM_YYYYMMDDHH24MISS 文件内容格式:一个指标一个采集点一行数据,行格式:告警主机名 告警主机IP 告警 指标ID 告警资源参数 当前值 警门限范围 告警产生时间 告警恢复标识

4.3.2.2 database 目录
用于存放数据库上传数据。 ? 配置文件: ? ? 文件名称格式:DATABASE_CM_YYYYMMDDHH24MI 文件内容格式:一个指标一个采集点一行数据,行格式:数据库服务名 主机ip 指标ID 资源参数 数据采样时间点 指标值 ? 性能文件: ? ? 文件名称格式:HOST_PM_YYYYMMDDHH24MI 文件内容格式:一个指标一个采集点一行数据,行格式:数据库服务名 主机ip 指标ID 资源参数 数据采样时间点 指标值 ? 告警文件:
第 24 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

? ?

文件名称格式:HOST_PM_YYYYMMDDHH24MISS 文件内容格式:一个指标一个采集点一行数据,行格式:数据库服务名 主机IP 告警指 标ID 告警资源参数 当前值 警门限范围 告警产生时间 告警恢复标识

4.4 省部接口
省部接口负责总部网管中心与省级网管中心之间的数据传输, 用于收集各省增值业务系统的配置 信息、 告警信息以及业务运行状况的性能数据。 省级网管根据接口要求定期上传总部各类数据与信息。

4.4.1 接口逻辑图
集团公司一级业务支撑网网管系统 FTP/XML

FTP/XML 省公司业务支撑网 网管系统

FTP/XML 省公司业务支撑网 网管系统

FTP/XML 省公司业务支撑网 网管系统

4.4.2 接口内容的范围
省部接口的范围,包括需要给总部接口上传和总部给省份下发的接口两部分。

4.4.2.1 省份上传总部
? ? 监控平台:省份上传包含 平台类、业务类的资源配置指标、性能指标、告警指标。 局数据 :现网局数据的比对结果(号段类局数据 一天一次) ,现网局数据。

4.4.2.2 总部下发省份
? 监控平台: 校验回执,补传通知
第 25 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

?

局数据: 标准局数据的下发主要是号段类局数据。

4.4.3 接口双方的责任
4.4.3.1 数据提供方的责任
? ? ? ? ? ? ? ? ? ? ? 负责保证在指定的时间范围内及时生成规定的数据文件并及时提交接口系统; 负责保证接口文件中的记录各值域在有效的取值范围内,确保数据的有效性、准确性、及时 性; 负责根据数据接收方提供的校验结果,及时处理异常情况; 保证上传文件安全性 ,如对病毒扫描; 所有生产设备都要作为被监控实体(包括备机), 开发、测试设备不是生产设备。 由于传输原因导致的文件漏传, 当恢复后将所有在中断开始时间到本地恢复时间段内的文件 全部上传; 对于退回的错误文件,需要重传文件中全部记录; 性能、配置、局数据等上传的文件不能为空,记录可以为空但格式要有。 配置数据要求:第一次需要全量上传,每日对于前一日新增、修改等有变化需要上传,如果 没有改变上传空文件,每月 1 号需重新全量上传; 对于本规范中未尽事宜,源数据提供方应协助数据接收方协商解决相关问题; 重传机制:6 号前允许重传上个月的数据。程序自动解析。6 号之后重传上个月数据不会自 动解析。数据发现不一致:以全网数据为准

4.4.3.2 数据接收方的责任
? ? ? ? ? ? ? 负责与源数据提供方的信息交互和沟通; 负责对源数据提供方提供的接口文件进行及时的收取、校验,并及时返回校验结果; 负责对源数据提供方提供的正确数据准确及时的呈现; 负责对源数据提供方提供的及时处理过的异常数据再次进行处理; 负责对本端的接口服务器的维护和管理; 对于文件名称中日期格式错误,在接收时直接过滤; 对于文件名称中省代码错误,在接收时直接过滤。

第 26 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.4 FTP/XML 接口方式定义
4.4.4.1 通用处理流程 4.4.4.1.1 交互流程定义

省端接口

集团接口

校验模块

总部网管

0 启动FTP服务

准备上传文件 上传文件 接收文件 获取文件 文件级校验 返回校验结果 返回校验报告 处理返回错误 修正并重传文件 重传文件 备份上传数据 记录级校验

准备校验报告 接收数据 处理数据

准备下一个文件

补传通知 数据准备 补传文件

流程说明: 1. 总部启动 FTP 服务; 2. 省端准备上传文件;
第 27 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

3. 4. 5. 6. 7. 8. 9. 10.

省端通过 FTP 发送文件; 总部检测省端上传的文件; 总部文件级检查模块获取上传文件;进行文件级检查及记录级检查。 总部生成文件级校验报告回执; 返回校验报告回执; 省部修正并重新传文件; 最大重传次数 5 次; 省端就绪下一个文件准备发送

4.4.4.1.2 文件传输定义
总部端建立 FTP 服务器,FTP 服务默认端口 21。 总部端建立 upSendMsg 和 result 及 backUp 三个目录,省端自己建立文件备份目录。 upSendMsg:该目录用来存放上传指标的 XML 文件,上传和处理过程如下: (1) 省端定期将指标的 XML 文件 upload 到该目录,在传输的过程中,在文件命名规则的基础上, 在后面增加字符串“.tmp”作为后缀,代表该文件正在传输过程中,当文件传输完毕时,再 将原文件更改为不带“.tmp”的正式文件名; (2) 总部端分析 XML 文件,在 result 目录给出回执,并将该 XML 文件命名为“.old”文件,代 表已处理; (3) 总部网管系统定期将“.old”文件转移到 backUp 目录作为备份。目录中保留最近 1 年的 result:该目录用来存放网管的回执 XML 文件,回执和处理过程如下: (1) 省级网管系统上传业务指标 XML 文件完成一段时间之后(性能、配置 1 个小时时间需确认) , 主动查看是否生成了回执文件。 (2) 总部系统生成回执,省级网管系统发现立即进行分析,如果回执中列出错误,则需要省端自 动进行分析处理,重新生成和上传业务指标 XML 文件。 回执文件直接通知给省网管,而不需要省网管到总部 result 目录中提取。如有回执/重传通知每天 14 点发送给省网管系统,省网管收到通知后 5 天未反馈,总部网管系统产生相应告警(短信或邮件 通知对应网管负责人)并展现到全网网管报表上。需要记录回执/重传通知发送时间、发送次数、反 馈时间、反馈次数、处理结果等信息。

第 28 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

文件上传及时性的检查,如小时粒度/天粒度文件没有按上传时间约定上传到总部的,总部应主 动发消息告知省网管上传对应文件,每天 14 点发送给省网管系统,省网管收到通知后 5 天未反馈, 总部网管系统产生相应告警(短信或邮件通知对应网管负责人)并展现到全网网管报表上。需要记录 通知发送时间、发送次数、反馈时间、反馈次数、处理结果等信息。5 天后产生的告警再上传的文件 需要告知原因。 省网管主动要求重传的文件(错误数据重传) ,省网管主动发消息给总部网管。总部网管需要记 录重传通知发起时间、发起次数、处理结果等信息。

4.4.4.1.2.1 省端节点配置
省级网管系统自己保存上传文件记录。

4.4.4.1.2.2 总部节点配置
总部的 FTP 服务是默认端口 21。 FTP 目录设置中,总部节点对每一个下级节点省份都配置了单独目录,可支持总部与各省分并行 的数据传输。对每一个省份设立独立的访问帐户,并且每个省份限制连接数为 10(建议省级系统顺 序上传文件) 。每一个下级节点(对应每个省)都配置了单独目录,以省份编码为目录名,省份编码 见参见 附件 1。省份自己的目录下建立 upSendMsg 和 result 及 backUp 两个目录,分别放置省端上 传的文件和集团的回执。及备份文件。 局数据的 标准局数据 部分,总部设立独立的局数据目录 GCData。放置下发的标准据数据. 目录如下图所示:

Ftp root
├─GCData
├─BJ │ │ │ │ │ ├─upSendMsg └─result └─backUp └─hourUpSendMsg └─hourResult 第 29 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0



└─hourBackUp

├─AH │ │ │ │ │ │ ├─upSendMsg └─result └─backUp └─hourUpSendMsg └─hourResult └─hourBackUp

├─CQ │ │ │ │ │ │ ├─upSendMsg └─result └─backUp └─hourUpSendMsg └─hourResult └─hourBackUp

└─.....

目录说明表:
目录名 upSendMsg result backUp GCData
hourUpSendMsg

功能描述 省端上传文件存放目录 集团回执下发目录 上传文件备份目录 标准据数据下发目录 省端上传小粒度文件存放目录 集团回执小粒度文下发目录 上传文件小粒度文件备份目录

权限 省级网管系统拥有读取和写入地权限, 没有修改和删除的权限。 省级网管系统拥有读取的权限,没有写 入与修改的权限 省级网管系统拥有读取的权限,没有写 入与修改的权限 省级网管系统拥有读取和写入地权限, 没有修改和删除的权限。 省级网管系统拥有读取的权限,没有写 入与修改的权限

hourResult

hourBackUp

4.4.4.2 上传文件名称定义
省级网管系统和总部网管系统主要是以 XML 格式文件进行交互的,总部网管系统会发送检
第 30 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

查结果文件对上传数据文件进行应答,文件名定义如下:

TYPE_PROV_业务系统名_YYYYMMDD_HHMM_FFF.YYY
说明: 元素 TYPE 描述 文件类型前缀 取值说明 这里表示的前缀为字符,可能的取值如下: 告警数据文件: 性能数据文件: 配置数据文件: 现网局数据文件: 局数据比对文件:: 拓扑数据文件: PROV 业务系统名 省份缩写 业务系统名 参看附录 1 只有性能文件按业务系统分 平台 联通短信中心 联通在信网关 互联网关 WAP 网关 MMSC 语音 炫铃 SPMS WAP 业务平台 定位接入及应用系统 彩信业务平台 行业应用平台 GSM 网终端管理系统 增值业务用户鉴权中心 VAC 扩展业务管理平台 EMP 拨测 统计分析 拓扑图 图标 连线 001 002 003 005 006 007 008 009 010 011 013 014 015 016 017 018 SIMULATOR COUNTA MAP MAPSYMBOL MAPLINK FM; PM; CM; RC; SC; TOPO;

短信业务平台(SP 业务平台) 012

第 31 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

除性能文件外,其他文件业务系统名为 000 YYYYMMDD 时间 填写文件的所在日(月) ,示例: 15 分钟上传文件格式(如告警文件) :20090101 每日,每小时上传文件(如日性能文件)格式: 20090101 每月上传文件(如配置全量、日期填写‘00’ ) 格式: HHMM 小时分钟 比如 20060100 5 号的日性能文件,文件名中的 填写小时和分钟,文件范围的结束时间。 YYYYMMDD 是 20081206 HHMM 是 0000 5 号最后一个告警文件,文件名中的 YYYYMMDD 是 20081206 HHMM 是 0000 FFF YYY 重传标志位 文件后缀名 填写是否重传的标志,000 非重传文件;如果重 传,按重传次数依次递增 1。 Xml ,标准局数据是 xls

上传文件名示例: 1) 北京上传的平台类告警文件,文件所在日为 2008 年 6 月 8 日,生成时间为上午 10 点,状态为正常上传的文件,则文件名称为 FM_BJ_001_20080608_1000_000.xml 2) 北京上传的短信中心小时性能文件,文件所在日为 2008 年 6 月 8 日,生成时间为下 午 3 点 , 状 态 为 正 常 上 传 的 文 件 , 则 文 件 名 称 为 PM_BJ_002_ 3) 4) 5) 6) 7) 20080608_1500_000.xml 北京上传的短信中心日性能文件,文件所在日为 2008 年 6 月 8 日,状态为重传的文 件,则文件名称为 PM_BJ_002_ 20080609_0000_001.xml 北京上传的在信网关月配置文件,文件所在日为 2008 年 6 月 1 日,状态为正常上传 的文件,则文件名称为 CM_BJ_ 003_20080600_0000_000.xml 北京上传的局数据比对文件,文件所在日为 2008 年 6 月 8 日,状态为正常上传的文 件,则文件名称为 SC_BJ_000_20080609_0000_000.xml 北京上传的现网局数据文件,文件所在日为 2008 年 6 月 8 日,状态为正常上传的文 件,则文件名称为 RC_BJ_000_20080609_0000_000.xml 北京上传的拓扑图文件,文件所在日为 2008 年 6 月 8 日,非重传,则文件名称为 TOPO_BJ_MAP_20080608_000.xml , 第 一 次 重 传 , 则 文 件 名 为

TOPO_BJ_MAP_20080608_001.xml 8) 北京上传的拓扑图图标文件,文件所在日为 2008 年 6 月 8 日,非重传,则文件名称 为 TOPO_BJ_MAPSYMBOL_20080608_001.xml 9) 北京上传的拓扑图连线文件,文件所在日为 2008 年 6 月 8 日,非重传,则文件名称 为 TOPO_BJ_MAPLINK_20080608_001.xml

第 32 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.4.3 下发文件名称定义
总部向省端下发 检查回执文件 及 补传通知,对于同一个上传文件,总部下发下面 4 种中的一 种为回执文件。文件正确通知和补传通知,对这两种回执省级系统只需要解析文件名即可,回执文件 体为空。定义一下 WEBservice 接口 result 目录可删除了 下发文件名列表 文件名 前缀(T_)+ 原文件名 前缀(F_)+ 原文件名 前缀(E_)+ 原文件名 说明 文件检查结果正确通知 文件级检查结果文件名 记录级检查结果文件名 注释 只有在正确的时候才有 只有在出现文件级错误的上 传文件才有 每个无文件级错误的上传文 件都有对应的记录级检查结 果文件反馈 前缀(R_)+ 文件名 补传通知 通知省端数据重传 如需要补传前一天的性能数 据

4.4.4.4 上传文件校验 4.4.4.4.1 文件级检查结果文件定义 4.4.4.4.1.1 文件级检查结果错误类型定义
错误编码 F001 F002 F003 错误编码注释 文件名重复 文件名称错误 文件格式错误 备注

第 33 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.4.4.1.2 文件级检查结果文件格式定义
父元素名称 Verify Error Error 元素名称 Error ErrorCode ErrorMessage 约束 1 1 1 类型 String String String 描述

文件级检查结果文件示例: <Verify> <Error> <ErrorCode>F001</ErrorCode> <ErrorMessage>错误示例</ErrorMessage> </Error> </Verify>

4.4.4.4.2 记录级检查结果文件定义 4.4.4.4.2.1 记录级检查结果错误类型定义
错误编码 E001 E002 E003 错误编码注释 字段格式错误 字段取值范围错误 字段类型错误 备注 错误的格式 取值是否过大或过小 确认 字段类型是否匹配

监控平台涉及的告警和性能数据文件需要检错的字段如下表: 文件类型 告警数据文件 字段 ProvinceID 检错方式 类型/值域
第 34 页

检错标准 类型 string/取值参见附件 1

中国联通增值业务综合网管系统技术规范 第六分册 3.0

BeginTime EndTime FirstTime LastTime EventLevel

字段类型 字段类型 字段类型 字段类型 值域

Date Date Date Date 1 :CRITICAL 2 : MAJOR 3 :MINOR 4 :WARNING 5 :INDETERMINATE 6 :CLEARINFO

Count 性能数据文件 ProvinceID BeginTime EndTime Value

字段类型 类型/值域 字段类型 字段类型 值域

Int 类型 string/取值 Date Date

4.4.4.4.2.2 记录级检查结果文件格式定义
父元素名称 Verify Errors Errors Error Error Error 元素名称 Errors Sum Error ErrorCode SeqNum ErrorMessage 约束 1 1 * 1 1 1 String Int String 错误编码 错误记录的序列号, 对应上传的 文件中的记录序列号 出错原因 int 错误记录条数 类型 描述

记录级检查结果文件示例: <Verify> <Errors> <Error> <ErrorCode>R002</ ErrorCode> <SeqNum>1</SeqNum> <ErrorMessage>错误记录信息示例</ErrorMessage> </Error>

第 35 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<Sum>1</Sum> -- 如果没有记录错误,此处为 0 </Errors> </Verify> 该文件第二条记录有字段类型错误,详细信息可以参见 ErrorMessage

4.4.4.5 文件补传通知
若总部网管系统发现所接收到指标上报数据缺失,则应向省网管发出任务补传通知,要求省级网 管针对某一性能文件进行补报。通知下达后,省级网管应根据要求整理数据并将相应的指标数据传送 到集团网管。

如:补传北京上传的现网局数据文件,文件所在日为 2008 年 6 月 8 日,则文件下发的名称为 R_SC_BJ_000_20080609_0000_000.xml webservice 方式

4.4.4.6 各文件上传周期
1) 告警为 webservice 方式实时上传。 2) 性能分为小时、日性能和月性能(季度性能包含在月性能中) :粒度为 15 分钟的汇聚后再小 时性能里发, 小时性能在每下一小时的前 15 分钟内上传; 粒度小于 1 天的汇聚后在日性能里 发,日性能每天早上 10 点前上传;粒度大于 1 天小于 1 个月的汇聚到月性能里发,如果存在 采集粒度为季度的在当月月性能里发,月性能每月 1 号早上 10 点前上传。 3) 配置分日配置和月配置两种,每天 10 点前发送前一天配置变化信息,每月 1 号 10 点前发送 配置全量信息。 4) 现网局数据每天 9 点前上传。

第 36 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.5 全网与省份消息交互
4.4.5.1 全网回执消息交互 4.4.5.1.1 功能描述
全网回执文件直接通知给省网管,将省份上传的文件格式异常及内容异常情况进行通知。回执通 知每天 14 点发送给省份网管系统,发送消息前,先判断全网和省份心跳是否存在,如果心跳不存在, 全网就不给省份发送消息内容,并发出告警给全网。

4.4.5.1.2 心跳监听
全网在发送消息前,先判断心跳是否存在,心跳正常发送消息内容,否则不发送。

4.4.5.1.3 回执消息字符串格式
fileName 文件名称 例 :

PM_BJ_001_20101209_0000_001.xml fileType 文件粒度分为天文件和 小时文件 errorNum 重传原因 例:上次文件数据不准确,本次重新 上传 全网作为客户端,省份作为服务端。全网每次发送一条消息内容给省份。每次生成的的字符串 以“<?xml version="1.0" encoding="GB2312"?><errorInfo>”开始,以“</ errorInfo >\r\n”结束,最后 加回车换行符“\r\n”用于标志一个上传字符串的结束。中间内容分为两个部分:第一部分记录错误 文件名称,如: <fileName> 文件名称 </ fileName >. 第二部分记录错误编码,如<errorNum>错误编码</ errorNum >. 错误编码分为: 错误编码 错误编码注释 备注 天文件:0,小时文件:1

第 37 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

F001 F002 F003 E001 E002 E003

文件名重复 文件名称错误 文件格式错误 字段格式错误 字段取值范围错误 字段类型错误 错误的格式 取值是否过大或过小 确认 字段类型是否匹配

4.4.5.1.4 回执消息样例
返回消息文件命名:省份上传文件名 省份上传文件名:实际省份网管上传文件名称 以返回北京文件为例。如:PM_BJ_001_20080321_1015_000.xml 内容如下 <?xml version="1.0" encoding="GB2312"?> <errorInfo> <fileName>PM_BJ_001_20080321_0000_000.xml </fileName> <fileType> 0 </ fileType > < errorNum > F003</ errorNum > <errorInfo>

4.4.5.1.5 回执消息回复
全网发送消息后,省份收到消息内容返回 1。

第 38 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.5.1.6 流程图

开始

N

N

发送告警

全网

result是否有异常文件

全网与省份通道是否畅

Y

发送消息

Y

发送消息

省份

4.4.5.2 文件上传及时性消息交互 4.4.5.2.1 功能描述
如天粒度数据,查看当天 14 点前,省份是否上传当天业务文件。如果是小时粒度文件,查看前 一天 24 时小时文件是否上传。如果没有按上传时间约定上传到总部的,总部应主动发消息告知省网 管上传对应文件,每天 14 点发送给省网管系统。发送消息前,先判断全网和省份心跳是否存在,如 果心跳不存在,全网就不给省份发送消息内容,并发出告警给全网。

4.4.5.2.2 心跳监听
全网在发送消息前,先判断心跳是否存,心跳正常发送消息内容,否则不发生送。

4.4.5.2.3 及时性消息字符串格式
全网作为客户端,省份作为服务端。全网每次发送一条消息内容给省份。每次生成的的字符串以 “<?xml version="1.0" encoding="GB2312"?><timely>”开始,以“</ timely >\r\n”结束,最后加回车
第 39 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

换行符“\r\n”用于标志一个上传字符串的结束。中间内容包括为以下部分。 中间内容: 标签名称 标签描述 缺少时间 缺少文件称名称 文件粒度分为天文件和 小时文件 info 消息描述 例:缺失文件 备注 例:20080320 例: PM_BJ_001_20080321_0000_000.xml 天文件:0,小时文件:1

lackTime
lackFile fileType

4.4.5.2.4 及时性消息样例
以返回北京文件为例。如:PM_BJ_001_20080321_0000_000.xml 内容如下 <?xml version="1.0" encoding="GB2312"?> <timely> <lackTime>20080320 </ lackTime > <lackFile> PM_BJ_001_20080321_0000_000.xml </ lackFile > <fileType>0</ fileType > < info> 缺少文件</ info > <timely>

4.4.5.2.5 及时性消息回复
全网发送消息后,省份收到消息内容,并返回 1。

4.4.5.2.6 流程图

第 40 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

开始

N

N

发送告警

全网

是否缺失小时/天文件

全网与省份通道是否畅

Y

发送消息

Y

发送消息

省份

4.4.5.3 重传文件消息交互 4.4.5.3.1 功能描述
省网管主动要求重传的文件(错误数据重传) ,省网管主动发消息给总部网管。总部网管需要记 录重传通知发起时间、发起次数、处理结果等信息。

4.4.5.3.2 心跳监听
省份在发送消息前,先判断心跳是否存,心跳正常发送消息内容,否则不发生送。

4.4.5.3.3 重传消息字符串格式
省份网管作为客户端,全网作为服务端。省份每次发送一条消息内容给全网。每次生成的的字符 串以“<?xml version="1.0" encoding="GB2312"?><reCollect>”开始,以“</ reCollect >\r\n”结束, 最后加回车换行符“\r\n”用于标志一个上传字符串的结束。中间内容包括为以下部分。 中间内容:
第 41 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

标签名称

标签描述 文件名称 文件粒度分为天文件和 小时文件

备注 例:PM_BJ_001_20101209_0000_001.xml 天文件:0 小时文件:1 例:上次文件数据不准确,本次重新上传

filename
fileType

Reason

重传原因

4.4.5.3.4 重传消息样例
以返回北京文件为例。如:PM_BJ_001_20080321_0000_000.xml 内容如下 <?xml version="1.0" encoding="GB2312"?> <reupload> <fileName> PM_BJ_001_20080321_0000_000.xml </ fileName > <fileType>0</ fileType > < reason >上次文件数据不准确,本次重新上传</ reason > <reupload>

4.4.5.3.5 重传消息回复
省份发送消息后,全网收到消息内容返回 1。

第 42 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.5.3.6 流程图

开始

省份
N

发送告警

全网与省份通道是否畅

Y

发送文件

全网

记录消息内 容

4.4.5.4 全网与省份心跳监听 4.4.5.4.1 功能描述
为了保持全网与省份网管通道畅通,添加心跳功能,省份与全网每 10 秒钟发送消息,进行通信。 接受方收到消息后,返回内容 1;

4.4.5.4.2 心跳消息字符串格式
省份网管和全网作为服务端发送消息内容,每次发送一条消息内容。每次生成的的字符串以 “<?xml version="1.0" encoding="GB2312"?><Infoformation>”开始,以“</ Infoformation >\r\n”结 束,最后加回车换行符“\r\n”用于标志一个上传字符串的结束。中间内容包括为以下部分 中间内容:

第 43 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

标签名称
province

标签描述 省份名称 发送时间,精确到秒

备注

startTiem

例:2009-10-11 13:00:12

4.4.5.4.3 心跳消息样例
返回消息文件命名: 省份名+时间 省份名:省份或是全网名称 时间: 20091011 130012 以返回上海文件为例。如:上海_20091011 130012.xml 内容如下 <?xml version="1.0" encoding="GB2312"?> < Infoformation > < province >上海 </ province > < startTiem > 2009-10-11 13:00:12</ startTiem > < /Infoformation > 如:全网,上海,湖北

4.4.5.4.4 重传消息回复
消息收到方返回内容 1。

第 44 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.4.5.4.5 流程图

开始

省份

N 省份记录信息,出告警 发送消息是否 正常

Y

全网

数据库

4.4.5.4.6 wsdl 文件定义
暂时没有定义。

4.5 监控管理两级接口 4.5.1 上传接口文件说明
4.5.1.1 XML 数据文件格式定义
上传数据分为性能数据(PM)和配置数据(CM)、局数据(SC、RC),上传格式必须符合以下 dtd 的定义:

第 45 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.5.1.2 拓扑图数据文件上传 4.5.1.2.1 拓扑图数据文件上传约定
拓扑图数据文件上传流程约定如下:每天 10 点前发送拓扑图的全量信息

4.5.1.2.2 拓扑图数据格式定义
拓扑图数据文件上传属性集定义: 是否允 属性名
ProvinceID mapname ParentMapName

中文描述 省名称 拓扑图名称 父节点图的名 称

字段类型 STRING STRING STRING

许为空 否 否 是 否

取值说明 填写附件 1 中的省份 ID 拓扑图的名称,不允许重复 当前拓扑图的父节点拓扑图的名 称,该属性为空是,表示无父节点 拓扑图在树节点上显示的标签:命 名参考: 4.3 附件三 联通三期项 目拓扑节点命名规范

Label BackgroundColor BackgroundImage TreeNodeIcon

显示标签 背景颜色 背景图名称 树节点图标

STRING STRING STRING STRING 否 是


拓扑图的背景色 拓扑图的背景图的图片名称
树节点图标的图标名称

拓扑图数据文件示例:

第 46 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<?xml version="1.0" encoding="UTF-8"?> <MAPDoc docId="TOPO_BJ_MAP_20080321_000.xml" ProvinceID="BJ" creationTime="2008-03-21 10:00:00"> <MAP mapname="parentMap"> <ParentMapName></ParentMapName> <Label>拓扑图</Label> <BackgroundColor>0,0,0</BackgroundColor> <BackgroundImage>image.png</BackgroundImage> <TreeNodeIcon>treenode.png</TreeNodeIcon> </MAP> <MAP mapname="map1"> <ParentMapName>parentMap</ParentMapName> <Label>一级骨干网拓扑图</Label> <BackgroundColor>0,0,0</BackgroundColor> <BackgroundImage>image.png</BackgroundImage> <TreeNodeIcon>treenode.png</TreeNodeIcon> </MAP> <MAP mapname="map2"> <ParentMapName>parentMap</ParentMapName> <Label>邮件系统</Label> <BackgroundColor>0,0,0</BackgroundColor> <BackgroundImage>image.png</BackgroundImage> <TreeNodeIcon>treenode.png</TreeNodeIcon> </MAP> </MAPDoc>

4.5.1.3 拓扑图图标数据文件上传 4.5.1.3.1 拓扑图图标数据文件上传约定
拓扑图图标数据文件上传流程约定如下:每天 10 点前发送拓扑图的全量信息

4.5.1.3.2 拓扑图图标数据格式定义
拓扑图图标数据文件上传属性集定义:
第 47 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

拓扑图标可以针对任何对象,但是本接口中建议拓扑图标只上传节点级对象的图标信息 是否允 属性名
ProvinceID mapname symbolname Label

中文描述 省名称 拓扑图名称 图标名称 显示标签

字段类型 STRING STRING STRING STRING

许为空 否 否 否 否 是

取值说明 填写附件 1 中的省份 ID 图标所属的拓扑图的名称 图标的名称,在同一个拓扑图里, 图标名称不能重复 图标在拓扑图上显示的标签 图标在拓扑图上显示的图片的名 称(不传也可以,这边可以用其他 图片来展示,只是最终拓扑图上呈

图标所用的图
IconName PositionX PositionY KBP

片名称 坐标的 X 值 坐标的 Y 值 KBP 编号

STRING 否 INT


现的图标的图片和省部的不同) 图标的左上角顶点坐标的 X 值, 单 位为像素,必须为正整数 图标的左上角顶点坐标的 Y 值, 单 位为像素,必须为正整数 节点级对象 KBP 的字符编号(为 是 空时表示不对应 kbp 的空图标) 标示图标对应的设备类型 0:路由器 1:交换机 2:防火墙 3:主机 4:pc 5:其它

INT STRING

KBPType

KBP 类型

INT



KBP 不为空时, 该字段也不能为空

拓扑图图标数据文件示例:

<?xml version="1.0" encoding="UTF-8"?> <MAPDoc docId="TOPO_BJ_MAPSYMBOL_20080321_000.xml" ProvinceID="BJ" creationTime="2008-03-21 10:00:00"> <MAP mapname="map1"> <MAPSYMBOL symbolname="switch1"> <Label>交换机1</Label>
第 48 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<IconName>icon.png</IconName> <PositionX>50</PositionX> <PositionY>110</PositionY> <KBP>Switch001</KBP> <KBPType>2</ KBPType> </MAPSYMBOL> <MAPSYMBOL symbolname="switch2"> <Label>交换机2</Label> <IconName>icon.png</IconName> <PositionX>70</PositionX> <PositionY>110</PositionY> <KBP>002</KBP> <KBPType>2</ KBPType> </MAPSYMBOL> <MAPSYMBOL symbolname="host1"> <Label>主机1</Label> <IconName>icon.png</IconName> <PositionX>90</PositionX> <PositionY>110</PositionY> <KBP>011</KBP> <KBPType>0</ KBPType> </MAPSYMBOL> </MAP> <MAP mapname="map2"> <MAPSYMBOL symbolname="switch2"> <Label>交换机2</Label> <IconName>icon.png</IconName> <PositionX>50</PositionX> <PositionY>110</PositionY> <KBP>002</KBP> <KBPType>2</ KBPType> </MAPSYMBOL> <MAPSYMBOL symbolname="host2"> <Label>主机2</Label> <IconName>icon.png</IconName> <PositionX>50</PositionX> <PositionY>110</PositionY> <KBP>012</KBP> <KBPType>0</ KBPType> </MAPSYMBOL> </MAP> </MAPDoc>
第 49 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.5.1.4 拓扑图连线数据文件上传 4.5.1.4.1 拓扑图连线数据文件上传约定
拓扑图连线数据文件上传流程约定如下:每天 10 点前发送拓扑图的全量信息

4.5.1.4.2 拓扑图连线数据格式定义
拓扑图图标数据文件上传属性集定义: 是否允 属性名
ProvinceID mapname

中文描述 省名称 拓扑图名称

字段类型 STRING STRING

许为空 否 否 否

取值说明 填写附件 1 中的省份 ID 连线所属的拓扑图的名称 连线的名称,在同一个拓扑图里, 连线名称不能重复

linkname Label

连线名称 显示标签 连线的源点图

STRING STRING 是 否 STRING 否 STRING


连线的标签

SourceMapSymbol

标名称 连线的目的点

连线的源点图标名称

DestMapSymbol

图标名称 连线的源点接 口对象 KBP 标

连线的目的点图标名称

连线的源点接口对象 KBP 的字符 STRING 编号

SourceInterfaceKBP

号 连线的目的点 接口对象 KBP

连线的目的点接口对象 KBP 的字 STRING INT 是 是 符编号 连线的线宽,单位为象素点(为空

DestInterfaceKBP Thickness

标号 线宽

时,将默认设置为 2) ,必须为正

第 50 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

整数

拓扑图图标数据文件示例:

<?xml version="1.0" encoding="UTF-8"?> <MAPDoc docId="TOPO_BJ_MAPLINK_20080321_000.xml" ProvinceID="BJ" creationTime="2008-03-21 10:00:00"> <MAP mapname="map1"> <MAPLINK linkname="maplink1"> <Label>交换机1-主机1</Label> <SourceMapSymbol>switch1</SourceMapSymbol> <DestMapSymbol>host1</DestMapSymbol> <SourceInterfaceKBP>0001</SourceInterfaceKBP> <DestInterfaceKBP>0002</DestInterfaceKBP> <Thickness>2</Thickness> </MAPLINK> <MAPLINK linkname="maplink2"> <Label>交换机1-交换机2</Label> <SourceMapSymbol>switch1</SourceMapSymbol> <DestMapSymbol>switch2</DestMapSymbol> <SourceInterfaceKBP>0003</SourceInterfaceKBP> <DestInterfaceKBP>0004</DestInterfaceKBP> <Thickness>4</Thickness> </MAPLINK> </MAP> <MAP mapname="map2"> <MAPLINK linkname="maplink1"> <Label>交换机2-主机2</Label> <SourceMapSymbol>switch2</SourceMapSymbol> <DestMapSymbol>host2</DestMapSymbol> <SourceInterfaceKBP>0005</SourceInterfaceKBP> <DestInterfaceKBP>0006</DestInterfaceKBP> <Thickness>2</Thickness> </MAPLINK> </MAP> </MAPDoc>

第 51 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.5.1.5 告警数据上传
告警数据在联通四期项目所需接入的业务系统定制规范过程中做了统一, 不再在各平台各模块中 定义具体的告警,而是将所有系统的告警统一,需要业务厂家提供告警时间,告警 ID 等内容,并提 供告警 ID 与告警标题的对应关系。

4.5.1.5.1 告警指标
具体告警指标如下,其中 XX 表示在总册中各业务平台的编号: 采集间隔:实时 KBP 编码规则: 对应平台缩写–对应平台编号
编号 KPI-ID KPI 名称 KPI 描述 采样间隔 数据类型

1

FM-01-XX-01-01-01

告警发生(或恢复)时间

告警发生(或恢复)时间 平台级告警: 用来区分同一种类型设备

实时

时间型

2

FM-01-XX-01-01-02

告警ID

的告警 系统级告警:区分同一类型告警 平台级告警:具体网元设备唯一标识

实时

字符型

3

FM-01-XX-01-01-03

告警对象

系统级告警:对应关键业务点的KBP编 码

实时

字符型

4

FM-01-XX-01-01-04

系统编号

对应总册系统编号

实时

整型

告警级别: 1—严重告警 critical) 2— ( ; 主 要 告 警 ( major ) ; 3— 次 要 告 警 5 FM-01-XX-01-01-05 告警级别 (minor) 4—警告告警 warning) 实时 ; ( ; 5—不确定告警 indeterminate) 6— ( ; 清除告警(cleared,告警恢复) 整型

第 52 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

6

FM-01-XX-01-01-06

告警内容

具体告警的内容描述; 有告警数值的明 确当前值及阀值等信息

实时

字符型

注:业务厂商需向网管提供告警 ID 和模块的对应关系文档,OID 和 FM 对应关系。 业务厂家提供以上 6 个告警指标(可提供更多的信息,但是需要保证有这 6 个指标),由网管厂 商进行解析对应而产生一条告警信息。

4.5.1.5.2 消息字符串格式
上传字符串数据采用 XML 格式,便于 UltraNMS 服务端解析。每次上传的字符串以“<?xml version="1.0" encoding="GB2312"?><Alarms>”开始,以“</Alarms >”结束,中间的各条告警消息以 <Alarm></Alarm>分隔开,可同时包含多条告警消息。 省分网管的告警(包含活动告警、确认告警、 恢复告警),告警消息各字段的 XML 结点名称及解释参考如下: 属性名 KPIID KPIName AlarmId KBP KBP Name SeqNum Content BeginTime 中文描述 KPI 标号 KPI 名称 告警唯一标志 KBP 标号 KBP 名称 告警的顺序号 告警内容 开始时间 字段类型 STRING STRING STRING STRING STRING NUMBER STRING DATE 取值说明 KPI 标号,具体查看接口数据定义 KPI 名称,具体查看接口数据定义(可 空) 各省级系统上传告警的唯一标志 KBP 的字符编号 KBP 的中文名称(可空) 告警序列号,不能为空 告警的内容,不能为空 填写上传时间段的开始时间 格式:YYYY-MM-DD HH:mm:SS 格式同上 EndTime FirstTime LastTime 结束时间 告警首次发生时间 告警最后发生时间 DATE DATE DATE 填写上传时间段的结束时间 格式同上 填写监测到告警首次发生时的时间点 格式同上 填写监测到告警最近发生时的时间点 按照规范中的定义填写相应的告警级别 1 CRITICAL 2 MAJOR 3 MINOR 4 WARNING

EventLevel

告警级别

NUMBER
第 53 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5 INDETERMINATE 6 CLEARINFO 格式:YYYY-MM-DD HH:mm:SS AckTime AckUser 告警确认时间 告警确认人 DATE STRING 可以为空 告警确认人信息 可以为空 格式:YYYY-MM-DD HH:mm:SS 当告警是当前告警时为空, ClearTime 告警清除时间 DATE 当 EventLevel=6 时必须需填写 告警清除人员信息, 当告警是当前告警时为空, ClearUser Count 告警清除人 告警计数 STRING NUMBER 当 EventLevel=6 时必须需填写 填写本告警发生的次数,如果是告警清 除记录,则填 1

4.5.1.5.3 消息样例
省分网管的WebService客户端上传一条活动告警消息字符串样例,参考 FM_BJ_001_20080321_1015_000.xml: <?xml version="1.0" encoding="GB2312"?> <Alarms docId="FM_BJ_001_20080321_1015_000.xml" creationTime="2008-03-21 10:15:00" ProvinceID="BJ"> <Alarm > <AlarmId>1</AlarmId> <BeginTime>2008-03-21 10:00:00</BeginTime> <EndTime>2008-03-21 10:15:00</EndTime> <seqNum>1</seqNum> <KPIID>FM-00-01-XX-XX-XX</KPIID> <KPIName>XX告警</KPIName> <KBP>dasd-sda-sad</KBP> <KBPName>cisco2900</KBPName> <CONTENT>2008-03-21 10:00:009网管服务器到在信平台(10.54.13.52)连接不通.</CONTENT>
第 54 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<FirstTime>2008-03-21 10:13:00</FirstTime> <LastTime>2008-03-21 10:13:00</LastTime> <EventLevel>1</EventLevel> <AckTime></AckTime> <AckUser> </AckUser> <ClearTime></ClearTime> <ClearUser> </ClearUser> <Count>1</Count> </Alarm> </Alarms>

在这条告警消息字符串中,只上传了一条告警消息。对应这条告警的恢复告警,参考FM _BJ_001_20080321_1045_000.xml: <?xml version="1.0" encoding="GB2312"?> <Alarms docId="FM _BJ_001_20080321_1045_000.xml" creationTime="2008-03-21 10:45:00" ProvinceID="BJ"> <Alarm > <AlarmId>1</AlarmId> <BeginTime>2008-03-21 10:30:00</BeginTime> <EndTime>2008-03-21 10:45:00</EndTime> <seqNum>1</seqNum> <KPIID>FM-00-01-XX-XX-XX</KPIID> <KPIName>XX告警</KPIName> <KBP>dasd-sda-sad</KBP> <KBPName>cisco2900</KBPName> <CONTENT>2008-03-21 10:00:009网管服务器到在信平台(10.54.13.52)连接不通.</CONTENT> <FirstTime>2008-03-21 10:13:00</FirstTime>

第 55 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<LastTime>2008-03-21 10:18:00</LastTime> <EventLevel>6</EventLevel> <AckTime>2008-03-21 10:43:00</AckTime> <AckUser>people</AckUser> <ClearTime>2008-03-21 10:43:00</ClearTime> <ClearUser>people1</ClearUser> <Count>1</Count> </Alarm> </Alarms>

每次上传的告警消息字符串可同时包含多个活动告警、确认告警、恢复告警。在 <Aarmls></Alarms>中可包含多个告警信息<Alarm>,参考 FM _BJ_001_20080321_1046_000.xml: <?xml version="1.0" encoding="GB2312"?> <Alarms docId="FM _BJ_001_20080321_1046_000.xml" creationTime="2008-03-21 10:45:00" ProvinceID="BJ"> <Alarm> <AlarmId>1</AlarmId> <BeginTime>2008-03-21 10:00:00</BeginTime> <EndTime>2008-03-21 10:15:00</EndTime> <seqNum>1</seqNum> <KPIID>FM-00-01-XX-XX-XX</KPIID> <KPIName>XX告警</KPIName> <KBP>dasd-sda-sad</KBP> <KBPName>cisco2900</KBPName> <CONTENT>2008-03-21 10:00:009网管服务器到在信平台(10.54.13.52)连接不通.</CONTENT>
第 56 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<FirstTime>2008-03-21 10:13:00</FirstTime> <LastTime>2008-03-21 10:13:00</LastTime> <EventLevel>1</EventLevel> <AckTime></AckTime> <AckUser> </AckUser> <ClearTime></ClearTime> <ClearUser> </ClearUser> <Count>1</Count> </Alarm> <Alarm type="FMType"> <AlarmId>1</AlarmId> <BeginTime>2008-03-21 10:30:00</BeginTime> <EndTime>2008-03-21 10:45:00</EndTime> <seqNum>2</seqNum> <KPIID>FM-00-01-XX-XX-XX</KPIID> <KPIName>XX告警</KPIName> <KBP>dasd-sda-sad</KBP> <KBPName>cisco2900</KBPName> <CONTENT>2008-03-21 10:00:009网管服务器到在信平台(10.54.13.52)连接不通.</CONTENT> <FirstTime>2008-03-21 10:13:00</FirstTime> <LastTime>2008-03-21 10:18:00</LastTime> <EventLevel>6</EventLevel> <AckTime>2008-03-21 10:43:00</AckTime> <AckUser>people</AckUser> <ClearTime>2008-03-21 10:43:00</ClearTime> <ClearUser>people1</ClearUser> <Count>1</Count> </Alarm>

第 57 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

</Alarms>

一个活动告警的AlarmId(告警ID)与它的确认告警和恢复告警的AlarmId(告警ID)是必须一致 的,UltraNMS服务端通过确认告警或恢复告警的AlarmId(告警ID)来找到与它对应的活动告警进行 确认操作或者清除操作。

4.5.1.5.4 心跳消息格式
各省分网管平台客户端可每 10 分钟上传一次心跳消息, UltraNMS 可用心跳消息判断各平台是否 正常 。心跳消息的 XML 格式:
<?xml version="1.0" encoding="GB2312" ?> <heartbeat> <time>1273468663339</time> </heartbeat>

其中<time>为 long 型的毫秒级时间值,就是发送心跳消息的时间。

4.5.1.5.5 告警消息上传方式
1. 由 UltraNMS 端提供 Web Service 服务的 URL 地址,各省分网管告警的实时上传采用 Web Service 客户端方式。Web Service 是语言和平台无关的接口方式,Web Service 是基于 HTTP 的 XML 传输。 2. UltranNMS 系 统 端 建 立 WebService 服 务 , 各 省 分 网 管 的 WebService 客 户 端 调 用 upSendAlarm(String datas)方法上传告警数据;上传的字符串中可包括一条或多条告警信息, UltranNMS 系统对接收到的字符串数据进行格式分析,如果没有错误,在返回值中返回值为 0;如果有错误,将返回代表错误信息的数字。返回值参见下表。
0 1 2 格式分析正确,成功 上传的字符串不符合 XML 格式,格式有错 告警唯一标识号为空 第 58 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

3 4 6 7 8 9 10 11

实例名称为空 告警级别为空, 告警发生时间为空,或时间格式有误 告警确认状态为空, 区分告警为活动告警、确认告警、恢复(清除)告警的标记为空 告警标题为空 告警详细内容为空 发送此告警的时间为空,或时间格式有误

3. WebService 的 WSDL 文件参见 AlarmUpSend.wsdl,里面的 location 需要修改成实际的 WebService 地址,各省分网管告警上传客户端开发人员可依此进行开发。

AlarmUpSend.wsdl

4.5.1.6 性能数据文件上传 4.5.1.6.1 性能数据文件上传约定
性能数据文件上传流程约定如下: 1. 2. 3. 4. 对于每小时统计一次的指标,在下一小时一刻钟之前,生成性能指标上传文件; 对于每日统计一次的指标,在第二天的早晨 10 点之前,生成性能指标上传文件; 对于每月统计一次的指标,在下个月 1 日的早晨 10 点之前,生成性能指标上传文件; 对于每季度统计一次的指标,在下个季度首月 1 日的早晨 10 点之前,和月性能指标数 据和在同一个文件里一起上传;

4.5.1.6.2 性能数据格式定义
性能数据文件上传属性集定义:(注:以下所有属性都必填)

第 59 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

属性名
ProvinceID KPIID KPIName KBP KBPName

中文描述 省名称 KPI 标号 KPI 名称
KBP 标号 KBP 名称

字段类型 STRING STRING STRING STRING STRING

取值说明 填写附件 1 中的省份缩写 KPI 标号, 具体查看接口数据 定义 KPI 名称, 具体查看接口数据 定义(可空)
KBP 标号 KBP 名称(可空)

填写指标统计开始时间 YYYY-MM-DD hh:mm:ss。 被
BeginTime

指标统计开始时间

DATE

统计的指标的开始时间 填写指标统计截止时间 YYYY-MM-DD hh:mm:ss

EndTime MinValue AvgValue MaxValue SumValue

指标统计截止时间 最小值 平均值 最大值 和值 整点值 15 分钟值(1 刻钟值) 30 分钟值(2 刻钟值) 45 分钟值(3 刻钟值)

DATE NUMBER NUMBER NUMBER NUMBER NUMBER NUMBER NUMBER NUMBER

被统计的指标的结束时间 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998) 填写指标的数值 (对于带小 数的保留 4 位,例如 0.9998)

Hour Quarter HalfHour ThreeEngraved

日性能数据文件一个性能指标示例:

<?xml version="1.0" encoding="UTF-8"?> <IDRDoc docId="PM_BJ_001_20080321_0000_000.xml" <creationTime="2008-03-21 10:00:00" ProvinceID="BJ"> <IDR type="PMType"> <seqNum>1</seqNum>
第 60 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<BeginTime>2008-03-20 00:00:00</BeginTime> <EndTime>2008-03-21 00:00:00</EndTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>XX指标</KPIName> <KBP>001</KBP> <KBPName>001的名称</KBPName> <MinValue>12</MinValue> <AvgValue>10000</AvgValue> <MaxValue>13000</MaxValue> <SumValue>40000</SumValue> </IDR> <IDR type="PMType"> <seqNum>2</seqNum> <BeginTime>2008-03-20 00:00:00</BeginTime> <EndTime>2008-03-21 00:00:00</EndTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>XX指标</KPIName> <KBP>002</KBP> <KBPName>002的名称</KBPName> <MinValue>12</MinValue> <AvgValue>10000</AvgValue> <MaxValue>13000</MaxValue> <SumValue>40000</SumValue> </IDR> <End count="2" endTime="2008-03-21 10:00:00"/> </IDRDoc>
小时性能数据文件一个性能指标示例:

<?xml version="1.0" encoding="UTF-8"?> <IDRDoc docId="PM_BJ_001_20080320_0100_000.xml" creationTime="2008-03-20 01:00:00" ProvinceID="BJ"> <IDR type="PMType"> <seqNum>1</seqNum> <BeginTime>2008-03-20 01:00:00</BeginTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>XX指标</KPIName> <KBP>001</KBP> <KBPName>001的名称</KBPName> <Hour>13000</ Hour > <Quarter>12</Quarter > < HalfHour >10000</ HalfHour > <ThreeEngraved>13000</ ThreeEngraved >
第 61 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

</IDR> <IDR type="PMType"> <seqNum>2</seqNum> <BeginTime>2008-03-20 01:00:00</BeginTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>XX指标</KPIName> <KBP>002</KBP> <KBPName>002的名称</KBPName> < Hour >12</ Hour > < Quarter >10000</ Quarter > < HalfHour >13000</ HalfHour > < ThreeEngraved >40000</ ThreeEngraved > </IDR> <End count="2" endTime="2008-03-20 02:00:00"/> </IDRDoc>

4.5.1.7 配置数据文件上传 4.5.1.7.1 配置数据文件上传约定
配置数据文件上传流程约定如下: 1. 2. 3. 第一次需要配置数据全量上传; 每月一号需要进行配置数据全量上传; 每日早晨 10 点之前,对于前一日新增、修改、删除等变化需要上传,无变化上传空文 件;

4.5.1.7.2 配置数据格式定义
性能数据文件上传属性集定义:(注:以下所有属性都必填) 属性名
ProvinceID

中文描述 省名称

字段类型 STRING

取值说明 填写附件 1 中的省份 ID 填写指标统计开始时间 YYYY-MM-DD hh:mm:ss。

BeginTime EndTime

指标统计开始时间 指标统计截止时间

DATE DATE
第 62 页

被统计的指标的开始时间 填写指标统计截止时间 YYYY-MM-DD hh:mm:ss

中国联通增值业务综合网管系统技术规范 第六分册 3.0

被统计的指标的结束时间 KPI 标号,具体查看接口数
KPIID

KPI 标号

STRING

据定义 动作,表明是 新增 add 修改 update 删除 del

action KPIName KBP KBPName VALUE

动作 KPI 名称
KBP 标号 KBP 名称

STRING STRING STRING STRING STRING

全量 all KPI 名称,具体查看接口数 据定义
KBP 标号 KBP 名称



CM 值属性

配置数据文件一个性能指标示例:

<?xml version="1.0" encoding="UTF-8"?> <IDRDoc docId="CM_BJ_001_20080321_0000_000.xml " ProvinceID="BJ" creationTime="2008-03-21 10:00:00"> <IDR type="CMType" action="ADD"> <seqNum>1</seqNum> <BeginTime>2008-03-20 00:00:00</BeginTime> <EndTime>2008-03-21 00:00:00</EndTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>主机IP</KPIName> <KBP>001</KBP> <KBPName>001的名称</KBPName> <Value>192.168.0.1</Value> </IDR> <IDR type="CMType" action="UPDATE"> <seqNum>2</seqNum> <BeginTime>2008-03-20 00:00:00</BeginTime> <EndTime>2008-03-21 00:00:00</EndTime> <KPIID>PM-00-01-XX-XX-XX</KPIID> <KPIName>主机系统名</KPIName> <KBP>001</KBP> <KBPName>001的名称</KBPName> <Value>SUN880</Value> </IDR>
第 63 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<IDR type="CMType" action="DEL"> <seqNum>3</seqNum> <BeginTime>2008-03-20 00:00:00</BeginTime> <EndTime>2008-03-21 00:00:00</EndTime> <KPIID/> <KPIName/> <KBP>001</KBP> <KBPName>001的名称</KBPName> <Value/> </IDR> <End count="3" endTime="2008-03-21 10:00:00"/> </IDRDoc>

4.5.1.8 完整上传文件示例

4.5.2 上传接口数据定义
4.5.2.1 上传指标选取和用途说明
指标选取的主要原则如下: 1) 2) 3) 4) 所有指标都直接或间接来自于省业务规范 ; 选取的指标力图反映各省网管系统重大故障和主要性能 ; 选取的指标主要用于反映客户感知的指标 ; 编写性能指标用于评估各平台和应用可用性 ;

4.5.2.2 接口数据定义说明
本节说明接口数据定义各描述项的含义:

序号

名称

解释

第 64 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

1

KPI_ID KPI 名称 KPI 取值 告警级别

KPI 的数字编码,编码规则参见附件 2 KPI_ID 所包含大致信息 可能的 KPI 上发取值(精确小数点后 4 位) 分为 4 级

2

3

4

1 :CRITICAL 2 :MAJOR 3 :MINOR 4 :WARNING 5 :INDETERMINATE 6 :CLEARINFO
5 上发频率 上传指标的最小频率(大于采样频率)

6

不可用说明

针对系统可用性类的性能指标, 需要定义不可用取值范围。 比 如: 主机不可用时间包括 1) down 机时间 2) 计划外割接时间

7

备注

对于该 KPI 定义的补充说明

4.5.3 平台数据集
平台级数据配置和性能指标详见《中国联通增值业务综合网管系统技术规范 第一分册:公共增 值业务网管技术规范3.0》 。 平台级数据告警指标做统一要求,目前只上传如下告警内容:其中采样间隔是代理或者采集机的 采样间隔,发现超过告警门限,告警实时产生。 ⑴主机
编 号 1 KPI-ID FM-00-01-01-01-04 KPI 名称 主机 Cluster 状态 FM-00-01-01-02-03 文件系统使 用比率 KPI 描述 主机当前 CLUSTER 的 状态 文件系统已使用的空间 与总空间的比值 15 分钟 数值型 >90% 主要告警 采样间隔 5 分钟 数据类型 字符型 告警门限 告警级别 主要告警

2

第 65 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

3

FM-00-01-01-02-05

进程状态

进程状态包括运行,等 待,阻塞,挂起,停止

15 分钟

字符型

主要告警

⑵网络设备
编 号 1 KPI-ID FM-00-02-01-01-02 KPI 名称 设备端口状 态 FM-00-02-01-01-03 2 网络链路状 态 KPI 描述 网元设备的各端口的状 态 网络链路状态是通过网 络设备状态间接获取。 包含:链路通/断两种状 态 3 FM-00-02-01-02-02 4 FM-00-02-01-02-03 端口丢包率 设备 CPU 利 用率 FM-00-02-01-02-04 设备内存利 用率 端口丢包率(百分比) 网络设备 CPU 利用率 (百分比) 网络设备内存利用率 (百分比 15 分钟 数值型 >90% 主要告警 15 分钟 15 分钟 数值型 数值型 >70% 主要告警 主要告警 5 分钟 字符型 严重告警 采样间隔 5 分钟 数据类型 字符型 告警门限 告警级别 严重告警

5

⑶数据库
编 号 KPI-ID 1 FM-00-03-01-01-01 2 FM-00-03-01-01-02 3 FM-00-03-01-02-04 KPI 名称 数据库状态 表空间状态 表空间使用 率 KPI 描述 数据库是否可用 表空间所处状态 该表可用空间的百分比 采样间隔 15 分钟 15 分钟 1 小时 数据类型 字符型 字符型 数值型 90% 告警门限 告警级别 严重告警 主要告警 主要告警

4.5.4 业务数据集
业务级数据指标详见中国联通增值业务综合网管系统技术规范 第二分册~第五分册。 其中各分册 中规定的指标采样粒度小于天粒度的汇聚为天粒度上报; 大于天粒度的按各分册指标所规定的粒度上 报。 部分业务系统由于需要计算忙时占用等情况需要上报原始粒度15分钟数据的, 在下面会具体列出 这部分指标,此部分指标按小时粒度上报。目前所涉及到的平台有:短信中心、联通在信网关、互通 网关和彩信中心。其他未列出的指标遵从上段所述的上报要求。 业务级数据告警指标也在此列出,包括系统级告警和指标数据汇聚产生的告警。

第 66 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.5.4.1 GSM 短信中心应用管理 4.5.4.1.1 业务处理模块
(二)性能 (1)业务性能(根据短信中心编号实例化,上报间隔为1小时,采样间隔为15分钟) KBP编码规则:GSMSC-联通G网短信中心编号 GSMSC:固定值 联通G网短信中心编号:实际的联通G网短信中心编号
编号 KPI-ID PM-01-01-02-01-01 KPI 名称 MS 向短信中心提交 (MO)的短消息条数 PM-01-01-02-01-02 短消息成功处理的 (MO)短消息条数 PM-01-01-02-01-03 向短信中心提交的点 对点短信条数 PM-01-01-02-01-04 向短信中心提交成功 的点对点短信条数 KPI 描述 移动提交的短信条数,含点对点业务、 SP 业务、含 EMP 业务等。测量时间内 的统计值,下同。 移动台成功提交的短信条数, 含点对点 业务、SP 业务、含 EMP 业务等 移动提交的点对点短信条数,不含 SP 业务、不含 EMP 业务开户、销户消息 移动提交成功的点对点短信条数, 不含 SP 业务、不含 EMP 业务开户、销户消 息 短信中心下发点对点 MT 短信条数,不 含 SP 业务、不含 EMP 业务开户、销户 消息 短信中心下发成功的点对点 MT 短信条 数, 不含 SP 业务、 不含 EMP 业务开户、 15 分钟 销户消息 含点对点业务、SP 业务、互通业务、 含 EMP 开户、销户下行通知消息等 整型 15 分钟 整型 15 分钟 整型 15 分钟 整型 15 分钟 整型 采样间隔 数据类型

1

2

3

15 分钟

整型

4

5

PM-01-01-02-01-05

短信中心下发的点对 点短信条数

6

PM-01-01-02-01-06

短信中心下发成功的 点对点短信条数 短消息中心尝试下发

7

PM-01-01-02-01-07

至移动台的短消息条 数(MT) 短消息中心成功下发

15 分钟

整型

8

PM-01-01-02-01-08

至移动台的短消息条 数(MT)

含点对点业务、SP 业务、互通业务、 含 EMP 开户、销户下行通知消息等 含点对点业务、SP 业务、互通业务、 含 EMP 开户、销户下行通知消息等 含点对点业务、SP 业务、互通业务、

15 分钟

整型

9

PM-01-01-02-01-09

短信中心下发的短信 条数(不含重发)

15 分钟

整型

10

PM-01-01-02-01-10

短信中心成功下发的

短信条数(不含重发) 含 EMP 开户、销户下行通知消息等 PM-01-01-02-01-11 短信中心下发至其他 业务平台短信条数 含 SP 业务、互通业务、含 EMP 开户、 销户下行通知消息等

15 分钟

整型

11

15 分钟

整型

第 67 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

短消息中心成功下发 12 PM-01-01-02-01-12 至其他业务平台短消 息条数 13 PM-01-01-02-01-13 短信中心收到的 EMP 转发的状态报告数 短信中心收到的 EMP 14 PM-01-01-02-01-14 转发的状态报告成功 数

含 SP 业务、互通业务、含 EMP 开户、 销户下行通知消息等 被叫为异地有签约的 EMP 发来的 Submit_SR 消息数 被叫为异地有签约的 EMP 发来的 Submit_SR 中成功的消息数 网内点对点短信发送总条数 (不含重发

15 分钟

整型

15 分钟

整型

15 分钟

整型

15

PM-01-01-02-01-15

网内点对点短信尝试 发送条数

次数, 例如 1 条短信尝试发送 5 次才发 送成功,则尝试下发总次数为 5,发送 条数为 1。注意:这里“条数”与“次 数”有区别。下同) 15 分钟 整型

16

PM-01-01-02-01-16

网内点对点短信发送 成功条数

网内点对点短信发送成功条数 网内点对点短信尝试下发总次数 (包括

15 分钟

整型

17

PM-01-01-02-01-17

网内点对点短信尝试 下发总次数

重发与非重发, 即包括重发短信的下发 总次数以及非重发短信的下发总次数。 下同)

15 分钟

整型

18

PM-01-01-02-01-18

至移动互通点对点短 信发送条数

至移动互通点对点短信发送总条数 (不 含重发) 至移动互通点对点短信发送成功条数 至移动互通点对点短信尝试下发总次 数(包括重发与非重发) 至电信互通点对点短信发送总条数 (不 含重发) 至电信互通点对点短信发送成功条数 至电信互通点对点短信尝试下发总次 数(包括重发与非重发) 至省内在信网关短信发送总条数 (不含 重发) 至省内在信网关短信发送成功条数 至省内在信网关短信尝试下发总次数 (包括重发与非重发) 至全国在信网关短信发送总条数 (不含 重发) 至全国在信网关短信发送成功条数

15 分钟

整型

19

PM-01-01-02-01-19

至移动互通点对点短 信发送成功条数

15 分钟

整型

20

PM-01-01-02-01-20

至移动互通点对点短 信尝试下发总次数

15 分钟

整型

21

PM-01-01-02-01-21

至电信互通点对点短 信发送条数

15 分钟

整型

22

PM-01-01-02-01-22

至电信互通点对点短 信发送成功条数

15 分钟

整型

23

PM-01-01-02-01-23

至电信互通点对点短 信尝试下发总次数

15 分钟

整型

24

PM-01-01-02-01-24

至省内在信短信网关 发送条数

15 分钟

整型

25

PM-01-01-02-01-25

至省内在信网关发送 成功条数

15 分钟

整型

26

PM-01-01-02-01-26

至省内在信网关尝试 下发总次数

15 分钟

整型

27

PM-01-01-02-01-27

至全国在信短信网关 发送条数

15 分钟

整型

28

PM-01-01-02-01-28

至全国在信网关发送 成功条数

15 分钟

整型

第 68 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

29

PM-01-01-02-01-29

至全国在信网关尝试 下发总次数

至全国在信网关短信尝试下发总次数 (包括重发与非重发)

15 分钟

整型

4.5.4.2 联通在信网关应用管理 4.5.4.2.1 业务处理模块
(二)性能 (5) 短信中心到网关 MO 性能(根据相连短信中心编号实例化,上报间隔为 1 小时,采样间隔 为 15 分钟) KBP 编码规则:ZXSMG-联通在信网关编码-短消息中心编码 网关编码:实际的网关编码 短消息中心编码:实际的短消息中心编码
编号 6 7 8 KPI-ID PM-01-04-01-05-01 PM-01-04-01-05-02 PM-01-04-01-05-03 KPI 名称 接收 MO 总数 回复 response 数 回复成功 response 数 KPI 描述 接收 MO 总数 回复 response 数 回复成功 response 数 采样间隔 15 分钟 15 分钟 15 分钟 数据类型 整型 整型 整型

(6) 网关到短信中心 MT 性能(根据相连短信中心编号实例化,上报间隔为 1 小时,采样间隔 为 15 分钟) KBP 编码规则:ZXSMG-联通在信网关编码-短消息中心编码 网关编码:实际的网关编码 短消息中心编码:实际的短消息中心编码
编号 1 2 3 4 5 6 KPI-ID PM-01-04-01-06-01 PM-01-04-01-06-02 PM-01-04-01-06-03 PM-01-04-01-06-04 PM-01-04-01-06-05 PM-01-04-01-06-06 MT 总数 MT 重发次数 收到 response 数 收到成功 response 数 收到 report 数 收到成功 report 数 KPI 名称 KPI 描述 不含重发 采样间隔 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 数据类型 整型 整型 整型 整型 整型 整型

4.5.4.3 互通网关应用管理 4.5.4.3.1 业务处理模块
(二)性能 注:总部国际互通网关、集中互通网关对应的用户不区分短信中心。
第 69 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

(1) MT 性能(根据其他网关编号和本地短信中心编号实例化,上报间隔为 1 小时,采样间 隔为 15 分钟) KBP 编码规则:HTSMG-联通互通网关编号-其他网关编号-短信中心编号 HTSMG:固定值 联通互通网关编号:实际的联通互通网关编号 其他网关编号:实际的对方网关的编号 短信中心编号:实际的短信中心编号
编号 KPI-ID PM-01-03-01-01-01 KPI 名称 其他网关发往某短信中心用 户的短信发送条数 其他网关发往某短信中心联 通用户短信回复response数 其他网关发往某短信中心用 户短信回复成功response数 其他网关发往某短信中心联 通用户report回复数 其他网关发往某短信中心联 通用户短信成功条数 KPI 描述 其他网关发往某短信中心用 户的短信发送条数 指联通网关向其他网关回复 response条数 指联通网关向其他网关回复 成功response 指联通网关向其他网关回复 了report 指联通网关向其他网关回复 了成功report 采样间隔 15 分钟 数据类型 整型

1 2 3 4 5

PM-01-03-01-01-02

15 分钟

整型

PM-01-03-01-01-03

15 分钟

整型

PM-01-03-01-01-04

15 分钟

整型

PM-01-03-01-01-05

15 分钟

整型

(2) MO 性能(根据其他网关编号和本地短信中心编号实例化,上报间隔为 1 小时,采样间 隔为 15 分钟) KBP 编码规则:HTSMG-联通互通网关编号-其他网关编号-短信中心编号 HTSMG:固定值 联通互通网关编号:实际的联通互通网关编号 其他网关编号:实际的对方网关的编号 短信中心编号:实际的短信中心编号
编号 1 KPI-ID PM-01-03-01-02-01 KPI 名称 联通某短信中心用户发往其 他网关短信条数 (不含重发) 联通某短信中心用户发往其 他网关重发次数 联通某短信中心用户发往其 他网关收到response数 联通某短信中心用户发往其 他网关收到成功response数 联通某短信中心用户发往其 他网关收到report数 联通某短信中心用户发往其 他网关收到成功report数 不含重发 联通某短信中心用户发往其 他网关重发次数 联通某短信中心用户发往其 他网关收到response数 联通某短信中心用户发往其 他网关收到成功response数 联通某短信中心用户发往其 他网关收到report数 联通某短信中心用户发往其 他网关收到成功report数 KPI 描述 采样间隔 15 分钟 数据类型 整型

2

PM-01-03-01-02-02

15 分钟

整型

3

PM-01-03-01-02-03

15 分钟

整型

4

PM-01-03-01-02-04

15 分钟

整型

5

PM-01-03-01-02-05

15 分钟

整型

6

PM-01-03-01-02-06

15 分钟

整型

第 70 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.5.4.4 MMSC 系统应用管理 4.5.4.4.1 MMSC
(一) 性能 (1) MMS 发送数统计(根据网内、网间实例化;最终分为网内省内、网内省间;网间移动、网 间电信、网间国际) (根据彩信中心编号实例化,上报间隔为 1 小时,采样粒度为 15 分钟) KBP 编码规则: MMSC-MMSC 的业务系统编号-类型码 MMSC:固定值 MMSC 的业务系统编号:实际的联通 MMSC 的业务系统编号 类型码:网内-01、网间-02 (第二阶段需要将网内区分为省内、省间;将网间区分为移动、电信、国际;类型码细化为: 网内省内-0101、网内省间-0102、网间移动-0201、网间电信-0202、网间国际-0203)
编号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 KPI-ID KPI 名称 KPI 描述 统计时间段里 O 消息的总数 网络原因失败的 O 消息条数 用户原因失败的 O 消息条数 统计时间段里 T 消息的总数 网络原因失败的T消息条数 用户原因失败的T消息条数 MO 消息提交条数 MO 消息提交成功条数 应用类型为到终端的T消息条数 应用类型为到终端的T消息成功条数 提交的EO消息条数 提交的EO消息成功条数 ET消息条数 ET消息成功条数 AO消息条数 AO消息成功条数 应用类型为终端到应用的AT消息条数 应用类型为终端到应用的AT消息成功 条数 应用类型为终端到终端的MO提交消息 条数 应用类型为终端到终端的MO提交消息 成功条数 采样间隔 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 15 分钟 数据类型 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数 整数

PM-01-13-01-01-01 MMS 发送总条数 PM-01-13-01-01-02 网络失败提交数 PM-01-13-01-01-03 用户失败提交数 PM-01-13-01-01-04 MMS 接收总条数 PM-01-13-01-01-05 网络失败下发数 PM-01-13-01-01-06 用户失败下发数 PM-01-13-01-01-07 MO 消息条数 PM-01-13-01-01-08 MO 消息成功数 PM-01-13-01-01-09 MT 消息条数 PM-01-13-01-01-10 MT 消息成功数 PM-01-13-01-01-11 EO 消息条数 PM-01-13-01-01-12 EO 消息成功数 PM-01-13-01-01-13 ET 消息条数 PM-01-13-01-01-14 ET 消息成功数 PM-01-13-01-01-15 AO 消息条数 PM-01-13-01-01-16 AO 消息成功数 PM-01-13-01-01-17 AT 消息条数 PM-01-13-01-01-18 AT 消息成功数 PM-01-13-01-01-19 MOMT 提交消息条数 PM-01-13-01-01-20 MOMT 提交消息成功数

19

15 分钟

整数

20

15 分钟

整数

第 71 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

21

MOMT 提交消息网络失 PM-01-13-01-01-21 败数 MOMT 提交消息用户失 PM-01-13-01-01-22 败数 MOMT 彩信终端 T 消息 PM-01-13-01-01-23 条数 MOMT 未知终端 T 消息 PM-01-13-01-01-24 条数 MOMT 彩信终端 T 消 息成功数 MOMT 未知终端 T 消 息成功数 MOMT 彩信终端因用

终端到终端的O方向网络失败条数

15 分钟

整数

22

终端到终端的O方向用户失败条数 应用类型为终端到终端接受方为彩信 终端的T消息条数 应用类型为终端到终端接受方为未知 终端的T消息条数 应用类型为终端到终端接受方为彩信 终端的成功T消息条数 应用类型为终端到终端接受方为未知 终端的成功T消息条数 应用类型为终端到终端因为彩信终端 用户原因导致最终下发失败的彩信条 数 应用类型为终端到终端因为未知终端 用户原因导致最终下发失败的彩信条 数 应用类型为终端到终端因为彩信终端 网络原因导致最终下发失败的彩信条 数 应用类型为终端到终端因为未知终端 网络原因导致最终下发失败的彩信条 数 应用类型为终端到终端因为鉴权失败 导致的用户失败的彩信条数 应用类型为终端到终端用户主动拒绝 接收条数 统计时间段里 AT 消息中应用类型为 到终端的记录 MMS 条数 统计时间段里 AT 消息中应用类型为 到彩信终端的 MMS 成功记录条数 统计时间段里 AT 消息中应用类型为 到未知终端的 MMS 成功记录条数 应用类型为终端到 Email 的 MO 提交 消息条数 应用类型为终端到Email的MO消息成 功条数 应用类型为终端到应用的MO消息条数 应用类型为终端到应用的MO消息成功 条数

15 分钟

整数

23

15 分钟

整数

24

15 分钟

整数

25

PM-01-13-01-01-25

15 分钟

整数

26

PM-01-13-01-01-26

15 分钟

整数

27

PM-01-13-01-01-27 户 原 因 导 致 下 发 失 败 的条数 MOMT 未知终端因用

15 分钟

整数

28

PM-01-13-01-01-28 户 原 因 导 致 下 发 失 败 的条数 MOMT 彩信终端因网

15 分钟

整数

29

PM-01-13-01-01-29 络 原 因 导 致 下 发 失 败 的条数 MOMT 未知终端因网

15 分钟

整数

30

PM-01-13-01-01-30 络 原 因 导 致 下 发 失 败 的条数

15 分钟

整数

MOMT 因用户原因
31 PM-01-13-01-01-31 失 败 数 量 中 由 于 鉴

15 分钟

整数

权失败的条数
32 PM-01-13-01-01-32 MOMT 用户主动拒绝 接受的条数

15 分钟

整数

33

PM-01-13-01-01-33 转相册条数 彩信终端转相册成功 PM-01-13-01-01-34 数 未知终端转相册成功 PM-01-13-01-01-35 条数

15 分钟

整数

34

15 分钟

整数

35

15 分钟

整数

36

PM-01-13-01-01-36 MOET 提交消息条数 PM-01-13-01-01-37 MOET 提交消息成功数 PM-01-13-01-01-38 MOAT 提交消息数 PM-01-13-01-01-39 MOAT 提交消息成功数

15 分钟

整数

37 38 39

15 分钟 15 分钟 15 分钟

整数 整数 整数

第 72 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

40

PM-01-13-01-01-40 EOMT 提交消息数 PM-01-13-01-01-41 EOMT 提交消息成功数 PM-01-13-01-01-42 EOMT 彩信终端 PM-01-13-01-01-43 EOMT 未知终端 PM-01-13-01-01-44 AOMT 提交消息条数 PM-01-13-01-01-45 AOMT 提交消息成功数 AOMT 提交消息因网络 PM-01-13-01-01-46 原因失败数 AOMT 提交消息因用户 PM-01-13-01-01-47 原因失败数 AOMT 彩信终端 T 消息 PM-01-13-01-01-48 条数 AOMT 未知终端 T 消息 PM-01-13-01-01-49 条数 AOMT 彩信终端 T 消 息成功数 AOMT 未知终端 T 消 息成功数 AOMT 彩信终端因用

应用类型为Email到终端的EO消息总 数 应用类型为 Email 到终端的 EO 消息成 功总数 应用类型为 Email 到终端, 接受方为彩 信终端的 T 消息条数 应用类型为 Email 到终端接受方为未 知终端的 T 消息条数 应用类型为应用到终端的 AO 消息条 数 应用类型为应用到终端的 AO 消息成 功条数 应用到终端的 O 方向网络失败条数 应用到终端的 O 方向用户失败条数 应用类型为应用到终端接受方为彩信 终端的 T 消息条数 应用类型为应用到终端接受方为未知 终端的 T 消息条数 应用类型为应用到终端接受方为彩信 终端的成功 T 消息条数 应用类型为应用到终端接受方为未知 终端的成功 T 消息条数 应用类型为应用(SP)到终端因为彩 信终端用户原因导致最终下发失败的 彩信条数 应用类型为应用(SP)到终端因为未 知终端用户原因导致最终下发失败的 彩信条数 应用类型为应用(SP)到终端因用户 原因导致最终下发失败的彩信条数 应用类型为应用(SP)到终端因为网 络原因导致最终下发失败的彩信条数 应用类型为应用(SP)到终端因为鉴 权失败导致的用户失败的彩信条数 应用类型为应用(SP)到终端由于用 户主动拒绝接受的条数

15 分钟

整数

41

15 分钟

整数

42

15 分钟

整数

43

15 分钟

整数

44

15 分钟

整数

45

15 分钟

整数

46

15 分钟

整数

47

15 分钟

整数

48

15 分钟

整数

49

15 分钟

整数

50

PM-01-13-01-01-50

15 分钟

整数

51

PM-01-13-01-01-51

15 分钟

整数

52

PM-01-13-01-01-52 户 原 因 导 致 下 发 失 败 的条数 AOMT 未知终端因用

15 分钟

整数

53

PM-01-13-01-01-53 户 原 因 导 致 下 发 失 败 的条数 AOMT 因用户原因导 致下发失败的条数 AOMT 因网络原因导 致下发失败的条数

15 分钟

整数

54

PM-01-13-01-01-54

15 分钟

整数

55

PM-01-13-01-01-55

15 分钟

整数

AOMT 因用户原因
56 PM-01-13-01-01-56 失 败 数 量 中 由 于 鉴

15 分钟

整数

权失败的条数
57 PM-01-13-01-01-57 AOMT 用户主动拒绝 接受的条数

15 分钟

整数

注明:指标修改后遵循《彩信系统消息发送状态码细化方案 V1.8.0》 ,后简称为《细化方案》 。消 息数—包括状态类型为“成功”“准成功”“用户失败”“网络失败”所有四类状态码的总和;成功 、 、 、 消息数—只是状态类型为“成功”的状态码的数据;其中“用户失败”为《细化方案》中“成功状态”
第 73 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

列标为“用户失败”的所有状态码数据之和, “网络失败” 为《细化方案》中“成功状态”列标为“用 户失败”的所有状态码数据之和。所有指标分(O、T 方向) KBP 类型为网间时,不存在 AO、EO 及转相册的相关指标。

4.5.4.5 业务数据级告警
1.短信中心业务级告警
编 号 KPI-ID KPI 名称 链路状态是否正 常 与 ESME 之间的 SMPP 连接状态 与预付费系统之 间连接状态 与 VAC 之间连接 状态 与 EMP 系统之 间连接状态 KPI 描述 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-01-01-01-01 2 FM-01-01-03-01-01 3 FM-01-01-04-01-01 4 FM-01-01-07-01-01 5 FM-01-01-08-01-01

链路状态是否正常 成功与否(按照 ESME 进行实例化处理) 成功与否,按照预付费 系统进行实例化处理 成功与否

实时

布尔型

主要告警

实时

布尔型

主要告警

实时

布尔型

主要告警

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

2.短信中心业务指标告警
编 号 KPI-ID KPI 名称 KPI 描述 采样间隔 数据类型 告警门限 ① 平 均 小时 整型 60%以上 ② 平 均 50% 告警级 别 ①严重 告警 ②主要 告警

1 PM-01-01-01-01-01

占用百分 比

信令链路利用率百分比:接 收和发送总字节数/单位时 间可传递字节数。

3.联通在信网关业务级告警
编 号 KPI-ID KPI 名称 与数据库之间连 接状态 与短信中心之间 连接状态 与 SP 管理平台 之间连接状态 与预付费系统之 间连接状态 KPI 描述 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-04-01-01-01 2 FM-01-04-03-01-01 3 FM-01-04-04-01-01 4 FM-01-04-05-01-01

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

第 74 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5 FM-01-04-06-01-01 6 FM-01-04-06-01-02 7 FM-01-04-06-01-03

话单生成目录长 时间未更新 话单文件连续性 话单文件是否为 空

话 单 生 成 目录 长 时 间 未更新 话单文件产生断号、跳 号现象 话单文件是否为空

1 小时 1 小时 1 小时

布尔型

主要告警

布尔型

主要告警

布尔型

4.SP 管理系统业务级告警
编 号 KPI-ID KPI 名称 链路状态是否正 常 与 ESME 之间的 SMPP 连接状态 与预付费系统之 间连接状态 与 VAC 之间连接 状态 KPI 描述 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-01-01-01-01 2 FM-01-01-03-01-01 3 FM-01-01-04-01-01 4 FM-01-01-07-01-01

链路状态是否正常 成功与否(按照 ESME 进行实例化处理) 成功与否,按照预付费 系统进行实例化处理 成功与否

实时

布尔型

主要告警

实时

布尔型

主要告警

实时

布尔型

主要告警

实时

布尔型

主要告警

5.短信互通网关业务级告警
编 号 KPI-ID KPI 名称 KPI 描述 对 方 网 关 是否 限 制 流 量 成功与否 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-03-02-01-01 2 FM-01-03-02-01-02 3 FM-01-03-03-01-01 4 FM-01-03-04-01-01 5 FM-01-03-05-01-01 6 FM-01-03-05-01-02 7 FM-01-03-05-01-03

限制流量 与对方网关之间 连接状态 与短信中心之间 连接状态 与预付费系统之 间连接状态 话单生成目录长 时间未更新 话单文件连续性 话单文件是否为 空

实时

布尔型

主要告警

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否 话 单 生 成 目录 长 时 间 未更新 话单文件产生断号、跳 号现象 话单文件是否为空

实时

布尔型

主要告警

1 小时 1 小时 1 小时

布尔型

主要告警

布尔型

主要告警

布尔型

主要告警

6.EMP 系统业务级告警
编 号 KPI-ID KPI 名称 KPI 描述 采样间隔 数据类型 告警门 限 告警级别

第 75 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

1 FM-01-18-01-01-01 2 FM-01-18-03-01-01 3 FM-01-18-03-02-01 4 FM-01-18-04-01-01 5 FM-01-18-07-01-01

与数据库之间连 接状态 与短信中心之间 连接状态 与 EMP 之间连 接状态 EMP 与 ESN 之 间连接状态 与 VAC 之间连接 状态

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

成功与否

实时

布尔型

主要告警

7.语音短信平台业务级告警
编 号 KPI-ID 1 FM-01-05-02-01-01 2 FM-01-05-04-01-01 3 FM-01-05-04-01-02 4 FM-01-05-04-01-03 5 FM-01-05-08-01-01 6 FM-01-05-11-01-01 KPI 名称 中继故障 无法放音 IVR 模块无法放音次 数超门限值 IVR 模块无法录音次 数超门限值 其他错误告警 出现不正常状态 成功与否 KPI 描述 采样间隔 实时 5 分钟 5 分钟 5 分钟 实时 实时 数据类型 整型 整型 告警门 限 告警级别 主要告警 主要告警

无法录音 其他错误告警 TTS 连接状态 与 VAC 之间连接 状态

整型 字符串型 字符串型 布尔型

主要告警 主要告警 主要告警 主要告警

8.语音短信平台指标告警
编 号 KPI-ID KPI 名称 KPI 描述 采 样 时 间 间隔 内 交 换 1 PM-01-05-02-01-01 信令链路负荷 机 信 令 链 路的 平 均 爱 尔兰数 单位:爱尔兰 小时 浮点 平均 0.2 严重告警 采样间隔 数据类型 告警门 限 告警级别

采 样 时 间 间隔 内 中 继 2 PM-01-05-02-01-05 中继链路负荷 链路的平局负荷 位:爱尔兰 单 小时 浮点 平均 0.7 严重告警

9.炫铃系统业务级告警
编 号 KPI-ID KPI 名称 KPI 描述 中继故障,告警内容包 1 FM-01-10-01-01-01 中继故障 含 中 继 标 识以 及 故 障 状态 实时 整型 主要告警 采样间隔 数据类型 告警门 限 告警级别

第 76 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

信令链路故障,告警内 2 FM-01-10-01-02-01 3 FM-01-10-02-01-01 4 FM-01-10-02-01-02 5 FM-01-10-02-01-03 6 FM-01-10-07-01-01 信令链路故障 容 包 含 链 路标 识 以 及 链路状态 无法放音 无法录音 其他错误告警 与 VAC 之间连接 状态 IVR 模块无法放音 IVR 模块无法录音次 数超门限值 其他错误告警 成功与否 实时 实时 实时 实时 整型 整型 字符串型 布尔型 主要告警 主要告警 主要告警 主要告警 实时 整型 主要告警

10.炫铃系统指标告警
编 号 KPI-ID KPI 名称 KPI 描述 此 性 能 参 数是 每 个 性 1 PM-01-10-01-01-02 信令链路发送负 荷 能 采 集 周 期内 信 令 链 路的平均发送负荷 单位:爱尔兰 此 性 能 参 数是 每 个 性 2 PM-01-10-01-01-03 信令链路接收负 荷 能 采 集 周 期内 信 令 链 路的平均发送负荷。单 位:爱尔兰 采 样 时 间 间隔 内 中 继 3 PM-01-10-01-03-04 占用话务量 链路的平局负荷 位:爱尔兰 单 小时 浮点 平均 0.7 严重告警 小时 浮点 平均 0.2 严重告警 小时 浮点 平均 0.2 严重告警 采样间隔 数据类型 告警门 限 告警级别

11.WAP 网关业务级告警
编 号 KPI-ID KPI 名称 KPI 描述 告 警 发 生 在整 个 业 务 系统平台上,或不能准 确定位 表示 WAPG 与 GGSN 之间发生告警 表示 WAPG 与 radius 服务器之间发生告警 表示 WAPG 与短信中 心之间发生告警 表示 WAPG 与在信网 关之间发生告警 实时 布尔型 主要告警 实时 布尔型 主要告警 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-12-01-01-01

WAP 网关系统告 警 WAPG 与 GGSN 之间告警 WAPG 与 radius

2 FM-01-12-02-01-01

3 FM-01-12-03-01-01

服务器之间的告 警

实时

布尔型

主要告警

4 FM-01-12-04-01-01 5 FM-01-12-04-01-01

WAPG 与短信中 心之间告警 WAPG 与在信网 关之间告警

实时

布尔型

主要告警

实时

布尔型

主要告警

第 77 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

6 FM-01-12-05-01-01 7 FM-01-12-06-01-01

WAPG 与彩信中 心之间告警 与 VAC 之间连接 状态

表示 WAPG 与彩信中 心之间发生告警 成功与否

实时

布尔型

主要告警

实时

布尔型

主要告警

12.彩信中心业务级告警
编 号 KPI-ID KPI 名称 MMSC 业务系统 告警 MM1 接口告警 MM3 接口告警 MM4 接口告警 与预付费系统之 间连接状态 与 VAC 之间连接 状态 KPI 描述 表示整体 MMSC 业务 系统发生告警 MM1 接口发生告警 MM3 接口发生告警 MM4 接口发生告警 成功与否 采样间隔 数据类型 告警门 限 告警级别

1 FM-01-13-01-01-01 2 FM-01-13-02-01-01 3 FM-01-13-03-01-01 4 FM-01-13-04-01-01 5 FM-01-13-06-01-01 6 FM-01-13-07-01-01

实时 实时 实时 实时 实时

布尔型 布尔型 布尔型 布尔型 布尔型

主要告警 主要告警 主要告警 主要告警 主要告警

成功与否

实时

布尔型

主要告警

4.6 局数据管理平台两级接口

4.6.1 下发标准局数据说明
下发的标准局数据指 总部下发的标准局数据文件,为 excel 文件。 当有新的标准局数据文件时,将改文件放到 ftp 的 GCData 目录下。每天省端上传局数据和对比 局数据的时候检查一下, 文件名定义如下:

GCDATA_[源文件名]_YYYYMMDD.XLS
元素 GCDATA 源文件名 YYYYMMDD 描述 固定值 原始的文档文 件名 时间 取值说明 固定值 如: 附件 5 中国联通 GSM 网 130 号码汇总表 2008 年第二批 填写文件的所在日(月) ,示例:20090101
第 78 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

例:GCDATA_附件 5 中国联通 GSM 网 130 号码汇总表 2008 年第二批_20081225.xls

4.6.2 上传接口文件说明
注:现要求其他网管厂商将现网局数据和局数据对比结果都传给泰岳,由泰岳方来统一做展现工 作。

4.6.2.1 上传现网局数据 4.6.2.1.1 现网局数据上传约定
每天上午 9 点前需要进行现网局数据全量上传;每个业务系统建立一个文件夹,文件夹名定义如 下:文件夹命名规则参照业务系统名规则,例如短信中心,文件夹名字为 002,在信网关,文件夹名 字为 003 注:1、现网局数据号段文件和现网配置数据文件都放在各自的业务系统文件夹下面; 2、局数据对比文件放在短信中心(002)文件夹下。

4.6.2.1.2 现网局数据数据格式约定
局数据比对文件名定义如下:

TYPE_PROV_业务系统名 _YYYYMMDD_XXX_FFF.YYY
现网局数据号段文件和现网配置数据文件定义如下:

TYPE_PROV_业务系统名_模块名_YYYYMMDD_XXX_FFF.YYY
元素 描述 取值说明

第 79 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

TYPE

文件类型前缀

这里表示的前缀为字符,可能的取值如下: 现网局数据号段文件: 局数据比对文件:: SC RC

现网配置数据文件:CM PROV 业务系统名 省份缩写 业务系统名 参看附件 1 联通短信中心 联通在信网关 互通网关 G 网 WAP 网关 MMSC 语音 炫铃 SPMS WAP 业务平台 定位接入及应用系统 彩信业务平台 行业应用平台 GSM 网终端管理系统 增值业务用户鉴权中心 VAC 扩展业务管理平台 EMP 模块名(modelname) 模块名称 002 003 005 006 007 008 009 010 011 013 014 015 016 017 018

短信业务平台(SP 业务平台) 012

根据 CM 指标的 KPI 的前四位来区分模块 例如 01010101 代表短信中心的业务处理模块

YYYYMMDD

时间

填写文件的所在日(月) ,示例: 15 分钟上传文件格式(如告警文件) :20090101 每日,每小时上传文件(如日性能文件)格式: 20090101 每月上传文件(如配置全量、日期填写‘00’ )格式: 20060100

第 80 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

HHMM

小时分钟

填写小时和分钟,文件范围的结束时间。 比如 5 号的日性能文件,文件名中的 YYYYMMDD 是 20081206 HHMM 是 0000 5 号最后一个告警文件,文件名中的 YYYYMMDD 是 20081206 HHMM 是 0000

FFF

重传标志位

填写是否重传的标志,000 非重传文件;如果重传, 按重传次数依次递增 1。

YYY

文件后缀名

Xml ,标准局数据是 xls

上传文件名示例: 10) 北京上传的局数据比对文件,文件所在日为 2008 年 6 月 8 日,状态为正常上传的文 件,则文件名称为 SC_BJ_000_20080609_0000_000.xml 11) 北京上传的现网局数据 G 网短信中心号段文件,文件所在日为 2008 年 6 月 8 日,状 态 为 正 常 上 传 的 文 件 , 则 文 件 名 称 为 RC_BJ_002_ 01010101 20080609_0000_000.xml 12) 北京上传的现网配置数据文件,文件所在日为 2008 年 6 月 8 日,状态为正常上传的 文件,则文件名称为 CM_BJ_002_01010101_20080609_0000_000.xml

现网局数据数据格式约定补充

属性名 pro_name seqNum Value

中文描述 省份代码 序列号 值

字段类型 字符串 NUMBER NUMBER

取值说明

省份
唯一标示文件中一条记录 G 网短信中心 :GSMSC 联通在信网关: UniZXGateway 互通模块: ConnectGatewayAPP GWAPGW

Type

业务类型

字符串

G 网 WAP :

第 81 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

MMSC :

MMSC

语音短信及语音点播系统: SoundAddSystem EMP:EMP 行业应用平台:IAP 根据 CM 指标的 KPI 的前四位来区分模块 Modelname dcTime 模块名称 入库时间 地区 字符串 字符串 字符串 例如 01010101 代表短信中心的业务处理模块 入库时间 地区

area_code

4.6.2.1.3 完整上传文件示例
<?xml version="1.0" encoding="UTF-8"?> <!-pro_name:省份 createFileTime:创建文件的日期 modelname: 模块名称 value:号段 sysId:业务系统编号 入库时间:dcTime Area_code:地区 --> <gcDoc pro_name="河北" createFileTime="200804010058"> <gcvalue> <seqNum>1</seqNum> <type>GSMSC</type> < modelname> 01010101 </ modelname > <value>1325042</value> <sysId>8613010171500</sysId> <kbpId> GSMNUM -8613010171500-1325042</kbpId> <dcTime>200804010058</dcTime> <area_name>石家庄</area_name> </gcvalue> <gcvalue> <seqNum>2</seqNum> <type>GSMSC</type> < modelname> 01010101</ modelname > <value>1325763</value>
第 82 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<sysId>8613010171500</sysId> <kbpId> GSMNUM -8613010171500-1325763</kbpId> <dcTime>200804010058</dcTime> < area_name >保定</ area_name > </gcvalue> </gcDoc>

4.6.2.2 上传局数据比对结果 4.6.2.2.1 局数据比对上传约定
每天上午 9 点前需要进行现网局数据比对结果全量上传;

4.6.2.2.2 局数据比对数据格式约定
属性名 pro_name cencode area_name 中文描述 省份 短信中心编号 地区 字段类型 字符串 NUMBER 字符串 type="漏做" :代表某号段存在于标 准局数据,但实际局数据中并没做 type="多做": type 操作错误类型 字符串 代表某号段存在于实 际局数据,但标准局数据中并不存在 type="错做": 同一个号段, 实际局数 据分配的地区与标准局数据所分配 的地区不同 standard fact 标准局数据值 实际局数据 NUMBER NUMBER 取值说明

第 83 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.6.2.2.3 完整上传文件示例
<?xml version="1.0" encoding="UTF-8"?> <!-pro_name:省份 createFileTime:创建文件的日期 operation_system:业务系统 num:号段 :GSMSC-8613010171500-130 GSMSC:G网短信中心 8613010171500:G网短信中心编号 130:号段 dcTime:入库时间 area_name:地区 -->
-

<gccheck pro_name="山东" creationTime="200912210000">

- <gcDoc operation_system="GSMSC"> - <gcvalue type="漏做" cencode="8613010161500">

<seqNum>1</seqNum> <standard area_name="济南">1300170</standard> <fact area_name="" /> </gcvalue>
- <gcvalue type="漏做" cencode="8613010161500">

<seqNum>2</seqNum> <standard area_name="济南">1300171</standard> <fact area_name="" />

第 84 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

</gcvalue>
- <gcvalue type="漏做" cencode="8613010161500">

<seqNum>3</seqNum> <standard area_name="济南">1300172</standard> <fact area_name="" /> </gcvalue>
</gcDoc> </gccheck>

4.6.2.3 上传局数据配置数据 4.6.2.3.1 局数据配置格式约定
属性名 pro_name sysId 中文描述 省份 业务系统编号 字段类型 字符串 NUMBER WAP 网关:GWAPGW 彩信中心:MMSC 互 通 网 关 : ConnectGatewayAPP 炫铃平台 CRBT Type 业务系统 字符串 在信网关 UniZXGateway 短信中心 GSMSC 短信业务平台:SMSP 彩信业务平台:MMSSP WAP 业务平台:WAPSP VAC:VAC
第 85 页

取值说明

中国联通增值业务综合网管系统技术规范 第六分册 3.0

GSM 网终端平台:GTMS 行业应用平台:IAP modelname Kpi 模块名称 指标 字符串 字符串 见以上说明

4.6.2.3.2 局数据配置实例
<?xml version="1.0" encoding="UTF-8"?> <!-pro_name:省份 createFileTime:创建文件的日期 type:业务系统 modelname: 模块名称 kpi:指标 sysId:业务系统编号 入库时间:dcTime(13位毫秒) --> <gcDoc pro_name="河北" createFileTime="200804010058" type=" GWAPGW " modelname="01120201 " > <gcvalue sysId ="8613010171500"> <seqNum>1</seqNum> <kbp> WAPG-GGSN-1207712-822002-GXGGSN1</kbp> <kpis> <kpi <kpi </kpis> <dcTime>1288540800000</dcTime> </gcvalue> <gcvalue sysId ="8613010171500"> <seqNum>2</seqNum> <kbp> WAPG-GGSN-1207712-822002-GXGGSN1</kbp> <kpiList> <kpi id="CM-01-12-02-01-01">260 </kpi> <kpi id="CM-01-12-02-01-02">192.168.20.182 </kpi> </kpiList> <dcTime>1288540800000</dcTime>
第 86 页

id="CM-01-12-02-01-01">250 </kpi> id="CM-01-12-02-01-02">192.168.20.128 </kpi>

中国联通增值业务综合网管系统技术规范 第六分册 3.0

</gcvalue> </gcDoc>

4.7 电子运维系统接口
综合监控平台与电子功工单系统接口,以触发告警工单;自动巡检系统与电子工单系统接口,以 触发业务派单。总部电子运维与总部/省增值业务综合网管系统间接口已实现,省电子运维系统与省 综合网管间接口可参照总部接口实现。

4.7.1 告警派单接口
自动派单流程

第 87 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

告警自动派单接口 EOMS系统 告警系统

接收告警信息生成工单 按照角色细分规则派发

调用EOMS告警接收服务

修改告警状态 记录告警清除时间

告警状态发生变化调用 EOMS告警同步服务

1) 告警派单 网管系统负责进行告警是否派单的判定,并调用 EOMS 系统提供的“告警接收”接口服务,将需要 派单的告警信息送入 EOMS 系统。 当 EOMS 系统接收到需要派单的告警时, 自动生成故障工单, 并根据角色细分规则进行工单派发。 2) 告警状态同步 当告警状态发生变化时,告警系统调用 EOMS 告警同步服务,EOMS 修改相关工单的告警状态, 并记录告警清除时间。

4.7.1.1 接口定义
网管告警派单接口采用 Web Service/SOAP 技术。 各接口的详细信息统一使用“opDetail”参数,“opDetail”以 XML 封装,格式如下:

第 88 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

<opDetail> <recordInfo> <fieldInfo> <fieldChName>…</fieldChName> <fieldEnName>…</fieldEnName>

//详细信息 //记录内容 //字段内容 //字段中文名 //字段英文名

<fieldContent>…</fieldContent> //字段内容 </fieldInfo> </recordInfo> </opDetail> <opDetail>中可包括多个<recordInfo>部分,<recordInfo>中可包括多个<fieldInfo>部分。如果没有 详细信息,则仅存“<opDetail></opDetail>”。 网管告警派单接口包括以下服务: 服务名称 InterSwitchAlarm SheetStateSync 中文名称 告警信息传送服务 工单状态同步服务 服务说明 用于接收告警及告警同步信息 用于接收故障工单状态变化信息 提供方 EOMS 网管

4.7.1.1.1 EOMS 提供的 WS 接口服务 4.7.1.1.1.1 告警信息传送服务(InterSwitchAlarm)
(1). 连通测试 (isAlive) 说明:网管系统在调用 EOMS 系统相应服务模块中其他接口方法之前, 可利用此服务调用判断对方当 前服务是否已经部署完毕,以确定所调用的方法当前是否可以正常服务。 服务名称:InterSwitchAlarm 接口方法:isAlive 输入参数:Null(无) 输出参数:isAliveResult(string 类型。为空表示相应服务可用,非空表示该服务当前出现问题,错误
第 89 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

返回信息用相应明文进行说明) (2). 告警接收 (newAlarm) 说明:EOMS 系统提供该接口服务用于接收需要自动或手工派发故障工单的告警信息。 服务名称:InterSwitchAlarm 接口方法:newAlarm 输入参数: 参数名称 serSupplier 长度 string(16) 中文名称 服务提供方 说明 命名形如:省市代码_系统名称 命名形如:省市代码_系统名称 serCaller string(16) 服务调用方
作用:区分不同的省份的网管的 系统名称就是**省网管系统

callerPwd callTime

string(32) string(20)

口令 服务调用时间

/ / 参见“详细信息约定”

opDetail

String

详细信息

输出参数:输出为一个字符串,格式为“sheetNo=工单号;errList=错误描述”。如果派单成功:“工单号” 不为空串,“错误描述”为空串;如果派单失败,“工单号”为空串,“错误列表”为错误描述。约定 “sheetNo=”和“errList=”不管派单成功与否都必须有,只是值可以为空串。 opDetail 详细信息约定: 字段英文名 alarmId alarmFatherId alarmCreateTime 类型(长度) string(80) string(80) string(40) 字段中文名 告警 ID 设备 ID 发生时间 说明 告警记录的唯一 ID 网管系统中父节点的 moName 告警发生时间,时间格式为:

第 90 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

yyyy-MM-dd HH:mm:ss ProvinceID string(400) 省分代码 告警级别 省分名称,如河北 告警级别的对应关系: 严重告警——重大故障 alarmLevel string(20) 主要告警——严重故障 次要告警——一般故障 警告告警——一般故障 工单主题 告警标题 如: 截取描述的前 30 个字符 或 EomsName string(200) 日期+告警级别来做标题( 例 如:2008-12-01 23:33:30 严重 告警) 可根据各省告警要求进行 EomsDepict string(500) 工单描述 处理人 告警内容 告警相关运维人员用户名,通 过通知规则获得 手机号码 HandsetPhone string(32) 通过通知规则获得 (3). 告警同步 (syncAlarm) 说明:当已派发了故障工单的网管告警的状态发生变化时,网管系统调用 EOMS 系统提供的接口服 务,同步两个系统中的告警状态,并给出告警清除时间。 服务名称:InterSwitchAlarm 接口方法:syncAlarm 告警相关运维人员手机号码,

sender

string(40)

第 91 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

输入参数:如下表所示 参数名称 serSupplier 参数类型 string(16) 中文名称 服务提供方 说明 命名形如:省市代码_系统名称 命名形如:省市代码_系统名称
省市代码参考基本规范中:省份、省

serCaller

string(16)

服务调用方

公司编码部分 作用:区分不同的省份的网管的 系统名称就是**省网管系统

callerPwd callTime

string(32) string(20)

口令 服务调用时间

/ / 参见“详细信息约定”

opDetail

String

详细信息

输出参数:输出为字符串。格式为“sheetNo=工单号;errList=错误描述” 。如果调用成功,则 sheetNo 不为空串为该告警对应的工单号、errList 为空串;如果调用失败,则如果该告警在电子运维系统中不 存在对应的工单则 sheetNo 为空串, ,errList 为错误描述。约定“sheetNo=”和“errList=”不管调 用成功与否都必须有,只是值可以为空串。 opDetail 详细信息约定: 字段英文名 alarmId alarmStatus clearTime clearPeople 类型(长度) string(80) Integer(2) string(20) string(20) 字段中文名 告警 ID 告警状态 告警清除时间 告警清除人 说明 告警 ID 1:自动清除;2:手工清除; / 告警处理人

第 92 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.7.1.1.2 网管提供的 WS 接口服务 4.7.1.1.2.1 工单状态同步服务(SheetStateSync)
(1). 连通测试(isAlive) 说明:网管系统在调用 EOMS 系统相应服务模块中其他接口方法之前, 可利用此服务调用判断对方当 前服务是否已经部署完毕,以确定所调用的方法当前是否可以正常服务。 服务名称:InterSwitchAlarm 接口方法:isAlive 输入参数:Null(无) 输出参数:isAliveResult(string 类型。为空表示相应服务可用,非空表示该服务当前出现问题,错误 返回信息用相应明文进行说明) (2). 告警确认(syncSheetState) 说明:当已派发了故障工单的网管告警相关事件工单一旦得到了人员确认或者开始处理,EOMS 系统 调用网管系统提供的接口服务,进行告警确认。 服务名称:SheetStateSync 接口方法:syncSheetState 输入参数:如下表所示 参数名称 serSupplier serCaller callerPwd callTime 参数类型 string(16) string(16) string(32) string(20) 中文名称 服务提供方 服务调用方 口令 服务调用时间 说明 命名形如:省市代码_系统名称 命名形如:省市代码_系统名称 / /

第 93 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

opDetail

String

详细信息

详细信息,参见“详细信息约定”

输出参数:输出为字符串。格式为“alarmID=网管系统简称_告警 ID;errList=错误内容” 。如果调用 成功,则 alarmID 不为空串,为该工单对应的告警号、errList 为空串;如果调用失败,则 alarmID 为 空串,errList 为错误描述。约定“alarmID=”和“errList=”不管调用成功与否都必须有,只是值可 以为空串。 opDetail 详细信息约定: 字段英文名 alarmId affirmPeople 类型(长度) string(80) string(80) 字段中文名 告警 ID 确认人 说明 告警 ID 工单处理人

4.7.1.2 接口要求 4.7.1.2.1 告警派单规则
告警自动派单规则由网管系统制定,用户可自行定义。网管系统应能够根据网管告警信息项“设 备类型”“网元名称”“告警类型”“告警级别”“告警标题”“告警描述特征字串”“告警历时” 、 、 、 、 、 、 中某几项或全部项进行“自动派单告警”定义。网管系统根据己方系统的自动派单规则自动判定当前告 警是否需要自动派单, 如果需要, 则将相应的告警信息以规范的格式通过标准接口传送给 EOMS 系统, 由 EOMS 系统生成相应的故障工单。

4.7.1.2.2 告警派单要求
网管系统需满足以下要求: 1) 网管系统要对已派工单的告警进行标识,避免重派。 2) 网管系统应负责对“闪断”告警进行处理(如在派单规则中加一定时延处理),以避免向 EOMS 系统 发送大量无效告警。 3) 网管系统应负责对因工程或割接等原因产生的告警进行屏蔽,以避免向 EOMS 系统发送大量无效
第 94 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

告警。 EOMS 系统需满足以下要求: 4) 对于告警派发的故障工单,告警的状态为“清除”时,EOMS 系统才允许相应故障工单“归档”。 基本技术要求: 5) 在本规范中,如无特殊说明,时间类字段的数据格式均为:“YYYY-MM-DD H24:MI:SS”。 6) 接口实现必须使用 SOAP 协议,接口描述必须使用 WSDL 语言。 7) 接口实现必须符合 SOAP 协议 V1.1 版本规范,高版本 SOAP 协议必须保证与 1.1 版本的兼容性。 8) 接口实现必须至少支持 SOAP 在 HTTP V1.0 协议上的传输。 9) 接口实现必须符合 WSDL 语言 V1.1 版本规范,高版本 WSDL 语言必须保证与 1.1 版本的兼容性。 10) 接口描述必须至少支持 WSDL 在 SOAP V1.1 协议上的绑定。 11) 接口提供商必须提供接口定义文件(WSDL)下载,建议提供 URL 使用 Web 方式实时提供。 12) 接口实现必须支持 WS-I Basic Profile V1.0(or Higher)互联互通协议。 现阶段不考虑接口安全因素。 针对 WSDL 基于 SOAP 的绑定方式,必须满足:绑定(binding)和操作(operation)的风格(style)必 须满足:style=“document”;消息体的呈现方式必须满足:use=“literal”。 13) 在应用层采用 GB2312 编码方式。

4.7.1.2.3 Web Service/SOAP 技术约定
为保证 Web Service/SOAP 技术的规范性和互联互通性,现作出如下技术约定: 1) 整个接口消息基于 XML 语言, 必须符合 XML V1.0(2nd Edition or Higher)规范和 XML Schema (1st

Edition or Higher)规范。 2) 3) 4) 5) 接口实现必须使用 SOAP 协议,接口描述必须使用 WSDL 语言; 接口实现必须符合 SOAP 协议 V1.1 版本规范, 高版本 SOAP 协议必须保证与 1.1 版本的兼容性; 接口实现必须至少支持 SOAP 在 HTTP V1.0 协议上的传输; 接口实现必须符合 WSDL 语言 V1.1 版本规范, 高版本 WSDL 语言必须保证与 1.1 版本的兼容性;

第 95 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

6) 7) 8)

接口描述必须至少支持 WSDL 在 SOAP V1.1 协议上的绑定。 接口提供商必须提供接口定义文件(WSDL)下载,建议提供 URL 使用 Web 方式实时提供。 接口实现必须支持 WS-I Basic Profile V1.0(or Higher)互联互通协议。 现阶段不考虑接口安全因素。

针对 WSDL 基于 SOAP 的绑定方式,必须满足以下约定: a) b) 9) 绑定(binding)和操作(operation)的风格(style)必须满足:style=“document”; 消息体的呈现方式必须满足:use=“literal”。 在应用层采用 GB2312 编码方式;

10) 为 了 保 证 不 同 厂 家 接 口 操 作 调 用 的 互 通 性 , SOAP 服 务 命 名 空 间 (NS) 均 约 定 为:”http://service.eoms.unicom.com/服务名称“的形式; 11) 服务调用的 SOAPAction 内容为服务提供方的命名空间+“/”+“接口方法名”形式。例:调用集团 E-OMS 系 统 的 派 发 工 单 服 务 , 相 应 服 务 调 用 的 HTTP SOAPAction 内 容 为 : SOAPAction=“http://service.eoms. unicom.com/FaultSheet/newWorkSheet“;

4.7.1.2.4 接口安全技术要求 4.7.1.2.4.1 接口安全设计目标与内容
接口安全设计的目标是防止非法程序对系统接口的非法访问。 接口安全设计可包括以下几个方面 的内容: 1) 网络控制 在网络层面对来访程序进行一定的控制,保证来访程序来自于可靠地址。 2) 数据机密性 对接口传输的数据进行加密/解密,确保数据在传输过程中不被窃听。 3) 数据完整性 对接口传输的数据进行完整性检查,确保数据在传输过程中不被篡改。

第 96 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4) 授权与鉴权 提供对来访程序的相应的用户/口令、权限分配管理功能。 当来访程序访问系统接口时,首先对来访程序进行鉴权,检查来访程序的用户名/口令以及是否 拥有对所访问接口程序的访问权限。 5) 审计管理 提供接口日志管理功能,包括接口访问日志的记录、查询/检索、备份、删除、示警等。

4.7.1.2.4.2 不同层面的接口安全措施
为保证系统接口的安全,可在不同层面实施安全保障措施: 1) 网络层 在网络设备上设置访问控制列表,限制对接口机的访问。 2) 传输层 进行数据加密传输,以保证数据的机密性;实施数据签名,以保证数据的完整性。 3) 应用层 实施基于“用户名/口令”的授权/鉴权机制,确保来访程序拥有相应的权限;支持审计管理。

4.7.1.2.4.3 接口安全性要求
本规范对接口安全约定如下: 1) 在网络设备上设置接口机的访问控制列表,从而限制对接口机的访问,避免接口机遭受恶意 攻击。 2) 考虑到 EOMS 系统与网管系统均为内网系统,窃听和篡改数据的难度较大,因而不要求实施 加密数据传输和数字签名等防护措施。 3) 采用“用户名/口令”机制对访问程序进行鉴权。对于 Web Service/SOAP 接口,具体为在服务 调用参数中增加用户名/口令,服务调用方被调用时首先进行用户权限认证,若认证失败,则 服务调用结束,返回相应的错误代码。(注:“用户名”是访问系统在被访问系统中的标识,即 后文接口服务调用参数中的“服务调用方”。) 4) 接口双方要约定某种口令更换策略,定期或不定期地更换口令。
第 97 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5) 要求不把口令固定地写在程序中,而是存放在程序外部的数据文件、数据库表或其它数据载 体中,以便于能够灵活地修改口令。并要求客户端对存放在外部的口令进行可逆加密,以防 止客户端口令数据被盗;要求服务端对存放在外部的口令进行不可逆加密,以防止服务端口 令数据被盗。 6) 提供日志管理功能,包括接口访问日志的记录、查询/检索、备份、删除、示警等。EOMS 系 统与网管系统接口应分别提供日志功能, 对接口中服务的调用方式(调用其他接口服务或被其 他接口所调用)、调用或被调用服务名称、接口服务的调用时间、调用执行的结果等信息进行 详细的记录。 本小节对接口安全的要求为最基本要求, 容许并鼓励接口实施方协商补充更为周全的安全防护措 施。

4.8 总部固网增值业务网管接口
总部固网增值业务网管作为省分节点纳入增值业务综合网管管理,上传配置数据、性能数据、告 警数据、拓扑数据等。 具体接口方式参见4.3省部接口中平台类数据上传规范。

4.9 电子运维系统与其他电子运维系统接口(预留)

5 附录

第 98 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5.1 附录 1------省份、省公司编码
省份、直辖市名称 省份、直辖市 安徽 北京 重庆 福建 广东 甘肃 广西 贵州 河北 河南 黑龙江 海南 湖北 湖南 吉林 江苏 江西 辽宁 内蒙 宁夏 青海 四川 山东 上海 陕西 山西 天津 新疆 西藏 云南 浙江 总部固网网管 AH BJ CQ FJ GD GS GX GZ HEB HEN HLJ HN HUB HUN JL JS JX LN NM NX QH SC SD SH SX SXI TJ XJ XZ YN ZJ ZBGW 缩写

第 99 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5.2 附录 2------文件校验错误代码表

文件及错误代码表 错误编码 F001 F002 F003 F999 错误编码注释 文件名重复 文件名称错误 文件格式错误 其他错误 备注

记录级错误代码表 错误编码 R001 R002 R003 R999 错误编码注释 字段格式错误 字段取值范围错误 字段类型错误 其他 备注 错误的格式 取值是否过大或过小, 如超过改 类型最大最小范围 字段类型是否匹配

5.3 附录 3------拓扑节点命名规范
分公司系统和总部系统名称如下表。 序号 1 2 3 4 分公司业务系统 短消息中心 联通在信网关 短信管理平台 短信互通网关

总部业务系统 联通在信网关 短信互通网关 行业网关 炫铃平台

第 100 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5 6 7 8 9 10 11 12 13 14 15 16 17 18

短消息扩展业务平台(EMP) 短信业务平台(SP 管理系统) 炫铃平台 语音短信系统(IVR) WAP 网关 WAP 业务平台 彩信中心 彩信业务平台 行业网关 定位接入系统 终端管理平台 增值业务用户鉴权中心

语音短信系统(IVR )

WAP 门户运营支撑平台 彩信网关系统 彩信互通网关
彩信相册系统

综合下载平台 定位平台
中央音乐平台

手机邮箱系统 手机支付平台 终端管理平台 VASP 平台 增值业务用户鉴权中心 综合 PUSH 平台

5.3.1 总拓扑节点命名规范
【格式】XX 联通增值业务拓扑图

例如:海南联通增值业务拓扑图

第 101 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

【注意】xx 后边不带省

5.3.2 业务系统拓扑节点命名规范
【格式】业务系统名称(业务系统厂家名称) 例如:短信中心(中兴)

正确的样式:

错误的样式:

【注意】()为英文状态下的,非输入法状态下的。

5.4 附录 4 其他接口方式 5.4.1 非实时接口方式
在非实时接口方式中,有由网管主动采集的DB-LINK和SNMP SET/GET接口,也有业务系统主动上 传的XML Over FTP接口,但都要保证网管系统中数据的有效性、及时性。特别是业务系统的数据配置 等信息,这些信息修改后业务系统要进行及时更新,保证网管系统能够采集到有效的信息、或主动将 改变的信息上传。

5.4.1.1 DB-LINK 接口方式
对于采用DB-LINK的接口方式,业务系统作为数据提供源节点,按照规范建立统一的数据库视图 来向网管系统提供数据,同时建立一张控制表来提高系统的采集性能及加强系统间的交互。
第 102 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5.4.1.1.1 控制表
由业务系统侧在数据库建立控制表,并同时完成该表的初始值插入操作。 控制表表名:FLAG-NMSVW SQL创建角本: CREATE TABLE FLAG-NMSVW ( VW-NAME CHAR(17) PRIMARY KEY, VW-RCD-DATE CHAR(14), GET-TIMESTAMP CHAR(14), UPLOAD-FLAG CHAR(2) );

字段名 VW-NAME VW-RCD-DATE GET-TIMESTAMP UPLOAD-FLAG

键值 PK

类型 CHAR(17) CHAR(14) CHAR(14) CHAR(2)

简单说明 相应业务系统存在的视图名称 VW-NAME 所表示的视图最新记录的时间 VW-NAME 所表示的视图网管系统已经到采集的时间 交互标识,可能的取值为 00 或 11

字段详细说明: ? ? VW-NAME:该控制表的主键,其内容为一个标准视图的实际名称,见下一节的标准视图命名; VW-RCD-DATE:由业务系统侧进行update操作,其内容表示VW-NAME列所表示的实际视图里最 新的记录时间,格式为YYYYMMDDhhmmss ? GET-TIMESTAMP:由网管系统侧进行update操作,其内容为VW-NAME列所表示的实际视图里网 管已经获取到记录的时间,格式为YYYYMMDDhhmmss

?

UPLOAD-FLAG:由数据提供源节点和网管共同进行update操作,00表示不需要上传或数据提 供源节点检测到11标识更新完成后置成00;11 VW-NAME数据的更新操作。
第 103 页

表示网管通知数据源节点需要进行视图

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5.4.1.1.2 标准视图
业务系统按照以下方式,对规范的每一类KPI建立一个视图,视图名称就为控制表FLAG-NMSVW的 第一列VW-NAME的内容。 视图命名: VW-WW-XX-YY-ZZ-MM VW为固定前缀值,表示为一张视图(VIEW); WW-XX-YY-ZZ-MM的每一个字段编码对应KPI编码规则,具体参考本规范的9.1.4.2小节KPI编码部 分。 视图列创建要求:

?

视图的前2列:为固定值,分别为KBP和DCTIME。 键值 PK PK 类型 VARCHAR(100) CHAR(14) 简单说明 对应业务规范中的 KBP 列,用来标识关键业务点 采集数据的时间标识,形式为 YYYYMMDDhhmmss

字段名 KBP DCTIME

?

视图的其他列:把业务规范中的KPI_ID依次做为视图的列名; 字段名 键值 类型 按规范约定 按规范约定 按规范约定 按规范约定 简单说明 该 KBP 在该 DCTIME 的该列名对应的 KPI 的值 该 KBP 在该 DCTIME 的该列名对应的 KPI 的值 该 KBP 在该 DCTIME 的该列名对应的 KPI 的值 该 KBP 在该 DCTIME 的该列名对应的 KPI 的值

<KPI_ID 1> <KPI_ID 2> ? <KPI_ID n>

5.4.1.1.3 视图举例
以联通在信业务系统的一类KPI举例如下: KBP编码规则:ZXSMG-联通在信网关编号-SP企业代码-SP接入号

第 104 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

编号 1 2 3 4

KPI_ID PM-01-04-01-01-01 PM-01-04-01-01-02 PM-01-04-01-01-03 PM-01-04-01-01-04

KPI 名称 发送 MO 总数 重发 MO 次数 收到 response 数 收到成功 response 数

KPI 含义 不含重发

数据类型 整型 整型 整型 整型

粒度要求 1 小时 1 小时 1 小时 1 小时

那么按照规范: 视图名称为:VW- PM-01-04-01-01 视图的各列为 字段名 KBP DCTIME PM-01-04-01-01-01 PM-01-04-01-01-02 PM-01-04-01-01-03 PM-01-04-01-01-04 类型 VARCHAR(100) CHAR(14) NUMERIC(20) NUMERIC(20) NUMERIC(20) NUMERIC(20)

同时把该视图名称插入控制表FLAG-NMSVW中做为一条记录。 INSERT INTO FLAG-NMSVW(VW-NAME,VW-RCD-DATE,GET-TIMESTAMP,UPLOAD-FLAG) VALUES (‘VWPM-01-04-01-01’,’’,’’,’00’);

第 105 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

5.4.1.1.4 系统交互
网管系统 业务系统

[创建且初始化] 查询控制表FLAG-NMSVW的每一列 [扫描] 控制表FLAG-NMSVW [创建] 初始化控指标和各视图

VW-RCD-DATE>GET-TIMESTAMP

[更新] [是] 采集VW-NAME所对应的视图 [采集] [插入] VW-NAMAE表示的视图... VW-NAMAE表示的视图 [更新] 定期采集数据更新

备份<GET-TIMESTAMP的数据

图 9-2 数据库接口视图交互功能示意图

1. 业务系统作为数据源提供点,按照以上说明建立相应业务系统的标准视图,同时把视图的名
称插入到控制表FLAG-NMSVW中作为一条记录完成初始的INSERT操作; 2. 业务系统按照规范规定的采集周期对业务点(KBP)进行指标(KPI)的采集,写入到对应的 视图中, 同时在控制表FLAG-NMSVW中更新对应视图(VW-NAME)一行的时间字段(VW-RCD-DATE)为视图的 最新采集时间; 3. 网管系统定期扫描控制表 FLAG-NMSVW,扫描到VW-NAME列对应的VW-RCD-DATE 时间大于 GET-TIMESTAMP时间,从而可以判断相应VW-NAME名称所表示的视图中有了新的数据,对VW-NAME这个 视图进行采集,采集完成后更新控制表中GET-TIMESTAMP字段;

第 106 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

4.业务系统也定期扫描控制表FLAG-NMSVW,可以对VW-NAME所对应的视图中小于GET-TIMESTAMP 的记录进行删除或备份操作,减少数据库的负担提高网管采集的效率; 5. 为了增强DB-LINK方式的交互性, UPLOAD-FLAG字段由数据提供源节点和网管每隔一定间隔 (可配置,暂定为1个小时)轮询该字段。 a) 当网管检测到从数据提供源节点视图VW-NAME中获取的数据不够及时准确或可能存在潜

在错误时,将UPLOAD-FLAG字段置为11标识,通知数据提供源节点进行该视图的及时更新操作。 b) 当数据提供源节点轮询检测到该字段为11时,需要进行VW-NAME中数据的更新操作,操

作完成后将UPLOAD-FLAG字段置为00,同时更新VW-RCD-DATE字段通知网管已进行了更新。

5.4.1.1.5 其他说明
市场上有些数据库系统(如 ORACLE)不支持中划线“-”符号作为表名、视图名、字段名,所以 在实际中可以将这些字段中的“-”符号修改成“_”下划线符号。

5.4.1.2 SNMP SET/GET
本种接口只是简单的定义了用SNMP协议进行数据的传输,对之上的MIB文件没有进行严格的标准 格式约定,主要是考虑到业务厂商已经建成的业务系统已经有相应MIB进行提供,所以就分别由业务 厂商提供MIB文件由网管厂商根据相应MIB文件进行处理。考虑到SNMP为UDP协议传输不够可靠、且大 多数厂商的MIB文件形式不一定符合本次网管项目的要求,所以在新接入厂商、新建设系统的接口开 发中不再建议采用这种接口方式,建议采用DB+LINK或XML文件处理非实时数据、CORBA或SNMP TRAP、 WEB SERVICE处理实时指标。

5.4.2 非实时接口方式
5.4.2.1 CORBA 接口
对于采用CORBA实时或准实时的数据,可以抽象为两种接口方式:单行数据,即一个KBPID,一个 KPIID,一个时间点,一个值的情况;多行数据,即对于多个实例一次传递多行数据的情况,可以采 用调用批量传输数据的接口。 由增值业务综合网管系统在网管服务器上开放一个CORBA接口、两个CORBA函数来提供给业务厂 商。业务系统调用该接口来进行数据传递,同时业务系统需要提供调用接口失败的重试机制,防止由 于网络等原因引起的超时或失败,其中重试次数和重试间隔应该可配置。

第 107 页

中国联通增值业务综合网管系统技术规范 第六分册 3.0

IDL接口文件(UpSendMsgInterface.idl) //返回值代表是否成功,0代表成功,其他代表错误原因 module smg{ interface UpSendMsgInterface { //定义数组型变量 typedef sequence <wstring> wstringarray; //单行数据 wstring upSendMsg( in wstring kpiId, in wstring kbpId, in wstring dcTime, in wstring value ); //批量数据 wstring upSendMsgBulk( //代表批量数据中一共有多少行,随后的4个sequence的实际长度应该相等, //由size来进行匹配,如mKpiId[0], mKbpId[0], mDcTime[0], mValue[0]为一组 in short size, in wstringarray mKpiId, in wstringarray mKbpId, in wstringarray mDcTime, in wstringarray mValue ); }; };

第 108 页


相关文章:
中国联通增值业务综合网管系统技术规范 第六分册-接口技术规范3.0-正式版本
中国联通增值业务综合网管系统技术规范 第六分册-接口技术规范3.0-正式版本 隐藏>...107 II 中国联通增值业务综合网管系统技术规范 第六分册 3.0 前 言 本标准由...
中国联通增值业务综合网管系统技术规范 第四分册:数据类增值业务网管技术规范3.0--正式版本
业务综合网管系统技术规范 第四分册:数据类增值业务网管技术规范3.0--正式版本...《中国联通增值业务综合网管系统技术规范 第六分册:接口技术分册 V1.0》规定了...
中国联通增值业务综合网管系统技术规范 总册V3.1--正式版本
中国联通增值业务综合网管系统技术规范 总册 3.0 前 言 增值业务已经成为电信...《中国联通增值业务综合网管系统技术规范 第六分册:接口技术分册 V1.0》规定了...
中国联通增值业务综合网管系统技术规范 第一分册:公共增值业务网管技术规范V3.0-正式版本
中国联通增值业务综合网管系统技术规范 第一分册:公共增值业务网管技术规范V3.0-正式版本 备用备用隐藏>> 中国联通公司企业标准 QB/CU xxx-xxx 中国联通增值业务综合...
中国联通增值业务网络管理系统技术规范 第五分册:支撑类增值业务网管技术规范3.0-正式版本
第五分册:支撑类增值业务网管技术规范3.0-正式版本_信息与通信_工程科技_专业...《中国联通增值业务综合网管系统技术规范 第六分册:接口技术分册 V1.0》规定了...
34-2004 中国联通传输网网络管理系统技术规范(V1.0) 第六分册 SDH接口规范
23 I 中国联通传输网网络管理系统技术规范 第六分册 SDH 接口规范 前 言 本规范是《中国联通传输网网络管理系统技术规范》系列技术规范中的第六分册。该系列 规范...
中国联通传输网综合网络管理系统技术规范-第一分册总册_联通
中国联通传输网综合网络管理系统技术规范-第一分册总册_联通_信息与通信_工程科技_专业资料。中国联通传输网综合网络管理系统技术规范-第一分册总册_联通http...
中国联通OSS-移动综合网管系统与移动资源管理系统间接口技术规范 摘要
接口技术规范》摘要《中国联通 OSS-移动综合网管系统...业务流程 b) 规定了中国联通移动电子运维系统与移动...网综合网管系统部省接口技术规范 第六部分:与智能网...
中国联通客户网管系统技术规范
69 中国联通客户网管系统技术规范 v1.0 前 言 中国联通客户网管系统, 是以对客户租用电路和客户设备的实时监测为主要目标, 从面 向客户、面向业务的角度对网管...
中国联通GSM-WCDMA省级综合网管技术规范V1.0-20090727_Tag
中国联通拟建设GSM/WCDMA部省两级综合网管系统,对GSM...与网元管理系统间接口技术规范 第一部 分:通用功能...视图连线需能够区分业务连接和信令连接; ——跨本地...
更多相关标签:
网吧增值网管外快秘籍 | 聚生网管正式版 | 话务网管 技术规范 | otn 网管验收 规范 | 增值税发票填写规范 | 增值税发票规范 | 增值税普通发票规范 | 增值税开票规范 |