Event sinks

The Event Monitor configuration allows for a wide variety of sinks to contain events, including log, database, e-mail, and JMX notification.

Any number of sinks may be defined. For example, multiple SMTP sinks could be defined based on their purpose. One SMTP sink could be setup to send all Error events to an administrator e-mail address or pager. Another SMTP sink could be setup to send all template events to a group of users who need to know when templates change (newly imported, deleted, etc.).

Note that it is not recommended to configure multiple log, database and JMX sinks.

log sink

Following is an example of how to configure the log sink within the event-monitor-sinks.xml file. The configuration is managed via the application server log configuration.

<sinks>
	<sink name="Sample log sink">
		<config type="log"/>
	</sink>
</sinks>

Database sink

The database sink connects to the database defined by the EngageOne data source. Following is an example of how to configure the database sink within the event-monitor-sinks.xml file.

<sinks>
	<sink name="Sample database sink">
		<config type="database"/>
	</sink>
</sinks>

e-mail (SMTP) sink

Following is an example of how to configure the SMTP sink within the event-monitor-sinks.xml file.

<sinks>
	<sink name="Sample SMTP sink">
		<config type="smtp">
			<property name="securityMode">STARTTLS</property>        
			<property name="host">mail.whoever.com</property>
			<property name="port">25</property>
			<property name="to">somebody@somewhere.com</property>
			<property name="from">engageone@somewhere.com</property>
			<property name="subject">Someone logged an event!</property>
		</config>
	</sink>
</sinks>

Properties defined for an SMTP sink are listed below:


Property	Description
securityMode	Security mode. Allowed values: NONE, STARTTLS, SSLTLS. Default = NONE (optional). For STARTLS and SSLTLS to work properly set in deploy.properties trust store details(tls.trust.store.location and tls.trust.store.password)
host	Specifies the SMTP server (mandatory).
port	The port number the SMTP server is listening on. Default = 25 (optional).
to	The e-mail address or addresses separated by commas to which the event should be sent (mandatory).
from	The from e-mail address of the message. Default = Event Monitor System do.not.reply@event.monitor (optional).
subject	The subject of the message. Default = Event Monitor Event (optional).

Note that authentication SMTP is supported if you selected this option during the install process. These SMTP settings are stored in the configuration framework file. Once event-monitor-sinks.xml has been edited to allow events to be processed via SMTP, all events that fit the filter criteria will be sent seamlessly as e-mails, as well as logged to the database.

JMX sink

The JMX sink sends notifications to any registered listeners. Following is an example of how to configure the JMX sink within the event-monitor-sinks.xml file.

<sinks>
	<sink name="Sample JMX sink">
		<config type="jmx"/>
	</sink>
</sinks>