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.
CiscoCM_LocationObj
By default, this script runs every 15 minutes.
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. |