年广东公司综合监控系统四期接口南向v

1、综合告警南向接口规范目录12变更综合2.12.2. 4南向接口告警接入规范5总体描述5实时告警接口描述62.2.12.2.22.2.32.2.42.2.5EAI转发7Socket直连8接口消息定义8接口字段定义9接口字段内容为数字值错误!未定义书签。2.3同步告警接口描述172.3.12.3.22.3.3工2.4.12.4.22.4.3EAI转发17Socket直连18MQ转发18态回传接口描述19接口描述19接口消息定义19接口字段定义202.42.5实时告警样例202.5.12.5.22.5.32.5.4产生告警20清除告警22心跳消息24提示消息242.6同步告警样例242.6.12.6

2、.22.6.3工2.7.12.7.2MQ同步请求消息25MQ同步告警消息25MQ同步结束消息25态回传消息样例262.7消息样例26派派单失败消息样例262.8告警约束262.8.12.8.22.8.3唯一性约束26对告约束27一致性约束282.92.10工程测试环境28附件282.10.1接口字段填写研283综合3.13.2南向接口告警转出规范28总体描述28实时告警接口描述293.2.1Socket直连292综合告警南向接口规范3.2.23.2.33.2.43.2.5直连29接口消息定义30告警字段描述30接口字段内容为数字值373.3实时告警样例403.3.13.3.23.3.3产生告警

3、41清除告警42心跳告警433.4告警状态变更实时接口443.4.1接口定义443综合告警南向接口规范1变更4版本时间操作人操作内容0.12009-3-20、创建文档；0.22009-3-20、改为 WEB SERVICES 接口方式；0.32009-3-23修改；0.42009-3-23规范文档中确的描述；0.52009-3-261、 增加标准化字段；2、 增加方式；3、 接口方式变更： 放弃 WS 方式；增加 JMS、MQ、SOCKET 方式；0.62009-3-31根据综合 南向接口规范评审会会议纪要-20090326,修改规范：1、修改 标题为综合 告警南向接口规范；2、专业 （传输、

4、数据、安全）必须使用 Socket（TCP）、 、JMS 三种方式中的 式向综合前转告警（或 JMS 方式需使用 EAI 来进行协议转换和数据中转， Socket 方式直接连话务）；3、增加附件 1接口字段填写研；0.72009-4-7、根据话务、安全的接口字段填写样例，调整；0.82009-4-8、1、 增加同步接口描述；2、 调整 EAI 总线接口示意图、Socket 直连接口示意图中确的描述；3、 删除文档历时版本中的批注与修订信息；0.92009-5-41、在接口字段中增加“所辖业务地区” 字段；1.02009-7-10、1、增态回传接口”；2、增加“是否有对告”字段；1.12009-

5、09-241、补充接口中哪些字段内容为数字和数字字典表；1.22009-11-041、 在接口字段中增加三个传输专综合告警南向接口规范2 综合南向接口告警接入规范2.1 总体描述本章节规范描述综合系统与各专业系统（传输、动环、数据等）告警接入方案和接口定义。总体方案是：1、各专业中的系统提供实时接口，通过Socket（TCP）、JMS三种方式式，将专业系统中的告警信息接入到综合系统当中。其5用字段： “circuit_number” “count” “site”2、 在接口字段中增加 3 个通用的字符串类型字段：“extra_string1” “extra_string2” “extra_st

6、ring3”3、 在接口字段中增加 3 个通用的数字类型字段：“extra_id1” “extra_id2” “extra_id3”4、在活动告警消息和清除告警消息中， 都event_time”与“cancel_time”两个字段信息。1.32009-11-161、 修改“2.4.3 接口字段定义”；1.42010-4-151、 增加 2.3.3MQ 转发；2、 增加 2.6.1MQ 同步请求消息；3、 增加 2.6.2MQ 同步告警消息；4、 增加 2.6.3MQ 同步结束消息；1.52010-7-6李1、综合南向接口规范分成告警接入和告警转出两大章节；2、增加 3 综合南向接口告警转出规范

7、；1.62010-8-9李1409 消息中增加告警与厂家1.72011-06-081、规范 EAI 接口字段数据类型2、为数据网新增“告警业务分类”、“告警业务子类”两个字段内容综合告警南向接口规范中方式、JMS方式需要使用EAI进行协议转换；Socket（TCP）方式，可直连综合主机；2、综合系统在EAI上订阅各专业系统的告警（方式、JMS方式）或使用Socket（TCP）方式直连专业获取告警；3、对于EAI转发方式，在收到各专业系统告警时，EAI系统将告警信息分发到综合系统中。接口定义可按照实际情况增加，但接口方式保持不变。综合、EAI总线、专业关系如下图：综合告警综合话务EAI总线传输其

8、它4、对于Socket直连方式，建议一般由专业作为Socket的server端，在接入时，请各专业提供server的IP地址及端口。综合方式关系如下图：的Socket直连与专业动环告务器综合告警机信令监测告务器TCP/IPTCP/IP5、作为实时接口的必要补充，定义告警同步接口，并区分为：6、工EAI转发； Socket直连；态回传接口：用于回传各专业告警的派态；2.2 实时告警接口描述实时告警接口指该接口传送的告警数据为设备上实时产生、清除的告警。6综合告警南向接口规范2.2.1 EAI转发2.2.1.1接口描述专业系统向EAI提供主动、实时的告警接口，综合系统不考虑接收告警数据的准确性、及

9、时性、完整性，请各专业自行保证上报告警的准确性、及时性及完整性。具体接口方式和协议如下：1、接口方式：方式；JMS方式；2、接口数据格式：XML格式的String型字符串（详见本文档下文中的告警样例）。3、接口说明：在专业系统和EAI之间通过以上两种方式进行连接时，由专业系统作为client端，EAI系统作为server端，EAI系统提供方法名以及输入参数的数据格系统按照规范调用EAI系统，将告警数据发给EAI。式，由专业4、异常处理当各专业系统调用EAI接口不时，需等待一定时间（可设定）后，再次重新尝试连接接口服务器，直至。在长时间无告警时（具体时间由各专业决定），专业系统能够向EAI接口心

10、跳信号（格式详见本文档下文中的告警样例），当综合在一定的时间里没有收到心跳信号时，将尝试重新连接EAI接口，并在告警上报”提示告警。界面上产生相应的“XX长时间无告警2.2.1.2接口地址；7综合告警南向接口规范2.2.2 Socket直连2.2.2.1接口描述机直接通过socket连接接口地址。专业与综合的告警1、接口方式： Socket直连。2、接口数据格式：XML格式的String型字符串（详见本文档下文中的告警样例）。3、接口说明：建议一般由专业作为Socket的server端，在接入时，请各专业提供server的IP地址及端口。4、异常处理：专业需要提供心跳信息，当综合在一定的时间里

11、没有收到心跳信号时，将尝试重新建立Socket连接，并在告警长时间无告警上报”提示告警。界面上产生相应的“XX2.2.3 接口消息定义对于“EAI转发”与“Socket直连”两种接口方式，接口消息定义相同，如下：8服务名实时数据分发：RTDataSend方法String Process(String xmlData)输入参数xmlDataXML 字符串，包括如下信息： 数据类别标识 数据集综合告警南向接口规范其中，主要字段说明如下：1、messageType：该值为各专业的系统名称，如传输、动环等；2、data_type：该值为消息体中的消息类型，目前可选值有：ALARM_ACT：表示消息体中

12、传送的是一条活动告警； ALARM_CLR：表示消息体中传送的是一条清除告警； ALARM_HB：表示消息体中传送的是一条心跳消息；ALARM_TIPS：表示信息体中传送的是一条提示消息，无对告；ALARM_WS：表示消息体中传送的是一条告警工态信息；3、字段X：表示告警的各个属性字段，如告警标题、告警流水号、告警时间等。具体字段参见接口字段节描述。2.2.4 接口字段定义目前，接口已的字段如下表：9YYYZZZ输出参数result综合告警南向接口规范10序号字段中文名字段英文名字段类型说明南向接口规范字段是否为标准化字段是否必填1是否已标准化梳理标志standard_flag数字，枚举1：标

13、准化梳理2：已标准化梳理是否是2告警状态active_status数字，枚举0：网元自动清除1：活动告警2：同步清除3：手工清除是否是3活动告警唯一标识alarm_fp字符串告警，告警的流水号。通过这个可以在专业内唯一到一条告警。是否是4清除告警唯一标识alarm_c_fp字符串清除告警的唯一性标志是否是5省份province_name字符串为南北基地的集中所预设的字段是否是6城市city_name字符串是否是7告警来源alarm_source字符串网元产生的告警：网元名称网元管理系统产生的告警：OMC 或 EMS 名称网络管理系统产生的告警：网络管理系统名称是否是8设备厂家vendor_na

14、me字符串爱立信、等。指网元设备厂家是否是9系统厂家sys_vendor_id数字，枚举SUN,CISCO 等，此字段为数据网专业，指的是主机系统的厂家，暂未定义枚举值是否否10网元版本eqp_version字符串厂家网元设备版本；保留告警发生时的网元版本是否否11网元名称eqp_label字符串发生告警的网元或设备的名称注意：消息体中既要包含告警设备的 INT_ID,又要包含设备名是否是12网元别名eqp_alias字符串用于话音网专业时：存放中文名/英文名/简化名等别名是否否13设备 IP 地址eqp_ip字符串网元设备的 IP 地址是否否综合告警南向接口规范1114设备类型eqp_obj

15、ect_clas s字符串，枚举以话音网为例:MSC、MSC_server、MGW、HLR、GMSC、BSC、TMSC1、TMSC2、SSP、SMP、SCP、VC。以数据网为例：GGSN,SGSN,数通交换机,路由器,防火墙,主机,SAU。部分枚举类型如下：100:OMC101:MSC102:HLR200:BSC是否是15设备重要级别eqp_severity字符串，枚举数据网、传送网字段。如：关键路由器，一般路由器是否否16维护责任人maintain_man字符串大网元的维护责任人，、小区的公司是否否17设备工程状态resource_status字符串，枚举或数字，枚举是指网元设备是否从工程部

16、门进入网维部门的状态。四期规范中的 工程状态传输专业为：正常或者工程1:现网状态(有业务)2:退网状态3:工程实施状态(无业务)4:未知状态(虚拟)5:现网状态(无业务)6:工程实施状态(有业务)7:容灾状态8:退网待删除状态是否是18设备态eqp_operation_s tatus字符串，枚举是指网元设备在厂家上的状态位，如 HALTED， ACTIVE 等，如 halted,active是否否19设备工程细分状态alarm_resource_ status字符串，枚举或数字，枚举是指网元设备进入网维部门之后，网维部门对其进行工程割接、巡检、升级等维护工作的状态 1:正常3:网络变更4:例行

17、工作5:软件装载8:故障处理9:数据删除10:本端演练25:工程26:维护是否否综合告警南向接口规范1220locate_info字符串如果告警中包含设备的端口，节点信息，与告警判重有关的话，此处需给出。比如传输专业是指告警端口速率，对应传输 的“信号速率”字段是否否21告警对象alarm_locate_ob ject字符串到告警网元的具体细粒度对象，如 link、bts 等，他们的告警设备分别对应 msc、bsc 等；传输专业就是具体板卡或者端口。部分枚举类型如下：100:OMC101:MSC102:HLR200:BSC是否否22告警对象别名ne_alias字符串可用于存放、小区、链路的中文

18、名/英文名/ 简化名等别名是否否23告警对象设备类型object_class字符串，枚举警对象的设备类型是否否24告警对象重要级别alarm_object_severity字符串，枚举VVIP,VIP,A,B,C,普通是否否25告警对象工程状态ne_status字符串，枚举或数字，枚举四期规范中的工程状态现网有承载,现网无承载,工程有业务,工程无业务,虚拟,未知1:现网状态(有业务)2:退网状态3:工程实施状态(无业务)4:未知状态(虚拟)5:现网状态(无业务)6:工程实施状态(有业务)7:容灾状态8:退网待删除状态是否否26告警对象管理状态ne_admin_status字符串，枚举或数字，枚

19、举网厂家中的状态，如 halted,active 1、不是所有告警都需要填这个字段2、在收到特定告警清除消息时才触发指令网元的态1:ACTIVE2:HALTED是否否27告警对象工程细分状态alarm_ne_status字符串，枚举或数字，枚举割接,巡检,升级等工程操作引起的本端的临时工程状态1:正常3:网络变更4:例行工作5:软件装载8:故障处理是否否综合告警南向接口规范139:数据删除10:本端演练25:工程26:维护28专业professional_ty pe数字，枚举1：话音网2：数据网3：传送网4：动力环境5：系统6：安全7：IP 承载网8：信令监测9：业务拨测是否是29网络类型ne

20、twork_type字符串，枚举或数字，枚举主要帮助做告警统计分析用，可以参考以下分类定义，对该字段不做统一要求： 话音网：传统交换、软交换、BSC，智能网，STP、覆盖、OMC数据网：CMNET、IP 承载网、MDC、WLAN、城域网、时间同步网、GPRS、ADC、DNS、DSMP、GT100、KJAVA、WAP、彩信、流、12117、SIMOTA 业务、USSD 业务、WAPOTA 业务、彩铃业务、漫游欢迎业务、邮箱业务、省级校迅通业务、形象代言人、移动支付平台业务、语音信箱、OMC 传送网：一干传送网、二干传送网、同步网、本地骨干层、本地汇聚层、本地接入层、EMS：话务、数据、传输、动环

21、监控系统、信令监测系统、业务拨测系统、EOMS是否是（有两种填法：标准化的专业需要按 表填，非标准化的可随意填）30告警类别org_type数字枚举1：设备告警；3：安全告警；2：性能告警；4：业务告警是否是31告警逻辑分类logic_alarm_typ e字符串，枚举处理器模块、输入输出设备、话务处理、计费系统、中继与传输、信令与IP、操作维护、数据配置，详见告警梳理模板是是标准化专业必填，非标准化专业不需要填综合告警南向接口规范1432告警逻辑子类logic_sub_alarm_type字符串，枚举如处理器故障、区域处理器故障等统一划分的 20 类告警逻辑子类，详见告警梳理模板是是标准化专

22、业必填，非标准化专业不需要填33厂家原始告警类别vendor_type字符串爱立信的 ALCAT是否是34是否需要上报send_jt_flag数字，枚举1:是2:否是否是35告警标题alarm_title_text字符串是否是36告警标准名standard_alarm_ name字符串不同厂家同类设备的告警标题可能不一样，需要统一；有些告警标题过长，需要简化（如爱立信的告警标题）；同一厂家不同版本的同一设备的告警标题需要标准化（如不同版本的 BSC）； 因此新增字段，显示该告警的规范名字；是是标准化专业必填，非标准化专业不需要填37厂家原始告警级别vendor_severity字符串爱立信的

23、A1,A2,A3,O1,O2是否是38告警级别org_severity数字，枚举1：一级2：3：三级4：四级一级为最严重告警，四级为提示性告警；各级别的显示颜色如上。如果是非标准化专业，则自行定义告警级别。是是是39厂家告警号probable_cause数字如的告警 ID是否否40告警IDstandard_alarm_ id字符串中国移动对厂家告警的统一编码(参考文档中国移动告警 ID 编码规则)是是标准化专业必填，非标准化专业不需要填41原始告警流水号omc_alarm_id数字告警正文中的流水号是否否42告警可能原因probable_cause_txt字符串爱立信告警的 probably

24、cause是否否43告警正文alarm_text字符串告警正文全部内容此字段不在告警列表中呈现，而是在告警详情的操作中呈现是否是综合告警南向接口规范1544活动告警计数alarm_act_count数字当前活动告警中如果同一告警标题有重复计数， 则使用此字段表示是否否45关联信息related_informa tion字符串告警派单时需要提供的关联信息，如的公司，BSC 所处的机房位置等。此字段不在告警列表中呈现，而是在关联查询的操作中呈现，是否否46该对设备的影响effect_ne数字，枚举该对设备造成影响程度1:设备全阻2:设备局部故障3:设备性能下降4:可能设备全阻5:可能设备局部故障6

25、:无影响7:业务质量下降8:设备局部受阻9:设备可能受阻10:设备全部受阻11:设备告警是是标准化专业必填，非标准化专业不需要填47该对业务的影响effect_service数字，枚举该对业务的影响程度1:业务全阻2:业务受影响3:可能业务全阻4:可能业务受影响5:可能局部业务受阻6:无影响7:业务质量下降8:可能局部业务受影响9:可能设备全阻10:业务可能局部受阻11:业务局部受阻12:业务可能全阻13:业务无影响14:设备性能下降15:可能设备局部故障16:设备局部故障17:设备全阻是是标准化专业必填，非标准化专业不需要填48告警解释与处理经验alarm_memo字符串详细说明此告警的具体

26、含义，产生等相当于告警处理的经验库、知识库。此字段不在告警列表中呈现，而是在告警详情的操作中呈现是否否综合告警南向接口规范1649告警价值alarm_value数字，枚举借鉴山东公司，将告警的重要等级排序（此告警价值与告警设备的重要等级有函数关系）。枚举值，暂未定义是是如需对告警进行排序则需要填，否则统一填 050预处理方式preprocess_mann er数字，枚举某些告警可以由系统自动发指令来进行预处理， 则在此提供处理结果的显示，以便提供给告警监控 参考1:手工操作2:一键触发3:自动触发4:不需预处理5:无预处理是是如需作预处理则需要填， 否则统一填 051省市受理标志provinc

27、e_proces s_flag数字，枚举1：省公司2：市公司是是如需自动派需要填，否则填 052部门受理标志department_proc ess_flag数字，枚举1：2：3：专业是是如需自动派需要填，否则填 053方式channel_type数字，枚举1:非实时文件或数据库方式2:前转3:同步4:直连网元是否是54告警发生间event_time字符串时间格式为 YYYY-MM-DD HH:mm:ss是否是55告警清除时间cancel_time字符串时间格式为 YYYY-MM-DD HH:mm:ss是否只有清除告警才需要填这个字段56所辖业务地区business_area字符串以逗号分割地区

28、是否如：广州,57对告标志correlate_alarm_flag数字，枚举0：产生告警无对应清除告警；1：产生告警有对应清除告警；是否是58电路名称circuit_number字符串传输专业填写“电路名称字段”是否否59县count字符串传输专业填写“县”是否否60局站site字符串传输专业填写“局站”是否否61告警业务分类service_alarm_type字符串，枚举是否数据网，告警业务分类62告警业务子类service_sub_alarm_type字符串，枚举是否数据网，告警业务子分类63通用字符串扩展字段 1extra_string1字符串是否否64通用字符串扩展字段 2extra_

29、string2字符串是否否65通用字符串扩展字段 3extra_string3字符串是否否66通用数值扩extra_id1数字是否否综合告警南向接口规范相关说明如下：“字段英文名称”为消息体中使用的字段名称；以上字段为接口定义的保留字段，在上传告警时，应尽量满足各字段有确切的值，若无值，请在告警接入时与综合相关协商，以确定接入风险；对于需要进行标准化的专业，“标准化字段”为必填项，否则未可选项；在某个消息中，上表中的两个时间（发生时间、清除时间）只会存在一个，即 在“data_typeALARM_ACT”时，只有发生时间； 在“data_typeALARM_CLR”时，只有清除时间； 在“da

30、ta_typeALARM_HB”时，只有发生时间； 在“data_typeALARM_TIPS”时，只有发生时间。设备类型、告警对象设备类型、网络类型、告警逻辑分类、告警逻辑子类 的字典表见“部分告警数字枚举表”附件。部分告警字典映射表.xls2.3 同步告警接口描述同步接口指为保障告警的准确性、完整性，通过非及时的告警接口告警，以便对实时告警接口中的缺漏告警进行准确性、完整性补充。2.3.1 EAI转发采用EAI接口的告警接入，综合系统无法发起对专业的告警17展字段 167通用数值扩展字段 2extra_id2数字是否否66通用数值扩展字段 3extra_id3数字是否否综合告警南向接口规范

31、同步动作，所以，请各专业在上报告警时：1、专业无告警同步通道时，请各专业自行保证上报告警的准确性、及时性、完整性。2、专业有告警同步通道时，请根据实际情况，修改接口中的“方式（channel_type）”字段值为“网元同步”或“OMC同步”，并将修改后的告警信息通过实时EAI接口上报告警给综合。3、对于EAI告警同步通道，其接口描述、接口消息定义、接口字段定义与实时EAI接口中描述一致。2.3.2 Socket直连采用Socket直连接口的告警接入，由于网络故障等不确定因素，告警情况不可避免，故增加Socket告警同步接口。根据同步触发方式不同，可分为专业触发同步、综合触发同步。1、专业触发同

32、步：对于采用这种同步方式的专业，在根据实际情况修改接口中的“方式（channel_type）”字段值为“网元同步”或“OMC同步”后，可将同步后的告警数据通过socket直连方式上报给综合。其接口描述、接口消息定义、接口字段定义与实时Socket接口中描述一致。2、 综合专业触发同步：对于采用这种同步方式的专业，专业需要开放告警数据库或网元令接口，以便综合系统已同步数据库方式或直连网元方式进行告警同步。其接口描述、接口消息定义、接口字段定义等信息专业无需考虑，由综合系统内部确定。2.3.3 MQ转发综合告警平台告警同步消息给传输（可由综合告警发起，亦可由传输发起同步申请后，综合告警告警同步消息给传输），传输收到消息后将系统当前告警给综合告警平台。同步的告警消息通过单独的MQ通道，与实时告警。18综合告警南向接口规范2.4 工态回传接口描述2.4.1 接口描述