3.17 SystemUsage

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.

3.17.1 Resource Object

CiscoUCM_CMServer

3.17.2 Default Schedule

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.

3.17.3 Setting Parameter Values

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.