Reporting on the Resource Monitoring Function
The SBC generates statistics on the monitored resources for debugging purposes on the live systems. The SBC also generates statistics on the Resource Monitoring Function. You can get this information using ACLI commands, Alarms, Log Files and SNMP. For high availability, these statistics are generated separately on the active and standby nodes.
ACLI Commands
The SBC provides ACLI commands you can run on the runtime system to see what resources are active and what type of action the system has taken for specific thresholds. You can observe these statistics and status reports on the resource monitoring function using the commands below.
- show resourcemonitor action-information: Shows the precautionary actions count per resource.
ORACLE# show resourcemonitor action-information Accepted 13:22:17-173 Action Stats TASK-NAME MINOR MAJOR CRITICAL ALARM&TRAP DECREMENT_HEALTHSCORE ClearAction SRTP_D tPpmEntry 0 0 0 0 0 0 HMU tPpmEntry 0 0 0 0 0 0 2833 tPpmEntry 0 0 0 0 0 0 COMMAND_QUEUE sipd01 0 0 0 0 0 0 COMMAND_QUEUE mbcd01 0 0 0 0 0 0 SRTP_SESSIONS mbcd 0 0 0 0 0 0 SRTP_E tPpmEntry 0 0 0 0 0 0 COMMAND_QUEUE atcpd01 0 0 0 0 0 0 QOS tPpmEntry 0 0 0 0 0 0 TCP/TLS atcpd 0 0 0 0 0 0 NAT_FLOWS tPpmEntry 0 0 0 0 0 0 HEAP heap 0 0 0 0 0 0 CPU sipd01 0 0 0 0 0 0 CPU mbcd01 0 0 0 0 0 0 CPU 2 tDpwdMonitor 0 0 0 0 0 0 PAC_BUFFER_COMMON heap 0 0 0 0 0 0 PAC_BUFFER_NET_G heap 0 0 0 0 0 0 PAC_BUFFER_NET_P heap 0 0 0 0 0 0 DPWD_MON_CPU tDpwdMonitor 0 0 0 0 0 0 DPWD_MON_CPU 2 tDpwdMonitor 0 0 0 0 0 0 DPWD_MON_MEMORY tDpwdMonitor 0 0 0 0 0 0 APPLICATION_FD 0 0 0 0 0 0 - show resourcemonitor registration-status: Shows registration status per resource.
ORACLE# show resourcemonitor registration-status Accepted 13:22:43-199 Registration Status TASK-NAME STATUS SRTP_E tPpmEntry INACTIVE QOS tPpmEntry INACTIVE 2833 tPpmEntry INACTIVE NAT_FLOWS tPpmEntry INACTIVE COMMAND_QUEUE sipd01 INACTIVE HMU tPpmEntry INACTIVE COMMAND_QUEUE mbcd01 INACTIVE SRTP_SESSIONS mbcd INACTIVE COMMAND_QUEUE atcpd01 INACTIVE TCP/TLS atcpd INACTIVE SRTP_D tPpmEntry INACTIVE HEAP heap INACTIVE PAC_BUFFER_COMMON heap INACTIVE PAC_BUFFER_NET_G heap INACTIVE PAC_BUFFER_NET_P heap INACTIVE DPWD_MON_CPU tDpwdMonitor INACTIVE DPWD_MON_MEMORY tDpwdMonitor INACTIVE CPU sipd01 INACTIVE APPLICATION_FD INACTIVE - show resourcemonitor resource-registrations: Shows registration count of resource monitor function resources.
ORACLE# show resourcemonitor resource-registrations Accepted 13:23:05-120 Registration stats ---- Lifetime ---- Recent Total PerMax Register 0 12 6 Register 4xx 0 12 6 Register 200OK 0 0 0 Deregister 0 0 0 - show resourcemonitor resource-reports: Shows the report count for resources in the resource monitor function.
ORACLE# show resourcemonitor resource-reports Accepted 13:23:27-143 Usage-Percent stats ---- Lifetime ---- Resource TASK-NAME Recent Total PerMax SRTP_D tPpmEntry 0 0 0 HMU tPpmEntry 0 0 0 2833 tPpmEntry 0 0 0 COMMAND_QUEUE sipd01 0 0 0 COMMAND_QUEUE mbcd01 0 0 0 SRTP_SESSIONS mbcd 0 0 0 SRTP_E tPpmEntry 0 0 0 COMMAND_QUEUE atcpd01 0 0 0 QOS tPpmEntry 0 0 0 TCP/TLS atcpd 0 0 0 NAT_FLOWS tPpmEntry 0 0 0 HEAP heap 0 0 0 PAC_BUFFER_COMMON heap 0 0 0 PAC_BUFFER_NET_G heap 0 0 0 PAC_BUFFER_NET_P heap 0 0 0 DPWD_MON_CPU tDpwdMonitor 0 0 0 DPWD_MON_MEMORY tDpwdMonitor 0 0 0 CPU sipd01 0 0 0 APPLICATION_FD 0 0 0 REPORT REJECTION 0 0 0 - reset resourcemonitor: Resets all the statistics produces by the commands above.
The system also provides manual commands to clear out the actions the system has taken for the specified or all resource types.
clear-resourcemonitor < "resource-type" > | < all >This command syntax example clears any action performed on heap memory, based on every crossed threshold.
ORACLE#clear-resourcemonitor HEAPYou can also use the following to view information the system generates within the context of this feature:
- The log.tResourceMonitor log file captures log messages generated by the Resource Monitoring Module.
- DEBUG and MINOR level logs in the log.heap logfile .
- Whenever required, the SBC issues the applicable SNMP traps and alarms. The applicable objects include:
- apRmResourcesGroupTrap
- apRmResourcesGroupClearTrap
- RESOURCE_MONITOR_ALARM
Logs and Alarms
The SBC includes a log file named log.tPpmEntry that presents PPM resource logs generated by the resource monitor client. There are also some DEBUG and MINOR level log message related to this resource monitoring feature in the log.sipd, log.mbcd, and log.atcpd logfile.
There are no separate alarms used only for this feature. Instead, the SBC uses the alarms and traps previously developed for resource issues. Each resource uses its own ALARM ID and processName.
The example alarm below show ID 131100 informing you that the HEAP process, configured with a threshold of 80% is breached.
ORACLE# display-alarms
2 alarms to show
ID Task Severity First Occurred Last Occurred
131100 3524 4 2023-12-04 06:33:59 2023-12-04 06:34:29
Count Description
2 Resource monitoring module raising alarm - Resource task id = 3524, threshold = 80%, current value = 82%,processName = heapNote:
Whenever the system raises an alarm within the context of this feature, it simultaneously issues an equivalent trap.See the Alarms Table appendix in the MIB Guide for information about the alarms raised by resource monitoring actions.
SNMP
With respect to SNMP, the SBC uses the ap-res-monitor.mib to collate status data on each registered monitoring function, and generate SNMP traps on the configured resource monitoring object. The applicable OIDs use the prefix, 1.3.6.1.4.1.9148.3 under the table apRMResourceObjects, which is within ap-res-monitor.mib.
For traps, the SBC maintains an object named apRMNotifications, which includes the apRMNotificationObjects. This object refers to the apRmTrapType, which in conjunction with apRmTrapValue establishes a usable value pair that specifies each resource's utilization. The system can compare these values with your configured thresholds and generate the following when an active value crosses above or below your thresholds:
- apRmResourcesGroupTrap (threshold raised trap)
- apRmResourcesGroupClearTrap (threshold came down trap).
See the MIB Guide for detailed information about SNMP variables in the Resource Monitor OIDs section and SNMP traps in the apRMResourceObjectsTraps (ap-res-monitor.mib) section.