
RSSOutputHandler
Sat Oct 24 03:09:22 EDT 2009
This Handler writes an RSS feed file for recent alerts.
This handler always returns 'true'. It should be place as the last AND
condition in any handler chain so that the log is only written when the other
handlers agree.
The alert field variables available for substitution in the 'format' setting
are mostly self-explanatory. In addition to those, any variable parsed in the
rule tree, or enriched via a handler, may be referenced.
Handler Folders
An instance of this handler should be placed at both the isValid and alertCompleted
folders, so that the RSS feed will be updated to contain only current alerts.
Instances
Note that this handler is synchronized, so it is best to use a separate
instance per gateway. Otherwise, gateways that share an instance will act as if
they were in one thread, which could impact performance if the gateways are
very busy (hundreds of events per second).
Installation
Due to a class-loader conflict, the Rome 1.0 libraries cannot be embedded in this
plugin. Instead, the libraries have to be installed in Augur's main classpath.
(Note that a copy of the two Rome *.jar files are in this plug-in's lib directory.
You can unzip this plug-in's *.api file to extract those files, or just download
the latest Rome libraries on the Internet:
http://rome.dev.java.net/
On Unix-based
systems, you can put these jars in ~/lib/plugins/. On Windows, you can put the
jars in the ~/lib/classes directory, but then you have to expand them (right-click,
then select "Expand Here"). You will also need to stop/start the Augur server.