|
Version 6.3 |
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
Monitoring Statistics Elements via WebUse the WebAdmin Interface to monitor the Server Statistics Elements via Web. Open the Statistics page in the Monitors realm. 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:
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. Monitoring Statistics Elements via CLI/APIThe CLI/API GETSTATELEMENT command allows a Server Administrator to monitor the Statistics Elements via the CLI/API interface and various CLI "wrappers". Trigger ManagerThe 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 HandlersA 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.
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-mailTo send Trigger Notifications via E-mail, select the Send E-mail option:
Notification via Instant MessagesTo send Trigger Notifications as an Instant Message, select the Send Instant Message option:
Notification via SNMP TrapsTo send Trigger Notifications as SNMP Traps, select the Send SNMP Trap option:
Notification via Account AlertsTo send Trigger Notifications as Account Alerts, select the Send Account Alert option:
Notification via URL RequestsTo send Trigger Notifications a URL requests, select the Execute URL option:
Frequency LimitsEach 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). 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 TriggersYou 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: 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 ---). LoggingYou 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: 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. Custom Statistics Elements |