CISCO-SIP-CALLS-MIB

All MIBs › CISCO-SIP-CALLS-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2004-04-16

Category: Cisco Devices, Telephony and VoIP

Description: Monitors active and historical SIP call legs, media streams, and call quality statistics on Cisco SIP gateways.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) 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.

What Is CISCO-SIP-CALLS-MIB?

CISCO-SIP-CALLS-MIB is a Cisco vendor-specific MIB that provides protocol-specific visibility into active Session Initiation Protocol (SIP, RFC 3261) calls on Cisco SIP gateways and voice equipment. Its central cSipCallActiveTable extends the generic callActiveTable from IETF DIAL-CONTROL-MIB with SIP-specific detail: call state and substate via the CSipCallState/CSipCallSubstate textual conventions (covering the full SIP transaction lifecycle from sentInvite through active, disconnecting, and dead), whether the local endpoint is a User Agent Client or Server, calling/called numbers, the signaling source/destination IP addresses and ports used for the INVITE dialog, and media-forking counts (cSipCallActiveMediaStreams, cSipCallActiveMediaStreamsActive). Monitoring it lets operators see exactly which SIP calls are in progress, what state each is in, and how many media streams are active per call, useful for diagnosing stuck SIP transactions, call setup failures, or media-forking issues in VoIP deployments. It depends on IETF DIAL-CONTROL-MIB for its base call index and INET-ADDRESS-MIB for address typing; it's deployed on Cisco SIP gateway platforms handling VoIP call signaling, and the CISCO-SIP-CALLS-MIB MIB is commonly loaded into monitoring tools to track SIP call setup and health in real time.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-SIP-CALLS-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 SIP-enabled voice gateways and Unified Communications voice platforms

Monitoring Examples

An operator polls cSipCallActiveTable for a specific call to check cSipCallActiveState against active(8) and cSipCallActiveMediaStreamsActive against cSipCallActiveMediaStreams; a call stuck in sentInvite(4) or rcvdProceeding(5) for an extended period, or an active call showing fewer active media streams than expected, would indicate a stalled call setup or a dropped media leg.

What Can Be Monitored

active SIP call state and substate (FSM transitions)
user agent role (UAC vs. UAS)
calling/called number identification
signaling source/destination IP address and port
active vs. total media stream counts per call

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-VOICE-COMMON-DIAL-CONTROL-MIB

CvcCoderTypeRate

From DIAL-CONTROL-MIB

callActiveIndex	OBJECT-TYPE
callActiveSetupTime	OBJECT-TYPE

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using cSipUACActiveCalls OID:

Select a Cisco SIP-enabled voice gateway or UC voice platform as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cSipUACActiveCalls into the Find box to locate it in the OID tree, then select it and click OK. This object reflects the number of UAC calls currently active. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Gauge32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoSipCallsMIB	1.3.6.1.4.1.9.9.995			The Cisco Session Initiation Protocol (SIP) Calls MIB module is designed to provide protocol-specific information on SIP calls which are currently active. SIP is an application-layer signalling protocol for creating, modifying and terminating multimedia sessions with one or more participants. SIP is defined in RFC 3261 (June 2002). The endpoints in a SIP communication are called user agents. A user agent is an application which contains both a User Agent Client (UAC) and a User Agent Server (UAS). A UAC is an application that initiates a SIP request. A UAS is an application that contacts the user when a SIP request is received and that returns a response on behalf of the user. This MIB module provides information on SIP calls and the user agents initiating these calls. Also, it provides a way to manage media forking of SIP calls.
ciscoSipCallsMIBNotifs	1.3.6.1.4.1.9.9.995.0
ciscoSipCallsMIBObjects	1.3.6.1.4.1.9.9.995.1
cSipCallActive	1.3.6.1.4.1.9.9.995.1.1
G32 cSipUACActiveCallsEx	1.3.6.1.4.1.9.9.995.1.1.1	Gauge32	read-only	This object reflects the number of UAC calls currently active. UAC calls are those calls which are initiated by this system's SIP user agent on behalf of users acting as the calling party.
G32 cSipUASActiveCalls	1.3.6.1.4.1.9.9.995.1.1.2	Gauge32	read-only	This object reflects the number of UAS calls currently active. UAS calls are those calls which are received by this system's SIP user agent on behalf of users acting as the called party.
cSipCallActiveTable	1.3.6.1.4.1.9.9.995.1.1.3		not-accessible	This table is the SIP extension to cvVoIPCallActiveTable of CISCO-VOICE-DIAL-CONTROL-MIB. It represents UAC and UAS information on active SIP calls.
cSipCallActiveEntry	1.3.6.1.4.1.9.9.995.1.1.3.1		not-accessible	An entry contains information regarding a single active SIP Call. The active call entry is identified by using the same index objects that are used by callActiveTable of IETF DIAL-CONTROL-MIB to identify the call.
STR cSipCallActiveId	1.3.6.1.4.1.9.9.995.1.1.3.1.1	SnmpAdminString	read-only	This object represents the protocol specific unique identifier for this call.
INT cSipCallActiveType	1.3.6.1.4.1.9.9.995.1.1.3.1.2	INTEGER	read-only	This object denotes whether the call is a UAC or a UAS one. 'uac' - User Agent Client 'uas' - User Agent Server.
CSI cSipCallActiveState	1.3.6.1.4.1.9.9.995.1.1.3.1.3	CSipCallState	read-only	This object reflects the current state of the call.
CSI cSipCallActiveSubstate	1.3.6.1.4.1.9.9.995.1.1.3.1.4	CSipCallSubstate	read-only	This object reflects the current substate of the call.
STR cSipCallActiveCallingNumber	1.3.6.1.4.1.9.9.995.1.1.3.1.5	SnmpAdminString	read-only	Indicates the calling number.
STR cSipCallActiveCalledNumber	1.3.6.1.4.1.9.9.995.1.1.3.1.6	SnmpAdminString	read-only	Indicates the called Number.
IPt cSipCallActiveSigSrcIpAddrType	1.3.6.1.4.1.9.9.995.1.1.3.1.7	InetAddressType	read-only	Internet type of the signaling source IP address.
IP cSipCallActiveSigSrcIpAddr	1.3.6.1.4.1.9.9.995.1.1.3.1.8	InetAddress	read-only	This object reflects the signaling source IP address. Its value should be interpreted within the context of the associated cSipCallActiveSigSrcIpAddrType object.
IPt cSipCallActiveDestReqIpAddrType	1.3.6.1.4.1.9.9.995.1.1.3.1.9	InetAddressType	read-only	Internet type of the signaling destination request IP address.
IP cSipCallActiveDestReqIpAddr	1.3.6.1.4.1.9.9.995.1.1.3.1.10	InetAddress	read-only	This object reflects the signaling destination request IP address. Its value should be interpreted within the context of the associated cSipCallActiveDestReqIpAddrType object.
INE cSipCallActiveDestReqPort	1.3.6.1.4.1.9.9.995.1.1.3.1.11	InetPortNumber	read-only	This object reflects the signaling destination request port number.
IPt cSipCallActiveDestResIpAddrType	1.3.6.1.4.1.9.9.995.1.1.3.1.12	InetAddressType	read-only	Internet type of the signaling destination response IP address.
IP cSipCallActiveDestResIpAddr	1.3.6.1.4.1.9.9.995.1.1.3.1.13	InetAddress	read-only	This object reflects the signaling destination response IP address. Its value should be interpreted within the context of the associated cSipCallActiveDestResIpAddrType object.
INE cSipCallActiveDestResPort	1.3.6.1.4.1.9.9.995.1.1.3.1.14	InetPortNumber	read-only	This object reflects the signaling destination response port number.
IPt cSipCallActiveDestIpAddrType	1.3.6.1.4.1.9.9.995.1.1.3.1.15	InetAddressType	read-only	Internet type of the signaling destination IP address.
IP cSipCallActiveDestIpAddr	1.3.6.1.4.1.9.9.995.1.1.3.1.16	InetAddress	read-only	This object reflects the signaling destination IP address. It may be either a DNS hostname or an IP address. Its value should be interpreted within the context of the associated cSipCallActiveDestIpAddrType object.
U32 cSipCallActiveMediaStreams	1.3.6.1.4.1.9.9.995.1.1.3.1.17	Unsigned32	read-only	If the call is a media-forked one, this object reflects the number of media streams.
U32 cSipCallActiveMediaStreamsActive	1.3.6.1.4.1.9.9.995.1.1.3.1.18	Unsigned32	read-only	If the call is a media-forked one, this object reflects the number of media streams currently active.
cSipMediaStreamsTable	1.3.6.1.4.1.9.9.995.1.1.4		not-accessible	This table contains objects relating to the media streams that get forked in a SIP call. It includes information about each media stream, if it is a media-forked call.
cSipMediaStreamsEntry	1.3.6.1.4.1.9.9.995.1.1.4.1		not-accessible	Each entry in this table, represents information regarding a media stream associated with a SIP call. Conceptually it is a nested table within a call entry in the cSipCallActiveTable.
U32 cSipMediaStreamIndex	1.3.6.1.4.1.9.9.995.1.1.4.1.1	Unsigned32	not-accessible	The unique media stream identifier for a single call.
INT cSipMediaStreamState	1.3.6.1.4.1.9.9.995.1.1.4.1.2	INTEGER	read-only	The current state of the media stream. 'invalidStreamState' - None of the following. 'idle' - Initialization state. The stream is yet to be forked. 'adding' - The stream is getting forked. 'deleting' - The stream is being deleted from the call. 'changing' - The stream is in the process of changing its state. 'active' - The stream is now active and communication is on. 'dead' - The stream has been cleared.
I32 cSipMediaStreamCallId	1.3.6.1.4.1.9.9.995.1.1.4.1.3	Integer32	read-only	This object represents the stream call identifier indicated by the media stream header. A value of -1 indicates that the stream is in DEAD state.
INT cSipMediaStreamType	1.3.6.1.4.1.9.9.995.1.1.4.1.4	INTEGER	read-only	This object identifies the type of the Media Stream. 'voiceOnly' - Voice-only media streams send all audio from the DS0 channel. 'dtmfRelay' - Dual Tone Multi Frequency Tones. 'voiceAndDtmfRelay' - Send both encoded voice and DTMF-relay packets.
CVC cSipMediaStreamNegotdCodec	1.3.6.1.4.1.9.9.995.1.1.4.1.5	CvcCoderTypeRate	read-only	This object reflects the codec selected for the media stream.
I32 cSipMediaStreamCodecPayloadType	1.3.6.1.4.1.9.9.995.1.1.4.1.6	Integer32	read-only	The RTP payload type of the media stream. RTP payload specifies the data transported by RTP in a packet, for example audio samples or compressed video data. A value of -1 means that no codec has been negotiated. RFC 3551 specifies the payload type number to be used with different codecs. The following are some of the standard payload types applicable to SIP calls : PT Encoding Name 0 PCMU(G711ulaw) 3 GSM 4 G723 8 PCMA(G711alaw) 9 G722 15 G728 18 G729 96--127 dynamic For other codecs, dynamic payload types in the range 96--127 are negotiated during call setup. Also note that Cisco has preassigned certain payload types in this dynamic range for certain encodings: PT Function 96 fax 97 fax-ack 100 NSE 101 NTE 121 DTMF-relay 122 Fax-relay 123 CAS 125 ClearChan
INT cSipMediaStreamNegotdDtmfRelay	1.3.6.1.4.1.9.9.995.1.1.4.1.7	INTEGER	read-only	This object reflects the DTMF-relay selected for the media stream indicated by the media stream header. 'inBandVoice' - DTMF digits are sent as in-band audio. 'rtpNte' - RTP Named Telephony Event. RTP-NTE is described in RFC 2833.
I32 cSipMediaStreamDtmfPayloadType	1.3.6.1.4.1.9.9.995.1.1.4.1.8	Integer32	read-only	The RTP payload type of the negotiated DTMF-relay. RTP payload specifies the data transported by RTP in a packet, for example audio samples or compressed video data. A value of -1 means that no codec has been negotiated. RFC 3551 specifies the payload type number to be used with different codecs. The following are some of the standard payload types applicable to SIP calls : PT Encoding Name 0 PCMU(G711ulaw) 3 GSM 4 G723 8 PCMA(G711alaw) 9 G722 15 G728 18 G729 96--127 dynamic For other codecs, dynamic payload types in the range 96--127 are negotiated during call setup. Also note that Cisco has preassigned certain payload types in this dynamic range for certain encodings: PT Function 96 fax 97 fax-ack 100 NSE 101 NTE 121 DTMF-relay 122 Fax-relay 123 CAS 125 ClearChan
IPt cSipMediaStreamSrcIpAddrType	1.3.6.1.4.1.9.9.995.1.1.4.1.9	InetAddressType	read-only	Internet type of the media stream source IP address.
IP cSipMediaStreamSrcIpAddr	1.3.6.1.4.1.9.9.995.1.1.4.1.10	InetAddress	read-only	This object reflects the source IP address of the media stream. Its value should be interpreted within the context of the associated cSipMediaStreamSrcIpAddrType object.
INE cSipMediaStreamSrcPort	1.3.6.1.4.1.9.9.995.1.1.4.1.11	InetPortNumber	read-only	This object reflects the UDP port of the media stream source.
IPt cSipMediaStreamDestIpAddrType	1.3.6.1.4.1.9.9.995.1.1.4.1.12	InetAddressType	read-only	Internet type of the media stream destination IP address.
IP cSipMediaStreamDestIpAddr	1.3.6.1.4.1.9.9.995.1.1.4.1.13	InetAddress	read-only	This object reflects the destination IP address of the media stream. Its value should be interpreted within the context of the associated cSipMediaStreamDestIpAddrType object.
INE cSipMediaStreamDestPort	1.3.6.1.4.1.9.9.995.1.1.4.1.14	InetPortNumber	read-only	This object reflects the UDP port of the media stream destination.
cSipCallsMIBConformance	1.3.6.1.4.1.9.9.995.1.2
cSipCallsMIBCompliances	1.3.6.1.4.1.9.9.995.1.2.1
cSipCallsMIBCompliance	1.3.6.1.4.1.9.9.995.1.2.1.1			The compliance statement for entities which implement the CISCO-SIP-CALLS-MIB
cSipCallsMIBGroups	1.3.6.1.4.1.9.9.995.1.2.2
cSipCallActiveGroup	1.3.6.1.4.1.9.9.995.1.2.2.1			A collection of objects providing the active SIP calls capability.
cSipMediaStreamGroup	1.3.6.1.4.1.9.9.995.1.2.2.2			A collection of objects providing the media stream information capability.

RFC description

Tracks active Session Initiation Protocol (SIP) calls and user agent communication on Cisco systems.

Start monitoring Cisco SIP-enabled voice gateways and UC voice platforms 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-SIP-CALLS-MIB