Skip to content

Commit

Permalink
Enhancements for the notifications auto_acknowledge
Browse files Browse the repository at this point in the history
Notice: the following features are optional, they are going to be used
only if they are configured.

1) Matching event parameters

The original implementaion of auto-acknowledge provides a way to match
only the nodeId, the ipAddress and the serviceName. Now, it is possible
to match any event parameter, for example:

<auto-acknowledge resolution-prefix="RESOLVED: "
    uei="uei.opennms.org/nodes/snmp/interfaceOperUp"
    acknowledge="uei.opennms.org/nodes/snmp/interfaceOperDown">
    <match>nodeid</match>
    <match>interfaceid</match>
    <match>serviceid</match>
    <match>parm[snmpifname]</match>
</auto-acknowledge>

It is possible to provide either the parameter's name (like snmpifname)
or the parameter's number (like parm[#2])

2) Matching alarm's clear-key/reduction-key pairs:

2.1) Global configuration:

<auto-acknowledge-alarm resolution-prefix="RESOLVED: "/>

The above means, all the notifications related with events that have
alarm-data on their configuration are going to be auto-acknowledge.

If this setting is used, all the default entries for auto-acknowledge
can be removed as they are redundant.

2.2) Specific configuration:

<auto-acknowledge-alarm resolution-prefix="RESOLVED: ">
  <uei>uei.opennms.org/nodes/nodeUp</uei>
  <uei>uei.opennms.org/nodes/interfaceUp</uei>
  <uei>uei.opennms.org/nodes/nodeRegainedService</uei>
</auto-acknowledge-alarm>

The above means, apply auto-acknowledge for the provided resolving
events. In this case, if those events comes in, and the originator
events (matching the reduction-key/clear-key pairs) have notifications
configured, those are going to be auto-acknowledged and the resolved
notifications will be sent.
  • Loading branch information
agalue committed Apr 29, 2014
1 parent c76584e commit 305bc74
Show file tree
Hide file tree
Showing 3 changed files with 378 additions and 256 deletions.
15 changes: 15 additions & 0 deletions opennms-config-model/src/main/castor/notifd-configuration.xsd
Expand Up @@ -20,6 +20,9 @@

<complexType>
<sequence>
<element maxOccurs="1" minOccurs="0"
ref="this:auto-acknowledge-alarm"/>

<element maxOccurs="unbounded" minOccurs="0"
ref="this:auto-acknowledge"/>

Expand Down Expand Up @@ -55,6 +58,18 @@
</complexType>
</element>

<element name="auto-acknowledge-alarm">
<complexType>
<sequence>
<element maxOccurs="unbounded" minOccurs="0" name="uei" type="string"/>
</sequence>

<attribute default="RESOLVED: " name="resolution-prefix" type="string"/>

<attribute default="true" name="notify" type="boolean" use="optional"/>
</complexType>
</element>

<element name="auto-acknowledge">
<complexType>
<sequence>
Expand Down

0 comments on commit 305bc74

Please sign in to comment.