CISCO-CSG-MIB

All MIBs › CISCO-CSG-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2003-02-20

Category: Cisco Devices, Web and Application Servers

Description: Manages Cisco Content Services Gateway, monitoring subscriber service flows, billing records, and content-based charging functions.

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-CSG-MIB?

CISCO-CSG-MIB manages the Cisco Content Services Gateway (CSG), a platform used by service providers for subscriber-aware content billing and service-flow management. It exposes resource and usage counters: per-user session table data (card ID, group name, entry counts, high-water marks, LRU eviction counts) plus timers tracking lost accounting/billing records. Its monitoring value is centered on software/service resource status: csgUserCurrEntries versus csgUserMaxEntries and csgUserHighWater reveal how close the subscriber session table is to capacity, while csgUserLRUSteals and the lost-record timers flag when the CSG is dropping or evicting session/billing data under load. It is a self-contained Cisco service-platform MIB with limited apparent dependency on other standard MIBs beyond general SNMP conventions. It is deployed on Cisco CSG platforms in service-provider networks performing subscriber billing, quota management, and content-based charging.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-CSG-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 Content Services Gateway (CSG)

Monitoring Examples

An operator would compare csgUserCurrEntries to csgUserMaxEntries in csgUserTable to see how full the subscriber session table is, and watch csgUserHighWater for a new peak indicating growing subscriber load. A rising csgUserLRUSteals count would reveal the CSG is evicting active sessions to make room for new ones -- a capacity warning sign. csgAgentLostRecordTimer and csgQuotaMgrLostRecordTimer would be checked to detect billing/accounting record loss, which directly affects revenue-critical charging accuracy.

What Can Be Monitored

subscriber session table current vs. max entries
session table high-water mark
LRU session eviction count
lost accounting record timer
lost quota-manager record timer

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From INET-ADDRESS-MIB

InetAddress
InetAddressType
InetPortNumber

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Counter64
Gauge32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

RowStatus
TEXTUAL-CONVENTION
TimeInterval
TruthValue

How to Use in IPNetwork Monitor

Example using csgUserLRUSteals OID:

Select a Cisco Content Services Gateway (CSG) 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 csgUserLRUSteals into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports the number of User Table entries acquired from LRU list. 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 Counter32-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
ciscoCsgMIB	1.3.6.1.4.1.9.9.331			This MIB supports the Cisco Content Services Gateway (CSG) product. It includes five traps and four tables that enable querying CSG resource statistics.
ciscoCsgMIBNotifs	1.3.6.1.4.1.9.9.331.0
NTF ciscoCsgAgentStateChange	1.3.6.1.4.1.9.9.331.0.1			This notification is issued when csgAgentNotifsEnabled is set to 'true', and the billing mediation agent changes state. There is one exception: No notification is issued for state changes involving 'echowait' because this would cause an excessive number of notifications.
NTF ciscoCsgQuotaMgrStateChange	1.3.6.1.4.1.9.9.331.0.2			This notification is issued when csgQuotaNotifsEnabled is set to 'true', and the quota manager changes state. There is one exception: No notification is issued for state changes involving 'echowait' because this would cause an excessive number of notifications.
NTF ciscoCsgUserDbStateChange	1.3.6.1.4.1.9.9.331.0.3			This notification is issued when csgDatabaseNotifsEnabled is set to 'true', and the user database changes state.
NTF ciscoCsgAgentLostRecordEvent	1.3.6.1.4.1.9.9.331.0.4			This notification is issued when csgAgentNotifsEnabled is set to 'true', and the CSG must discard accounting records that should be sent to the billing mediation agent. Initially, csgAgentLostRecords is set to 0. When a record is discarded, csgAgentLostRecords is incremented, a period timer is started, and this notification is issued. The NMS and the agent save this value. The agent continues to increment csgAgentLostRecords each time a record is lost. When the period timer expires, the agent compares the current value of csgAgentLostRecords with the previous (saved) value. If the values are equal this notification is issued again, signalling to the NMS that the condition has been cleared. Otherwise, the timer is restarted to monitor the next period. When a record is lost and no period timer is active, this notification is issued and the above procedure is repeated.
NTF ciscoCsgQuotaMgrLostRecordEvent	1.3.6.1.4.1.9.9.331.0.5			This notification is issued when csgQuotaNotifsEnabled is set to 'true', and the CSG must discard request records to be sent to the quota manager. The processing is the same as described in the description for ciscoCsgAgentLostRecordEvent.
ciscoCsgMIBObjects	1.3.6.1.4.1.9.9.331.1
csgScalars	1.3.6.1.4.1.9.9.331.1.1
NUM csgAgentLostRecordTimer	1.3.6.1.4.1.9.9.331.1.1.1	TimeInterval	read-write	The time interval for monitoring the lost-record event (ciscoCsgAgentLostRecordEvent) of a billing mediation agent (BMA). A notification is issued when the CSG detects a lost BMA record. An interval timer is started with this value. When the timer expires the lost record count (csgAgentLostRecords) is checked. If the lost record count has increased since the previous the detection, the timer is restarted to monitor another period. If the lost record count has not increased since the previous detection, a final notification is sent to indicate that the condition has cleared.
NUM csgQuotaMgrLostRecordTimer	1.3.6.1.4.1.9.9.331.1.1.2	TimeInterval	read-write	The time interval for monitoring the lost-record event (ciscoCsgQuotaMgrLostRecordEvent) of a quota manager. A notification is issued when the CSG detects a lost quota manager record. An interval timer is started with this value. When the timer expires the lost record count (csgQuotaMgrLostRecords) is checked. If the lost record count has increased since the previous the detection, the timer is restarted to monitor another period. If the lost record count has not increased since the previous detection, a final notification is sent to indicate that the condition has cleared.
csgUserStats	1.3.6.1.4.1.9.9.331.1.2
csgUserTable	1.3.6.1.4.1.9.9.331.1.2.1		not-accessible	Table of User statistics. Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgUserRowStatus in accordance with the RowStatus convention.
csgUserTableEntry	1.3.6.1.4.1.9.9.331.1.2.1.1		not-accessible	Entry that defines parameters for the User Table.
CSG csgUserCardId	1.3.6.1.4.1.9.9.331.1.2.1.1.1	CsgSlotNumber	not-accessible	The slot number in the host switch in which the CSG card is inserted. This object is part of the index in all tables.
CSG csgUserGroupName	1.3.6.1.4.1.9.9.331.1.2.1.1.2	CsgEntityName	not-accessible	Name of associated user-group. This object is part of the index of this table and the csgUserDbTable.
CSG csgUserMaxEntries	1.3.6.1.4.1.9.9.331.1.2.1.1.3	CsgUserTableUpperBound	read-create	Maximum User Table entries.
G32 csgUserCurrEntries	1.3.6.1.4.1.9.9.331.1.2.1.1.4	Gauge32	read-only	Current number of user table entries.
CSG csgUserHighWater	1.3.6.1.4.1.9.9.331.1.2.1.1.5	CsgUserTableUpperBound	read-create	Highest number of entries inserted into User Table. The only write operation allowed is to reset the value to 0.
C32 csgUserLRUStealsEx	1.3.6.1.4.1.9.9.331.1.2.1.1.6	Counter32	read-only	Number of User Table entries acquired from LRU list. When the User Table becomes full and a new user is detected, the least recently used User Table entry is allocated to the new user.
ROW csgUserRowStatus	1.3.6.1.4.1.9.9.331.1.2.1.1.7	RowStatus	read-create	This object is used by the manager to create or delete the row entry in the csgUserTable following the RowStatus textual convention. If this row is deleted, then accounting records subsequently generated by the associated CSG line card (identified by csgUserCardId) will not contain user information.
csgUserDataBaseStats	1.3.6.1.4.1.9.9.331.1.3
csgUserDbTable	1.3.6.1.4.1.9.9.331.1.3.1		not-accessible	Table of user databases. Rows can be created and destroyed. Entries are added to this table via csgUserDbRowStatus in accordance with the RowStatus convention.
csgUserDbTableEntry	1.3.6.1.4.1.9.9.331.1.3.1.1		not-accessible	Entry that defines parameters for a User Database. The User Database is a server that returns a userid given an IP address received in request.
IPt csgUserDbIpAddrType	1.3.6.1.4.1.9.9.331.1.3.1.1.1	InetAddressType	not-accessible	Type of IP address of the user database.
IP csgUserDbIpAddr	1.3.6.1.4.1.9.9.331.1.3.1.1.2	InetAddress	not-accessible	The IP address of the user database.
INE csgUserDbPort	1.3.6.1.4.1.9.9.331.1.3.1.1.3	InetPortNumber	not-accessible	The listening UDP port of the user database.
INT csgUserDbState	1.3.6.1.4.1.9.9.331.1.3.1.1.4	INTEGER	read-only	State of the user database. 'reset' - State before the database is determined to be active. 'active' - The database is available and processing requests. 'failed' - The database has failed and is not processing requests.
C64 csgUserDbRequests	1.3.6.1.4.1.9.9.331.1.3.1.1.5	Counter64	read-only	Number of user database requests.
C64 csgUserDbUidsReturned	1.3.6.1.4.1.9.9.331.1.3.1.1.6	Counter64	read-only	Number of user identifiers returned.
C32 csgUserDbReqResent	1.3.6.1.4.1.9.9.331.1.3.1.1.7	Counter32	read-only	Number of database requests resent.
C32 csgUserDbReqTimeouts	1.3.6.1.4.1.9.9.331.1.3.1.1.8	Counter32	read-only	Number of user database requests that have timed out.
C32 csgUserDbReqErrors	1.3.6.1.4.1.9.9.331.1.3.1.1.9	Counter32	read-only	Number of errors returned on user database requests.
ROW csgUserDbRowStatus	1.3.6.1.4.1.9.9.331.1.3.1.1.10	RowStatus	read-create	This object is used by the manager to create or delete the row entry in the csgUserDbTable following the RowStatus textual convention. This row can be deleted regardless of the value of csgUserDbState. Deletion of this row means that the associated database (identified by csgUserDbIpAddr and csgUserDbPort) is no longer available to the associated CSG card. If all csgUserDbTable rows have been deleted for a given CSG card, then other mechanisms, such as intercepting RADIUS flows, may be used to associate a user name with an IP address. If this is not possible, then the user name will be absent from generated accounting records.
csgAgentStats	1.3.6.1.4.1.9.9.331.1.4
csgAgentTable	1.3.6.1.4.1.9.9.331.1.4.1		not-accessible	A table of billing mediation agents (BMAs). Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgAgentRowStatus in accordance with the RowStatus convention. At least one BMA is required per CSG line card. Multiple BMAs can be configured for the purposes of load sharing and redundancy in the event of failure.
csgAgentTableEntry	1.3.6.1.4.1.9.9.331.1.4.1.1		not-accessible	Entry that defines parameters for a mediation agent.
IPt csgAgentIpAddrType	1.3.6.1.4.1.9.9.331.1.4.1.1.1	InetAddressType	not-accessible	Type of IP address of a BMA.
IP csgAgentIpAddr	1.3.6.1.4.1.9.9.331.1.4.1.1.2	InetAddress	not-accessible	The IP address of a BMA.
INE csgAgentPort	1.3.6.1.4.1.9.9.331.1.4.1.1.3	InetPortNumber	not-accessible	The UDP port of a BMA.
CSG csgAgentAcctName	1.3.6.1.4.1.9.9.331.1.4.1.1.4	CsgEntityName	read-create	Name of associated accounting service.
CSG csgAgentPriority	1.3.6.1.4.1.9.9.331.1.4.1.1.5	CsgServerPriority	read-create	The activation priority of a BMA. BMAs are activated in highest priority order. If multiple BMAs are active for load sharing, the highest priority BMAs available are activated. If an active BMA fails, the next highest priority BMA (in 'standby' state) is activated.
INT csgAgentState	1.3.6.1.4.1.9.9.331.1.4.1.1.6	INTEGER	read-only	States of a billing mediation agent. 'standby' - The server is prepared to become active. 'failed' - The server has failed to respond to requests. 'active' - The server has been activated to receive requests. 'echowait' - CSG has sent an echo request to this billing mediation agent and is waiting for a response. 'nawait' - CSG has sent a node-alive request to this billing mediation agent and is waiting for a response. 'suspended' - The server has receive a stop request from the operator.
C32 csgAgentLostRecords	1.3.6.1.4.1.9.9.331.1.4.1.1.7	Counter32	read-only	Total number of lost records since system initialization or the last time the counter wrapped.
C64 csgAgentTotalSent	1.3.6.1.4.1.9.9.331.1.4.1.1.8	Counter64	read-only	Total number of records sent to the billing mediation agent.
C32 csgAgentFailAck	1.3.6.1.4.1.9.9.331.1.4.1.1.9	Counter32	read-only	Number of acknowledgments received from the billing mediation agent for which there are no outstanding requests.
G32 csgAgentOutstanding	1.3.6.1.4.1.9.9.331.1.4.1.1.10	Gauge32	read-only	Current number of messages waiting to be ACKed.
U32 csgAgentHighWater	1.3.6.1.4.1.9.9.331.1.4.1.1.11	Unsigned32	read-create	Highest number of messages waiting for ACKs. The only write operation allowed is to reset the value to 0.
C32 csgAgentBadRecord	1.3.6.1.4.1.9.9.331.1.4.1.1.12	Counter32	read-only	The number of bad records received. These are records in which the CSG detected an error in attempting to decode the contents.
C32 csgAgentRetransmit	1.3.6.1.4.1.9.9.331.1.4.1.1.13	Counter32	read-only	The number of messages retransmitted to the billing mediation agent.
ROW csgAgentRowStatus	1.3.6.1.4.1.9.9.331.1.4.1.1.14	RowStatus	read-create	This object is used by the manager to create or delete the row entry in the csgAgentTable following the RowStatus textual convention. Deletion of a row makes a BMA (identified by csgAgentIpAddr and csgAgentPort) unavailable to the associated CSG card. At least one BMA must be available to a CSG card. Therefore, deletion of the last BMA is not allowed. This row can be deleted regardless of the value of csgAgentState. Requests queued for the deleted BMA are requeued to another BMA.
csgQuotaMgrStats	1.3.6.1.4.1.9.9.331.1.5
csgQuotaMgrTable	1.3.6.1.4.1.9.9.331.1.5.1		not-accessible	Table of CSG quota managers. Columnar objects can be modified when the row is 'active'. Rows can be created and destroyed. Entries are added to this table via csgAgentRowStatus in accordance with the RowStatus convention.
csgQuotaMgrTableEntry	1.3.6.1.4.1.9.9.331.1.5.1.1		not-accessible	Entry that defines parameters for a quota manager.
IPt csgQuotaMgrIpAddrType	1.3.6.1.4.1.9.9.331.1.5.1.1.1	InetAddressType	not-accessible	Type IP address of a quota manager.
IP csgQuotaMgrIpAddr	1.3.6.1.4.1.9.9.331.1.5.1.1.2	InetAddress	not-accessible	The IP address of a quota manager.
INE csgQuotaMgrPort	1.3.6.1.4.1.9.9.331.1.5.1.1.3	InetPortNumber	not-accessible	The UDP port of a quota manager.
CSG csgQuotaMgrUserGroupName	1.3.6.1.4.1.9.9.331.1.5.1.1.4	CsgEntityName	read-only	Name of associated user-group.
CSG csgQuotaMgrPriority	1.3.6.1.4.1.9.9.331.1.5.1.1.5	CsgServerPriority	read-create	The priority of a quota manager.
INT csgQuotaMgrState	1.3.6.1.4.1.9.9.331.1.5.1.1.6	INTEGER	read-only	States of a quota manager: 'standby' - The QuotaMgr is prepared to become active. 'failed' - The QuotaMgr has failed to respond to requests. 'active' - The QuotaMgr has been activated to receive requests. 'echowait' - CSG has sent an echo request to this QuotaMgr and is waiting for a response. 'nawait' - CSG has sent a node-alive request to this QuotaMgr and is waiting for a response. 'suspended' - The QuotaMgr has receive a stop request from the operator.
C32 csgQuotaMgrLostRecords	1.3.6.1.4.1.9.9.331.1.5.1.1.7	Counter32	read-only	Total number of lost records since system initialization or the last time the counter wrapped.
C64 csgQuotaMgrTotalSent	1.3.6.1.4.1.9.9.331.1.5.1.1.8	Counter64	read-only	Total number of records sent to the quota manager.
C32 csgQuotaMgrFailAck	1.3.6.1.4.1.9.9.331.1.5.1.1.9	Counter32	read-only	Number of acknowledgments received from the quota manager for which there are no requests.
G32 csgQuotaMgrOutstanding	1.3.6.1.4.1.9.9.331.1.5.1.1.10	Gauge32	read-only	Current number of messages waiting to be ACKed.
U32 csgQuotaMgrHighWater	1.3.6.1.4.1.9.9.331.1.5.1.1.11	Unsigned32	read-create	Highest number of messages waiting for ACKs. The only write operation allowed is to reset the value to 0.
C32 csgQuotaMgrBadRecord	1.3.6.1.4.1.9.9.331.1.5.1.1.12	Counter32	read-only	The number of bad records received. These are records in which the CSG detected an error in attempting to decode the contents.
C32 csgQuotaMgrRetransmit	1.3.6.1.4.1.9.9.331.1.5.1.1.13	Counter32	read-only	The number of messages retransmitted to the billing mediation agent.
ROW csgQuotaMgrRowStatus	1.3.6.1.4.1.9.9.331.1.5.1.1.14	RowStatus	read-create	This object is used by the manager to create or delete the row entry in the csgQuotaMgrTable following the RowStatus textual convention. Deletion of a row makes a QuotaMgr (identified by csgQuotaMgrIpAddr and csgQuotaMgrPort) unavailable to the associated CSG card. For the prepaid billing function, at least one QuotaMgr must be available to a CSG card. Therefore, deletion of the last QuotaMgr causes all accounting processing to switch to post-paid billing. This row can be deleted regardless of the value of csgQuotaMgrState. Requests queued for the deleted QuotaMgr are requeued to another QuotaMgr if one is available. If no QuotaMgr is available, processing reverts to post-paid billing.
csgNotifsEnable	1.3.6.1.4.1.9.9.331.1.6
T/F csgAgentNotifsEnabled	1.3.6.1.4.1.9.9.331.1.6.1	TruthValue	read-write	The CSG Agent notification truth value. 'true' Indicates that all defined notifications for CSG agents are enabled. 'false' Indicates that CSG Agent notification generation is disabled.
T/F csgQuotaNotifsEnabled	1.3.6.1.4.1.9.9.331.1.6.2	TruthValue	read-write	The CSG notification truth value. 'true' Indicates that all defined notifications for quota servers are enabled. 'false' Indicates that CSG quota server notifications generation are disabled.
T/F csgDatabaseNotifsEnabled	1.3.6.1.4.1.9.9.331.1.6.3	TruthValue	read-write	The CSG notification truth value. 'true' Indicates that all defined notifications for the CSG database are enabled. 'false' Indicates that CSG database notification generation is disabled.
ciscoCsgMIBConform	1.3.6.1.4.1.9.9.331.2
ciscoCsgMIBCompliances	1.3.6.1.4.1.9.9.331.2.1
ciscoCsgMIBCompliance	1.3.6.1.4.1.9.9.331.2.1.1			The compliance statement for entities which implement the Cisco CSG line card MIB.
ciscoCsgMIBGroups	1.3.6.1.4.1.9.9.331.2.2
ciscoUserGroup	1.3.6.1.4.1.9.9.331.2.2.1			CSG User Table Statistic objects.
ciscoUserDbGroup	1.3.6.1.4.1.9.9.331.2.2.2			CSG Statistic objects.
ciscoAgentGroup	1.3.6.1.4.1.9.9.331.2.2.3			CSG Statistic objects.
ciscoQuotaMgrGroup	1.3.6.1.4.1.9.9.331.2.2.4			CSG Statistic objects.
ciscoCsgNotifEnableGroup	1.3.6.1.4.1.9.9.331.2.2.5			CSG notifications enable/disable flags.
ciscoCsgNotifGroup	1.3.6.1.4.1.9.9.331.2.2.6			A collection of objects providing CSG notifications.

RFC description

Cisco Content Services Gateway MIB with traps and tables for CSG resource statistics and billing mediation management.

Start monitoring Cisco Content Services Gateway (CSG) 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-CSG-MIB