4.10 CCM_RegisteredResources

Use this Knowledge Script to monitor changes in the number of resources (phones, gateways, and station devices) registered to a Communications Manager server. This script raises an event if a threshold is exceeded. In addition, this script generates data streams for the percentage of increase or decrease in registered resources, as well as data streams for the number of registered resources related to those percentages of increases or decreases.

If the number of registered resources increases from zero to a larger number, this script reports the increase as 100% multiplied by the number of new registered resources. For example, if the previous number of registered gateways is zero, and the latest iteration of this script finds seven new registered gateways, then the script reports the increase in registered gateways as 700%. For more information about phone resources, see PhoneInventory.

This script is a member of the CiscoCM recommended Knowledge Script Group. For more information, see Section 4.57, Recommended Knowledge Script Group.

4.10.1 Resource Object

CiscoCM_CMServer

4.10.2 Default Schedule

By default, this script runs every five 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 so as to lessen the impact on CPU utilization when you run the KSG.

4.10.3 Setting Parameter Values

Set the following parameters 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 CCM_RegisteredResources job. The default is 5.

Monitor Registered Hardware Phones

Data Collection

Collect data for registered hardware phones?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number hardware phones that are registered at each script iteration. The default is unselected.

Monitor Increase in Registered Hardware Phones

Event Notification

Raise event if increase in registered hardware phones exceeds threshold?

Select Yes to raise an event if the increase in registered hardware phones exceeds the threshold you set. The default is unselected.

Threshold - Maximum increase in registered hardware phones

Specify the maximum increase in the number of registered hardware phones that can occur before an event is raised. The default is 1 phone.

Event severity when increase in registered hardware phones exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of new registered hardware phones exceeds the threshold you set. The default is 15.

Data Collection

Collect data for increase in registered hardware phones?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of increase in hardware phones during the monitoring period. The default is unselected.

Monitor Percentage Increase in Registered Hardware Phones

Event Notification

Raise event if percentage increase in registered hardware phones exceeds threshold?

Select Yes to raise an event if the percentage increase in registered hardware phones exceeds the threshold you set. The default is Yes.

Threshold - Maximum percentage increase in registered hardware phones

Specify the maximum decrease in registered hardware phones that can occur before an event is raised. The default is 10%.

Event severity when percentage increase in registered hardware phones exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of increase in registered hardware phones exceeds the threshold you set. The default is 15.

Data Collection

Collect data for decrease in registered hardware phones?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of decrease in hardware phones during the monitoring period. The default is unselected.

Monitor Decrease in Registered Hardware Phones

Event Notification

Raise event if decrease in registered hardware phones exceeds threshold?

Select Yes to raise an event if the decrease in registered hardware phones exceeds the threshold you set. The default is unselected.

Threshold - Maximum decrease in registered hardware phones

Specify the maximum decrease in the number of registered hardware phones that can occur before an event is raised. The default is 1 phone.

Event severity when decrease in registered hardware phones exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the decrease in number of registered hardware phones exceeds the threshold you set. The default is 15.

Data Collection

Collect data for decrease in registered hardware phones?

Select Yes to collect data for charts and reports. If enabled, data collection returns the decreasing number of registered hardware phones during the monitoring period. The default is unselected.

Monitor Percentage Decrease in Registered Hardware Phones

Event Notification

Raise event if percentage decrease in registered hardware phones exceeds threshold?

Select Yes to raise an event if the percentage decrease in registered hardware phones exceeds the threshold you set. The default is Yes.

Threshold - Maximum percentage decrease in registered hardware phones

Specify the maximum percentage decrease in registered hardware phones that can occur before an event is raised. The default is 10%.

Event severity when percentage decrease in registered hardware phones exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of decrease in registered hardware phones exceeds the threshold you set. The default is 15.

Data Collection

Collect data for percentage decrease in registered hardware phones?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of decrease in hardware phones during the monitoring period. The default is unselected.

Monitor Registered MGCP Gateways

Data Collection

Collect data for registered MGCP gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of MGCP gateways registered at each script iteration. The default is unselected.

Monitor Increase in Registered MGCP Gateways

Event Notification

Raise event if increase in registered MGCP gateways exceeds threshold?

Select Yes to raise an event if the increase in registered MGCP gateways exceeds the threshold you set. The default is Yes.

Threshold - Maximum increase in registered MGCP gateways

Specify the maximum increase in registered MGCP gateways that can occur before an event is raised. The default is 10%.

Event severity when increase in registered MGCP gateways exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of increase in registered MGCP gateways exceeds the threshold you set. The default is 15.

Data Collection

Collect data for increase in registered MGCP gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of increase in registered MGCP gateways during the monitoring period. The default is unselected.

Monitor Decrease in Registered MGCP Gateways

Event Notification

Raise event if decrease in registered MGCP gateways exceeds threshold?

Select Yes to raise an event if the decrease in registered MGCP gateways exceeds the threshold you set. The default is Yes.

Threshold - Maximum decrease in registered MGCP gateways

Specify the maximum decrease in registered MGCP gateways that can occur before an event is raised. The default is 10%.

Event severity when decrease in registered MGCP gateways exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of decrease in registered MGCP gateways exceeds the threshold you set. The default is 15.

Data Collection

Collect data for decrease in registered MGCP gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of decrease in registered MGCP gateways during the monitoring period. The default is unselected.

Monitor Registered Analog Access Gateways

Data Collection

Collect data for registered Analog Access gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of Analog Access gateways registered at each script iteration. The default is unselected.

Monitor Increase in Registered Analog Access Gateways

Event Notification

Raise event if increase in registered Analog Access gateways exceeds threshold?

Select Yes to raise an event if the increase in registered Analog Access gateways exceeds the threshold you set. The default is Yes.

Threshold - Maximum increase in registered Analog Access gateways

Specify the maximum increase in registered Analog Access gateways that can occur before an event is raised. The default is 10%.

Event severity when increase in registered Analog Access gateways exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of increase in registered Analog Access gateways exceeds the threshold you set. The default is 15.

Data Collection

Collect data for increase in registered Analog Access gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the increase in registered Analog Access gateways during the monitoring period. The default is unselected.

Monitor Decrease in Registered Analog Access Gateways

Event Notification

Raise event if decrease in registered Analog Access gateways exceeds threshold?

Select Yes to raise an event if the decrease in registered Analog Access gateways exceeds the threshold you set. The default is Yes.

Threshold - Maximum decrease in registered Analog Access gateways

Specify the maximum decrease in registered Analog Access gateways that can occur before an event is raised. The default is 10%.

Event severity when decrease in registered Analog Access gateways exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of decrease in registered Analog Access gateways exceeds the threshold you set. The default is 15.

Data Collection

Collect data for decrease in registered Analog Access gateways?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of decrease in registered Analog Access gateways during the monitoring period. The default is unselected.

Monitor Registered Other Station Devices

Data Collection

Collect data for registered other station devices?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of other station devices registered at each script iteration. The default is unselected.

Monitor Increase in Registered Other Station Devices

Event Notification

Raise event if increase in registered other station devices exceeds threshold?

Select Yes to raise an event if the increase in registered other station devices exceeds the threshold you set. The default is Yes.

Threshold - Maximum increase in registered other station devices

Specify the maximum increase in registered other station devices that can occur before an event is raised. The default is 10%.

Event severity when increase in registered other station devices exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of increase in registered other station devices exceeds the threshold you set. The default is 15.

Data Collection

Collect data for increase in registered other station devices?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of increase in registered other station devices during the monitoring period. The default is unselected.

Monitor Decrease in Registered Other Station Devices

Event Notification

Raise event if decrease in registered other station devices exceeds threshold?

Select Yes to raise an event if the decrease in registered other station devices exceeds the threshold you set. The default is Yes.

Threshold - Maximum decrease in registered other station devices

Specify the maximum decrease in registered other station devices that can occur before an event is raised. The default is 10%.

Event severity when decrease in registered other station devices exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of decrease in registered other station devices exceeds the threshold you set. The default is 15.

Data Collection

Collect data for decrease in registered other station devices?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of decrease in registered other station devices during the monitoring period. The default is unselected.