Table Of Contents
Admin Serviceability Tool
Overview
Monitor System Performance
Performance Monitoring Hierarchy
Monitor Device Status
Devices Hierarchy
Load Admin Serviceability Tool
AST Window Overview
AST Default Configuration
Customize AST Window
Cluster Information
Use the AST Window
Use the CallMgr Info Button
Preferences
View Preferences
Change AST Configuration Display
Create Configuration Preferences
Alert Notify
Heartbeat
Configure Alert Notification for Heartbeat Monitoring
Resource Usage
Last 24 hr. Calls
Process Activity
About AST
Help
Heartbeat
AST Monitoring Pane Options
Category Tabs
Create a Category
Remove a Category
Rename a Category
Cisco CallManager Counters Performance Example
Gateway Device Example
Sample Rate
Performance Counters Table View/Chart View
Re-Select
Monitor Performance
Add a Counter to Monitor
Configure Alert Notification for Counter
Zoom Counter
Remove a Counter From Monitor
Counter Properties
Property Description
Data Sample
View Data for a Monitor
Monitor Devices
Device Monitoring Pane
Add Device to Monitor
View Phone Information
View Device Description
View Gateway Channel Status
Configure Alert Notification for Gateway
Configure Refresh Rate for Gateway
Admin Serviceability Tool
This chapter provides general and procedural information on the Admin Serviceability Tool (AST) for Cisco CallManager Serviceability.
This chapter contains the following general topics for the Admin Serviceability Tool:
•
Overview
•Monitor System Performance
•Performance Monitoring Hierarchy
•Monitor Device Status
•Devices Hierarchy
The following topics cover the Admin Serviceability Tool configurable options:
•Load Admin Serviceability Tool
•Cluster Information
•Preferences
•Resource Usage
•About AST
•Help
•Heartbeat
•AST Monitoring Pane Options
•Category Tabs
•Create a Category
•Remove a Category
•Rename a Category
•Sample Rate
•Performance Counters Table View/Chart View
•Re-Select
The following topics cover the Admin Serviceability Tool performance monitoring information:
•Monitor Performance
•Add a Counter to Monitor
•Configure Alert Notification for Counter
•Zoom Counter
•View Data for a Monitor
•Remove a Counter From Monitor
•Counter Properties
The following topics cover AST device status information:
•Monitor Devices
•Add Device to Monitor
•View Phone Information
•View Device Description
•View Gateway Channel Status
•Configure Alert Notification for Gateway
•Configure Refresh Rate for Gateway
Related Topics
•Chapter 8, "Monitor Performance Counters."
•Chapter 13, "SNMP Instrumentation."
•Appendix A, "Cisco CallManager Perfmon Counters, AST, and CCM_SNMP_MIB."
Overview
Cisco CallManager Serviceability provides a web-based tool that monitors real-time behavior of the components in a Cisco CallManager cluster. The AST uses HTTP and TCP to monitor device status, system performance, and device discovery. It also connects directly to devices using HTTP for troubleshooting system problems.
See Figure 5-1 for an illustration of the Admin Serviceability Tool window.
Monitor System Performance
The Admin Serviceability Tool displays performance information of all Cisco CallManager components in a cluster. The tool integrates with the Cisco CallManager administration and serviceability software. The AST provides an alert notification mechanism to ease the system administrator troubleshooting tasks. The AST monitors various aspects of the Cisco CallManager performance by periodically polling NT/2000 performance counter values.
Performance monitoring provides the following services:
•Monitors performance counters from the Cisco CallManager cluster, including Cisco CallManager nodes, TFTP servers, and database servers.
•Presents counters hierarchically for easy navigation.
•Associates counter threshold settings to alert notification. An e-mail or popup message provides notification to the administrator.
•Permits saving and restoring settings, such as counters being monitored, threshold settings, and alert notifications, for customized troubleshooting tasks.
•Displays up to three counters in one chart for performance comparisons.
Performance Monitoring Hierarchy
The Windows 2000 operating system provides performance data that contains information for various object types, instances for each object type, and counters for each object type. The counters measure various aspects of system performance. For example, the object type, Cisco CallManager, includes the registered phones counter. The registered phones counter measures the number of registered phones. An instance designates a unique copy of a particular object type, though not all object types support multiple instances. For example, the object types Cisco CallManager or Cisco Tftp have no instances because only one CallManager or TFTP service exists on a Win2000 system. However, the Cisco Phones and Cisco Lines object types support multiple instances.
Consult Microsoft Windows documentation for more information about Windows 2000 objects and counters.
The following list defines performance monitoring hierarchy:
•The Cisco CallManager cluster name appears at the top of the hierarchy; for example, Cluster1.
•The list shows the servers in each cluster listed under the cluster name. The list shows the servers by their IP address (for example, 172.10.10.10) or their domain name (for example, Cisco_TFTP). Use Cisco CallManager Administration to name servers.
•The objects running on each server appear under the server name. Objects include Microsoft NT objects and Cisco CallManager objects; for example, Active Server Pages is an NT object, while Cisco Media Streaming App is a Cisco CallManager object.
•The list shows the counters for each object listed under the object name; for example, the counters for Active Server Pages comprise Debugging Requests, Error/Sec, and Requests/Sec; the counters for Cisco Media Streaming App comprise Heartbeat, IOCTL Errors, and StartTime.
Each level of hierarchy supports a right-click context menu as follows:
•The cluster level supports three menu choices: launch Cisco CallManager Administration, display property information for the cluster, and refresh the performance counters for the nodes within the cluster.
•The server level supports two menu choices: launch Cisco CallManager Administration and display property information for the cluster.
•The counter level supports three menu choices: add a counter to the AST performance monitoring pane, add an instance to the AST performance monitoring pane, and display property information for the counter.
Monitor Device Status
The Admin Serviceability Tool discovers devices regardless of their registration status (for example, registered or failed to register) in the cluster. The AST searches on device name, device description, IP address, IP subnet, or DN, and monitors the status of discovered devices.
Device status monitoring supports the following capabilities:
•Device selection and discovery for servers
•Cluster-wide device selection and discovery
•Discover configured devices that are not physically connected
•Gateway port and channel status monitoring and alert notification
Devices Hierarchy
The following list defines device monitoring hierarchy:
•The Cisco CallManager cluster name appears first; for example, Cluster1.
•Under the cluster name, the list shows the devices configured for each cluster; for example, Phone, Gateway, and H.323 devices.
Each level of hierarchy supports a right-click context menu as follows:
•The cluster level supports three menu choices: monitor cluster devices, launch Cisco CallManager Administration, and display property information for the cluster.
•The device level supports two menu choices: monitor device status and launch Cisco CallManager Administration.
Load Admin Serviceability Tool
The Cisco CallManager Serviceability program lists the AST under the Tools menu item. Perform the following procedure to load the AST.
Step 1 Choose Application > Cisco CallManager Serviceability from the Cisco CallManager Administration window.
The Cisco CallManager Serviceability window displays.
Step 2 Choose Tools > Admin Serviceability Tool.
The tool displays. See Figure 5-1.
Step 3 From the Select Configuration window, choose the configuration you want displayed.
Note The AST provides a default configuration. For more information, see AST Default Configuration.
Step 4 Click the OK button.
Note If you do not want a configuration that displays in the Select Configuration window, click the Cancel button. To create configurations, see Create Configuration Preferences.
The configuration you chose displays. The cluster information displays in the pane area called Monitoring Objects. Performance and Devices designate the tabs in this pane.
Step 5 If you want to monitor the performance of object counters, see Monitor Performance; otherwise, continue with the next step.
Step 6 If you want to monitor Cisco CallManager Devices, see Monitor Devices.
AST Window Overview
The AST window comprises the following panes:
•The Monitoring Objects pane that appears on the left contains two tabs: Performance and Devices.
•The Performance Monitoring pane or the Device Monitoring pane appears on the right.
•The window status bar appears in the bottom, right corner and contains icons for preferences, cluster information, resource usage, about information, and help.
Figure 5-1 Admin Serviceability Tool Window
AST Default Configuration
When you initially load AST, it comes with a default configuration called CM-Default. Dynamically created, CM-Default monitors all registered phones in all the Cisco CallManager nodes. If your cluster has five Cisco CallManager nodes configured, CM-Default displays all the registered phones for each node in the Performance Monitoring pane. See Figure 5-2.
Figure 5-2 AST Window with CM-Default Configuration
Customize AST Window
You can customize your AST window to contain any information you need for troubleshooting purposes. See Preferences.
Cluster Information
You can easily view server information (such as active calls, registered phones, and memory usage) of the Cisco CallManager cluster. See the following sections:
•Use the AST Window
•Use the CallMgr Info Button
Use the AST Window
Perform the following procedure to view cluster information from the AST window.
Step 1 Right-click the cluster name or the server folder in the Monitoring Objects pane.
A popup menu displays.
Step 2 Choose Properties.
The CallManager Cluster Information window displays.
Step 3 In the window, click the tab with the server name for which you want information.
Step 4 Click the Update button to view updated information such as uptime or number of active calls.
Step 5 Click the Cancel button to close the window.
Use the CallMgr Info Button
Perform the following procedure to view cluster information from the CallMgr Info button on the AST window status bar.
Step 1 Click the CallMgr Info button located in the AST window status bar (second icon from the right).
The CallManager cluster information window displays.
Step 2 In the window, click the tab with the server name for which you want information.
The CallManager cluster information for that server displays.
Step 3 Click the Update button to view updated information such as uptime or number of active calls.
Step 4 Click the Cancel button to close the window.
Preferences
The Preferences icon located in the AST monitoring window status bar performs the following functions:
•Save, restore, and delete AST configuration preferences.
•Add, edit, and delete Alert Notify settings.
•Configure heartbeat monitoring and polling rates.
The Configuration preference saves the following information:
•Performance monitoring categories including associated counters, counter thresholds, counter alerts, and polling rate.
•Monitored devices categories including search criteria and polling rate.
•Heartbeat monitoring polling settings.
View Preferences
Perform the following procedure to view the AST preferences.
Step 1 Click the Preferences button located in the AST window status bar (first icon on the left).
The Preferences window displays.
Step 2 Click the Configuration tab to view the AST configuration list and description.
Step 3 Click the Alert Notify tab to view the AST alert list and descriptions.
Step 4 Click the OK button to close the window.
Change AST Configuration Display
Perform the following procedure to change the displayed AST configuration.
Step 1 Click the Preferences button located in the AST window status bar (first icon on the left).
The Preferences window displays.
Step 2 Click the Configuration tab in the Preferences window.
The Configuration List displays the configuration options.
Step 3 In the AST monitoring pane, choose the configuration you want to display.
Step 4 Click the Restore button to load the configuration.
Create Configuration Preferences
You can create custom AST windows to aid you in troubleshooting system problems. The customized window may display device or performance monitoring windows, alert notifications for counters and gateway ports, or multiple categories containing various information. See the following sections to create windows, alerts, or categories:
•Category Tabs
•Monitor Performance
•Add a Counter to Monitor
•Configure Alert Notification for Counter
•Add Device to Monitor
•Configure Alert Notification for Gateway
After you have customized your AST window to contain the specific information you need for troubleshooting, you can save it to a configuration preference.
Perform the following procedure to create an AST configuration preference.
Step 1 Click the Preferences button located in the AST window status bar (first icon on the left).
The Preferences window displays.
Step 2 Click the Configuration tab in the window.
The Configuration List displays the configuration options.
Step 3 Click the Save button to save your customized configuration.
Alert Notify
Add, edit, and delete Alert preferences using the Preferences button located in the AST monitoring window status bar. Configure Alert notifications for performance counter value thresholds, schedule for alert checking, and status change of device (for example, port is out of service).
To configure the alert notification for performance counters, see Configure Alert Notification for Counter. To configure the alert notification for gateways, see Configure Alert Notification for Gateway.
Heartbeat
Enable heartbeat monitoring using the Preferences button located in the AST monitoring window status bar. You can configure heartbeat monitoring for one or more Cisco CallManager servers in a cluster.
Perform the following procedure to enable heartbeat monitoring.
Step 1 Click the Preferences button located in the AST window status bar (first icon on the left).
The Preferences window displays.
Step 2 Click the CM Heartbeat tab in the window.
The Enable Heartbeat Monitoring window displays.
Step 3 Check the Enable Monitoring check box.
Step 4 Choose a CallManager server to monitor.
Step 5 Enter time in the polling interval field; for example, 30.
Step 6 Click the down arrow in the drop-down menu.
Step 7 Choose Seconds, Minutes, or Hours.
Step 8 Click the Enable Alert check box if you want an alert sent when the heartbeat for the server is lost.
Step 9 Click the Notify Once check box if you only want one alert sent when the heartbeat for the server is lost.
Note Notify once means AST sends an alert for one heartbeat lost condition. If the heartbeat is lost again, AST sends another alert.
Step 10 Choose the alert you want sent when the heartbeat is lost by clicking the down arrow in the Alert drop-down box.
Note Make sure the alert is previously configured. See Configure Alert Notification for Heartbeat Monitoring, Configure Alert Notification for Counter, or Configure Alert Notification for Gateway.
Step 11 Click the Apply button to activate the heartbeat monitoring.
Click the OK button to close the window without making changes.
Configure Alert Notification for Heartbeat Monitoring
Perform the following procedure to configure the alert notification parameters for heartbeat monitoring.
Step 1 Click the Preferences icon in the status bar.
Step 2 Click the Alert Notify tab.
Step 3 Click the Add button.
The Alert Configuration window displays.
Step 4 Enter the name for the alert in the Alert Name field; for example, CallMgr Hearbeat.
Step 5 Enter the description of the alert in the Alert Description field; for example, the Lost heartbeat for CallMgr number 1.
If you want the alert information sent in an e-mail, continue with the following steps.
If you want the alert to pop up a message, go to Step 14.
Step 6 Click the Email Alert radio button to send the alert as an e-mail.
Step 7 Click the Config MailServer button if this is the first time you are setting up an e-mail notification; otherwise, continue with Step 11.
The Mail Server Configuration window displays.
Step 8 Enter the server name in Server field.
Step 9 Enter the port number in the Port field.
Step 10 Click the OK button.
The window closes, and the Alert Configuration window displays.
Step 11 Enter the e-mail recipient address in the To field.
Step 12 Enter the subject text in the Subj field.
Step 13 Enter information about the alert in the Msg field.
Step 14 Click the Message Popup radio button.
Step 15 Enter the text of the message for the alert; for example, Lost heartbeat.
Step 16 Click the OK button.
The Preferences window displays. The Alert list box displays the alert you added.
Resource Usage
If the system is running slowly, or calls are not getting through, you can view Cisco CallManager resources.
Last 24 hr. Calls
Serviceability monitors calls attempted and calls completed every hour for 24 hours (this is an automatic setting). See the following Note.
Note The Admin Serviceability Tool collects data each hour about calls attempted and completed. The program stores this information in its background. If you click the Update button before the hour of collecting data completes, the information displayed in the window does not change. If the hour of collecting data is complete, the information updates when you click the Update button. For example, if you click the resource usage icon at 7:15, the system displays the calls attempted and completed information at that hour (for example, 7:00). If you click the Update button at 7:30, the system displays the same information as it did at 7:15. If you click the Update button at 8:15, the system displays the updated information about the calls attempted and completed for that hour (for example, 8:00).
Perform the following procedure to view the Cisco CallManager resource usage for calls during the last 24 hours.
Step 1 Click the Resource Usage button located in the AST window status bar (third icon on the left).
The Resource Usage window displays.
Step 2 Click the Last 24 hr. Calls tab to view your system resource usage information.
The window displays the usage information in bar graph form. Two bars display for every hour for the last 24 hours: one for calls attempted, one for calls completed.
Step 3 Click the down arrow in the drop-down menu box.
Step 4 Choose the server for which you want resource usage information.
Step 5 Click the Update button to view updated information.
Step 6 Click the OK button to close the window.
Process Activity
Perform the following procedure to view the Cisco CallManager process activity resource usage.
Step 1 Click the Resource Usage button located in the AST window status bar (third icon on the left).
The Resource Usage window displays.
Step 2 In the window, click the Process Activity tab for which you want resource usage information.
Step 3 Click the down arrow in the drop-down menu box.
Step 4 Choose the server for which you want resource usage information.
Step 5 Click the Update button to view updated information.
Note The information displayed represents the resource usage when you accessed the program (that is, it is static information). To view changes in status (such as processes that have ended or started), click the Update button.
Step 6 Click the OK button to close the window.
About AST
Perform the following procedure to view the AST About information.
Step 1 Click the About button located in the AST window status bar (fourth icon on the left).
The About window displays the following information:
•Product name—Admin Serviceability Tool
•AST Client Version—3.21
•AST Server Version—3.1.0.21
•Third-party libraries:
–JVM by Microsoft Corp.
–JFC by Sun Microsystems
–JCLASS by K&L Group
–Xerces by Apache
Step 2 Click the Version button to view the version of the Cisco CallManager software.
The Version window displays.
Step 3 Click the OK button to close the window.
Help
Perform the following procedure to view the Help information.
Step 1 Click the Help button located in the AST window status bar (last icon).
The Help window displays.
Step 2 Choose the type of help information you want displayed.
Step 3 Click the OK button to close the window.
Heartbeat
The Admin Serviceability Tool monitors the Cisco CallManager heartbeat. When the heartbeat is lost, a blinking icon appears in the AST window status bar. To find out when the heartbeat loss was detected, click the blinking icon. See Figure 5-3.
An e-mail can notify you of the heartbeat loss.
Perform the following procedure to view the Cisco CallManager Heartbeat information.
Step 1 Click the blinking icon in the AST window status bar.
A popup window displays providing the time and node of the lost heartbeat.
Step 2 Click the OK button to close the window.
Figure 5-3 AST Heartbeat Icon
AST Monitoring Pane Options
The following list contains configuration options in the AST monitoring pane:
•Create a new category tab
•Remove a category tab
•Rename a category tab
•Sample Rate
Category Tabs
A category comprises monitored performance counters. A tab in the AST monitoring pane contains the category name. All performance counters monitored in this tab belong to a category. The system polls the performance counters in the tab at the same rate, with each category configured to have its own polling rate.
You can create custom categories in the AST monitoring pane to view information that helps you troubleshoot specific performance or device problems. If your Cisco CallManager system is experiencing performance problems with specific objects, create custom categories to monitor the performance of the counters within the object. If the system is experiencing problems with specific devices, create custom categories to monitor the devices within the cluster. In addition, you can create alert notifications for counters and gateways in these custom categories.
To create custom categories, you add a new category tab. When the tab is created, you specify the specific performance counters, devices, and alerts within that tab and then save your custom category using Preferences.
See the following sections for more information:
•Add a Counter to Monitor
•Configure Alert Notification for Counter
•Add Device to Monitor
•Configure Alert Notification for Gateway
•Preferences
Create a Category
Perform the following procedure to create a new category for the AST performance or device monitoring pane.
Note Up to 15 performance monitoring categories are allowed. Device monitoring categories are unlimited.
Step 1 Right-click any tab in the monitoring pane.
A popup window displays.
Step 2 Choose New Category.
Step 3 Enter the tab name in the tab name field.
Step 4 Check the Present Data in Table View check box to display the performance counters in table format; otherwise, leave box unchecked for chart view.
Note Performance counters display in chart or table view. Device monitors only display in table view.
Step 5 Click the OK button.
A new tab with the name you chose displays.
Step 6 Choose an object or a device in the Monitoring Objects pane. See Add a Counter to Monitor, and Add Device to Monitor.
Remove a Category
Perform the following procedure to remove a category from the performance or device monitoring pane.
Step 1 In the AST monitoring pane, right-click the tab that you want to remove.
A popup window displays.
Step 2 Choose Remove Category.
The tab you removed, along with any counters or devices that displayed in that pane, no longer displays.
Rename a Category
Perform the following procedure to rename a category in the AST performance or device monitoring pane.
Step 1 In the AST monitoring pane, right-click the tab that you want to rename.
A popup window displays.
Step 2 Choose Rename Category.
Step 3 Enter the new name of the tab in the tab name field.
Step 4 Click the OK button.
The tab you renamed displays.
The following examples illustrate creating special AST panes to monitor three Cisco CallManager counters and the gateway devices.
Cisco CallManager Counters Performance Example
In this example, the Cisco CallManager system experiences performance problems with Cisco CallManager objects. You determine that you need to monitor the Calls Attempted, Calls Completed, and Calls In Progress counters. To monitor only those counters, set up special screens in the AST performance monitoring pane. Perform the following example procedure.
Step 1 Click the Performance tab.
Step 2 Right-click any tab in the AST performance monitoring pane.
A popup window displays.
Step 3 Choose New Category.
Step 4 Enter the tab name in the tab name field; for example, CallManager.
A new tab with CallManager in boldface inside displays.
Step 5 Under the Cisco CallManager object in the Monitoring Objects pane, choose the CallsAttempted counter. To make the counter appear in the right pane, double-click the counter name or right-click and choose Add.
The counter displays in the right side of the AST performance monitoring pane in the tab you named CallManager.
Step 6 Repeat Step 5 to add the CallsCompleted and CallsInProgress counters.
Gateway Device Example
In this example, the Cisco CallManager system experiences problems with gateway ports going out of service. You determine that you need to monitor the gateway devices. To monitor this device, set up special screens in the AST device monitoring pane. Perform the following example procedure.
Step 1 Click the Devices tab.
Step 2 Right-click any tab in the AST device monitoring pane.
A popup window displays.
Step 3 Choose New Category.
Step 4 Enter the tab name in the tab name field; for example, gateways.
A new tab with gateways in boldface inside displays.
Step 5 Right-click the gateway device in the Monitoring Objects pane.
Step 6 Choose Monitor from the window.
Step 7 Choose the device status of the gateway.
Step 8 Click the Next > button.
Step 9 Choose the search criteria for the gateway.
Step 10 Click the Next > button.
Step 11 Check the monitoring attributes for the gateway.
Step 12 Click the Finish button.
Step 13 In the AST device monitoring pane, choose a gateway.
Step 14 Right-click the gateway name.
Step 15 Choose Port/Channel Status.
Step 16 View the status of the gateway ports to determine which port is out of service.
Sample Rate
The Cisco CallManager software polls counters, devices, and gateway ports to gather status information. In the AST monitoring pane, you configure the polling intervals for the performance counters, devices, and gateway ports for each category tab you create. For a description of the polling intervals for gateway ports, see Configure Refresh Rate for Gateway.
Note High-frequency polling rate affects Cisco CallManager performance. The minimum polling rate for monitoring a performance counter in chart view is 5 seconds; the minimum rate for monitoring a performance counter in table view is 1 second. Ten seconds is the default for both.
Perform the following procedure to configure the polling interval.
Step 1 In the AST monitoring pane, right-click any tab for which you want to configure the polling interval.
A popup window displays.
Step 2 Choose Sample Rate.
The Polling Rate window displays. You can configure polling rates from 1 second to 24 hours. The default is 10 minutes.
Step 3 Enter a number from 1 to 9 in the polling interval field.
The maximum polling interval is 24 hours, which the system calculates. An error displays if you configure more than 24 hours in the polling interval field.
Step 4 Click the down arrow in the drop-down box.
Step 5 Choose Seconds, Minutes, or Hours from the drop-down menu.
Step 6 Click the OK button.
Performance Counters Table View/Chart View
The Cisco CallManager software displays performance counters in chart or table format. Chart format looks like a miniature screen of information. Up to six charts display in the AST performance monitoring pane for each category tab you create. Because chart view is the default, you configure the performance counters to display in table format when you create a category.
Perform the following procedure to configure table format for the performance monitoring pane.
Step 1 Right-click any tab in the performance monitoring pane.
A popup window displays.
Step 2 Choose New Category.
Step 3 Enter the tab name in the tab name field.
Step 4 Check the Present Data in Table View check box to display the performance counters in table format; otherwise, leave box unchecked for chart view.
Step 5 Click the OK button.
A new tab with the name you chose displays.
Step 6 Choose an object in the Monitoring Objects pane. See Add a Counter to Monitor.
Re-Select
To change the contents of the device monitoring pane without going to the device name in the Monitoring Objects pane, use the Re-Select option. Perform the following procedures to change the contents of the device monitoring pane.
Step 1 Right-click any tab in the AST device monitoring pane.
A popup window displays.
Note This procedure works only when device information displays; otherwise, the system shows the Re-Select option as grayed out.
Step 2 Choose Re-Select.
The Select Device to Monitor window displays. You can now check or uncheck the appropriate check boxes, or you can navigate backward or forward within the window.
Step 3 Click the Finish button when your changes are complete; otherwise, click the Cancel button.
The AST device monitoring pane displays the changed information.
Monitor Performance
You monitor the performance of the Cisco CallManager software by selecting the counters for any object. The counters for each object display when the folder is expanded.
Add a Counter to Monitor
To troubleshoot system performance problems, you add the counter associated with the performance object to the AST performance monitoring pane, which displays a chart for the counter. Before you add counters, see Load Admin Serviceability Tool, and Category Tabs.
Category tabs contain up to six performance counter charts.
Perform the following procedures to add a counter to the AST performance monitoring pane.
Note To choose a counter, double-click the name, right-click the name, or drag the counter and drop it in the performance monitoring pane. A double-click displays the counter information in chart format in the AST performance monitoring pane. A right-click opens a menu and displays the Add option; choose Add to display the counter information in the AST performance monitoring pane. In the following procedure, use any method to choose a device.
Note You can display up to three counters in one chart in the AST performance monitoring pane. To add three counters in one chart, click the counter and drag it to the AST performance monitoring pane. Repeat for each counter.
Step 1 Click the file icon next to the server name.
The file icon opens, and a list of objects displays.
Step 2 Click the file icon next to the object name that contains the counters you want to monitor.
The object icon opens, and a list of counters displays.
Step 3 Choose the counter you want to monitor.
Step 4 Right-click the counter name.
Step 5 Click the Add button.
The counter displays in the AST performance monitoring pane.
Configure Alert Notification for Counter
Cisco CallManager notifies you of system problems using the alert notification feature. Perform the following configuration setup to activate alert notifications for a system counter:
•Choose the system performance counter from the AST performance monitoring pane.
•Set up an e-mail or a message popup window for alert notification.
•Determine the threshold for the alert (for example, an alert activates when Calls in progress exceed the threshold of over 100 calls, or under 50 calls).
•Determine the frequency of the alert notification (for example, the alert occurs once or every hour). See Table 5-1.
•Determine the schedule for when the alert activates (for example, on a daily basis or at certain times of the day). See Table 5-1.
Perform the following procedure to configure the alert notification parameters for a counter.
Step 1 In the AST performance monitoring pane, right-click the counter displayed for which you want to configure the alert notification.
Step 2 Choose Alert/Threshold.
The Counter Alert Configuration window displays.
Step 3 Click the Configuration button.
The Preferences window displays the Alert Notify and Description information.
Step 4 Click the Add button.
The Alert Configuration window displays.
Step 5 Enter the name for the alert in the Alert Name field; for example, HeartBeat counter.
Step 6 Enter the description of the alert in the Alert Description field; for example, the HeartBeat counter is performing slowly.
If you want the alert information sent in an e-mail, continue with the following steps.
If you want the alert to pop up a message, go to Step 15.
Step 7 Click the Email Alert radio button to send the alert as an e-mail.
Step 8 If this is the first time you are setting up an email notification, click the Config MailServer button; otherwise, continue.
The Mail Server Configuration window displays.
Step 9 Enter the server name in Server field.
Step 10 Enter the port number in the Port field.
Step 11 Click the OK button.
The window closes, and the Alert Configuration window displays.
Step 12 Enter the e-mail recipient address in the To field.
Step 13 Enter the subject text in the Subj field.
Step 14 Enter information about the alert in the Msg field. Go to Step 17.
Step 15 Click the Message Popup radio button.
Step 16 Enter the text of the message for the alert; for example, HeartBeat is too slow.
Step 17 Click the OK button.
The Counter Alert Configuration window displays. The Alert selection drop-down box displays the alert you added.
Step 18 If you want the alert threshold to be over a certain value, check the Over check box.
Step 19 Enter a value in the Over value field. For example, enter a value that is the number of calls in progress.
Note Use the Over check box in conjunction with the Frequency and Schedule configuration parameters.
Step 20 If you want the alert threshold to be under a certain value, check the Under check box.
Step 21 Enter a value in the Under value field. For example, enter a value that is the number of calls in progress.
Note Use the Under check box in conjunction with the Frequency and Schedule configuration parameters.
Step 22 Click the Next > button.
The Frequency and Schedule window of the Counter Alert Configuration displays.
Step 23 If you want the alert notification activated only once when the threshold is met, click the Once radio button.
For example, if you set the threshold to be Over 100 calls in progress and Under 50 calls in progress, the system sends an alert when the thresholds of either more than 100 calls in progress take place or under 50 calls in progress take place.
Note Once eliminates Every as an option.
If the calls in progress continue to go over or under the threshold, the system does not send another alert notification. When the threshold is normal (between 50 and 100 calls in progress), the system deactivates the alert notification. However, if the threshold should go over or under the threshold value again, the system reactivates alert notification.
Step 24 If you want the alert notification activated at certain intervals, click the Every radio button.
Note Every eliminates Once as an option.
Step 25 Enter a value in the Every field (for example 10).
Step 26 Click the down arrow of the Every drop-down menu to select the interval for the value you entered in Step 25.
Step 27 Choose seconds, minutes, or hours (for example, every 10 minutes).
For example, if you set the threshold to be Over 100 calls in progress and Under 50 calls in progress, the system checks the counter value every 10 minutes to determine whether it is under or over the thresholds of either more than 100 calls in progress take place or under 50 calls in progress take place. If the counter value exceeds the thresholds, the system activates an alert notification.
Step 28 If you want the counter to be checked on a daily basis, check the Daily Task check box. If this check box is checked, continue; otherwise, go to either Step 33 if you want the counter to be checked immediately or to Step 35 if you want the counter to be checked at a specific time and day.
Note The start and stop time date field does not display if the Daily Task check box is checked.
Step 29 Click the start time At radio button to set the time when the system should start checking the value of the counter threshold.
Step 30 Enter a start time for the Daily Task.
Step 31 Click the stop time At radio button to set the time when the system should stop checking the value of the counter threshold.
Step 32 Enter a stop time for the Daily Task.
Step 33 If you want to begin checking the counter immediately, click the Now radio button.
Step 34 If you always want the counter to be checked, click the Never stop radio button.
Step 35 Click the start time and stop time At radio buttons to configure the counter to be checked at certain times of the day.
Step 36 Enter the date of the start and stop times.
Step 37 Click the Activate button.
Note If you want to change any alert configuration information, click the < Back button or the Cancel button.
Figure 5-4 provides an example of an alert e-mail sent to the system administrator when the RegisteredPhones was below the low threshold.
Table 5-1 provides a description of the counter alert configuration parameters.
Figure 5-4 Alert Notification E-Mail
Table 5-1 Counter Alert Configuration Parameters
Parameter
|
Description
|
Over
|
Check this check box to configure a maximum threshold that must be met before an alert notification is activated. The value entered in this check box field associates with the counter type (for example, Calls in progress).
|
Under
|
Check this check box to configure a minimum threshold that must be met before an alert notification is activated. The value entered in this check box field associates with the counter type (for example, Calls in progress).
|
Frequency
|
The Once option configures the alert notification to activate once when either the under or over counter threshold is exceeded.
The Every option configures the system to check the value of the counter threshold at specific intervals and to determine whether an alert notification should activate. The Every option values range from 1 to 99 seconds, minutes, or hours.
|
Daily Task
|
Check the Daily Task check box if the system is to check the value of the counter threshold every day. If the check box is checked, enter the start and stop times of the daily task. For example, you can configure the counter to be checked every day from 9:00 am to 5:00 pm or from 9:00 pm to 9:00 am.
|
Now
|
Click the Now radio button if the system is to check the value of the counter threshold immediately.
|
Never stop
|
Click the Never stop radio button if the system is to always check the value of the counter threshold.
|
Start time
|
Click the At radio button in the start time to configure a time for the system to start checking the counter threshold. If the Daily Task check box is not checked, enter a date in the date field.
|
Stop time
|
Click the At radio button in the stop time to configure a time for the system to stop checking the counter threshold. If the Daily Task check box is not checked, enter a date in the date field.
|
Zoom Counter
To get a closer look at performance monitors, zoom the monitor counter in the AST performance monitoring pane.
Perform the following procedure to zoom the monitoring information for a counter.
Step 1 In the AST performance monitoring pane, right-click the counter for which you want to zoom.
Step 2 Choose Zoom.
The Zoom window displays.
Step 3 The minimum, maximum, average, and last fields show the values for the counter since the monitoring began for the counter.
Step 4 Click the OK button to close the window.
Remove a Counter From Monitor
You remove counters from the AST performance monitoring pane when they are no longer needed.
Perform the following procedure to remove a counter from the window.
Step 1 In the AST performance monitoring pane, right-click the counter that you want to remove.
Step 2 Choose Remove.
The counter no longer displays in the window.
Counter Properties
Counter properties provides two capabilities: display a description of the counter and configure data sampling parameters.
Property Description
Use one of two ways to obtain a description of the counter:
•In the monitoring objects pane, right-click the counter to display only the description of the counter.
•In the AST performance monitoring pane, right-click the counter chart to display the description and configure the data sampling parameters.
Perform the following procedure to display the counter property description.
Step 1 In the AST performance monitoring pane or in the monitoring objects pane, right-click the counter for which you want property information.
Step 2 Choose Properties.
The Counter Property window displays the description of the counter. The description includes the host address, the object to which the counter belongs, the counter name, and a brief overview of what the counter does.
Step 3 Click the OK button to close the Counter Property window.
Data Sample
The Counter Property window contains the option to configure data samples for a counter. The performance counters displayed in the AST performance monitoring pane contain green dots representing samples of data over a period of time. You can configure the number of data samples to collect and the number of data points to show in the chart. After the data sample is configured, view the information by using the View All Data/View Current Data menu selection. See View Data for a Monitor.
Perform the following procedure to configure the number of data samples to collect for a counter.
Step 1 In the AST performance monitoring pane, right-click the counter for which you want property information.
Step 2 Choose Properties.
The Counter Property window displays the description of the counter. The description includes the host address, the object to which the counter belongs, the counter name, and a brief overview of what the counter does.
Step 3 Click the Data Sample tab to configure the number of data samples for the counter.
Step 4 Click the down arrow of the No. of data samples drop-down menu.
Step 5 Choose the number of samples (between 100 and 1000). The default is 100.
Step 6 Click the down arrow of the No. of data points shown on chart drop-down menu.
Step 7 Choose the number of data points to show on the chart (between 10 and 50). The default is 20.
Step 8 Click the Absolute radio button to display current counter value or click the Delta radio button to display the difference between the current counter value and the previous counter value.
Note Because some counters values are accumulative (for example, CallsAttempted or CallsCompleted), to display the data at its current status, choose Absolute. To display the difference between the current counter value and the previous counter value, choose Delta.
Step 9 Click the OK button to close the Counter Property window and return to the AST performance monitoring pane.
View Data for a Monitor
Use this view data for a monitor option to view the data collected for a performance counter. See Counter Properties, for a description of data sample configuration.
Perform the following procedure to view all and current data for a performance counter.
Step 1 In the AST performance monitoring pane, right-click the counter for which you want to view data samples.
Step 2 Choose View All Data.
The counter chart displays all data that has been sampled. The green dots appear very close together, almost forming a solid line.
Step 3 Right-click the counter currently displayed.
Step 4 Choose View Current Data.
The counter chart displays the last configured data samples collected. See the Counter Properties, procedure for configuring data samples.
Monitor Devices
The Cisco CallManager Admin Serviceability Tool monitors device activity for the following items:
•Phone (includes Cisco IP SoftPhone)
•Gateway
•Media resource manager (used for conference bridge, media termination point, and music on hold)
•H.323 devices
•CTI
•Voice mail
AST monitors the following device information in real time:
•Name
•Directory number
•IP address
•Model name
•Status
•Node name
•Status reason
•Time and date
Device Monitoring Pane
The device monitoring pane displays device status information in table format. Use the procedure, Add Device to Monitor, to display device status in the device monitoring pane.
The device monitoring pane table supports a right-click context menu for each device as follows:
•The phone and Cisco IP SoftPhone devices support two menu choices: open the device configuration window and display the device description.
•The gateway device supports three menu choices: open the device configuration window, display the port/channel status information, and display the device description.
•The H.323 device supports one menu choice: display the device description.
All devices contain a description menu choice and devices that have a built-in HTTP server contain an open menu choice.
Add Device to Monitor
Perform the following procedure to add a device to the device monitoring pane.
Note To choose a device, double-click the name or right-click the name. A double-click opens the Select Device to Monitor window. A right-click displays the Monitor option, which must be chosen to display the Select Device to Monitor window. In the following procedure, use either method to choose a device.
Step 1 Choose a device in the Monitoring Objects pane; for example, Gateway.
The Select Device to Monitor window displays.
Tips To monitor all devices in the Cisco CallManager cluster, right-click the cluster name and choose Monitor; continue with the following steps.
Step 2 Click one of the following radio buttons:
•Registered
•Deregistered
•Rejected
•Any Status
•Device only configured in database
The drop-down box displayed to the right of the radio button highlights.
Step 3 Click the down arrow in the drop-down box.
The menu list displays.
Step 4 Choose the appropriate Cisco CallManager server for which you want the device information to display.
Note In the remaining steps, you can choose the < Back, Next >, Finish, or Cancel buttons. The procedure uses the button that completes the procedure.
Step 5 Click the Next > button.
A window with search criteria displays.
Step 6 Click one of the following radio buttons:
•Any name/address
•Directory Number
•Device Name
•Device Description
•IP Address
•IP Subnet (IP and Mask fields)
Step 7 Enter the information in the field for the radio button that you clicked; for example, if you clicked the Directory Number radio button, enter the directory number in the field.
Step 8 Click the Next > button.
A window with the monitoring attributes fields displays.
Step 9 Check the check box for the information you want to display.
Step 10 Click the Finish button.
The device monitoring pane displays the information that you chose.
View Phone Information
You can view information about phones displayed in the AST device monitoring pane. Perform the following procedure to view phone information.
Step 1 See Add Device to Monitor, to display the phone in the AST device monitoring pane.
Step 2 Choose the phone for which you want information.
Step 3 Right-click the mouse button.
A popup menu displays.
Step 4 Choose Open.
The Device Information window displays. See Figure 5-5. For more information on the device, choose any field displayed in the left pane of the window.
Figure 5-5 Device Information Window
View Device Description
You can view the descriptions of devices that display in the AST device monitoring pane. Perform the following procedure to view device descriptions.
Step 1 Perform the procedure to display the device in the AST device monitoring pane. See Add Device to Monitor.
Step 2 Choose the device for which you want the description.
Step 3 Right-click the mouse button.
A popup menu displays.
Step 4 Choose Description.
The Device Description window displays.
View Gateway Channel Status
You can view the status of any gateway that displays in the AST device monitoring pane. Perform the following procedure to view gateway status.
Step 1 Perform the procedure to display the gateway in the AST device monitoring pane. See Add Device to Monitor.
Step 2 Choose the gateway for which you want information.
Step 3 Right-click the mouse button.
A popup menu displays.
Step 4 Choose Port/Channel Status. See Table 5-2.
The Port Status window displays the port number, the port type, and the port status of the gateway.
Table 5-2 Gateway Status
Gateway Type
|
Status
|
Analog
|
Busy
Idle
Out of Service
|
Digital D channel
|
In Service
Out of Service
|
Digital B channel
|
Busy
Idle
Out of Service
|
Configure Alert Notification for Gateway
Cisco CallManager uses the Alert Notification feature to notify you of gateway port problems. Perform the following configuration setup to activate alert notifications for a gateway and its ports:
•Choose the gateway from the AST device monitoring pane.
•Set up an e-mail or a message popup window for alert notification.
•Determine the frequency of the alert notification (for example, will the alert be sent once or every hour). See Table 5-3.
•Determine the schedule for the alert to activate (for example, on a daily basis or at certain times of the day). See Table 5-3.
Perform the following procedures to configure the alert notification parameters for a gateway.
Step 1 In the AST device monitoring pane, right-click the gateway that you want to configure the alert notification.
Step 2 Choose Port/Channel Status.
The Port Status window displays.
Step 3 Click the Alert button.
The Port Status Alert Configuration window displays.
Step 4 Click the Configuration button.
The Preferences window displays the Alert Notify and Description information.
Step 5 Click the Add button.
The Alert Configuration window displays.
Step 6 Enter the name for the alert in the Alert Name field; for example, Out of Service.
Step 7 Enter the description of the alert in the Alert Description field; for example, port 2 is bad.
If you want the alert information sent in an e-mail, continue with the following steps.
If you want the alert to pop up a message, go to Step 16.
Step 8 Click the Email Alert radio button to send the alert as an e-mail.
Step 9 If this is the first time you are setting up an e-mail notification, click the Config MailServer button; otherwise, continue.
The Mail Server Configuration window displays.
Step 10 Enter the server name in Server field.
Step 11 Enter the port number in the Port field.
Step 12 Click the OK button.
The window closes, and the Alert Configuration window displays.
Step 13 Enter the e-mail recipient address in the To field.
Step 14 Enter the subject text in the Subj field.
Step 15 Enter information about the alert in the Msg field. Go to Step 18.
Step 16 Click the Message Popup radio button.
Step 17 Enter the text of the message for the alert; for example, Port 2 is Out of Service.
Step 18 Click the OK button.
The Port Status Alert Configuration window displays. The alert you added displays in the Alert selection drop-down box.
Step 19 Click the All Ports or Selected Ports radio button in the Monitor "Out of Service" state window.
If you choose All Ports, the system monitors all ports in the gateway for an out-of-service state. If you choose Selected Ports, you must choose which port you want monitored by clicking on that port field. To choose multiple ports, hold the Shift key while clicking the port fields.
Step 20 Click the Next > button.
The Frequency and Schedule window of the Port Status Alert Configuration displays.
Step 21 If you want the alert notification activated only once when the port is out of service, click the Once radio button.
Step 22 If you want the alert notification activated at certain intervals, click the Every radio button.
Step 23 Enter a value in the Every field (for example 10).
Step 24 Click the down arrow of the Every drop-down menu to select the interval for the value you entered in Step 23.
Step 25 Choose seconds, minutes, or hours (for example, every 10 minutes).
For example, the system checks the port status every 10 minutes to determine whether it is out of service. If it is, the system activates an alert notification.
Step 26 If you want the port status to be checked on a daily basis, check the Daily Task check box. If this check box is checked, continue; otherwise; go to either Step 31 if you want the counter to be checked immediately or to Step 33 if you want the counter to be checked at a specific time and day.
Note The start and stop time date field does not display if the Daily Task check box is checked.
Step 27 Click the start time At radio button to set the time when the system should start checking the port status.
Step 28 Enter a start time for the Daily Task.
Step 29 Click the stop time At radio button to set the time when the system should stop checking the port status.
Step 30 Enter a stop time for the Daily Task.
Step 31 If you want to begin checking the port status immediately, click the Now radio button.
Step 32 If you always want the port status to be checked, click the Never stop radio button.
Step 33 Click the start time and stop time At radio buttons to configure the port status to be checked at certain times of the day.
Step 34 Enter the date of the start and stop times.
Step 35 Click the Activate button.
Note If you want to change any alert configuration information, click the < Back button or the Cancel button.
Table 5-3 Gateway Alert Configuration Parameters
Parameter
|
Description
|
Frequency
|
The Once option configures the alert notification to activate once when the assigned port goes out of service.
The Every option configures the system to check the status of the gateway ports at specific intervals and to determine whether an alert notification should activate. The Every option values range from 1 to 99 seconds, minutes, or hours.
|
Daily Task
|
Check the Daily Task check box if the system is to check the status of the gateway ports every day. If the check box is checked, enter the start and stop times of the daily task. For example, you can configure the gateway port status to be checked every day from 9:00 am to 5:00 pm or from 9:00 pm to 9:00 am.
|
Now
|
Click the Now radio button if the system is to check the gateway port status immediately.
|
Never stop
|
Click the Never stop radio button if the system is to always check the gateway port status.
|
Start time
|
Click the At radio button in the start time to configure a time for the system to start checking the gateway port status. If the Daily Task check box is not checked, enter a date in the date field.
|
Stop time
|
Click the At radio button in the stop time to configure a time for the system to stop checking the gateway port status. If the Daily Task check box is not checked, enter a date in the date field.
|
Configure Refresh Rate for Gateway
The Cisco CallManager software polls counters, devices, and gateway ports to gather status information. In the AST monitoring pane, you configure the polling intervals for the performance counters, devices, and gateway ports for each category tab you create. For a description of polling intervals for performance counters, see Sample Rate.
Perform the following procedure to configure the polling interval.
Step 1 Right-click any gateway in the AST device monitoring pane.
A popup window displays.
Step 2 Choose Port/Channel Status.
The Port Status window displays.
Step 3 Click the Refresh Rate button.
The Polling Rate window displays.
Step 4 Enter a number from 1 to 99999999 in the polling interval field. The default is 10 seconds.
Step 5 Click the down arrow in the drop-down box.
Step 6 Choose Seconds, Minutes, or Hours from the drop-down menu.
Step 7 Click the OK button.
Feedback
