Version 5.1

Introduction Installation SysAdmin Network Objects E-mail Signals Access Services Directory Clusters Applications Miscellaneous Licensing   WebMail PBX

Sys Admin Logs Router Protection Security PKI Intercept Scalability Alerts Triggers Triggers Configuring Trigger Handlers Notification via E-mail Notification via Instant Messages Notification via SNMP Traps Notification via Account Alerts Notification via URL Requests Frequency Limits Specifying Triggers The CommuniGate Pro Server can detect certain situations and process them as Triggers, invoking Trigger Handlers. Trigger Handlers notify System Administrators. The Trigger Manager monitors the values of selected SNMP elements. A Trigger is "released" 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, a Trigger 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 SIP Module has to process more than 500 incoming requests per second (the value of the sipTotalServers COUNTER-type SNMP Element increased for more than 5000 during the last 10 seconds).

Configuring Trigger Handlers

A Trigger Handler specifies how a System Administrator or System Operator should be notified. Several notification methods are supported, and each Trigger Handler can use any number of supported methods.

Use the WebAdmin Interface to configure the Trigger Handlers. Open the General pages in the Settings realm, then open the Triggers pages.
Click the Handler link to configure the Trigger Handlers. The list of existing Trigger Handlers will appear. Each Trigger Handler has a name and notification methods with parameters:

Name:

.....methods....

There is an empty Trigger 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 Trigger Notifications via E-mail, select the Send Email option:

Send Email

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

Subject

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

To

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

Body

This field specifies the text of E-mail messages sent with this 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 has released the Trigger.

^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.

^3

This combination is replaced with the current Server time.

Notification via Instant Messages

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

Send Instant Message

To:   Parameter ^0=^2, threshold = ^1

To

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

Body

This field specifies the text of Instant Messages sent with this 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 Trigger 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 Trigger Notifications as Account Alerts, select the Send Account Alert option:

Send Account Alert

To:

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 Trigger Notifications a URL requests, select the Send URL option:

Send URL

To:

To

This field specifies the URL this 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 Trigger Handler has settings that limit the amount of 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 Trigger Handler would send notifications every time it sees the Element in the "red zone" (aproximately every 5 seconds).

Frequency:

not more than 12345710152025 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 released Triggers are still recorded in the Server Log.

Specifying Triggers

You can specify a Trigger 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, the Trigger is released.

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, the Trigger is released.

Use the WebAdmin Interface to specify Triggers. Open the General pages in the Settings realm, then open the Triggers pages. Click the Elements link to specify Triggers:

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 Trigger Handler should be used to process this Trigger.

To remove a Trigger, reset its Threshold value (set it to ---).

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