CISCO-CALL-HISTORY-MIB

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.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring CISCO-CALL-HISTORY-MIB with a free 30-day trial of IPNetwork Monitor.

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.

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.

What Can Be Monitored

call start time
calling and called numbers
call disconnect cause
destination address/hostname
call history table retention

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

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoCallHistory	1.3.6.1.4.1.9.9.27.1.1
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.
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 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.
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.
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.
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 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.
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.
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 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.
ciscoCallHistoryEntry	1.3.6.1.4.1.9.9.27.1.1.3.1		not-accessible	The information regarding a single Connection.
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.
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.
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.
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
ciscoCallHistoryMibCompliances	1.3.6.1.4.1.9.9.27.2.1
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
ciscoCallHistoryMibConformance	1.3.6.1.4.1.9.9.27.2
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.
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.
ciscoCallHistoryMibGroups	1.3.6.1.4.1.9.9.27.2.2
ciscoCallHistoryMibObjects	1.3.6.1.4.1.9.9.27.1
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
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 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 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.
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.
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.
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.
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 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 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.

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.

Download CISCO-CALL-HISTORY-MIB

What Is CISCO-CALL-HISTORY-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description