华为北向网管NCE开发教程(7)历史告警采集

2024-06-15 10:28

本文主要是介绍华为北向网管NCE开发教程(7)历史告警采集,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1准备工作

准备一个FTP服务器和网管北向网络通,网管北向生成告警文件,会推送到准备的FTP服务器上。
linux,都是自带FTP的,如果是linux则无需自己搭建,如果是windows则需要自己搭建

2生成告警文件

2.1方法说明getAllHistoryAlarmsByFTP

该方法是接口EMSMgr_I中的方法

void getAllHistoryAlarmsByFTP(
java.lang.String destination, 
java.lang.String userName, 
java.lang.String password, 
mtnm.tmforum.org.globaldefs.NameAndStringValue_T[][] meNameList, 
java.lang.String[] typeList, 
java.lang.String[] excludeProbCauseList, mtnm.tmforum.org.notifications.PerceivedSeverity_T[] excludeSeverityList,
java.lang.String startTime, 
java.lang.String endTime
) throws mtnm.tmforum.org.globaldefs.ProcessingFailureException;

下面这个是华为的文档说明
在这里插入图片描述

2.2getAllHistoryAlarmsByFTP请求参数示例

Common_IHolder commonHolder = new Common_IHolder();
emsSession.getManager("EMS", commonHolder);
EMSMgr_I emsMgr = EMSMgr_IHelper.narrow(commonHolder.value);//指定生成的网元
String managedElement = "3145734"//FTP信息
//生成文件地址实际路径为192.168.1.11服务器的 /home/admin/alarms/,登录用户目录/destination中指定的目录
String destination = "192.168.1.11:alarms/"+managedElement+".txt";
String userName = "admin";
String password = "123456";//构建网元查询条件
NameAndStringValue_T[][] meNameList = new NameAndStringValue_T[1][];//网元名称列表(与typeList 条件不能同时输入)。仅支持网元/光网元,不支持EMS/SNMS。
NameAndStringValue_T[] meName = new NameAndStringValue_T[2];
meName[0] = new NameAndStringValue_T("EMS", "Huawei/NCE");
meName[1] = new NameAndStringValue_T("ManagedElement", managedElement);
meNameList[0] = meName;//网元类型和网元ID互斥,为空即可
String[] typeList = new String[0];//网元类型列表(与meNameList 条件不能同时输入)//告警原因
String[] excludeProbCauseList = new String[0];//符合此类原因的告警不查询。列表为空标识不使用该过滤条件。//告警级别
PerceivedSeverity_T[] excludeSeverityList = new PerceivedSeverity_T[0];//符合此类级别的告警不查询,列表为空标识不使用该过滤条件。//时间范围
String startTime = "20150101000000.0";//起始时间(格式如:20130111000000.0 Z 本地时间及UTC时间均支持)针对告警的清除时间进行过滤,不包括起始时间点。
String endTime = "20240604000000.0";//终止时间(格式如:20130111000000.0 Z 本地时间及UTC时间均支持)针对告警的清除时间进行过滤,包括终止时间点。//调用接口
emsMgr.getAllHistoryAlarmsByFTP(destination, userName, password, meNameList, typeList, excludeProbCauseList, excludeSeverityList, startTime, endTime);

接下来就是怎么采集了。下图所示,我先查询所有的网元,然后再根据网元的managedElement 逐个的生产历史告警。
在这里插入图片描述

2.3接收历史告警的文件传输通知

这里生成历史告警信息,不是实时的,调用方法以后,北向网管异步生成文件上传至FTP,至于最后是否成功或者失败?什么时候生成完毕?只能通过订阅通知获取。
具体的订阅通知代码,具体细节请看
华为北向网管NCE开发教程(6)消息订阅
下面是核心代码及日志记录
在这里插入图片描述

如下是记录的日志信息
在这里插入图片描述

2.4查看告警文件

登录FTP服务器(linux),在文件通知中,可以看到某个文件生成的地址信息。当然了,地址本来就是我们自己给定linux地址。下面是我们使用admin用户登录,则登录linux以后,默认路径就是在home/admin之下,然后生成的全路径也就是home/admin/alarms/xxxxx.txt

String destination = "192.168.1.11:alarms/"+managedElement+".txt";
String userName = "admin";
String password = "123456";

备注:此处建议FTP就直接用部署解析数据的程序linux服务器,这样北向网管上传的文件其实对于程序来说,就是在本地,对于你程序后续解析文件或者其他操作比较方便。不然还得单独写从FTP获取文件增加工作量。然后再很多公司的安全要求里面,FTP被当做不安全的文件传输协议,到时候开发起来,麻烦事比较多。
如果你以为万一这个服务器蹦了,考虑不考虑用集群或者负载均衡等方式,多用几台服务器来采集数据,那就别想了,这个问题无解,对接北向corba就只能单体部署。否则你就只能用rest或者kafka了。当然了用这两个,是要收钱的。

为了方便调试,我把生成在linux的文件,下载到我本地电脑上
在这里插入图片描述

3解析告警文件

其实这一块,可以不写的,毕竟解析和北向网管对接,其实没啥关系了,不过也说一下,毕竟这个确实不好弄

3.1查看文件结构

这是接口文档给的,每一列的含义,告你你用\来分割
在这里插入图片描述
这是我们打开告警文件看到的
在这里插入图片描述
将一整行拆开,可以看到,有些在标签中,有些不在标签中。
在这里插入图片描述

3.2解析思路一:XML报文

1按照行\n切割,得到一条告警信息
2按照每行的 \t分割,得到每个字段
3重新构建一个xml报文
3.1将带标签的转成标准的标签
3.2将没有标签的带上标签
4将xml报文转java对象

生成新的XML报文如下,此方法适用于,你要的数据基本都在标签中

3.2.1生成新的XLM报文

我们需要将原来的txt文件的内容变成如下这种形式

<allRoot><root><node><name>EMS</name><value>Huawei/NCE</value></node><node><name>ManagedElement</name><value>167772176</value></node><node><name>PTP</name><value>/rack=1/shelf=1/sub_shelf=0/slot=5/domain=eth/type=mac/port=1</value></node><ProposedRepairActionList_T/><oneParam><name>Location</name><value>NA</value></oneParam><oneParam><name>Direction</name><value>NA</value></oneParam><oneParam><name>MaintenanceStatus</name><value>NotInMaintenance</value></oneParam><oneParam><name>AlarmSerialNo</name><value>6833516</value></oneParam><oneParam><name>AlarmReason</name><value>缃戝彛杩炴帴涓㈠け</value></oneParam><oneParam><name>ProductName</name><value>OptiX OSN 1800 V</value></oneParam><oneParam><name>EquipmentName</name><value>B2EFS8</value></oneParam><oneParam><name>AffirmState</name><value>TRUE</value></oneParam><oneParam><name>DetailInfo</name><value/></oneParam><oneParam><name>SlaveShelf</name><value>涓诲瓙鏋?</value></oneParam><oneParam><name>HandlingSuggestion</name><value>(1)端口已使能但端口的网线或光纤没有连接好;(2)网线或光纤故障;(3)对端发送部分故障;(4)本端接收部分故障。(5)灰光光模块与彩光光模块对接,端口可能上ETH_LOS。(6)彩光光模块对接,配置不同波长。(7)对接端口的传输模式不一致或者FEC模式不一致。</value></oneParam><oneParam><name>LocationInfo</name><value>0-涓诲瓙鏋?-5-B2EFS8-1(鑷冲竷鏃ラ兘鍐呰挋璋冨害鏁版嵁缃?34M)-MAC:1</value></oneParam><oneParam><name>DeviceIP</name><value/></oneParam><oneParam><name>ROUTE_CAUSE</name><value>0</value></oneParam><oneParam><name>lResSubType</name><value>124321792</value></oneParam><alarmAffect>SA_SERVICE_AFFECTING</alarmAffect><alarmNeTime>1712600372000</alarmNeTime></root><root><node><name>EMS</name><value>Huawei/NCE</value></node><node><name>ManagedElement</name><value>167772176</value></node><node><name>EquipmentHolder</name><value>/rack=1/shelf=1/sub_shelf=0/slot=18</value></node><node><name>Equipment</name><value>1</value></node><ProposedRepairActionList_T/><oneParam><name>Location</name><value>NA</value></oneParam><oneParam><name>Direction</name><value>NA</value></oneParam><oneParam><name>MaintenanceStatus</name><value>NotInMaintenance</value></oneParam><oneParam><name>AlarmSerialNo</name><value>6835838</value></oneParam><oneParam><name>AlarmReason</name><value>鐢垫簮鏁呴殰</value></oneParam><oneParam><name>ProductName</name><value>OptiX OSN 1800 V</value></oneParam><oneParam><name>EquipmentName</name><value>F5PIU</value></oneParam><oneParam><name>AffirmState</name><value>TRUE</value></oneParam><oneParam><name>DetailInfo</name><value>48V涓荤數婧愭瑺鍘?鍛婅?﹀弬鏁癐I(16杩涘埗) 0x50</value></oneParam><oneParam><name>SlaveShelf</name><value>涓诲瓙鏋?</value></oneParam><oneParam><name>HandlingSuggestion</name><value>(1)备份电源板开关未打开;(2)电源板失效;(3)单板电源老化。</value></oneParam><oneParam><name>LocationInfo</name><value>0-涓诲瓙鏋?-18-F5PIU-OTHER</value></oneParam><oneParam><name>DeviceIP</name><value/></oneParam><oneParam><name>ROUTE_CAUSE</name><value>0</value></oneParam><oneParam><name>lResSubType</name><value>124321792</value></oneParam><alarmAffect>SA_SERVICE_AFFECTING</alarmAffect><alarmNeTime>1712616472000</alarmNeTime></root><root><node><name>EMS</name><value>Huawei/NCE</value></node><node><name>ManagedElement</name><value>167772176</value></node><node><name>PTP</name><value>/rack=1/shelf=1/sub_shelf=0/slot=5/domain=eth/type=mac/port=1</value></node><ProposedRepairActionList_T/><oneParam><name>Location</name><value>NA</value></oneParam><oneParam><name>Direction</name><value>NA</value></oneParam><oneParam><name>MaintenanceStatus</name><value>NotInMaintenance</value></oneParam><oneParam><name>AlarmSerialNo</name><value>6845135</value></oneParam><oneParam><name>AlarmReason</name><value>缃戝彛杩炴帴涓㈠け</value></oneParam><oneParam><name>ProductName</name><value>OptiX OSN 1800 V</value></oneParam><oneParam><name>EquipmentName</name><value>B2EFS8</value></oneParam><oneParam><name>AffirmState</name><value>TRUE</value></oneParam><oneParam><name>DetailInfo</name><value/></oneParam><oneParam><name>SlaveShelf</name><value>涓诲瓙鏋?</value></oneParam><oneParam><name>HandlingSuggestion</name><value>(1)端口已使能但端口的网线或光纤没有连接好;(2)网线或光纤故障;(3)对端发送部分故障;(4)本端接收部分故障。(5)灰光光模块与彩光光模块对接,端口可能上ETH_LOS。(6)彩光光模块对接,配置不同波长。(7)对接端口的传输模式不一致或者FEC模式不一致。</value></oneParam><oneParam><name>LocationInfo</name><value>0-涓诲瓙鏋?-5-B2EFS8-1(鑷冲竷鏃ラ兘鍐呰挋璋冨害鏁版嵁缃?34M)-MAC:1</value></oneParam><oneParam><name>DeviceIP</name><value/></oneParam><oneParam><name>ROUTE_CAUSE</name><value>0</value></oneParam><oneParam><name>lResSubType</name><value>124321792</value></oneParam><alarmAffect>SA_SERVICE_AFFECTING</alarmAffect><alarmNeTime>1712681968000</alarmNeTime></root>
</allRoot>

3.2.2定义新XML报文实体类

定义一个java实体类来接收上面的XML报文

@XmlRootElement(name = "allRoot")
@ToString
public class AllRoot {private List<Root> roots;@XmlElement(name = "root")public List<Root> getRoots() {return roots;}public void setRoots(List<Root> roots) {this.roots = roots;}
}@XmlRootElement(name = "root")
@ToString
public class Root {private List<Node> nodes;private List<OneParam> oneParams;private String alarmAffect;private Long alarmNeTime;public Root() {}@XmlElement(name = "node")public List<Node> getNodes() {return nodes;}public void setNodes(List<Node> nodes) {this.nodes = nodes;}@XmlElement(name = "oneParam")public List<OneParam> getOneParams() {return oneParams;}public void setOneParams(List<OneParam> oneParams) {this.oneParams = oneParams;}@XmlElement(name = "alarmAffect")public String getAlarmAffect() {return alarmAffect;}public void setAlarmAffect(String alarmAffect) {this.alarmAffect = alarmAffect;}@XmlElement(name = "alarmNeTime")public Long getAlarmNeTime() {return alarmNeTime;}public void setAlarmNeTime(Long alarmNeTime) {this.alarmNeTime = alarmNeTime;}}@XmlRootElement(name = "node")
@ToString
public class Node {private String name;private String value;@XmlElement(name = "name")public String getName() {return name;}public void setName(String name) {this.name = name;}@XmlElement(name = "value")public String getValue() {return value;}public void setValue(String value) {this.value = value;}
}@XmlRootElement(name = "oneParam")
@ToString
public class OneParam {private String name;private String value;@XmlElement(name = "name")public String getName() {return name;}public void setName(String name) {this.name = name;}@XmlElement(name = "value")public String getValue() {return value;}public void setValue(String value) {this.value = value;}
}

3.2.3代码实现

private static final Set<String> ALARM_AFFECT = new HashSet<>(Arrays.asList("SA_UNKNOWN", "SA_SERVICE_AFFECTING", "SA_NON_SERVICE_AFFECTING"));public AllRoot getAlarmDataByPath(String path) throws JAXBException {String alarmStr = JsonUtils.readStringFromSystemPath(path);String[] rows = alarmStr.split("\n");StringBuilder rootStr = new StringBuilder();rootStr.append("<allRoot>");for (int i = 1; i < rows.length; i++) {String alarmAffect = "";Long alarmNeTime = null;rootStr.append("<root>");String[] columns = rows[i].split("\t");for (int j = 1; j < columns.length; j++) {//提取标准标签内容if(columns[j].contains("<") && columns[j].contains(">")) {rootStr.append(columns[j]);//提取标签外的内容时间和ALARM_AFFECT,这里是需要特殊处理的,根据你要的业务来特殊处理,我所需要的两个字段刚好都可以满足我的需求进行特殊处理}else {if(ALARM_AFFECT.contains(columns[j])) {alarmAffect = columns[j];}else if(columns[j].contains(".0Z")){//大时间是emsTime,小时间是neTimeLong date = DateUtils.StrToLongTime(columns[j], FORMAT);if(alarmNeTime == null) {alarmNeTime = date;}else {alarmNeTime = Math.min(alarmNeTime, date);}}}}//追加标签外的alarmAffect和alarmNeTime到新报文中rootStr.append("<alarmAffect>");rootStr.append(alarmAffect);rootStr.append("</alarmAffect>");rootStr.append("<alarmNeTime>");rootStr.append(alarmNeTime.toString());rootStr.append("</alarmNeTime>");rootStr.append("</root>");}rootStr.append("</allRoot>");//新XML报文转Java对象JAXBContext jaxbContext = JAXBContext.newInstance(AllRoot.class);Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();StringReader reader = new StringReader(rootStr.toString());return (AllRoot) unmarshaller.unmarshal(reader);}

3.3解析思路二:按照顺序列赋值

1按照行\n切割,得到一条告警信息
2按照每行的 \t分割,得到每个字段
3假定每行切割的第一个字段是aa属性,第二个字段是bb属性,第三个字段是cc属性

核心代码

String alarmStr = JsonUtils.readStringFromSystemPath(path);
String[] rows = alarmStr.split("\n");
String[] title = rows[0].split("\t");
StringBuilder rootStr = new StringBuilder();
for (int i = 1; i < rows.length; i++) {String[] columns = rows[i].split("\t");for (int j = 1; j < columns.length; j++) {System.out.println("第:" + j +"列");System.out.println("标题:"+title[j]);System.out.println("对应值:"+columns[j]);System.out.println("------------------");}
}

在这里插入图片描述
完毕。

这篇关于华为北向网管NCE开发教程(7)历史告警采集的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1063191

相关文章

springboot使用Scheduling实现动态增删启停定时任务教程

《springboot使用Scheduling实现动态增删启停定时任务教程》:本文主要介绍springboot使用Scheduling实现动态增删启停定时任务教程,具有很好的参考价值,希望对大家有... 目录1、配置定时任务需要的线程池2、创建ScheduledFuture的包装类3、注册定时任务,增加、删

Go语言开发实现查询IP信息的MCP服务器

《Go语言开发实现查询IP信息的MCP服务器》随着MCP的快速普及和广泛应用,MCP服务器也层出不穷,本文将详细介绍如何在Go语言中使用go-mcp库来开发一个查询IP信息的MCP... 目录前言mcp-ip-geo 服务器目录结构说明查询 IP 信息功能实现工具实现工具管理查询单个 IP 信息工具的实现服

如何为Yarn配置国内源的详细教程

《如何为Yarn配置国内源的详细教程》在使用Yarn进行项目开发时,由于网络原因,直接使用官方源可能会导致下载速度慢或连接失败,配置国内源可以显著提高包的下载速度和稳定性,本文将详细介绍如何为Yarn... 目录一、查询当前使用的镜像源二、设置国内源1. 设置为淘宝镜像源2. 设置为其他国内源三、还原为官方

Maven的使用和配置国内源的保姆级教程

《Maven的使用和配置国内源的保姆级教程》Maven是⼀个项目管理工具,基于POM(ProjectObjectModel,项目对象模型)的概念,Maven可以通过一小段描述信息来管理项目的构建,报告... 目录1. 什么是Maven?2.创建⼀个Maven项目3.Maven 核心功能4.使用Maven H

IDEA自动生成注释模板的配置教程

《IDEA自动生成注释模板的配置教程》本文介绍了如何在IntelliJIDEA中配置类和方法的注释模板,包括自动生成项目名称、包名、日期和时间等内容,以及如何定制参数和返回值的注释格式,需要的朋友可以... 目录项目场景配置方法类注释模板定义类开头的注释步骤类注释效果方法注释模板定义方法开头的注释步骤方法注

售价599元起! 华为路由器X1/Pro发布 配置与区别一览

《售价599元起!华为路由器X1/Pro发布配置与区别一览》华为路由器X1/Pro发布,有朋友留言问华为路由X1和X1Pro怎么选择,关于这个问题,本期图文将对这二款路由器做了期参数对比,大家看... 华为路由 X1 系列已经正式发布并开启预售,将在 4 月 25 日 10:08 正式开售,两款产品分别为华

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t

Python虚拟环境终极(含PyCharm的使用教程)

《Python虚拟环境终极(含PyCharm的使用教程)》:本文主要介绍Python虚拟环境终极(含PyCharm的使用教程),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录一、为什么需要虚拟环境?二、虚拟环境创建方式对比三、命令行创建虚拟环境(venv)3.1 基础命令3

使用Node.js制作图片上传服务的详细教程

《使用Node.js制作图片上传服务的详细教程》在现代Web应用开发中,图片上传是一项常见且重要的功能,借助Node.js强大的生态系统,我们可以轻松搭建高效的图片上传服务,本文将深入探讨如何使用No... 目录准备工作搭建 Express 服务器配置 multer 进行图片上传处理图片上传请求完整代码示例

Spring Shell 命令行实现交互式Shell应用开发

《SpringShell命令行实现交互式Shell应用开发》本文主要介绍了SpringShell命令行实现交互式Shell应用开发,能够帮助开发者快速构建功能丰富的命令行应用程序,具有一定的参考价... 目录引言一、Spring Shell概述二、创建命令类三、命令参数处理四、命令分组与帮助系统五、自定义S