Event Log Trigger Properties

This page defines the conditions for triggering a job. adTempus will trigger your job each time a new event is reported that meets all of the criteria you specify.

Optional Descriptive Name

Optionally, provide a descriptive name for this trigger. Otherwise, a description will be created automatically based on trigger settings.

Enable this Trigger

If this box is checked, the trigger is enabled and will cause the job to run. If this box is not checked, adTempus will ignore this trigger.

Log

Select the log to monitor. A trigger can only monitor a single log.

Sources

Select the event sources (applications) whose events you want to check. You may select any number of sources; if you do not select any source, all sources will be considered.

For example, you might want to trigger based on Error messages logged by a particular application in the Application log. Or you might want to trigger any time an Error message is logged in the System log.

Category

This option is available only if you have selected a single event source. Select the category of messages you want adTempus to examine.

Types

Select the types (severities) to consider. If none are selected, all types are considered.

Include Event IDs

If you want to trigger only when specific events are logged, enter the IDs of those events here. You can specify as many events as you wish, separated by commas.

Event IDs are specific to each application (Event Source). To determine which events IDs you want to capture, consult the documentation for the application in question, or use the Windows Event Log Viewer to examine events the application has logged. The Event Log Viewer will show you the Event IDs for those events.

If you have selected multiple Event Sources, you should not specify Event IDs unless you are sure you know what you are doing (i.e., all of the sources you have selected use the same Event IDs to mean the same thing).

Exclude Event IDs

If you want to ignore certain events, enter the IDs of those events here. You can specify as many events as you wish, separated by commas.

For example, you might want to trigger any time an event of type Error is logged by Source "My Application", except if the event ID is 117.

Minimum Time Between Triggers

Specify the minimum time (in seconds) that must elapse after this trigger fires before adTempus will fire it again. Once adTempus triggers the job, it will ignore all new events until the specified time has passed.

Select events whose message matches

Check this option to select events based on the text of the event message. If the message contains the text you specify, it will be selected. The message does not have to match the specified text exactly, it may contain the specified text anywhere within it.

Use regular expressions

If this option is checked, the match text you enter is treated as a regular expression. If a match for that regular expression is found anywhere within the event message, the condition is satisfied.

Use a script to select events

adTempus will run the script you specify. Information about the event will be passed to the script using the Parameters collection. Your script then evaluates the event and sets the global Result variable to True if adTempus should trigger the job, or False if it should not.

adTempus calls the script only for events that have satisfied all of the other criteria for the trigger.

Description/Notes

Enter any extended descriptive information or notes for this trigger. There is no limit on the length of the text.