Resource Monitor MIBs
You can configure the SBC to generate SNMP resource monitoring information by configuring one or more resource-monitoring-profile elements under the system branch and enabling the resource-monitoring parameter in the system-config. The SBC uses SNMP objects to capture statistics related to each resource registered with the Resource Monitoring Feature. The applicable OIDs use the prefix, 1.3.6.1.4.1.9148.3.22, and reside within the ap-res-monitor.mib. This information is made available from SNMP primarily for the purpose of troubleshooting individual PPMs.
Although you can get applicable data by browsing from you SNMP manager, much of that data is debug data, and is comparatively opaque to the user. The applicable SNMP objects can be used to retrieve internal details of a specific PPM. RMF will not use this data to generate traps or alarms. However, this information becomes valuable if any of the PPMs become overloaded, helping pinpoint the exact source of the issue.
To generate statistics from which the system can evaluate registered service utilization, it creates tables for each registered service that include a variety of debug data points that apply to each service specifically. Tables listing these debug data objects are presented within this section. Debug data tables the system may create include:
- apNatPpmDebugStatsTable
- ap2833PpmDebugStatsTable
- apHmuDebugStatsTable
- apQosPpmDebugStatsTable
- apSrtpEPpmStatsDebugTable
- apSrtpDPpmDebugStatsTable
The SBC also uses the apRmTrapValue in conjunction with apRmTrapType to establish a usable value pair that specifies each resource's utilization. The system computes the apRmTrapValue objects for each registered service on an ongoing basis using the debug statistics in each service's debug stats table.
Finally, the resource monitoring feature uses the apRMNotifications object to build traps. The system refers to apRmTrapType and apRmTrapValue to determine when to issue a trap or a clear trap when the resource crosses your configured thresholds. The system includes that information in the traps so you can monitor when a registered service crosses your configured resource thresholds:
- apRmResourcesGroupTrap (threshold raised trap)
- apRmResourcesGroupClearTrap (threshold down trap).
Each apRmTrapType object is described in the table below.
| PPM Value | Description |
|---|---|
| apRmCommandQueueUtil
1.3.6.1.4.1.9148.3.22.2.1 |
The percentage of commadQueue utilization |
| apRmNatFlowPpmUtil
1.3.6.1.4.1.9148.3.22.2.2 |
The percentage of PPM NatFlows utilization |
| apRmQosPpmUtil
1.3.6.1.4.1.9148.3.22.2.3 |
The percentage of PPM QoSFlows utilization |
| apRm2833PpmUtil
1.3.6.1.4.1.9148.3.22.2.4 |
The percentage of PPM RFC2833Flows utilization |
| apRmMbcdSrtpSessionsUtil
1.3.6.1.4.1.9148.3.22.2.5 |
The percentage of Mbcd SRTP Sessions utilization |
| apRmHmuPpmUtil
1.3.6.1.4.1.9148.3.22.2.6 |
The percentage of PPM HMUFlows utilization |
| apRmSrtpEPpmUtil
1.3.6.1.4.1.9148.3.22.2.7 |
The percentage of PPM SRTP-E Flows utilization |
| apRmSrtpDPpmUtil
1.3.6.1.4.1.9148.3.22.2.8 |
The percentage of PPM SRTP-D Flows utilization |
| apRmAtcpdTcpTlsSessions
1.3.6.1.4.1.9148.3.22.2.9 |
The percentage of Atcpd TCP/TLS connections utilization |
Debug Statistics Tables
The system includes apRMPPMObjects to establish a reference for individual tables for each PPM configured and registered with the resource monitoring function. These tables contain the debug data the system uses to calculate the utilization thresholds and trigger trap (alarm) actions. These OIDs include:
- apNatPpmDebugStatsTable—1.3.6.1.4.1.9148.3.22.1.1.1.2.X (X ranges from 1 – 10)
- ap2833PpmDebugStatsTable—1.3.6.1.4.1.9148.3.22.1.2.1.2.X (X ranges from 1 – 17)
- apHmuPpmDebugStatsTable—1.3.6.1.4.1.9148.3.22.1.3.1.2.X (X ranges from 1 - 18)
- apQosPpmDebugStatsTable—1.3.6.1.4.1.9148.3.22.1.4.1.2.X (X ranges from 1 - 23)
- apSrtpdPpmStatsDebugTable—1.3.6.1.4.1.9148.3.22.1.5.1.2.X (X ranges from 1 - 37)
- apSrtpDPpmDebugStatsTable—1.3.6.1.4.1.9148.3.22.1.6.1.2.X (X ranges from 1 - 37)
Each "X" in the list above represents a debug data point. Each PPM has a different number of debug data points. The tables below present each of these tables.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.1.1.2. | Description |
|---|---|---|
| apNatSuccessInstalls | 1 | The number of successful NAT entry installations |
| apNatUnSuccessInstalls | 2 | The number of unsuccessful NAT entry installations |
| apNatSuccessRemoves | 3 | The number of times a successful NAT entry installations has been removed successfully |
| apNatUnSuccessRemoves | 4 | The number of times a successful NAT entry installations for which removal was unsuccessful |
| apNatInvalidResultantFlowID | 5 | The number of times a successful NAT entry installations resulted in an invalid flow ID |
| apNatkeyLessInstalls | 6 | The number of successful keyless NAT entry installations |
| apNatkeyLessRemove | 7 | The number of successful keyless NAT entry removals |
| apNatInputPackets | 8 | The number of input packets related to a NAT entry |
| apNatOutputPackets | 9 | The number of output packets related to a NAT entry |
| apNatDrainFlowDrops | 10 | The number of drain flow drops related to a NAT entry |
The following table contains 2833 status OIDs along with descriptions.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.2.1.2. | Description |
|---|---|---|
| ap2833InstallFailure | 1 | The number of unsuccessful 2833 entry installations |
| ap2833InstallSuccess | 2 | The number of successful 2833 entry installations |
| ap2833DeleteFailures | 3 | The number of unsuccessful 2833 entry deletions |
| ap2833DeleteSuccess | 4 | The number of successful 2833 entry deletions |
| ap2833InvalidAcmeHeader | 5 | The number of 2833 entries with an invalid Acme header |
| ap2833UnknownEthernet | 6 | The number of 2833 entries with an invalid an unknown ethernet |
| ap2833DetectPktsNullInput | 7 | The number of 2833 packets with detected null input |
| ap2833GenerateDetectPktsNullInput | 8 | The number of generated 2833 packets detected with null input |
| ap2833GeneratePktsNullInput | 9 | The number of 2833 packets with generated null input |
| ap2833DetectRtpError | 10 | The number of 2833 entries detected with an RTP error |
| ap2833NonDigitCount | 11 | The number of generated entries detected without a digit count |
| ap2833GeneratePktsRtpError | 12 | The number of generated 2833 entries detected with an RTP error |
| ap2833PTMappingNullInput | 13 | The number of 2833 entries with payload type mapped to null input |
| ap2833PTMappingRtpError | 14 | The number of 2833 entries with a payload type mapping error |
| ap2833PTMappingPacketSuccess | 15 | The number of 2833 entries with successful payload type mapping |
| ap2833UDPHeaderErrors | 16 | The number of 2833 entries with a UDP header error |
| ap2833OddUDPPorts | 17 | The number of 2833 entries with an odd UDP port |
The following table contains HMU status OIDs along with descriptions.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.3.1.2. | Description |
|---|---|---|
| apHMUInstallFailure | 1 | The number of unsuccessful HMU entry installations |
| apHMUInstallSuccess | 2 | The number of successful HMU entry installations |
| apHMUDeleteFailures | 3 | The number of unsuccessful 2833 entry deletions |
| apHMUDeleteSuccess | 4 | The number of successful 2833 entry deletions |
| apHmuModifyFailure | 5 | The number of unsuccessful 2833 entry modifications |
| apHmuModifySuccess | 6 | The number of successful 2833 entry modifications |
| apHmuPPErrors | 7 | The number of PP errors for HMU entry installations |
| apHmuPPRtcpCount | 8 | The number if HMU PPR ICP entries |
| apHmuPPInitRtps | 9 | The number of HMU PP entries with intialized RTPS |
| apHmuPPLearnRtps | 10 | The number of HMU PP entries with learned RTPS |
| apHmuPPLearnInvalidPT | 11 | The number of learned HMU PP entries with invalid payload type |
| apHmuPPLearnDuplicatePackets | 12 | The number of learned HMU PP entries with invalid duplicate packets |
| apHmuPPLearnSSRCChanges | 13 | The number of learned HMU PP entries with invalid SSRC changes |
| apHmuPPWaitRtps | 14 | The number of HMU PP entries with wait Rtps |
| apHmuPPTransRtps | 15 | The number of HMU PP entries with trans Rtps |
| apHmuPPSsrcChanges | 16 | The number of HMU PP entries with SRCC changes |
| apHmuPPHideRtps | 17 | The number of HMU PP entries with hidden RTPS |
| apHmuPPBadState | 18 | The number of HMU PP entries in a bad state |
The following table contains QoS status OIDs along with descriptions.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.4.1.2. | Description |
|---|---|---|
| apQosInstallFailure | 1 | The number of unsuccessful QoS entry installations |
| apQosCollapsedInstalls | 2 | The number of successful QoS entry installations |
| apQosRtpInstalls | 3 | The number of QoS entry installations for RTP |
| apQosRtcpInstalls | 4 | The number of QoS entry installations for RTCP |
| apQosReportGenerations | 5 | The number of QoS report generations |
| apQosRtcpGenerations | 6 | The number of QoS report generations for RTCP |
| apQosDeleteFailures | 7 | The number of unsuccessful QoS entry deletes |
| apQosDeleteCollapsedCount | 8 | The number of collapsed count QoS deletes |
| apQosDeleteRtpCount | 9 | The number of RTP count QoS deletes |
| apQosDeleteRtcpCount | 10 | The number of RTCP count QoS deletes |
| apQosPPNullInputs | 11 | The number of QoS PP null inputs |
| apQosPPUdpHeaderErrors | 12 | The number of UDP header errors in QoS entries |
| apQosPPLengthErrors | 13 | The number of QoS PP Length errors |
| apQosRtpNull | 14 | The number of QoS entries with null RTP |
| apQosRtpSuccess | 15 | The number of successful QoS entries with RTP |
| apQosRtcpNull | 16 | The number of QoS entries with null RTCP |
| apQosRtcpSuccess | 17 | The number of successful QoS entries with RTCP |
| apQosRtcpGenNullInput | 18 | The number of RTCP QoS entries with null input |
| apQosRtcpGenNotReadys | 19 | The number of RTCP QoS entries with not readys |
| apQosRtcpGenPacketSent | 20 | The number packets sent from RTCP QoS entries |
| apQosRtcpGenPacketErrors | 21 | The number packets errors from RTCP QoS entries |
| apQosRtcpGenSendErrors | 22 | The number send errors for RTCP QoS entries |
| apQosRtcpGenl2Errors | 23 | The number errors for RTCP QoS entries |
The following table contains SRTP-E status OIDs along with descriptions.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.5.1.2. | Description |
|---|---|---|
| apSrtpeAllocationCount | 1 | The number of SRTP-E entry allocations |
| apSrtpeDeAllocationCount | 2 | The number of SRTP-E entry de-allocations |
| apSrtpeContextZoneAllocation | 3 | The number of SRTP-E entry zone allocations |
| apSrtpeContextZoneAllocationDeleteList | 4 | The number of deleted SRTP-E entry zone allocations |
| apSrtpeContextInDeleteList | 5 | The number of in context deletes for SRTP-E entries |
| apSrtpeContextInDeleteListLong | 6 | The number of long in context deletes for SRTP-E entries |
| apSrtpeIngressPktCount | 7 | The number of ingress packets for SRTP-E entries |
| apSrtpeIngressRtpCount | 8 | The number of ingress RTP packets for SRTP-E entries |
| apSrtpeIngressRtcpCount | 9 | The number of ingress RTCP packets for SRTP-E entries |
| apSrtpeEngressRtpCount | 10 | The number of egress RTP packets for SRTP-E entries |
| apSrtpeEngressRtcpCount | 11 | The number of egress RTCP packets for SRTP-E entries |
| apSrtpeSessionsCount | 12 | The number of SRTP-E sessions |
| apSrtpeInitRequests | 13 | The number of SRTP-E initialization requests |
| apSrtpeInitRequestSuccess | 14 | The number of successful SRTP-E initialization requests |
| apSrtpeInitRequestFailures | 15 | The number of unsuccessful SRTP-E initialization requests |
| apSrtpeModifyRequests | 16 | The number of modify requests forSRTP-E entries |
| apSrtpeModifyRequestFailures | 17 | The number of unsuccessful modify requests for SRTP-E entries |
| apSrtpeDeleteRequests | 18 | The number of delete requests forSRTP-E entries |
| apSrtpeDeleteRequestFailures | 19 | The number of unsuccessful delete requests for SRTP-E entries |
| apSrtpeQueryRequests | 20 | The number of query requests for SRTP-E entries |
| apSrtpeQueryFailures | 21 | The number of unsuccessful query requests for SRTP-E entries |
| apSrtpeCountInitNullConfiguration | 22 | The number of null configurations during the initialization of SRTP-E entries |
| apSrtpeNullSessionCount | 23 | The number of null sessions for SRTP-E entries |
| apSrtpeHashTableNullParameter | 24 | The number of null hash table parameters for SRTP-E entries |
| apSrtpeStreamNullParameter | 25 | The number of null stream parameters for SRTP-E entries |
| apSrtpeMkiNull | 26 | The number of SRTP-E entries with null MKI |
| apSrtpeCtxZoneAllocFailed | 27 | The number of unsuccessful Ctx zone allocations for SRTP-E entries |
| apSrtpeCtxDelayedDealloc | 28 | The number of delayed Ctx de-allocations for SRTP-E entries |
| apSrtpeResourceErrorCount | 29 | The number of resource errors for SRTP-E entries |
| apSrtpeProtectFailCount | 30 | The number of unsuccessful protection errors for SRTP-E entries |
| apSrtpeUnProtectFailCount | 31 | The number of unsuccessful un-protection errors for SRTP-E entries |
| apSrtpeAllocFailCount | 32 | The number of unsuccessful allocations for SRTP-E entries |
| apSrtpeDeAllocFailCount | 33 | The number of unsuccessful de-allocations for SRTP-E entries |
| apSrtpeNoCtxCount | 34 | The number of SRTP-E entries with no Ctx |
| apSrtpeSrtcpNullStream | 35 | The number of SRTP-E entries with null RTCP streams |
| apSrtpSrtpNullStream | 36 | The number of SRTP-E entries with null streams |
| apSrtpSsrcLimitExceded | 37 | The number of SRTP-E entries that have exceeded the SSRC limit |
The following table contains SRTP-D status OIDs along with descriptions.
| SNMP GET Query Name | Object ID: 1.3.6.1.4.1.9148.3.22.1.6.1.2 | Description |
|---|---|---|
| apSrtpdAllocationCount | 1 | The number of SRTP-D entry allocations |
| apSrtpdDeAllocationCount | 2 | The number of SRTP-D entry de-allocations |
| apSrtpdContextZoneAllocation | 3 | The number of SRTP-D entry zone allocations |
| apSrtpdContextZoneAllocationDeleteList | 4 | The number of deleted SRTP-D entry zone allocations |
| apSrtpdContextInDeleteList | 5 | The number of in context deletes for SRTP-D entries |
| apSrtpdContextInDeleteListLong | 6 | The number of long in context deletes for SRTP-D entries |
| apSrtpdIngressPktCount | 7 | The number of ingress packets for SRTP-D entries |
| apSrtpdIngressRtpCount | 8 | The number of ingress RTP packets for SRTP-D entries |
| apSrtpdIngressRtcpCount | 9 | The number of ingress RTCP packets for SRTP-D entries |
| apSrtpdEngressRtpCount | 10 | The number of egress RTP packets for SRTP-D entries |
| apSrtpdEngressRtcpCount | 11 | The number of egress RTCP packets for SRTP-D entries |
| apSrtpdSessionsCount | 12 | The number of SRTP-D sessions |
| apSrtpdInitRequests | 13 | The number of SRTP-D initialization requests |
| apSrtpdInitRequestSuccess | 14 | The number of successful SRTP-D initialization requests |
| apSrtpdInitRequestFailures | 15 | The number of unsuccessful SRTP-D initialization requests |
| apSrtpdModifyRequests | 16 | The number of modify requests forSRTP-D entries |
| apSrtpdModifyRequestFailures | 17 | The number of unsuccessful modify requests for SRTP-D entries |
| apSrtpdDeleteRequests | 18 | The number of delete requests forSRTP-D entries |
| apSrtpdDeleteRequestFailures | 19 | The number of unsuccessful delete requests for SRTP-D entries |
| apSrtpdQueryRequests | 20 | The number of query requests for SRTP-D entries |
| apSrtpdQueryFailures | 21 | The number of unsuccessful query requests for SRTP-D entries |
| apSrtpdCountInitNullConfiguration | 22 | The number of null configurations during the initialization of SRTP-D entries |
| apSrtpdNullSessionCount | 23 | The number of null sessions for SRTP-D entries |
| apSrtpdHashTableNullParameter | 24 | The number of null hash table parameters for SRTP-D entries |
| apSrtpdStreamNullParameter | 25 | The number of null stream parameters for SRTP-D entries |
| apSrtpdMkiNull( | 26 | The number of SRTP-D entries with null MKI |
| apSrtpdCtxZoneAllocFailed | 27 | The number of unsuccessful Ctx zone allocations for SRTP-D entries |
| apSrtpdCtxDelayedDealloc | 28 | The number of delayed Ctx de-allocations for SRTP-D entries |
| apSrtpdResourceErrorCount | 29 | The number of resource errors for SRTP-D entries |
| apSrtpdProtectFailCount( | 30 | The number of unsuccessful protection errors for SRTP-D entries |
| apSrtpdUnProtectFailCount | 31 | The number of unsuccessful un-protection errors for SRTP-D entries |
| apSrtpdAllocFailCount | 32 | The number of unsuccessful allocations for SRTP-D entries |
| apSrtpdDeAllocFailCount | 33 | The number of unsuccessful de-allocations for SRTP-D entries |
| apSrtpdNoCtxCount | 34 | The number of SRTP-D entries with no Ctx |
| apSrtpdSrtcpNullStream | 35 | The number of SRTP-D entries with null RTCP streams |
| apSrtpSrtpNullStream | 36 | The number of SRTP-D entries with null streams |
| apSrtpSsrcLimitExceded | 37 | The number of SRTP-D entries that have exceeded the SSRC limit |