Use the SystemUsage Knowledge Script to monitor CPU, memory, and disk usage for a Unified Communications server. This script raises an event if a threshold is exceeded. In addition, this script generates data streams for the following metrics:
CPU usage (%)
Physical and virtual memory usage (%)
Swap space usage (%)
Active, common, and swap partition usage (%)
Total processes
Total threads
This script is a member of the CiscoUCM recommended Knowledge Script Group (KSG). For more information, see Recommended Knowledge Script Groups.
CiscoUCM_CMServer
By default, this script runs every two minutes.
If you are running this script as part of the Recommended KSG, do not change the schedule. The schedules for the recommended scripts are staggered to lessen the impact on CPU utilization when you run the KSG.
Set the following parameters on the Values tab as needed:
Parameter |
How to Set It |
---|---|
General Settings |
|
Job Failure Notification |
|
Event severity when job fails |
Set the event severity level, from 1 to 40, to indicate the importance of the failure of the SystemUsage job. The default is 5. |
Monitor CPU Usage |
|
Event Notification |
|
Raise event if CPU usage exceeds threshold? |
Select Yes to raise an event if CPU usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum CPU usage |
Specify the highest percentage of CPU usage that must occur before an event is raised. The default is 80%. |
Event severity when CPU usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which CPU usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for CPU usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of CPU usage during the monitoring period. The default is Yes. |
Monitor Physical Memory Usage |
|
Event Notification |
|
Raise event if physical memory usage exceeds threshold? |
Select Yes to raise an event if physical memory usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum physical memory usage |
Specify the highest percentage of physical memory usage that must occur before an event is raised. The default is 80%. |
Event severity when physical memory usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which physical memory usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for physical memory usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of physical memory usage during the monitoring period. The default is Yes. |
Monitor Virtual Memory Usage |
|
Event Notification |
|
Raise event if virtual memory usage exceeds threshold? |
Select Yes to raise an event if virtual memory usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum virtual memory usage |
Specify the highest percentage of virtual memory usage that must occur before an event is raised. The default is 80%. |
Event severity when virtual memory usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which virtual memory usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for virtual memory usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of virtual memory usage during the monitoring period. The default is Yes. |
Monitor Swap Space Usage |
|
Event Notification |
|
Raise event if swap space usage exceeds threshold? |
Select Yes to raise an event if swap space usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum swap space usage |
Specify the highest percentage of swap space that must be in use before an event is raised. The default is 80%. |
Event severity when swap space usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which swap space usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for swap space usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of swap space usage during the monitoring period. The default is unselected. |
Monitor Active Partition Usage |
|
Event Notification |
|
Raise event if active partition usage exceeds threshold? |
Select Yes to raise an event if active partition usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum active partition usage |
Specify the highest percentage of active partition usage that must occur before an event is raised. The default is 80%. |
Event severity when active partition usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which active partition usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for active partition usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of active partition usage during the monitoring period. The default is unselected. |
Monitor Common Partition Usage |
|
Event Notification |
|
Raise event if common partition usage exceeds threshold? |
Select Yes to raise an event if common partition usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum common partition usage |
Specify the highest percentage of common partition usage that must occur before an event is raised. The default is 80%. |
Event severity when common partition usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which common partition usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for common partition usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of common partition usage during the monitoring period. The default is unselected. |
Monitor Swap Partition Usage |
|
Event Notification |
|
Raise event if swap partition usage exceeds threshold? |
Select Yes to raise an event if swap partition usage exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum swap partition usage |
Specify the highest percentage of swap partition usage that must occur before an event is raised. The default is 50%. |
Event severity when swap partition usage exceeds threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which swap partition usage exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for swap partition usage? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of swap partition usage during the monitoring period. The default is unselected. |
Monitor Total Processes |
|
Event Notification |
|
Raise event if total processes exceed threshold? |
Select Yes to raise an event if the number of active processes exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum total processes |
Specify the highest number of processes that must be active before an event is raised. The default is 250 processes. |
Event severity when total processes exceed threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which the number of active processes exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for total processes? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the number of processes that are active at each script iteration. The default is unselected. |
Monitor Total Threads |
|
Event Notification |
|
Raise event if total threads exceed threshold? |
Select Yes to raise an event if the number of threads exceeds the threshold that you set. The default is Yes. |
Threshold - Maximum total threads |
Specify the highest number of threads that must be created before an event is raised. The default is 2500 threads. |
Event severity when total threads exceed threshold |
Set the event severity, from 1 to 40, to indicate the importance of an event in which the number of threads exceeds the threshold you set. The default is 15. |
Data Collection |
|
Collect data for total threads? |
Select Yes to collect data for charts and reports. If enabled, data collection returns the total number of threads detected at each script iteration. The default is unselected. |