4.30 Locations

Use this Knowledge Script to monitor Cisco locations for voice and video bandwidth availability and usage. This script raises an event if a threshold is exceeded. In addition, this script generates data streams for the bandwidth availability, bandwidth usage (%), bandwidth-related call failures, video bandwidth availability, video bandwidth usage (%), and bandwidth-related failures of video stream requests.

4.30.1 Resource Object

CiscoCM_LocationObj

4.30.2 Default Schedule

By default, this script runs every 15 minutes.

4.30.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 Locations job. The default is 5.

Event Notification

Raise event if performance recommendation exceeded?

Select Yes to raise an event if the performance recommendation is exceeded. The default is Yes.

Event severity when performance recommendation exceeded

Set the event severity to indicate the importance when the performance recommendation is exceeded. The default is 15.

Monitor Available Bandwidth

Data Collection

Collect data for available bandwidth?

Select Yes to collect data for charts and reports. If enabled, data collection returns the amount of bandwidth available at each script iteration. The default is unselected.

Monitor Bandwidth Usage

Event Notification

Raise event if bandwidth usage exceeds threshold?

Select Yes to raise an event if the percentage of bandwidth usage exceeds the threshold. The default is Yes.

Threshold - Maximum bandwidth usage

Specify the maximum percentage of bandwidth usage that must be detected before an event is raised. The default is 90%.

Event severity when bandwidth usage exceeds threshold

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

Data Collection

Collect data for bandwidth usage?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of bandwidth usage at each script iteration. The default is unselected.

Monitor Call Failures Caused By Insufficient Bandwidth

Event Notification

Raise event if call failures exceed threshold

Select Yes to raise an event if the number of calls that failed because of insufficient bandwidth exceeds the threshold. The default is Yes.

Threshold - Maximum failed calls

Specify the maximum number of calls that must fail before an event is raised. The default is 0 calls.

Event severity when failed calls exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of call that failed because of insufficient bandwidth exceeds the threshold you set. The default is 15.

Data Collection

Collect data for failed calls?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of call failures caused by insufficient bandwidth during the monitoring period. The default is unselected.

Monitor Available Video Bandwidth

Data Collection

Collect data for available video bandwidth?

Select Yes to collect data for charts and reports. If enabled, data collection returns the amount of video bandwidth available at each script iteration. The default is unselected.

Monitor Video Bandwidth Usage

Event Notification

Raise event if video bandwidth usage exceeds threshold?

Select Yes to raise an event if the percentage of video bandwidth usage exceeds the threshold. The default is Yes.

Threshold - Maximum video bandwidth usage

Specify the maximum percentage of video bandwidth usage that must occur before an event is raised. The default is 90%.

Event severity when video bandwidth usage exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of video bandwidth usage exceeds the threshold you set. The default is 15.

Data Collection

Collect data for video bandwidth usage?

Select Yes to collect data for charts and reports. If enabled, data collection returns the percentage of video bandwidth usage at each script iteration. The default is unselected.

Monitor Failed Video Stream Requests Failures Caused by Insufficient Bandwidth

Event Notification

Raise event if failed video stream requests exceed threshold?

Select Yes to raise an event if the number of video stream requests that fail because of insufficient bandwidth exceeds the threshold. The default is Yes.

Threshold - Maximum failed video stream requests

Specify the maximum number of video stream requests that must fail before an event is raised. The default is 0 requests.

Event severity when failed video stream requests exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of video stream requests that fail because of insufficient bandwidth exceeds the threshold you set. The default is 15.

Data Collection

Collect data for failed video stream requests?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of bandwidth-related failures of video stream requests that occurred during the monitoring period. The default is unselected.