OpenNMS全接触-事件及通知（八）

转载于：/article/7321946.html

在上一篇中曾提到，在OpenNMS中有两种类型的事件，一种是OpenNMS内部产生的事件，而另外一种就是外部事件，如SNMP
Trap。OpenNMS中有个trapd服务专门负责接收SNMP Trap。而这是通过eventconf.xml文件中的<mask>元素来控制的：

<event>
<mask>
<maskelement>
<mename>id</mename>
<mevalue>.1.3.6.1.4.1.9.9.70.2</mevalue>
</maskelement>
<maskelement>
<mename>generic</mename>
<mevalue>6</mevalue>
</maskelement>
<maskelement>
<mename>specific</mename>
<mevalue>17</mevalue>
</maskelement>
</mask>
<uei>http://uei.opennms.org/vendor/Cisco/traps/ciscoC3800SysAggregateStatusChange</uei>
<event-label>CISCO-C3800-MIB defined trap event: ciscoC3800SysAggregateStatusChange</event-label>
<descr>&lt;p&gt;Notification that the aggregate status of a node
has changed.&lt;/p&gt;&lt;table&gt;
&lt;tr&gt;&lt;td&gt;&lt;b&gt;
c3800SysNextTrapSeqNum&lt;/b&gt;</td&gt;&lt;td&gt;%parm[#1]%
&lt;/td&gt;&lt;td&gt;&lt;p;&gt;</p&gt;&lt;/td;&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;b&gt;
sysName&lt;/b&gt;&lt;/td&gt;&lt;td&gt;%parm[#2]%
&lt;/td&gt;&lt;td&gt;&lt;p;&gt;&lt;/p&gt;&lt;/td;&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;b&gt;
c3800SysTrapSeverity&lt;/b&gt;&lt;/td&gt;&lt;td&gt;%parm[#3]%
&lt;/td&gt;&lt;td&gt;&lt;p;&gt;
clear(1) minor(2) major(3)&lt;/p&gt;
&lt;/td;&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;b&gt;
c3800SysAggregateStatus&lt;/b&gt;&lt;/td&gt;&lt;td&gt;%parm[#4]%
&lt;/td&gt;&lt;td&gt;&lt;p;&gt;
clear(1) minor(2) major(3)</p>
&lt;/td;&gt;&lt;/tr&gt;&lt;/table&gt;
</descr>
<logmsg dest='logndisplay'><p>Cisco Event: C3900: Node Status has changed.</p></logmsg>
<severity>Indeterminate</severity>
</event>

这是针对Cisco C3800设备的一个事件，该事件看起来与OpenNMS的内部事件很像，不过比内部事件多了个<mask>元素。<mask>又是由一系列的<maskelement>元素构成的。只有当定义的所有<maskelement>都匹配时，才会生成该事件。

对于上面这个例子而言，对于一个企业OID(id)为 .1.3.6.1.4.1.9.9.70.2，且generic的值为6，而specific值为17的snmp
trap才会匹配到该事件，从而产生该事件。

关于SNMP trap的具体内容可以参考RFC1157，这里重点讨论OpenNMS是怎么样将SNMP Trap映射到一个事件上的。

<mename>中的取值可以为以下几个之一：

uei

source

host

snmphost

nodeid

interface

service

id

specific

generic

community

另外还可以使用%作为通配符，如：

<mask>
<maskelement>
<mename>id</mename>
<mevalue>.1.3.6.1.4.1.9.%</mevalue>
</maskelement>
</mask>

这里就表示Cisco设备的所有SNMP Trap。

这里有个地方需要注意，就是OpenNMS在匹配SNMP Trap与eventconf.xml里面定义的事件时，当它匹配到第一个满足所有匹配调节的event后，就停止继续匹配，所以eventconf.xml文件中event定义的顺序非常重要。例如，如果我们把上面的带有通配符的事件定义在上面的ciscoC3800SysAggregateStatusChange事件之前，则ciscoC3800SysAggregateStatusChange事件

将永远不会被匹配到，从而也就永远不会发生。另外还有一点就是上面提到的通配符，其实只是简单的字符串替换的作用，相当于字串匹配。还是以.1.3.6.1.4.1.9.%为例，它只是会匹配以.1.3.6.1.4.1.9.开头的所有OID，而比如.1.3.6.1.4.1.9，则不会

被匹配，因为少了最后那个点。而如果我们去掉最后那个点，即变成.1.3.6.1.4.1.9%，如果有个OID为.1.3.6.1.4.1.99的事件，而又在这之后定义了.1.3.6.1.4.1.9%，则那么对于.1.3.6.1.4.1.9，则只会匹配到.1.3.6.1.4.1.99，而无法匹配到.1.3.6.1.4.1.9%。

OpenNMS中，对于有些事件，特别是SNMP Trap事件，还可以在事件中包含一些额外的信息，这些信息被称之为“variable bindings”或者简称为"varbinds"。在上述的ciscoC3800SysAggregateStatusChange事件中就包括了4个，这些信息可以通过parm元素访问它们。这些信息

其实就像事件的属性，它们由键值对组成，包括以下内容：

事件parm元素

参数名称	取值
%parm[all]%	将返回以空格隔开的所有参数名称及其取值， 如parmName1="parmValue1" parmName2="parmValue2
%parm[values-all]%	将返回以空格隔开的所有参数的取值， 如：parmValue1 parmValue2
%parm[names-all]%	将返回以空格隔开的所有参数的名称， 如：parmName1 parmName2
%parm[<name>]%	如果包含有以<name>为名称的属性，则返回该属性的值
%parm[##]%	返回属性的个数
%parm[#<num>]%	返回第<num>个参数的值
%parm[name-#<num>]%	返回第<num>个参数的名称

以ciscoC3800SysAggregateStatusChange事件为例，在该事件的描述中列出了该事件所有的参数，所以对于第2个参数，

即sysName，则可以通过%parm[#2]来访问其值并打印出来。我们既然可以访问这些值，自然也可以通过这些值进一步对SNMP Trap进行过滤，在下一篇文章中将介绍如果通过varbinds对SNMP Trap进一步进行匹配。