Downloads |
Table Of Contents
Gatekeeper Management Statistics
Prerequisites for Gatekeeper Management Statistics
Restrictions for Gatekeeper Management Statistics
Information About Gatekeeper Management Statistics
How to Monitor Gatekeeper Management Statistics
Monitoring Gatekeeper Management Statistics
Verifying Examples for Gatekeeper Management Statistics
Verifying Gatekeeper Management Statistics Example
show gatekeeper performance stats
Gatekeeper Management Statistics
The Gatekeeper Management Statistics feature adds support for gatekeeper performance management parameters that provide statistics that may be used to monitor a network and troubleshoot problems on the network.
Feature Specifications for Gatekeeper Management Statistics
Determining Platform Support Through Cisco Feature Navigator
Cisco IOS software is packaged in feature sets that are supported on specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Cisco Feature Navigator is a web-based tool that enables you to quickly determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common.
To access Cisco Feature Navigator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:
Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. For the most current information, go to the Cisco Feature Navigator home page at the following URL:
Availability of Cisco IOS Software Images
Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or Cisco Feature Navigator.
Contents
•
Prerequisites for Gatekeeper Management Statistics
•
•
•
•
Prerequisites for Gatekeeper Management Statistics
•
•
Restrictions for Gatekeeper Management Statistics
The SNMP objects are supported only in Cisco gatekeeper images (for example, ix and jsx).
Information About Gatekeeper Management Statistics
To access gatekeeper management statistics, you must understand the performance management parameter concept. Performance management parameters provide gatekeeper management statistics that may be used to monitor a network and troubleshoot problems on the network.
The statistics are counted when the Registration, Admission, and Status (RAS) messages are sent and received by the gatekeeper. The statistics are in raw form and reflect only a count of messages. Retries or retransmissions are not counted.
Gatekeeper performance management parameters provide statistics, such as the following:
•
•
•
•
•
•
How to Monitor Gatekeeper Management Statistics
The section includes the following task:
•
Monitoring Gatekeeper Management Statistics
There are two ways to monitor gatekeeper management statistics that are the following:
•
•
SUMMARY STEPS
1.
2.
3.
4.
DETAILED STEPS
Verifying Examples for Gatekeeper Management Statistics
This section provides the following verifying example:
•
Verifying Gatekeeper Management Statistics Example
The following is sample output from the show gatekeeper performance stats command. The output displays BASIC gatekeeper management statistics.
Router# show gatekeeper performance stats-----Gatekeeper Performance Statistics-----Performance statistics captured since: 00:17:00 UTC Mon Mar 1 1993Gatekeeper level Admission Statistics:ARQs received: 1ARQs received from originating endpoints: 0ACFs sent: 1ACFs sent to the originating endpoint: 0ARJs sent: 0ARJs sent to the originating endpoint: 0ARJs sent due to overload: 0Number of concurrent calls: 0Number of concurrent originating calls: 0Gatekeeper level Location Statistics:LRQs received: 1LRQs sent: 0LCFs received: 0LCFs sent: 1LRJs received: 0LRJs sent: 0LRJs sent due to overload: 0Gatekeeper level Registration Statistics:RRJ due to overload: 0Total Registered Endpoints: 1Gatekeeper level Disengage Statistics:DRQs received: 1DRQs sent: 0DCFs received: 0DCFs sent: 1DRJs received: 0DRJs sent: 0Load balancing events: 0The following CUMULATIVE sample output is the same as for BASIC output; the difference is that the BASIC counters are cleared by the clear h323 gatekeeper statistics command, and CUMULATIVE counters are not.
Router# show gatekeeper performance stats zone name voip3-2600-2Performance statistics for zone voip3-2600-2-----Zone Level Performance Statistics-----Performance statistics captured since: 00:17:00 UTC Mon Mar 1 1993Zone level Admission Statistics:ARQs received: 1ARQs received from originating endpoints: 0ACFs sent: 1ACFs sent to the originating endpoint: 0ARJs sent: 0ARJs sent to the originating endpoint: 0Number of concurrent total calls: 0Number of concurrent originating calls: 0Zone level Location Statistics:LRQs received: 1LRQs sent: 0LCFs received: 0LCFs sent: 1LRJs received: 0LRJs sent: 0Zone level Registration Statistics:Full RRQs received: 1Light RRQs received: 574RCFs sent: 576RRJs sent: 0Total Registered Endpoints: 1Zone level UnRegistration Statistics:URQs received: 0URQs sent: 0UCFs received: 0UCFs sent: 0URJs received: 0URJs sent: 0URQs sent due to timeout: 0Zone level Disengage Statistics:DRQs received: 1DRQs sent: 0DCFs received: 0DCFs sent: 1DRJs received: 0DRJs sent: 0Additional References
The following sections provide additional references related to the Gatekeeper Management Statistics feature:
•
•
Related Documents
Gatekeepers and H.323
The chapters "Configuring H.323 Gatekeepers" and "H.323 Applications" in Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2
MIBs and SNMP
The chapter "Configuring SNMP Support" in "FC: Part 3: System Management" in Cisco IOS Configuration Fundamentals Configuration Guide, Release 12.2
Standards
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.
—
MIBs
•
To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
1 Not all supported MIBs are listed.
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:
http://tools.cisco.com/ITDIT/MIBS/servlet/index
If Cisco MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco MIBs page at the following URL:
http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:
RFCs
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature.
—
Technical Assistance
Command Reference
This section documents one modified command. All other commands used with this feature are documented in the Cisco IOS Release 12.2 T command reference publications.
Modified Command
•
show gatekeeper performance stats
To display information about the number of calls accepted and rejected, the number of endpoints sent to other gatekeepers, and statistics per-zone level, use the show gatekeeper performance stats command in privileged EXEC mode
show gatekeeper performance stats [zone [name zone-name]] [cumulative]
Syntax Description
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Use this command to display the number of calls accepted, the number of calls rejected because of overload, and the number of endpoints sent to other gatekeepers.
When you enter this command, statistical data that relates to the router is displayed. You can identify the number of call initiation events using the following:
•
•
•
You can identify gatekeeper-level and zone-level disengage statistics using the following:
•
•
•
You can identify endpoint contact events that have been requested and either confirmed or rejected on the router using the following:
•
•
•
You can identify zone-level registration statistics using the following:
•
•
•
You can identify zone-level unregistration statistics using the following:
•
•
•
The counts associated with overload and the number of endpoints sent to alternate gatekeepers that are associated with overload conditions are also displayed. Only when the router experiences an overload condition do these counters reveal a value other than zero. The real endpoint count simply displays the number of endpoints registered on this router platform. The time stamp displays the time when the counters started capturing the data. When you want to request a new start period, enter the clear h323 gatekeeper statistics command. The counters are reset, and the time stamp is updated with the new time.
Statistics per zone-level can also be shown.
Examples
The following is sample BASIC output from the show gatekeeper performance stats command:
Router# show gatekeeper performance stats-----Gatekeeper Performance Statistics-----Performance statistics captured since: 00:17:00 UTC Mon Mar 1 1993Gatekeeper level Admission Statistics:ARQs received: 1ARQs received from originating endpoints: 0ACFs sent: 1ACFs sent to the originating endpoint: 0ARJs sent: 0ARJs sent to the originating endpoint: 0ARJs sent due to overload: 0Number of concurrent calls: 0Number of concurrent originating calls: 0Gatekeeper level Location Statistics:LRQs received: 1LRQs sent: 0LCFs received: 0LCFs sent: 1LRJs received: 0LRJs sent: 0LRJs sent due to overload: 0Gatekeeper level Registration Statistics:RRJ due to overload: 0Total Registered Endpoints: 1Gatekeeper level Disengage Statistics:DRQs received: 1DRQs sent: 0DCFs received: 0DCFs sent: 1DRJs received: 0DRJs sent: 0The following CUMULATIVE sample output is the same as for BASIC output; the difference is that the BASIC counters are cleared by the clear h323 gatekeeper statistics command and CUMULATIVE counters are not.
Router# show gatekeeper performance stats zone name voip3-2600-2Performance statistics for zone voip3-2600-2-----Zone Level Performance Statistics-----Performance statistics captured since: 00:17:00 UTC Mon Mar 1 1993Zone level Admission Statistics:ARQs received: 1ARQs received from originating endpoints: 0ACFs sent: 1ACFs sent to the originating endpoint: 0ARJs sent: 0ARJs sent to the originating endpoint: 0Number of concurrent total calls: 0Number of concurrent originating calls: 0Zone level Location Statistics:LRQs received: 1LRQs sent: 0LCFs received: 0LCFs sent: 1LRJs received: 0LRJs sent: 0Zone level Registration Statistics:Full RRQs received: 1Light RRQs received: 574RCFs sent: 576RRJs sent: 0Total Registered Endpoints: 1Zone level UnRegistration Statistics:URQs received: 0URQs sent: 0UCFs received: 0UCFs sent: 0URJs received: 0URJs sent: 0URQs sent due to timeout: 0Zone level Disengage Statistics:DRQs received: 1DRQs sent: 0DCFs received: 0DCFs sent: 1DRJs received: 0DRJs sent: 0Table 1 describes significant fields shown in the displays. Most of the fields are self-explanatory and are not listed the table.
Related Commands
clear h323 gatekeeper statistics
Clears statistics about gatekeeper performance.
Glossary
ACF—admission confirmation message.
ARJ—admission rejection message.
ARQ—admission request message.
CLI—command-line interface.
DCF—disengage confirmation message.
DRJ—disengage rejection message.
DRQ—disengage request message.
LCF—location confirmation message.
LRJ—location rejection message.
LRQ—location request message.
MIB—A module that consists of a repository of characteristics and parameters that support the function of a gatekeeper. The MIB gathers statistics and responds to queries as specified by the Simple Network Management Protocol (SNMP).
OIDs—object identifiers. OIDs are collections of managed identifiers and part of a MIB. The OIDs can configure, manage, or analyze aspects of the SNMP operations.
RAS—Registration, Admission, and Status protocol. RAS is a protocol that is used between endpoints and the gatekeeper to perform management functions. RAS signaling function performs registration, admissions, bandwidth changes, status, and disengage procedures between the Voice over IP (VoIP) gateway and the gatekeeper.
SNMP—Simple Network Management Protocol. A SNMP is an application-layer protocol that provides a message format for communication between SNMP managers and agents. SNMP provides a standardized framework and a common language used for the monitoring and management of devices in a network.
TAC—Cisco Technical Assistance Center.
UCF—unregistration confirmation message.
URJ—unregistration rejection message.
URQ—unregistration request message.
Note
