MDAS集采附录55中国移动MDAS类设备网络管理北向接口技术规范Word格式.docx

1、6.6.2 接口数据编码格式 86.6.3 接口定义 86.6.4 告警字段要求 86.6.5 文件格式 82前 言本规范定义了运营商MDAS网络监控管理的监控系统北向接口规范。本标准的附录A和B为规范性附录。本规范由规范归口部门负责解释。1 范围本标准供运营商内部和厂商共同使用，适用于MDAS网络管理接口部分的规划和设计。2 规范参考文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版。凡是不注日期的引用文件，其最新版本适用于本标准。 1移

2、动通信网网络运维业务需求V1.0.23 概述MDAS系统与网管系统（省）之间的接口称为北向接口（Itf-N），网管系统（省）通过此接口实现对MDAS系统的管理，MDAS系统监控系统须通过此接口实现对配置管理接口功能、故障管理接口功能、性能管理接口功能的支持。 故障管理接口功能：实现对MDAS系统设备故障告警数据的实时采集和集中监视，辅助故障定位。提供对告警信息的各种处理功能，提供对历史告警信息的统计查询功能。 配置管理接口功能：采集MDAS系统的全量网元、站点、基站配置数据。 性能管理接口功能：采集MDAS系统的全量网元、站点、基站性能数据。配置管理接口、性能管理接口所采集的配置、性能数据以及

3、其模型关系，以总部维护优化处发布的相关数据规范为准。4 配置管理接口配置管理接口采用Ftp协议，以XML方式定期提供配置数据。文件组织格式与命名规则以总部维护优化处发布的相关规范为准。如维护优化处的规范中未约定配置数据的时间粒度，则XML方式需支持24小时粒度的配置数据文件生成。5 性能管理接口性能管理接口采用Ftp协议，以XML方式定期提供性能数据。性能数据的采集时间粒度与空间粒度以总部维护优化处发布的相关数据规范为准。6 故障管理接口6.1 功能定义MDAS系统网管需要提供实时告警接口和告警同步接口。本方案主要确定MDAS系统网管与省网管的接口方式以及规范告警正文的格式。6.2 接口概述

4、说明：本地网管系统跟大网管之间采用2种接口方式：1）对于接收到的网元告警及告警清除消息通过实时告警接口采用TCP长连接方式立即发送给大网管；并当链路空闲无消息时发送心跳包维持该链路。2）本地网管采用FTP方式每天定时同步活动告警到大网管，数据采用CSV文件格式，每天同步一次。6.3 数据格式定义说明符含义解释一对尖括号之间的内容为实际输出内容。rn 换行符。 表示连续n个空格符。XXX对齐方式 其中： A0表示左对齐，A1表示右对齐。 默认左对齐。Mn 其中：Mn表示此信息段最大长度n字符。LnLn表示此信息段总长度是n字符，不足部分用空格填充； L0 表示输出该字段的实际长度，不用填充。XX

5、XXX 标记下划线的文字，为确定输出字样XXXX XXXX为其他部分实际输出更改；某一部分信息空缺，则填；如表示局名信息最大长度32字符，左对齐。6.4 告警告警接口6.4.1 接口协议接口采用TCP/IP（Socket）方式，数据格式为文本流。6.4.2 接口数据编码格式采用GBK编码。6.4.3 接口说明由MDAS系统网管系统向省网管系统提供告警接口，将告警数据通过告警接口发送到省网管系统。MDAS系统网管系统与省网管系统通过TCP/IP方式进行连接时，通过Client/Server的方式进行通信。MDAS网管系统作为Server端，提供接口服务器的IP地址和端口，省网管系统作为Clien

6、t端。6.4.4 通信规程省网管连接MDAS服务器（指定IP、PORT）, MDAS系统网管采集到告警信息后，将该告警按照指定的格式发送到省网管系统。针对异常处理说明：当省网管连接MDAS网管系统不成功时，需等待一定时间（可设定），再次重新尝试连接MDAS网管系统接口服务器，三次不成功则产生一次告警（无法连接话务网管接口服务器），同时继续尝试连接，直至成功6.4.5 消息格式定义6.4.5.1 消息头START4SP deviceLabel L208SP eventDate eventTime L19rneventLabel2SPeventStatusL8perceivedSeverity a

7、larmSource L50 alarmID L6alarmType 6.4.5.2 消息体由6.4.6.2节中的告警字段组成，每一行包含一个字段，格式”（字段名）=（内容）rn”组成，如:objectId100objectClass百货大楼北3F干放6.4.5.3 消息尾END rn6.4.6 告警字段要求6.4.6.1 消息头字段要求字段名称中文名称说明deviceLabel设备编号设备编号作为设备的唯一标识，与MDAS系统设备的名称一一对应；eventDate告警产生/恢复日期告警产生/恢复的日期,格式为：YYYY-MM-DD例如：2014-08-18 18:28:08eventTime

8、告警产生/恢复时间告警产生/恢复的时间,格式为：HH:mm:SS 如：18:eventLabel 告警标志固定为“ALARM”eventStatus告警类别告警类别有两类：告警、恢复；告警是指由于硬件设备故障或某些功能异常而产生的故障告警。恢复是指故障设备或异常功能恢复正常时产生的恢复告警。在告警报告中，以“故障”表示故障告警、“恢复”表示恢复告警；perceivedSeverity告警级别告警级别用于标识某项告警的严重程度，按严重程度递减分为：严重告警主要告警次要告警警告告警通知信息alarmSource告警来源显示的字符串是具体的网元名称，即MDAS系统的中文名称。alarmRecordI

9、D告警编号某一条告警/恢复的唯一标识，MDAS系统网管提供告警编号。要求：恢复告警报告中的告警编号与对应的故障告警的告警编号相同，即某一告警报告是否对应有恢复报告，以此编号识别。alarmType 告警分类告警类型包括如下：设备告警派生告警系统告警信源告警市电原因告警进程退出告警进程错误告警服务质量告警违反安全服务或机制告警通信告警处理错误告警环境告警完整性错误物理层错误时间域错误处理异常中断告警网络干扰业务处理异常软件操作异常协议告警阈值告警网管告警时限告警其他告警6.4.6.2 消息体字段要求probableCause 告警原因适用于MDAS型设备。表明告警发生的可能原因；proposed

10、RepairActions 修复建议表明处理该条告警的可能建议；alarmTitle 告警名称表明告警的中文名称。恢复告警报告中告警名称与对应的故障告警的告警名称相同。即通常的告警标题；alarmID 告警标识 告警名称的编号或描述，唯一确定告警名称。deviceID 自选编号运营商在MDAS系统网管中创建MDAS系统网元时定义的编号；objectClass 设备分类MDAS网管设备类型如下：系统网关安全网关AAAMDAS基站家庭级基站多模光纤直放站企业级基站MDAS基站拉远单元时钟服务器交换机防火墙服务器objectLocation 设备场所MDAS系统设备安装位置，设备场所有两类，分别为“

11、室内设备”和“室外设备；vendor 设备厂家MDAS分布系统设备的生产厂家substitute 代维厂家MDAS系统设备的维护厂家monitorArea 监控区域是指用户所负责管辖监控的范围monitorScope 业务区域是指某监控区域下可进行监控管理的范围。cell 基站小区基站对应的小区ID6.4.7 告警样例START 000812241636000001 2008-12-24 16:48:18ALARM 故障 主要告警 京信地下停车场MDAS基站 98488 通信告警 probableCause = 告警原因描述 proposedRepairActions = 修复建议描述alar

12、mTitle = S1 Link FailurealarmRecordID = 10000deviceID = 自选编号objectClass = MDAS基站objectLocation = 室内设备vendor = 京信通信substitute = 京信通信monitorArea = 杭州monitorScope = 西湖区cell = 1000END6.5 心跳检测接口6.5.1 接口协议6.5.2 接口数据编码格式6.5.3 接口定义当TCP/IP通道1分钟内没有数据交互时，检测方送心跳检测消息，接收方收到该消息时进行消息回复；心跳检测包及回应报采用固定长度。省网管作为心跳检测方，MD

13、AS网管作为心跳接收方。6.5.4 消息格式定义6.5.4.1 消息头固定为STARTrn6.5.4.2 消息体每一行包含一个字段，格式”rn”组成，发起方:HEARTBEAT 接收回应:HEARTBEAT RESPONSE6.5.4.3 消息尾固定为END rn6.5.5 心跳样例检测方：STARTrn接收方：6.6 同步告警信息接口6.6.1 接口协议接口采用FTP文件方式。6.6.2 接口数据编码格式6.6.3 接口定义同步告警信息接口采用FTP接口方式，每天在固定时间（可配置）定时同步网管全量活动告警到大网管，同步数据采用CSV文件格式。6.6.4 告警字段要求见6.4.6小节所述。6.6.5 文件格式同步告警信息接口传输的文件格式如附件活动告警信息.csv