Cascade

Thu Dec 03 13:32:57 EST 2009

This handler plugs into the isValid() and alertCompleted() hooks, to forward alert creation/clearing events to another gateway that may further consolidate alerts. Each alert/clear is packaged as an XML-like event, for example:

<alert gateway="FarmDemo" element="Hatchery HVAC" rule="/Farm/Parse All/Temperature/Critical" priority="1">
Temperature = 110
</alert>
 
<clear gateway="FarmDemo" element="Hatchery HVAC" rule="/Farm/Parse All/Temperature/Critical" priority="1">
Temperature = 95
</clear>

When used to consolidate alerts at a higher-tiered gateway, you may want to filter the lower alerts from task groups. That that a task group filter will not affect the alerts within Augur; the filter will only affect which alerts are visible to a task group.

oneAtATime

The oneAtATime property controls whether or not to leave the output socket open between writes. When this handler instance will be the only source of events for the target gateway, you can set oneAtATime=false.

However, if you are using this handler to forward alerts to a gateway with a shared connector (e.g. a socket that may receive events from an external trouble ticketing system), then you should set oneAtATime=true so that the socket is released after each event is written.