Statistics

Use the WebAdmin Interface to monitor the Server Statistics Elements via Web. Open the Statistics page in the Monitors realm.

Filter: MIB 30 of 248 selected
smtpInputActive	0		smtpInputTotal	0
smtpInputJobs	0		smtpInputTrafficIn	0
..................

The page contains the list of the Statistics Elements and their current values. Each Element name is a link. Click the Element link to open the Element Monitor page.

You can use the Filter field and the Display button to filter Statistics elements by name.

The Element Monitor page contains a histogram allowing you to monitor how the Element value changes over time:

Total: 451K Current: 152/sec
­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­		300
		0
11:22:13AM	11:25:35AM

There are time stamps at the bottom of the histogram (the time stamp on the right is the latest sampling time). On the right side of the histogram the graphic scale is indicated.

The histogram traces the current value of the INTEGER-type Elements. For the COUNTER-type Elements, the histogram traces the difference between the last two sample values, divided by the number of seconds passed between samples.

The WebAdmin Preferences can be used to change the parameters of the Statistics Web Monitor subsystem.

The CLI/API GETSTATELEMENT command allows a Server Administrator to monitor the Statistics Elements via the CLI/API interface and various CLI "wrappers".

The Trigger Manager monitors the values of selected Statistics 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 example, a Trigger can be "released" when there are more than 10,000 E-mail messages in the Server Queue (the value of the numQueuedMessages INTEGER-type Statistics 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 Statistics 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 E-mail option:

Send E-mail

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 Statistics Element that has released the Trigger.

^1

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

^2

This combination is replaced with the actual value of the Statistics 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 Execute URL option:

Execute 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 limiting 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" (approximately 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 Statistics Element.

For an INTEGER-type Element you specify the threshold as an integer value: if the Element value becomes larger than the threshold 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	---1351020301003001000300010000300001000003000001000000other
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 ---).

You may want to record the value of all Statistics Elements periodically.

Open the General pages in the Settings realm, then open the Triggers pages. Click the Events link and scroll to the bottom of the page:

Element	Handler	Threshold
............................
Log all Element values every: Never5 sec10 sec15 sec20 sec30 sec60 sec2 min3 min5 min10 min20 min30 min60 min2 hour(s)3 hour(s)6 hour(s)12 hour(s)24 hour(s)other

Select a desired time period and click the Update button. A record will be created in the "Statistics" Supplementary Log.

Each record contains the values of all Statistics Elements separated with the tabulation symbols.

The very first record of each file starts with the star (*) symbol and contains the Statistics Element names, also separated with the tabulation symbols. This record is also inserted after the CommuniGate Pro Server restarts, as the new version may have additional Statistics Elements.

There are 10 custom COUNTER-type Elements named custom1, custom2, ... custom10. The Server components do not modify their values themselves, but they can be updated using the CG/PL functions and CLI methods.