All MIBs › CISCO-CALL-HISTORY-MIB
Organization: Cisco Systems, Inc.
Last Updated: 1996-11-19
Category: Cisco Devices, Telephony and VoIP
Description:
Stores call information for all calls on Cisco routers and access servers for accounting purposes, including connection times and disconnection details.
Imported Objects
From CISCO-SMI
| ciscoMgmt | OBJECT-IDENTITY |
From IF-MIB
| InterfaceIndex |
From SNMPv2-CONF
| MODULE-COMPLIANCE | |
| OBJECT-GROUP |
From SNMPv2-SMI
| Integer32 | |
| MODULE-IDENTITY | |
| OBJECT-TYPE |
From SNMPv2-TC
| DisplayString | |
| TimeStamp |
What Is CISCO-CALL-HISTORY-MIB?
CISCO-CALL-HISTORY-MIB is a Cisco proprietary MIB that stores historical call records on Cisco routers and access servers for accounting and troubleshooting purposes, capturing details of each call placed or received. Its data is fundamentally a fault/event and usage-accounting log: per-call start time, calling and called numbers, the interface used, destination address/hostname, and disconnect cause, along with global settings for table size and retention timer. As a software-status MIB it is used to review completed call activity and diagnose failure patterns by examining disconnect cause codes, effectively serving the monitoring/fault-analysis role for voice/dial connectivity rather than reporting physical hardware health. It is closely related to, and often deployed alongside, CISCO-DIAL-CONTROL-MIB and the IETF Dial Control MIB framework that it extends for demand-access interfaces. It is typically deployed on Cisco routers and access servers handling dial-up or circuit-switched voice/data calls, where CISCO-CALL-HISTORY-MIB SNMP monitoring supports call accounting and disconnect-cause analysis.
IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-CALL-HISTORY-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.
What Can Be Monitored
- call start time
- calling and called numbers
- call disconnect cause
- destination address/hostname
- call history table retention
Supported Devices
- Cisco router or access server with dial/voice interfaces
Monitoring Examples
An administrator walks ciscoCallHistoryTable / ciscoCallHistoryEntry ordered by ciscoCallHistoryIndex, examining ciscoCallHistoryStartTime, ciscoCallHistoryCallingNumber, and ciscoCallHistoryCalledNumber to reconstruct recent call activity on a given ciscoCallHistoryInterfaceNumber. Reviewing ciscoCallHistoryCallDisconnectCause across many entries reveals recurring abnormal terminations, such as a specific destination consistently disconnecting with a busy or no-answer cause. Adjusting ciscoCallHistoryTableMaxLength and ciscoCallHistoryRetainTimer controls how much call history is retained locally before older entries are aged out, which matters for post-incident accounting audits.
OIDs
| OID symbolic | OID numeric | Type | Access | Description |
|---|---|---|---|---|
| ciscoCallHistoryMib | 1.3.6.1.4.1.9.9.27 | The MIB module to describe and store the call information of the routers for accounting purposes. | ||
| ciscoCallHistoryMibObjects | 1.3.6.1.4.1.9.9.27.1 | |||
| ciscoCallHistory | 1.3.6.1.4.1.9.9.27.1.1 | |||
| I32 ciscoCallHistoryTableMaxLength | 1.3.6.1.4.1.9.9.27.1.1.1 | Integer32 | read-write | The upper limit on the number of entries that the ciscoCallHistoryTable may contain. A value of 0 will prevent any history from being retained. When this table is full, the oldest entry will be deleted and the new one will be created. |
| I32 ciscoCallHistoryRetainTimer | 1.3.6.1.4.1.9.9.27.1.1.2 | Integer32 | read-write | The minimum amount of time that an ciscoCallHistoryEntry will be maintained before being deleted. A value of 0 will prevent any history from being retained, but will not prevent callCompletion traps being genarated. |
| ciscoCallHistoryTable | 1.3.6.1.4.1.9.9.27.1.1.3 | not-accessible | A table containing information about specific calls to a specific destination. | |
| ciscoCallHistoryEntry | 1.3.6.1.4.1.9.9.27.1.1.3.1 | not-accessible | The information regarding a single Connection. | |
| TIM ciscoCallHistoryStartTime | 1.3.6.1.4.1.9.9.27.1.1.3.1.1 | TimeStamp | not-accessible | The value of sysUpTime when this call history entry was created. This will be useful for an NMS to retrieve all calls after a specific time. |
| I32 ciscoCallHistoryIndex | 1.3.6.1.4.1.9.9.27.1.1.3.1.2 | Integer32 | not-accessible | Index variable to access the CallHistoryEntry objects of the ciscoCallHistoryTable. |
| OCT ciscoCallHistoryCallingNumber | 1.3.6.1.4.1.9.9.27.1.1.3.1.3 | OCTET STRING | read-only | The calling number for this call. If the number is not available, then it will have a length of zero. The variable is instantiated if this is an incoming call. |
| OCT ciscoCallHistoryCalledNumber | 1.3.6.1.4.1.9.9.27.1.1.3.1.4 | OCTET STRING | read-only | The number this call is connected to. This variable is instantiated if this is an outgoing call. |
| NUM ciscoCallHistoryInterfaceNumber | 1.3.6.1.4.1.9.9.27.1.1.3.1.5 | InterfaceIndex | read-only | This is the ifIndex value of the highest number of interface through which the call was made. |
| OCT ciscoCallHistoryDestinationAddress | 1.3.6.1.4.1.9.9.27.1.1.3.1.6 | OCTET STRING | read-only | The address of the host this call is connected to, if it is available. Most devices/routers connected to an interface have an address and this object will store that. The variable is not instantiated if it is not available. |
| STR ciscoCallHistoryDestinationHostName | 1.3.6.1.4.1.9.9.27.1.1.3.1.7 | DisplayString | read-only | The name of the host this call is connected to. Most devices/routers connected to an interface have a name and this object will store that name. |
| INT ciscoCallHistoryCallDisconnectCause | 1.3.6.1.4.1.9.9.27.1.1.3.1.8 | INTEGER | read-only | The reason for the call termination. |
| TIM ciscoCallHistoryCallConnectionTime | 1.3.6.1.4.1.9.9.27.1.1.3.1.9 | TimeStamp | read-only | The value of sysUpTime when the call was connected. |
| TIM ciscoCallHistoryCallDisconnectTime | 1.3.6.1.4.1.9.9.27.1.1.3.1.10 | TimeStamp | read-only | The value of sysUpTime when the call got disconnected last. |
| STR ciscoCallHistoryDialReason | 1.3.6.1.4.1.9.9.27.1.1.3.1.11 | DisplayString | read-only | The reason for initiating this call. This may include the destination address of the interesting packet that forced us to dial. This variable is instantiated for an outgoing call. |
| STR ciscoCallHistoryConnectTimeOfDay | 1.3.6.1.4.1.9.9.27.1.1.3.1.12 | DisplayString | read-only | The time of day at the time of call connect. |
| STR ciscoCallHistoryDisconnectTimeOfDay | 1.3.6.1.4.1.9.9.27.1.1.3.1.13 | DisplayString | read-only | The time of day when the call disconnected. |
| I32 ciscoCallHistoryTransmitPackets | 1.3.6.1.4.1.9.9.27.1.1.3.1.14 | Integer32 | read-only | Number of packets transmitted when this call was up. |
| I32 ciscoCallHistoryTransmitBytes | 1.3.6.1.4.1.9.9.27.1.1.3.1.15 | Integer32 | read-only | Number of Bytes transmitted when this call was up. |
| I32 ciscoCallHistoryReceivePackets | 1.3.6.1.4.1.9.9.27.1.1.3.1.16 | Integer32 | read-only | Number of packets received when this call was up. |
| I32 ciscoCallHistoryReceiveBytes | 1.3.6.1.4.1.9.9.27.1.1.3.1.17 | Integer32 | read-only | Number of Bytes received when this call was up. |
| I32 ciscoCallHistoryRecordedUnits | 1.3.6.1.4.1.9.9.27.1.1.3.1.18 | Integer32 | read-only | Advice of Charge recorded units when this call was up. |
| STR ciscoCallHistoryCurrency | 1.3.6.1.4.1.9.9.27.1.1.3.1.19 | DisplayString | read-only | Advice of Charge currency type. |
| I32 ciscoCallHistoryCurrencyAmount | 1.3.6.1.4.1.9.9.27.1.1.3.1.20 | Integer32 | read-only | Advice of Charge currency amount when this call was up. |
| INT ciscoCallHistoryMultiplier | 1.3.6.1.4.1.9.9.27.1.1.3.1.21 | INTEGER | read-only | Advice of Charge multiplier for currency amount |
| ciscoCallHistoryMibConformance | 1.3.6.1.4.1.9.9.27.2 | |||
| ciscoCallHistoryMibCompliances | 1.3.6.1.4.1.9.9.27.2.1 | |||
| ciscoCallHistoryMibCompliance | 1.3.6.1.4.1.9.9.27.2.1.1 | The compliance statement for entities which implement the Cisco call History MIB | ||
| ciscoCallHistoryMibComplianceRev1 | 1.3.6.1.4.1.9.9.27.2.1.2 | The compliance statement for entities which implement the Cisco call History MIB | ||
| ciscoCallHistoryMibComplianceV11R01 | 1.3.6.1.4.1.9.9.27.2.1.3 | The compliance statement for entities which implement the Cisco call History MIB | ||
| ciscoCallHistoryMibComplianceV11R02 | 1.3.6.1.4.1.9.9.27.2.1.4 | The compliance statement for entities which implement the Cisco call History MIB | ||
| ciscoCallHistoryMibGroups | 1.3.6.1.4.1.9.9.27.2.2 | |||
| ciscoCallHistoryMibGroup | 1.3.6.1.4.1.9.9.27.2.2.1 | A collection of objects providing the call History MIB capability. | ||
| ciscoCallHistoryMibGroupRev1 | 1.3.6.1.4.1.9.9.27.2.2.2 | A collection of objects providing the call History MIB capability. | ||
| ciscoCallHistoryMibGroupRev2 | 1.3.6.1.4.1.9.9.27.2.2.3 | A collection of objects providing the call History MIB capability. | ||
| ciscoCallHistoryMibGlobalsGroup | 1.3.6.1.4.1.9.9.27.2.2.4 | A collection of objects providing control over the retention of call History. |
RFC description
Call history and accounting information storage for Cisco routers and call management systems.
Start monitoring Cisco routers and access servers with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.