SNMP Management Information Base

SNMP allows access to Management Information Base (MIB), which is a collection of information that is organized hierarchically. MIBs comprise managed objects, which are identified by object identifiers. A MIB object, which contains specific characteristics of a managed device, comprises one or more object instances (variables).

The SNMP interface provides these Cisco Standard MIBs:

Observe the following limitations:

The SNM) extension agent resides in the server and exposes the CISCO-CCM-MIB, which provides detailed information about devices that are known to the server. In the case of a cluster configuration, the SNMP extension agent resides in each server in the cluster. The CISCO-CCM-MIB provides device information such as device registration status, IP address, description, and model type for the server (not the cluster, in a configuration that supports clusters).

The SNMP interface also provides these Industry Standard MIBs:

CISCO-CDP-MIB

Use the CDP subagent to read the Cisco Discovery Protocol MIB, CISCO-CDP-MIB. This MIB enables the SNMP managed device to advertise themself to other Cisco devices on the network.

The CDP subagent implements the CDP-MIB. The CDP-MIB contains the following objects:


Note

The CISCO-CDP-MIB is dependent on the presence of the following MIBs: CISCO-SMI, CISCO-TC, CISCO-VTP-MIB.

SYSAPPL-MIB

Use the System Application Agent to get information from the SYSAPPL-MIB, such as installed applications, application components, and processes that are running on the system.

System Application Agent supports the following object groups of SYSAPPL-MIB:

SYSAPPL-MIB Commands

Command

Description
Device-Related Queries
sysApplInstallPkgVersion Provides the version number that the software manufacturer assigned to the application package.
sysApplElmPastRunUser Provides the process owner's login name (for example, root).
Memory, Storage, and CPU-Related Queries
sysApplElmPastRunMemory Provides the last-known total amount of real system memory measured in kilobytes that was allocated to this process before it terminated.
sysApplElmtPastRunCPU Provides the last known number of centi-seconds of the total system CPU resources consumed by this process.
Note   

On a multiprocessor system, this value may increment by more than one centi-second in one centi-second of real (wall clock) time.
sysApplInstallElmtCurSizeLow Provides the current file size modulo 2^32 bytes. For example, for a file with a total size of 4,294,967,296 bytes this variable would have a value of 0; for a file with a total size of 4,294,967,295 bytes this variable would be 4,294,967,295.
sysApplInstallElmtSizeLow Provides the installed file size modulo 2^32 bytes. This is the size of the file on disk immediately after installation. For example, for a file with a total size of 4,294,967,296 bytes this variable would have a value of 0; for a file with a total size of 4,294,967,295 bytes this variable would be 4,294,967,295.
sysApplElmRunMemory Provides the total amount of real system memory, measured in kilobytes, that is currently allocated to this process.
sysApplElmRunCPU Provides the number of centi-seconds of the total system CPU resources consumed by this process.
Note   

On a multiprocessor system, this value may have been incremented by more than one centi-second in one centi-second of real (wall clock) time.
Process-Related Queries
sysApplElmtRunState Provides the current state of the running process. The possible values are running(1), runnable(2) but waiting for a resource such as CPU, waiting(3) for an event, exiting(4), or other(5).
sysApplElmtRunNumFiles Provides the number of regular files currently opened by the process. Transport connections (sockets) should not be included in the calculation of this value, nor should operating-system-specific special file types.
sysApplElmtRunTimeStarted Provides the time the process was started.
sysApplElmtRunMemory Provides the total amount of real system memory, measured in kilobytes, that is currently allocated to this process.
sysApplElmtPastRunInstallID Provides the index into the installed element table. The value of this object is the same value as the sysApplInstallElmtIndex for the application element of which this entry represents a previously executed process.
sysApplElmtPastRunUser Provides the process owner's login name (for example, root).
sysApplElmtPastRunTimeEnded Provides the time the process ended.
sysApplElmtRunUser Provides the process owner's login name (for example, root).
sysApplRunStarted Provides the date and time that the application was started.
sysApplElmtRunCPU Provides the number of centi-seconds of the total system CPU resources consumed by this process.
Note   

On a multiprocessor system, this value may have been incremented by more than one centi-second in one centi-second of real (wall clock) time.
Software Component-Related Queries
sysApplInstallPkgProductName Provides the name that the manufacturer assigned to the software application package.
sysApplElmtRunParameters Provides the starting parameters for the process.
sysApplElmtRunName Provides the full path and filename of the process. For example, '/opt/MYYpkg/bin/myyproc' would be returned for process 'myyproc' whose execution path is 'opt/MYYpkg/bin/myyproc'.
sysApplInstallElmtName Provides the name of this element, which is contained in the application.
sysApplElmtRunUser Provides the process owner's login name (for example, root).
sysApplInstallElmtPath Provides the full path to the directory where this element is installed. For example, the value would be '/opt/EMPuma/bin' for an element installed in the directory '/opt/EMPuma/bin'. Most application packages include information about the elements that are contained in the package. In addition, elements are typically installed in subdirectories under the package installation directory. In cases where the element path names are not included in the package information itself, the path can usually be determined by a simple search of the subdirectories. If the element is not installed in that location and no other information is available to the agent implementation, then the path is unknown and null is returned.
sysApplMapInstallPkgIndex Provides the value of this object and identifies the installed software package for the application of which this process is a part. Provided that the parent application of the process can be determined, the value of this object is the same value as the sysApplInstallPkgIndex for the entry in the sysApplInstallPkgTable that corresponds to the installed application of which this process is a part. If, however, the parent application cannot be determined (for example, the process is not part of a particular installed application), the value for this object is then '0', signifying that this process cannot be related back to an application, and in turn, an installed software package.
sysApplElmtRunInstallID Provides the index into the sysApplInstallElmtTable. The value of this object is the same value as the sysApplInstallElmtIndex for the application element of which this entry represents a running instance. If this process cannot be associated with an installed executable, the value should be '0'.
sysApplRunCurrentState Provides the current state of the running application instance. The possible values are running(1), runnable(2) but waiting for a resource such as CPU, waiting(3) for an event, exiting(4), or other(5). This value is based on an evaluation of the running elements of this application instance (see sysApplElmRunState) and their Roles as defined by sysApplInstallElmtRole. An agent implementation may detect that an application instance is in the process of exiting if one or more of its REQUIRED elements are no longer running. Most agent implementations will wait until a second internal poll is completed to give the system time to start REQUIRED elements before marking the application instance as exiting.
sysApplInstallPkgDate Provides the date and time this software application was installed on the host.
sysApplInstallPkgVersion Provides the version number that the software manufacturer assigned to the application package.
sysApplInstallElmtType Provides the type of element that is part of the installed application.
Date/Time-Related Queries
sysApplElmtRunCPU The number of centi-seconds of the total system CPU resources consumed by this process
Note    On a multiprocessor system, this value may have been incremented by more than one centi-second in one centi-second of real (wall clock) time.
sysApplInstallPkgDate Provides the date and time this software application is installed on the host.
sysApplElmtPastRunTimeEnded Provides the time the process ended.
sysApplRunStarted Provides the date and time that the application was started.

MIB-II

Use MIB2 agent to get information from MIB-II. The MIB2 agent provides access to variables that are defined in RFC 1213, such as interfaces, IP, and so on, and supports the following groups of objects:

MIB-II Commands

Command

Description
Device-Related Queries
sysName Provides an administratively assigned name for this managed node. By convention, this name is the fully qualified domain name of the node. If the name is unknown, the value is the zero-length string.
sysDescr Provides a textual description of the entity. This value should include the full name and version identification of the system hardware type, software operating-system, and networking software.
SNMP Diagnostic Queries
sysName Provides an administratively assigned name for this managed node. By convention, this name is the fully-qualified domain name of the node. If the name is unknown, the value is the zero-length string.
sysUpTime Provides the time (in hundredths of a second) since the network management portion of the system was last reinitialized.
snmpInTotalReqVars Provides the total number of MIB objects that were retrieved successfully by the SNMP protocol entity as the result of receiving valid SNMP Get-Request and Get-Next PDUs.
snmpOutPkts Provides the total number of SNMP Messages that were passed from the SNMP entity to the transport service.
sysServices Provides a value that indicates the set of services that this entity potentially offers. The value is a sum. This sum initially takes the value zero, then, for each layer, L, in the range 1 through 7, that this node performs transactions for, 2 raised to (L - 1) is added to the sum. For example, a node which is a host offering application services would have a value of 4 (2^(3-1)). In contrast, a node which is a host offering application services would have a value of 72 (2^(4-1) + 2^(7-1)).
Note   

In the context of the Internet suite of protocols, calculate: layer 1 physical (for example, repeaters), layer 2 datalink/subnetwork (for example, bridges), layer 3 internet (supports IP), layer 4 end-to-end (supports TCP), layer 7 applications (supports SMTP).

For systems including OSI protocols, you can also count layers 5 and 6.
snmpEnableAuthenTraps Indicates whether the SNMP entity is permitted to generate authenticationFailure traps. The value of this object overrides any configuration information; as such, it provides a means whereby all authenticationFailure traps may be disabled.
Note   

Cisco strongly recommends that this object be stored in nonvolatile memory so that it remains constant across reinitializations of the network management system.
Syslog-Related Queries
snmpEnabledAuthenTraps Indicates whether the SNMP entity is permitted to generate authenticationFailure traps. The value of this object overrides any configuration information; as such, it provides a means whereby all authenticationFailure traps may be disabled.
Note   

Cisco strongly recommends that this object be stored in a nonvolatile memory so that it remains constant across reinitializations of the network management system.
Date/Time-Related Queries
sysUpTime Provides the time (in hundredths of a second) since the network management portion of the system was last reinitialized.

HOST-RESOURCES MIB

Use Host Resources Agent to get values from HOST-RESOURCES-MIB. The Host Resources Agent provides SNMP access to host information, such as storage resources, process tables, device information, and installed software base. The Host Resources Agent supports the following groups of objects:

HOST-RESOURCES MIB Commands

Command

Description
Device-Related Queries
hrFSMountPoint Provides the path name of the root of this file system.
hrDeviceDescr Provides a textual description of this device, including the device manufacturer and revision, and optionally, the serial number.
hrStorageDescr Provides a description of the type and instance of the storage.
Memory, Storage, and CPU Related Queries
hrMemorySize Provides the amount of physical read-write main memory, typically RAM, that the host contains.
hrStorageSize Provides the size of the storage, in units of hrStorageAllocationUnits.This object is writable to allow remote configuration of the size of the storage area in those cases where such an operation makes sense and is possible on the underlying system. For example, you can modify the amount of main memory allocated to a buffer pool or the amount of disk space allocated to virtual memory.
Process-Related Queries
hrSWRunName Provides a textual description of this running piece of software, including the manufacturer, revision, and the name by which it is commonly known. If this software is installed locally, it must be the same string as used in the corresponding hrSWInstalledName.
hrSystemProcesses Provides the number of process contexts that are currently loaded or running on this system.
hrSWRunIndex Provides a unique value for each piece of software that is running on the host. Wherever possible, use the native, unique identification number of the system.
Software Component-Related Queries
hrSWInstalledName Provides a textual description of this installed piece of software, including the manufacturer, revision, the name by which it is commonly known, and optionally, the serial number.
hrSWRunPath Provides a description of the location of long-term storage (for example, a disk drive) from which this software was loaded.
Date/Time-Related Queries
hrSystemDate Provides the host local date and time of day.
hrFSLastPartialBackupDate Provides the last date at which a portion of this file system was copied to another storage device for backup. This information is useful for ensuring that backups are being performed regularly. If this information is not known, then this variable will have the value corresponding to January 1, year 0000, 00:00:00.0, which is encoded as (hex)'00 00 01 01 00 00 00 00'.

CISCO-SYSLOG-MIB

Syslog tracks and logs all system messages, from informational through critical. With this MIB, network management applications can receive syslog messages as SNMP traps:

The Cisco Syslog Agent supports trap functionality with the following MIB objects:


Note

The CISCO-SYSLOG-MIB is dependent on the presence of the CISCO-SMI MIB.

CISCO-SYSLOG-MIB Commands

Command

Description
Syslog-Related Queries
clogNotificationEnabled Indicates whether clogMessageGenerated notifications will be sent when the device generates a syslog message. Disabling notifications does not prevent syslog messages from being added to the clogHistoryTable.
clogMaxSeverity Indicates which syslog severity levels will be processed. The agent will ignore any syslog message with a severity value greater than this value.
Note   

Severity numeric values increase as their severity decreases. For example, error (4) is more severe than debug (8).

CISCO-CCM-MIB/CISCO-CCM-CAPABILITY MIB

The CISCO-CCM-MIB contains both dynamic (real-time) and configured (static) information about the Cisco Cisco Unified Communications Manager and its associated devices, such as phones, gateways, and so on, that are visible on this Cisco Cisco Unified Communications Manager node. Simple Network Management Protocol (SNMP) tables contain information such as IP address, registration status, and model type.

SNMP supports IPv4, although the CISCO-CCM-MIB includes columns and storage for IPv6 addresses, preferences, and so on.


Note

Cisco Cisco Unified Communications Manager supports this MIB in Cisco Cisco Unified Communications Manager systems. IM and Presence Service and Cisco Unity Connection do not support this MIB.

To view the support lists for the CISCO-CCM-MIB and MIB definitions, go to the following link:

ftp:/​/​ftp.cisco.com/​pub/​mibs/​supportlists/​callmanager/​callmanager-supportlist.html

To view MIB dependencies and MIB contents, including obsolete objects, across Cisco Cisco Unified Communications Manager releases, go to the following link: http:/​/​tools.cisco.com/​Support/​SNMP/​do/​BrowseMIB.do?local=en&step=2&mibName=CISCO-CCM-CAPABILITY

Dynamic tables get populated only if the Cisco CallManager service is up and running (or the local Cisco CallManager service in the case of a Cisco Cisco Unified Communications Manager cluster configuration); static tables get populated when the Cisco CallManager SNMP Service is running.

Cisco-CCM-MIB Dynamic Tables

Table(s)

Contents

ccmTable

This table stores the version and installation ID for the local Cisco Cisco Unified Communications Manager. The table also stores information about all the Cisco Cisco Unified Communications Manager in a cluster that the local Cisco Cisco Unified Communications Manager knows about but shows "unknown" for the version detail. If the local Cisco Cisco Unified Communications Manager is down, the table remains empty, except for the version and installation ID values.

ccmPhoneFailed, ccmPhoneStatusUpdate, ccmPhoneExtn, ccmPhone, ccmPhoneExtension

For the Cisco Unified IP Phone, the number of registered phones in ccmPhoneTable should match Cisco Cisco Unified Communications Manager/RegisteredHardware Phones perfmon counter. The ccmPhoneTable includes one entry for each registered, unregistered, or rejected Cisco Unified IP Phone. The ccmPhoneExtnTable uses a combined index, ccmPhoneIndex and ccmPhoneExtnIndex, for relating the entries in the ccmPhoneTable and ccmPhoneExtnTable.

ccmCTIDevice, ccmCTIDeviceDirNum

The ccmCTIDeviceTable stores each CTI device as one device. Based on the registration status of the CTI Route Point or CTI Port, the ccmRegisteredCTIDevices, ccmUnregisteredCTIDevices, and ccmRejectedCTIDevices counters in the Cisco Cisco Unified Communications Manager MIB get updated.

ccmSIPDevice

The CCMSIPDeviceTable stores each SIP trunk as one device.

ccmH323Device

The ccmH323DeviceTable contains the list of H.323 devices for which Cisco Cisco Unified Communications Manager contains information (or the local Cisco Cisco Unified Communications Manager in the case of a cluster configuration). For H.323 phones or H.323 gateways, the ccmH.323DeviceTable contains one entry for each H.323 device. (The H.323 phone and gateway do not register with Cisco Cisco Unified Communications Manager. Cisco Cisco Unified Communications Manager generates the H.323Started alarm when it is ready to handle calls for the indicated H.323 phone and gateway.) The system provides the gatekeeper information as part of the H.323 trunk information.

ccmVoiceMailDevice, ccmVoiceMailDirNum

For Cisco uOne, ActiveVoice, the ccmVoiceMailDeviceTable includes one entry for each voice-messaging device. Based on the registration status, the ccmRegisteredVoiceMailDevices, ccmUnregisteredVoiceMailDevices, and ccmRejectedVoiceMailDevices counters in the Cisco Cisco Unified Communications Manager MIB get updated.

ccmGateway

The ccmRegisteredGateways, ccmUnregistered gateways, and ccmRejectedGateways keep track of the number of registered gateway devices or ports, number of unregistered gateway devices or ports, and number of rejected gateway devices or ports, respectively.

Cisco Cisco Unified Communications Manager generates alarms at the device or port level. The ccmGatewayTable, based on CallManager alarms, contains device- or port-level information. Each registered, unregistered, or rejected device or port has one entry in ccmGatewayTable. The VG200 with two FXS ports and one T1 port has three entries in ccmGatewayTable. The ccmActiveGateway and ccmInActiveGateway counters track number of active (registered) and lost contact with (unregistered or rejected) gateway devices or ports.

Based on the registration status, ccmRegisteredGateways, ccmUnregisteredGateways, and ccmRejectedGateways counters get updated.

ccmMediaDeviceInfo

The table contains a list of all media devices which have tried to register with the local Cisco Cisco Unified Communications Manager at least once.

ccmGroup

This tables contains the Cisco Cisco Unified Communications Manager groups in a Cisco Cisco Unified Communications Manager cluster.

ccmGroupMapping

This table maps all Cisco Cisco Unified Communications Managers in a cluster to a Cisco Cisco Unified Communications Manager group. The table remains empty when the local Cisco Cisco Unified Communications Manager node is down.

CISCO-CCM-MIB Static Tables

Table(s)

Content

ccmProductType

The table contains the list of product types that are supported with Cisco Cisco Unified Communications Manager (or cluster, in the case of a Cisco Cisco Unified Communications Manager cluster configuration), including phone types, gateway types, media device types, H.323 device types, CTI device types, voice-messaging device types, and SIP device types.

ccmRegion, ccmRegionPair

ccmRegionTable contains the list of all geographically separated regions in a Cisco Communications Network (CCN) system. The ccmRegionPairTable contains the list of geographical region pairs for a Cisco Cisco Unified Communications Manager cluster. Geographical region pairs are defined by Source region and Destination region.

ccmTimeZone

The table contains the list of all time zone groups in a Cisco Cisco Unified Communications Manager cluster.

ccmDevicePool

The tables contains the list of all device pools in a Cisco Cisco Unified Communications Manager cluster. Device pools are defined by Region, Date/Time Group, and Cisco Cisco Unified Communications Manager Group.


Note

‘The "ccmAlarmConfigInfo" and "ccmQualityReportAlarmConfigInfo" groups in the CISCO-CCM-MIB define the configuration parameters that relate to the notifications that are described.

CISCO-UNITY-MIB

The CISCO-UNITY-MIB uses the Connection SNMP Agent to get information about Cisco Unity Connection.

To view the CISCO-UNITY-MIB definitions, go to the following link and click SNMP V2 MIBs:

http:/​/​www.cisco.com/​public/​sw-center/​netmgmt/​cmtk/​mibs.shtml


Note

Cisco Unity Connection supports this MIB. Cisco Cisco Unified Communications Manager and IM and Presence Service do not support this MIB.

The Connection SNMP Agent supports the following objects.

CISCO-UNITY-MIB Objects

Object

Description

ciscoUnityTable

This table contains general information about the Cisco Unity Connection servers such as hostname and version number.

ciscoUnityPortTable

This table contains general information about the Cisco Unity Connection voice messaging ports.

General Unity Usage Info objects

This group contains information about capacity and utilization of the Cisco Unity Connection voice messaging ports.