Events

Configuring Event Handlers Notification via E-mail Notification via Instant Messages Notification via SNMP Traps Notification via Account Alerts Notification via URL Requests Frequency Limits Specifying Events The CommuniGate Pro Server can detect certain situations and process them as Events, invoking Event Handlers. Event Handlers notify System Administrators about Events. The Event Manager monitors the values of selected SNMP elements. It generates an Event when the value of an INTEGER-type element crosses the specified threshold, or when the value of a COUNTER-type element has increased more than the specified limit over the specified period of time. For examlpe, an Event can be generated when there are more than 10,000 messages in the Server Queue (the value of the numQueuedMessages INTEGER-type SNMP Element is over 10,000) or when the POP Module has to process more than 100 connections per second (the value of the popInputJobs COUNTER-type SNMP Element increased for more than 2000 during the last 20 seconds).

Configuring Event Handlers

An Event Handlers specifies how a system administrator or system operator should be notified. Several notification methods are supported, and each Event Handler can use any number of supported methods.

To configure the Event Handlers, open the General page in the Settings realm of the CommuniGate Pro WebAdmin Interface, and follow the Events link. The list of existing Event Handlers will appear. Each Event Handler has a name and the notification method parameters:

Handler Name: .....methods....

There is an empty Event Handler at the bottom of the page. Enter a new Handler name and click the Update button to create a new Handler.

To remove a Handler, empty its Handler Name field and click the Update button.

To rename a Handler, change the value of its Handler Name field and click the Update button.

Notification via E-mail

To send Event Notifications via E-mail, select the Send Email option:

Send Email Subject: To: Text: The CommuniGate Pro server parameter ^0 value = ^2, threshold = ^1

Subject

This field specifies the Subject of E-mail messages sent with this Event Handler.

To

This field specifies the recipient(s) for E-mail messages sent with this Event Handler. Multiple recipients should be separated with the comma (,) symbol.

Body

This field specifies the text of E-mail messages sent with this Event Handler.

The Subject and Body parameters can include the special symbol combinations:

^0

This combination is replaced with the name of the SNMP Element that generated the Event.

^1

This combination is replaced with the value of the SNMP Element threshold.

^2

This combination is replaced with the actual value of the SNMP Element.

Notification via Instant Messages

To send Event Notifications as an Instant Message, select the Send Instant Message option:

Send Instant Message To: Text: Parameter ^0=^2, threshold = ^1

To

This field specifies the recipient for Instant Messages sent with this Event Handler.

Body

This field specifies the text of Instant Messages sent with this Event Handler. This text can contain the same special symbol combinations that can be used in E-mail Notifications (see above).

Notification via SNMP Traps

To send Event Notifications as SNMP Traps, select the Send SNMP Trap option:

Send SNMP Trap To: Active Monitors

To address field

This field specifies the addresses for computers to which SNMP Traps should be sent. Multiple addresses should be separated using the comma (,) symbol. Addresses can be specified as network (IP) addresses or as DNS domain names. If you want to send SNMP Traps not to the standard UDP port 162, but to a different port, specify the port number after the address, using the colon (:) symbol.

To Active Monitors

If this option is selected, the SNMP Trap is sent to all "Active SNMP Monitor" computers - all computers that have recently sent requests to the CommuniGate Pro SNMP module using the Trap Password "community name".

Notification via Account Alerts

To send Event Notifications as an Account Alert, select the Send Account Alert option:

Send Account Alert To: Text:

To

This field specifies the names of CommuniGate Pro Accounts the Alert should be sent to. Multiple names should be separated using the comma (,) symbol.

Text

This field specifies the text of the Alert. This text can contain the same special symbol combinations that can be used in E-mail Notifications (see above).

Notification via URL Requests

To send Event Notifications as a URL request, select the Send URL option:

Send URL To:

To

This field specifies the URL this Event Handler should send a request to. The text can contain the same special symbol combinations that can be used in E-mail Notifications (see above).

Frequency Limits

Each Event Handler has settings that limit the amount of event notifications the Handler can generate. This limit is necessary, because some Element can get into the "red zone" (cross the threshold) and stay there for some period of time. Without a limit, the Event Handler would send notifications every time it sees the Element in the "red zone" (aproximately every 5 seconds).

Frequency: not more than  1235710 alerts within  15 secondsminute2 minutes3 minutes5 minutes10 minutes15 minutes30 minuteshour2 hours3 hours6 hours12 hoursday2 days3 daysweek10 days2 weeks

If the Handler has already sent the specified number of notification during the specified period of time, no more notification is sent, but the generated events are still recorded in the CommuniGate Pro Log.

Specifying Events

You can specify an Event by setting a "threshold" for some SNMP Element.

For an INTEGER-type Element you specify the threshold as an integer value: if the Element value becomes larger than the threashold value, an Event is generated.

For a COUNTER-type Element you specify the threshold as an integer value and a time period: if the Element value has increased for more than the threshold value during the specified period of time, an Event is generated.

Use a Web browser to open the Events page in the Settings realm of the WebAdmin Interface. Click the Elements link to specify Events:

Element Handler Threshold ............................ smtpInputActive ---Warning ---13 51020301003001000300010000300001000003000001000000other smtpInputTotal ---Warning ---1351020301003001000300010000300001000003000001000000other smtpInputJobs ---Warning ---1351020301003001000300010000300001000003000001000000other in ---15 seconds30 secondsminute2 minutes3 minutes5 minutes smtpInputMessagesReceived ---Warning ---1351020301003001000300010000300001000003000001000000other in ---15 seconds30 secondsminute2 minutes3 minutes5 minutes ............................

The Handler field specifies which Event Handler should be used to process this Event.

To remove an Event, reset its Threshold value (set it to ---).

If you want to disable an Event without removing its threshold value, reset its Handler field (set it to ---).