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

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

 

<event>
  <mask>
    <maskelement>
      <mename>idmename>
      <mevalue>.1.3.6.1.4.1.9.9.70.2mevalue>
    maskelement>
    <maskelement>
      <mename>genericmename>
      <mevalue>6mevalue>
    maskelement>
    <maskelement>
      <mename>specificmename>
      <mevalue>17mevalue>
    maskelement>
  mask>
  <uei>http://uei.opennms.org/vendor/Cisco/traps/ciscoC3800SysAggregateStatusChangeuei>
  <event-label>CISCO-C3800-MIB defined trap event: ciscoC3800SysAggregateStatusChangeevent-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>Indeterminateseverity>
event>

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

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

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

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

• uei
• source
• host
• snmphost
• nodeid
• interface
• service
• id
• specific
• generic
• community

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

 

  
    id
    .1.3.6.1.4.1.9.%
  

 

这里就表示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[]%	如果包含有以为名称的属性，则返回该属性的值
%parm[##]%	返回属性的个数
%parm[#]%	返回第个参数的值
%parm[name-#]%	返回第个参数的名称

 

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

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