22.2 Creating Event Handlers

22.2.1 Event Action Log

22.2.2 Suspending an Event Handler

Event handlers enable you to create a condition which, when met, triggers notifications to concerned parties such as DBAs, System Administrators and so on.

The following condition criteria can be defined:

• Assets and Groups: enables you to select multiple assets or multiple groups to monitor.

  Important

  It is possible to define both Assets and Groups in an event handler, but is not recommended. It is recommended that you create the event handler using either Assets or Groups, not both. If you define Assets and Groups in an event handler, notifications are only sent for the defined Assets which also exist in the defined Groups.

• Advisors: enables you to select multiple Advisors to evaluate.

• Event Statuses: enables you to select multiple statuses to monitor.

To create an event handler, click Create Event Handler in the Event Handlers section on the Event Handlers page.

The Create Event Handler dialog is displayed.

Figure 22.6 Create Event Handler Dialog

Table 22.6 Create Event Handler Controls

Name	Description
Event Handler Name	Specify a name which uniquely identifies the new event handler.
Filters
Groups	Select the groups of assets to monitor. If this field is left blank, all groups are included in the event handler's condition, unless one or more assets are defined. If assets are defined, and the group field is blank, the event handler's condition includes the selected assets only.
Assets	Select the individual assets to monitor from the Assets drop-down list. If this field is left blank, all assets are included in the event handler's condition, unless one or more groups are defined. If groups are defined, and the asset field is blank, the event handler's condition includes the contents of the selected groups, only. The Assets drop-down list displays the Assets in their groups, if groups are defined. If no groups are defined, it lists the assets. It is not possible to select groups in the Assets field. You must expand the group to select individual assets. Note If you select the top-level of the asset, all assets are selected. This includes network interfaces, file systems, MySQL instances, and so on. You must expand the asset's entry to select individual assets.
Groups	Select the groups of assets to monitor. If this field is left blank, all groups are included in the event handler's condition, unless one or more assets are defined. If assets are defined, and the group field is blank, the event handler's condition includes assets only.
Advisors	Select the Advisors. If this field is left blank, all advisors are included in the event handler's condition.
Event Statuses	Select the statuses for which you want to receive notifications.
Event Handling
SMTP Notification Groups	Select the groups you want to notify.
SMTP/SNMP Notification Policy	Select one of the following: Notify on event escalation: sends a notification only if the event changes to a higher priority. From Warning to Critical, for example. No notification is sent if the event changes to a lower priority. From Critical to Warning, for example. Notify on any status change: sends a notification if the status changes to any other status. Always notify: sends a notification every time the defined event status(es) are broken. For example, if Critical and Emergency are defined in the Event Status field, and Always notify is selected, a notification is sent every time the Critical and Emergency events are triggered for the selected Advisors.
SMTP Rate Limit	Defines the maximum number of SMTP notifications which can be sent per minute. The default is 10.
Send SNMP Traps	Defines whether SNMP Traps are used for notifications.
Auto-Close Events	Defines whether the events are closed after the trigger status changes. The following values are possible: Yes: the default auto-close policy is honored and the events are closed when the conditions defined are no longer met. No: the default auto-close policy is ignored and the events remain open in the Events page even after the conditions are no longer met.

Important

If you leave the Assets, Groups, and Advisors fields empty, the event handler can generate an extremely high volume of emails, depending on the number of assets monitored. It is recommended to create event handlers which address specific requirements and contain strictly defined criteria.

Important

Do not define both Assets and Groups, use one or the other.

If multiple event handlers are defined on the same advisor, their corresponding actions are combined into a single action. However, these actions are logged separately in the event handler log.

If multiple event handlers are defined on the same advisor, their corresponding actions are combined into a single action. However, these actions are logged separately in the event handler log.