4.35 MGCP_GatewayUsage

Use this Knowledge Script to monitor active and in-service ports, active channels, and in-service spans for the following components of MGCP (Media Gateway Control Protocol) gateways:

  • BRI (basic rate interface) spans

  • FXO (foreign exchange office) ports

  • FXS (foreign exchange station) ports

  • PRI (primary rate interface) spans

  • T1CAS (channel associated signaling) spans

An active port or channel is actively handling a call. An in-service port or span is registered to a Communications Manager and available for handling a call.

This script raises an event if a threshold is exceeded. In addition, this script generates data streams for active ports and active channels.

4.35.1 Resource Object

CiscoCM_MGCPGatewayObj

4.35.2 Default Schedule

By default, this script runs every 15 minutes.

4.35.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 MGCP_GatewayUsage job. The default is 5.

Event Notification

Raise event if number of BRI spans in service decreases?

Select Yes to raise an event if the number of in-service BRI spans has decreased since the last monitoring interval. The default is unselected.

Event severity when number of BRI spans in service decreases

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of in-service BRI spans has decreased since the last monitoring interval. The default is 15.

Raise event if number of FXO ports in service decreases?

Select Yes to raise an event if the number of in-service FXO ports has decreased since the last monitoring interval. The default is unselected.

Event severity when number of FXO ports in service decreases

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of in-service FXO ports has decreased since the last monitoring interval. The default is 15.

Raise event if number of FXS ports in service decreases?

Select Yes to raise an event if the number of in-service FXS ports has decreased since the last monitoring interval. The default is unselected.

Event severity when number of FXS ports in service decreases

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of in-service FXS ports has decreased since the last monitoring interval. The default is 15.

Raise event if number of PRI spans in service decreases?

Select Yes to raise an event if the number of in-service PRI spans has decreased since the last monitoring interval. The default is unselected.

Event severity when number of PRI spans in service decreases

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of in-service PRI spans has decreased since the last monitoring interval. The default is 15.

Raise event if number of T1CAS spans in service decreases?

Select Yes to raise an event if the number of in-service T1CAS spans has decreased since the last monitoring interval. The default is unselected.

Event severity when number of T1CAS spans in service decreases

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of in-service T1CAS spans has decreased since the last monitoring interval. The default is 15.

Monitor Active BRI Channels

Event Notification

Raise event if active BRI channels exceed threshold?

Select Yes to raise an event if the number of active BRI channels exceeds the threshold. The default is Yes.

Threshold - Maximum active BRI channels

Specify the maximum number of BRI channels that must be active before an event is raised. The default is 25 channels.

Event severity when active BRI channels exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of active BRI channels exceeds the threshold you set. The default is 15.

Data Collection

Collect data for active BRI channels?

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

Monitor Active FXO Ports

Event Notification

Raise event if active FXO ports exceed threshold?

Select Yes to raise an event if the number of active FXO ports exceeds the threshold. The default is Yes.

Threshold - Maximum active FXO ports

Specify the maximum number of FXO ports that must be active before an event is raised. The default is 100 ports.

Event severity when active FXO ports exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of active FXO ports exceeds the threshold you set. The default is 15.

Data Collection

Collect data for active FXO ports?

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

Monitor Active FXS Ports

Event Notification

Raise event if active FXS ports exceed threshold?

Select Yes to raise an event if the number of active FXS ports exceeds the threshold. The default is Yes.

Threshold - Maximum active FXS ports

Specify the maximum number of FXS ports that must be active before an event is raised. The default is 100 ports.

Event severity when active FXS ports exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of active FXS ports exceeds the threshold you set. The default is 15.

Data Collection

Collect data for active FXS ports?

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

Monitor Active PRI Channels

Event Notification

Raise event if active PRI channels exceed threshold?

Select Yes to raise an event if the number of active PRI channels exceeds the threshold. The default is Yes.

Threshold - Maximum PRI channels

Specify the maximum number of PRI channels that must be active before an event is raised. The default is 100 channels.

Event severity when active PRI channels exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of active PRI channels exceeds the threshold you set. The default is 15.

Data Collection

Collect data for active PRI channels?

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

Monitor Active T1CAS Channels

Event Notification

Raise event if active T1CAS channels exceed threshold?

Select Yes to raise an event if the number of active T1CAS channels exceeds the threshold. The default is Yes.

Threshold - Maximum T1CAS channels

Specify the maximum number of T1CAS channels that must be active before an event is raised. The default is 100 channels.

Event severity when active T1CAS channels exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of active T1CAS channels exceeds the threshold you set. The default is 15.

Data Collection

Collect data for active T1CAS channels?

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