Table Of Contents

Configuring Polling and Thresholds

Overview of Polling and Thresholds

Which Settings are Applied to a Device?

What Are Customizable Groups?

Setting Priorities for Customizable Groups

How Does ITM Prioritize Groups for Polling and Thresholds?

Viewing the Overriding Group—Example

How Can I Set Parameters for a Device?

Updating Polling Parameters and Thresholds

Selecting Device Groups

Setting Parameters for Each Device Function

Managing Polling Parameters

Viewing Polling Parameters

Editing Polling Parameters

Understanding What Happens when You Apply Changes

Restoring Default Polling Parameters

Device Functions and Polling Settings

Managing Thresholds

Viewing Thresholds

Editing Thresholds

Restoring Default Thresholds

Device Functions and Threshold Categories

Threshold Categories and Parameter Definitions

Confidence Test Settings

Disk Usage and Virtual Memory Settings

Environment - RIB Card Settings

Environment Settings

Environment - Temperature Sensor Settings

Ethernet Threshold Categories

Generic Interface and Port Performance Threshold Categories

Inactive Phone Settings

Interface and Port Flapping Threshold Categories

Interface - backup settings

Interface - dial on demand settings

Interface - ISDN B channel backup settings

MWI Threshold Settings

Processor and Memory Settings for Hosts, Routers, Switches, and Optical Switches

Processor and Memory Settings for Media Server

Processor and Memory Settings for VG248 (Voice Gateways)

Reachability Settings

Threshold Parameter Values and Events

Configuring Polling and Thresholds

---

These topics describe the process for configuring polling settings and threshold values:

•Overview of Polling and Thresholds

•Updating Polling Parameters and Thresholds

•Managing Polling Parameters

•Managing Thresholds

Overview of Polling and Thresholds

IP Telephony Monitor (ITM) polls devices at regularly scheduled intervals and compares the data collected from them against thresholds. Thresholds define acceptable levels of performance and utilization for a device group. When upper thresholds are exceeded, or values fall below lower thresholds, ITM generates appropriate alerts.

ITM is configured with default settings for polling parameters and threshold values. You can use the default settings, modify them, and restore them to default values at any time.

In many cases, it may be acceptable to use the default polling parameters. However, depending on how important a device group is, you can increase or decrease the polling interval to accomplish either of the following objectives:

•Minimize the impact on the polled devices

•Enhance the resolution of the collected data.

In many cases, you can enhance the performance and utilization of devices by adjusting thresholds, taking into account the following information:

•Location of the devices in the IP fabric

•Roles the devices play

•Resource constraints

Which Settings are Applied to a Device?

You can set and apply polling parameters and thresholds for device groups only, not for individual devices. Every device belongs to at least one system-defined device group. See the "Working with System-Defined Groups" section for information about how devices are assigned to system-defined groups.

When polling a device, ITM uses the parameters of the overriding group, the highest priority device group to which the device belongs. ITM also uses the parameters of the overriding group when comparing polled data against thresholds.

The highest priority groups for polling and thresholds are customizable groups. See the "What Are Customizable Groups?" section for more information.

System-defined groups have a lower priority for polling and thresholds than customizable groups. You cannot change the priorities of system-defined groups. See the "How Does ITM Prioritize Groups for Polling and Thresholds?" section for a prioritized list of all device groups.

What Are Customizable Groups?

Customizable groups are the only user-defined groups for which you can set polling and threshold parameters. They are also the highest priority device groups. ITM provides seven customizable groups.

Table 17-1 lists the customizable groups in default priority order.

Table 17-1 Polling and Thresholds: Customizable Groups

Customizable Groups	Intended Use
A B C	Consider reserving customizable groups A, B, and C to troubleshoot: Add one device to any of these groups when you need to test; for example, to test a changed threshold or timeout value for a polling setting.
1 2 3 4	Consider using customizable groups 1, 2, 3, and 4 when you want to override polling settings and thresholds for more than one device.

You can set priorities within the customizable groups. To do so, see the "Setting Priorities for Customizable Groups" section. You must add devices to the customizable groups before you can set polling parameters or threshold values for them. To do so, see the "Working with Customizable Groups" section.

See the "How Does ITM Prioritize Groups for Polling and Thresholds?" section for a prioritized list of all device groups.

Setting Priorities for Customizable Groups

Customizable groups always have a higher priority than system-defined groups. You can change the priority of the customizable groups with respect to one another. By default, customizable groups are prioritized in the following order:

•Customizable Group A, Customizable Group B, Customizable Group C

•Customizable Group 1, Customizable Group 2, Customizable Group 3, Customizable Group 4

Before You Begin

If there are no devices in the customizable groups, add devices to them. Otherwise, you will not be able to prioritize them. See the "Creating and Editing Groups" section.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Setting Priorities. The Setting Priorities page appears, displaying the groups in priority order.

Step 2 Rearrange the groups according to your preference (the closer the group is to the top of the list, the higher its priority):

a. Select a customizable group.

b. Move the group up or down using the arrows.

Step 3 Click Apply. The changes are now saved in the database.

---

Note The changes are not applied to the IP fabric until you reconfigure the IP fabric. See the "Applying Changes" section.

---

---

How Does ITM Prioritize Groups for Polling and Thresholds?

ITM prioritizes device groups as shown in Table 17-2, with device groups in descending order of priority. A device can belong to multiple groups. ITM uses the highest priority group to which the device belongs to determine polling and threshold parameters for it.

Table 17-2 Device Groups Prioritized for Polling and Thresholds 

Device Groups in Priority Order				Parameters to Set
User Defined Groups				None
	Customizable Groups Note You can change priority order among members of this group.			None
		Customizable Group A		Depends on the type of device you add to each group
		Customizable Group B
		Customizable Group C
		Customizable Group 1		Depends on the types of devices you add to each group
		Customizable Group 2
		Customizable Group 3
		Customizable Group 4
System Defined Groups Note You cannot change priority order among members of this group.				None
	Cisco CallManager or Cluster			None
		Cluster name (the name Cisco CallManager provides for the cluster)		Polling and threshold parameters
			All 78XX Media Servers	Polling and threshold parameters
			All Cisco ICS 77XX	Polling and threshold parameters
			All Cisco Gatekeepers	Polling and threshold parameters
			All Cisco Voice Gateways	Polling and threshold parameters
			All Cisco Voice Mail Gateways	Polling and threshold parameters
	All Cisco IP Telephony Applications			None
		All Cisco Emergency Responders		Polling and threshold parameters
		All Cisco Unity Applications		Polling and threshold parameters
		All Cisco Customer Response Applications		Polling and threshold parameters
		All Cisco Personal Assistants		Polling and threshold parameters
		All Cisco CallManagers		Polling and threshold parameters
	All 78XX Media Servers			Polling and threshold parameters
	All Cisco ICS 77XX			Polling and threshold parameters
	All Cisco Gatekeepers			Polling and threshold parameters
	All devices with T1-E1 interfaces			Polling and threshold parameters
	All devices with FXX interfaces			Polling and threshold parameters
	All Cisco Voice Gateways			Polling and threshold parameters
	All Cisco Switches with phones connected			Polling and threshold parameters
	All Cisco Voice Mail Gateways			Polling and threshold parameters
	All Cisco Gateways			None
		All Cisco Voice Gateways		Polling and threshold parameters
		All Cisco Voice Mail Gateways		Polling and threshold parameters
	All Cisco Optical Switches			Polling and threshold parameters
	All Cisco Switches			Polling and threshold parameters
	All Cisco Routers			Polling and threshold parameters
	All Cisco Hubs			Polling and threshold parameters

---

Note To find the overriding group for a device, you can select any device group to which the device belongs and view a Polling Parameter Summary or a Threshold Parameter Summary for the group.

---

For additional information, see the following topics:

•How Does ITM Prioritize Groups for Polling and Thresholds?

•Selecting Device Groups

•Setting Parameters for Each Device Function

Viewing the Overriding Group—Example

The following example illustrates finding the overriding group for a router that has a T1 module and is registered to a Cisco CallManager, SJC-CCM11. Based on its device type, its components, and its registration with a Cisco CallManager, the router belongs to all of the following groups.

Groups to which router with a T1 module belongs	Devices that can also be members of the group1
P0	All devices
P0/System Defined Groups	All devices
P0/All Cisco Gateways	All Cisco voice gateways and voice mail gateways
P0/All Cisco Gateways/All Cisco Voice Gateways	All Cisco voice gateways
All devices with T1-E1 interfaces	All devices with T1-E1 interfaces
All Cisco Routers	All Cisco routers
Cisco CallManager or Cluster/VE-SJC-CCM11-Cluster/ All Cisco Voice Gateways	All voice gateways in the SJC-CCM11 cluster

1 From among devices that ITM can poll.

The Polling Parameter Summary and Threshold Parameter Summary pages for a device group display each device that is a member of the group, along with its overriding group.

To obtain a polling or threshold parameter summary page that includes a particular device, you must select a group to which the device belongs. To obtain a summary that includes fewer devices, select a group with fewer members.

How Can I Set Parameters for a Device?

When you set polling parameters and thresholds, you set them for a device group. If you want to set parameters for a device, you can add the device to a customizable group and set parameters for the group. See the "What Are Customizable Groups?" section.

You can also set parameters for the overriding device group to which a device belongs. See the "How Does ITM Prioritize Groups for Polling and Thresholds?" section for an explanation of how to find the overriding group for a device.

For additional information, see the following topics:

•Viewing Polling Parameters

•Viewing Thresholds

Updating Polling Parameters and Thresholds

This topic explains how to update polling parameters and thresholds and provides links to the related procedures.

ITM is preconfigured with default polling parameter and thresholds for each system-defined group of devices. You can make the following changes:

•Update the polling parameters and thresholds for system-defined groups.

•Restore polling parameters and thresholds to default values.

•Add devices to one or more of seven predefined customizable groups and edit their polling parameters and thresholds.

Table 17-3 describes the basic process for updating polling parameters and thresholds.

Table 17-3 Updating Polling Parameters and Thresholds: Process

	Task	Procedures
Step 1	If you are working with a customizable group, you may need to attend to the following tasks first: a. Add devices to the customizable group. By default, no devices belong to customizable groups. b. (Optional) Set the priority of the customizable group. Customizable groups have default priority settings, but you may want to change them.	Creating and Editing Groups Setting Priorities for Customizable Groups
Step 2	Change polling parameters and thresholds for a device group.	Editing Polling Parameters Restoring Default Polling Parameters Managing Thresholds Restoring Default Thresholds
Step 3	When you are done with all changes, if possible, select a time of low activity on the network to update the IP fabric with these changes. The new values will not be used until you apply changes. 1	Applying Changes

1 Note: You do not need to apply changes after you update the Inactive phone threshold setting; the updated value is applied immediately.

Selecting Device Groups

The first thing you must do when you use polling and threshold options is select a device group. If you want to view parameters, you can select any device group. If you want to edit parameters or restore them to default values, you must select a device group for which parameters exist.

Table 17-4 lists groups in the order in which they are displayed in the group selector and notes whether applicable parameters exist for the group. The group selector you see may not display all groups listed in Table 17-4; it displays only those device groups that contain devices.

Table 17-4 Device Groups as Displayed in the Device Selector 

Device Groups in Display Order					Parameters to Set
P0					None
	System Defined Groups				None
		All 78XX Media Servers			Polling and threshold parameters
		All Cisco Gatekeepers			Polling and threshold parameters
		All Cisco Gateways			None
			All Cisco Voice Gateways		Polling and threshold parameters
			All Cisco Voice Mail Gateways		Polling and threshold parameters
		All Cisco Hubs			Polling and threshold parameters
		All Cisco ICS 77XX			Polling and threshold parameters
		All Cisco IP Telephony Applications			None
			All Cisco Emergency Responders		Polling and threshold parameters
			All Cisco Unity Applications		Polling and threshold parameters
			All Cisco Customer Response Applications		Polling and threshold parameters
			All Cisco Personal Assistants		Polling and threshold parameters
			All Cisco CallManagers		Polling and threshold parameters
		All Cisco Optical Switches			Polling and threshold parameters
		All Cisco Routers			Polling and threshold parameters
		All Cisco Switches			Polling and threshold parameters
		All Cisco Switches with phones connected			Polling and threshold parameters
		All Cisco Voice Gateways			Polling and threshold parameters
		All Cisco Voice Mail Gateways			Polling and threshold parameters
		All devices with T1-E1 interfaces			Polling and threshold parameters
		All devices with FXX interfaces			Polling and threshold parameters
		Cisco CallManager or Cluster			None
			Cluster name —Name Cisco CallManager provides for cluster		Polling and threshold parameters
				All 78XX Media Servers	Polling and threshold parameters
				All Cisco ICS 77XX	Polling and threshold parameters
				All Cisco Gatekeepers	Polling and threshold parameters
				All Cisco Voice Gateways	Polling and threshold parameters
				All Cisco Voice Mail Gateways	Polling and threshold parameters
	User Defined Groups				None
		Customizable Groups			None
			Customizable Group 1		Polling and threshold parameters
			Customizable Group 2
			Customizable Group 3
			Customizable Group 4
			Customizable Group A		Polling and threshold parameters
			Customizable Group B
			Customizable Group C

For additional information, see the following topics:

•Selecting Objects and Groups

•Viewing Polling Parameters

•Editing Polling Parameters

•Viewing Thresholds

•Editing Thresholds

Setting Parameters for Each Device Function

Polling parameter and threshold settings are grouped by device function. When you set polling parameters and manage thresholds, you can set them for each available function in a device group.

Table 17-5 lists device groups and functions for which you can set polling and threshold parameters.

Table 17-5 Device Groups and Functions 

Device Group			Functions with Polling Parameters to Set1	Functions with Thresholds to Manage2
All 78XX Media Servers			Host Media Server	Host Media Server
All Cisco Gatekeepers			Router Voice Gateway	Router Voice Gateway
All Cisco Gateways
	All Cisco Voice Gateways		Host Phone Access Switch Router Switch Voice Gateway	Host Router Switch Voice Gateway
	All Cisco Voice Mail Gateways		Host Voice Mail Gateway	Host Voice Mail Gateway
All Cisco Hubs			Hub	Hub
All Cisco ICS 77XX			Host ICS Router Switch	Host ICS Router Switch
All Cisco Optical Switches			Switch	Switch
All Cisco Routers			Phone Access Switch Router Voice Gateway	Router Voice Gateway
All Cisco IP Telephony Applications
	All Cisco CallManagers All Cisco Customer Response Applications All Cisco Emergency Responders All Cisco Personal Assistants All Cisco Unity Applications		Host Media Server	Host Media Server
All Cisco Switches			Phone Access Switch Switch Voice Gateway	Switch Voice Gateway
All Cisco Switches with phones connected			Phone Access Switch Switch Voice Gateway	Switch Voice Gateway
All devices with FXX interfaces All devices with T1-E1 interfaces			Phone Access Switch Router Switch Voice Gateway	Router Switch Voice Gateway
Cisco CallManager or Cluster			Cisco CallManager or Cluster	Cisco CallManager or Cluster
	VE-<Cluster name>

1 See the "Device Functions and Polling Settings" section for polling settings associated with each function. 2 See the "Device Functions and Threshold Categories" section for threshold categories associated with each function.

---

Note A customizable group may contain members of one or more of the groups in Table 17-5.

---

Managing Polling Parameters

After you select the Polling Parameters application from the ITM navigation tree, you can perform any of the following tasks:

•Viewing Polling Parameters

•Editing Polling Parameters

•Restoring Default Polling Parameters

Viewing Polling Parameters

When you view polling parameters, you can see the devices that are members of the device group, and you can see the default as well as current values for the polling parameters.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Polling Parameters.

Step 2 Select any device group from the group selector. For more information, see the "Selecting Device Groups" section.

Step 3 Click the View button. The Polling Parameter Summary tabular display opens in a separate window. This display provides the following information.

Field	Explanation
Device Name	IP address or DNS name of a device.
Function (n)	A device can have more than one function; n indicates the number of parameters for the function. See the "Setting Parameters for Each Device Function" section for a list of functions that a device group can serve.
Polling Parameters	•Parameter—Name of the polling setting to which the values apply. Each function can have multiple polling settings. •Default Value (sec)—Default number of seconds between successive polls for the setting. •Default Retries—Default number of times to retry a failed poll request. •Default Timeout (msec)—Default number of milliseconds before a poll request times out. •Current Value (sec)—Current number of seconds between successive polls for the setting. •Current Retries—Current number of times to retry a failed poll request. •Current Timeout (msec)—Current number of milliseconds before a poll request times out. •Enabled—Whether polling is enabled (true) or not (false). •Overriding Group—Device group from which polling parameter values are applied. (This is the highest priority device group to which the device belongs.) Note If you want to change the polling parameters for a device, you can edit the settings for the overriding group. See the "Editing Polling Parameters" section.

Step 4 When you are done viewing the polling parameters, close the tabular display.

---

For additional information, see the following topics:

•Viewing the Overriding Group—Example

•Viewing Data from Tabular Displays with Over 2000 Records

•Exporting Data from Tabular Displays

•Printing Tabular Displays

Editing Polling Parameters

When you edit polling parameters, you edit settings that are associated with device groups, not with individual devices.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Polling Parameters.

Step 2 Select a device group for which you can set polling parameters. See the "Selecting Device Groups" section for a list of such device groups.

---

Note Not all device groups displayed have polling parameters associated with them.

---

Step 3 Click the Edit button. The Polling Parameters: Edit page appears, displaying the following information.

Field	Explanation
Function	Devices may serve more than one function. For a list of functions present in the group, see the "Setting Parameters for Each Device Function" section. Each function has separate polling parameter settings. For a list of polling parameters for each function, see the "Device Functions and Polling Settings" section.
Parameters	The parameters for the selected function are displayed, including: •Current values for each setting •Whether values are the default values (Default check box selected) •Whether polling is enabled for the settings (Enabled check box selected)

Step 4 To edit all parameters, repeat the following steps for each function:

a. Select a function.

b. Change the parameters appropriately for each setting. Each setting controls how frequently devices are polled for a particular type of data; for example, reachability.

•To reset all settings to default values, select the Default check box in the table heading.

•To disable polling for all settings, deselect the Enabled check box in the table heading.

•To set parameters for individual settings, enter data for the following parameters for each setting.

Field	Description	Usage Notes
New Interval	Enter the number of seconds between successive polls for the setting. Maximum value: 3600	See the "Device Functions and Polling Settings" section for minimum interval for each polling setting.
New Timeout	Enter the number of milliseconds allowed for a poll request before it times out. Minimum value: 10 Maximum value: 10,000 Increment: 100	Note Access port settings (for switch and router threshold categories) use the timeout value for Connector port and interface settings.
New Retry	Enter the number of times to retry a failed poll request. Minimum value: 0 Maximum value: 10 Increment: 1	Note Access port settings (for switch and router threshold categories) use the retry value for Connector port and interface settings.
Default	To reset the values for the setting to the defaults, select this check box. Note The Default check box in the table heading can override this setting.	To view default values, see the "Viewing Polling Parameters" section.
Enabled	To disable polling for this setting, deselect this check box. To enable polling, select it. Note The Enabled check box in the table heading can override this setting.	Note Access port settings (for switch and router threshold categories) are enabled or disabled depending on the Enabled check box for the Connector port and interface settings.

Step 5 To save the settings, do one of the following:

•Click Apply to save the settings and display the Polling Parameters: Edit page again.

•Click OK to save the settings and close the Polling Parameters: Edit page.

---

Note Although the polling parameters are saved in the database, they are not yet applied to the IP fabric. See the "Applying Changes" section.

---

---

For additional information, see the following topics:

•Selecting Device Groups

•Updating Polling Parameters and Thresholds

•Restoring Default Polling Parameters

Understanding What Happens when You Apply Changes

When you apply changes, ITM performs the following tasks:

•Recalculates the polling settings and thresholds of the devices in the selected device group

•Determines the overriding group, based on the priorities of the groups the devices belong to

•Applies the polling settings and thresholds, from the overriding group for each of the devices, to the devices.

After you apply changes, you can verify that the changes took effect by viewing the polling parameters and thresholds for the group. For instructions, see the "Device Functions and Polling Settings" section and the "Viewing Thresholds" section.

Restoring Default Polling Parameters

You can restore all parameter settings for all functions of a device group to default values using this procedure. If, instead, you want to restore only a few functions or settings, see the "Editing Polling Parameters" section.

Before You Begin

To review default polling settings before you apply them, view the Polling Parameter Summary for the device group. See the "Viewing Polling Parameters" section. Current settings along with the default settings are displayed.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Polling Parameters.

Step 2 Select a device group for which you can restore polling parameters. See the "Selecting Device Groups" section for a list of such device groups.

---

Note Not all device groups displayed have polling parameters associated with them.

---

Step 3 Click the Default button. A confirmation dialog box appears.

Step 4 Click Yes.

---

Note The settings are stored in the database, but not yet applied to the IP fabric. See the "Applying Changes" section.

---

---

Device Functions and Polling Settings

Table 17-6 lists the polling settings that are applicable to each device function, along with the minimum polling interval for each setting.

---

Note The minimum interval is usually lower than the default value provided by ITM. See the "Viewing Polling Parameters" section to obtain information about default parameter values.

---

See the "Editing Polling Parameters" section for minimum and maximum values of all parameters. See Table 17-5 for the functions that can be served by each device group.

Table 17-6 Polling Settings for Device Functions 

Function	Polling Settings	Minimum Interval (in seconds)
Cisco CallManager or Cluster	Cisco CallManager or cluster polling settings Digital voice gateway to cluster connectivity settings Gatekeeper to cluster connectivity settings Monitored phone to cluster connectivity settings1 Suspect phone polling settings Voice gateway to cluster connectivity settings	240 240 240 240 240 240
Host	Reachability settings2	30
Hub	Reachability settings2	30
Integrated Communication System (ICS)	Application polling settings Environment settings SPE - Hard disk and virtual memory utilization settings SPE - Ethernet interface settings	30 30 30 30
Media Server	Application polling settings Ethernet interface settings Environment - power supply, fan, and temperature sensor settings Environment - RIB card settings Hard disk and virtual memory settings Processor and memory utilization settings	30 30 30 30 30 30
Monitored Phone2	Reachability settings	30
Optical Switch	See polling settings for Switch
Phone Access Switch	Phone port settings	30
Router	Access port settings3 Connector port and interface settings3 Environment settings Processor and memory utilization settings Reachability settings2	30 30 30 30 30
Switch	Access port settings3 Connector port and interface settings3 Environment settings Processor and memory utilization settings Reachability settings2	30 30 30 30 30
Voice Gateway	E1 voice ports settings DS1 voice ports settings FXX interface settings Processor and memory utilization settings VG248 ports to cluster connectivity settings	30 30 30 30 30
Voice Mail Gateway	CCM connectivity settings Ethernet interface settings Port settings Processor and memory utilization settings	30 30 30 30

1 Monitored phones are replaced by phone reachability testing if IDU 2 or later is installed. 2 The polling interval for the reachability settings of a system determines the ICMP polling interval for the system. See the "How ITM Calculates ICMP Polling Intervals" section for more information. 3 Access port settings and connector port and interface settings are interrelated. You enable or disable polling for both settings when you select or deselect the Enable check box for connector port and interface settings. You cannot enable or disable polling for access port settings alone.

Managing Thresholds

When you select the Managing Thresholds application from the ITM navigation tree, you can perform any of the following tasks:

•Viewing Thresholds

•Editing Thresholds

•Restoring Default Thresholds

Viewing Thresholds

When you view thresholds, you can see the devices that are members of the device group, and you can see the default as well as current values for the thresholds.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Managing Thresholds.

Step 2 Select any device group from the group selector. For more information, see the "Selecting Device Groups" section.

Step 3 Click the View button. The Thresholds Summary tabular display opens in a separate window. The Thresholds Parameter Summary tabular display provides the following information.

Field	Explanation
Device Name	IP address or DNS name of the device.
Function (n)	A device can have more than one function; n indicates the number of parameters for the function. See the "Setting Parameters for Each Device Function" section for a list of functions that a device group may serve.
Threshold Parameters	•Category Name (n)—Each threshold category contains parameters related to a device element; n indicates the number of parameters in the category. •Parameter—Threshold name. •Metric—How ITM measures the parameter value: –%—percent. –count—number of occurrences. –sec—number of seconds. –C—centigrade. •Default—Default value for the parameter. •Current—Current value for the parameter. •Overriding Group—Device group from which threshold parameter values are applied. (This is the highest priority device group to which the device belongs.) Note If you want to change the threshold parameters for a device, you can edit the settings for the overriding group. See the "Editing Thresholds" section.

Step 4 When you are done viewing the threshold parameters, close the tabular display window.

---

For additional information, see the following topics:

•Viewing the Overriding Group—Example

•Viewing Data from Tabular Displays with Over 2000 Records

•Exporting Data from Tabular Displays

•Printing Tabular Displays

Editing Thresholds

When you edit thresholds, you edit values that are associated with device groups, not with individual devices.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Managing Thresholds.

Step 2 Select a device group for which you can set thresholds. See the "Selecting Device Groups" section for a list of such device groups.

---

Note Not all device groups displayed have thresholds associated with them.

---

Step 3 Click the Edit button. The Thresholds: Edit page appears, displaying the following information.

Field	Explanation
Function	Some device types serve more than one function. See Table 17-5 for a list of device groups and related functions. You can set thresholds for each function.
Threshold Category	One or more categories for each function. Only those categories that are applicable to the devices in the group are displayed.
Parameter	The parameters for the currently selected function and threshold category are displayed, including: •Current value for each threshold alongside an entry field for a new value. •Default check boxes that allow you to reset default values for all thresholds or for selected thresholds.

Step 4 To edit all thresholds, repeat the following steps for each function:

a. Select a function.

b. For each threshold category, select the threshold category and change the thresholds appropriately:

•To reset default values for all thresholds in the category, select the Default check box in the table heading.

•To set values for individual thresholds, enter data for each threshold:

Field	Description
New Value	(Optional) Enter a new value.
Default	If you entered a new value, make sure that the Default check box is not selected. To reset thresholds to the default values, select this check box. Note The Default check box in the table heading can override this setting.

Step 5 To save the thresholds, do one of the following:

•Click Apply to save the thresholds and display the Thresholds: Edit page again.

•Click OK to save the thresholds and close the Thresholds: Edit page.

---

Note Although the thresholds are saved in the database, they are not yet applied to the IP fabric. See the "Applying Changes" section.

---

---

For additional information, see the following topics:

•Threshold Categories and Parameter Definitions

•Understanding What Happens when You Apply Changes

Restoring Default Thresholds

You can use this procedure to reset all thresholds for all functions of a device group, and you can reset all categories of thresholds to use default values. However, if, instead, you want to reset only a few functions or threshold categories to default values for a device group, see the "Editing Thresholds" section.

Before You Begin

To review default thresholds before you apply them, view the thresholds for the device group. See the "Viewing Thresholds" section. Current values are displayed along with the default values.

---

Step 1 Select IP Telephony Monitor > Configuration > Polling and Thresholds > Managing Thresholds.

Step 2 Select a device group for which you can set thresholds. See the "Selecting Device Groups" section for a list of such device groups.

---

Note Not all device groups displayed have polling parameters associated with them.

---

Step 3 Click the Default button. A confirmation dialog box appears.

Step 4 Click Yes.

---

Note The settings are stored in the database, but not yet applied to the IP fabric. See the "Applying Changes" section.

---

---

For additional information, see the following topics:

•Viewing Thresholds

•Threshold Categories and Parameter Definitions

Device Functions and Threshold Categories

Table 17-7 lists the threshold categories for each device function. For the parameters that you can set for each threshold category, see the "Threshold Categories and Parameter Definitions" section or the "Threshold Parameter Values and Events" section. For a list of device types and functions, see Table 17-5.

Table 17-7 Functions and Related Threshold Categories 

Function	Threshold Categories
Cisco CallManager or Cluster	Inactive phone settings
Host1	Environment settings Interface - 1 GB Ethernet settings Interface - 10/100 MB Ethernet settings Interface - other generic interface/port performance settings Interface - other interface/port flapping settings Interface - serial generic interface/port performance settings Interface - serial interface/port flapping settings Interface - voice interface generic performance settings Interface - voice interface flapping settings Processor and memory settings Reachability settings
Hub	Interface - 1 GB Ethernet settings Interface - 10/100 MB Ethernet settings Reachability settings
ICS	SPE - Confidence test settings SPE - disk virtual memory settings SPE - MWI threshold settings
Media Server	Confidence test settings Disk usage and virtual memory settings Environment - RIB card settings Environment - temperature sensor settings MWI threshold settings Processor and memory settings
Monitored Phone2	None
Optical Switch	See threshold categories for Switch
Phone Access Switch	None
Router1	Environment settings Interface - 1 GB Ethernet settings Interface - 10/100 MB Ethernet settings Interface - ATM generic interface/port performance settings Interface - ATM interface/port flapping settings Interface - backup settings Interface - dial on demand settings Interface - FDDI settings Interface - ISDN B channel backup settings Interface - ISDN D channel interface flapping settings Interface - ISDN physical interface flapping settings Interface - ISDN physical interface generic performance settings Interface - other generic interface/port performance settings Interface - other interface/port flapping settings Interface - serial generic interface/port performance settings Interface - serial interface/port flapping settings Interface - token ring settings Interface - voice interface generic performance settings Interface - voice interface flapping settings Processor and memory settings Reachability settings
Switch1	Access port - 1 GB Ethernet settings Access port - 10/100 MB Ethernet settings Access port - ATM settings Access port - voice port generic performance settings Access port - other settings Environment settings Processor and memory settings Interface - 1 GB Ethernet settings Interface - 10/100 MB Ethernet settings Interface - ATM generic interface/port performance settings Interface - ATM interface/port flapping settings Interface - backup settings Interface - dial on demand settings Interface - FDDI settings Interface - ISDN B channel backup settings Interface - ISDN D channel interface flapping settings Interface - ISDN physical interface flapping settings Interface - ISDN physical interface generic performance settings Interface - other generic interface/port performance settings Interface - other interface/port flapping settings Interface - serial generic interface/port performance settings Interface - serial interface/port flapping settings Interface - token ring settings Interface - voice interface generic performance settings Interface - voice interface flapping settings Reachability settings
Switch 1(continued)	Trunk port - 1 GB Ethernet settings Trunk port - 10/100 MB Ethernet settings Trunk port - ATM settings Trunk port - other settings Trunk port - voice port generic performance settings-
Voice Gateway	Processor and memory settings
Voice Mail Gateway	Processor and memory settings

1 Some interface and port settings will not be displayed. The settings appear only when related interfaces and ports exist in inventory for the device group. 2 Monitored phones are replaced by phone reachability testing if IDU 2 or later is installed.

Threshold Categories and Parameter Definitions

When you manage thresholds, you must select a device group, a device function, and a threshold category. Threshold categories contain groups of parameters or thresholds that apply to that category.

For a list of device groups and their functions, see Table 17-5. For the threshold categories related to each function, see Table 17-7. For the threshold parameters that you can set for each category, see Table 17-8.

Confidence Test Settings

This threshold category monitors the failure rate of confidence tests.

Confidence Test Tolerance

Represents the upper threshold for the failure rate of the confidence test. Confidence test tolerance is expressed as a percentage of the total number of confidence tests.

Disk Usage and Virtual Memory Settings

Disk usage and virtual memory settings monitor the performance of disk usage and virtual memory elements. Events such as high disk utilization and high virtual memory utilization are controlled by these parameters.

Free hard disk threshold

Threshold for minimum amount of hard disk space, expressed as a percentage of the total hard disk memory.

Free virtual memory threshold

Threshold for minimum amount of free virtual memory, expressed as a percentage of total virtual memory.

Environment - RIB Card Settings

Battery percent charged threshold

Low threshold setting, expressed as a percentage of battery charge.

Environment Settings

Relative temperature threshold

Indicates how close the current temperature value can be to the value that triggers an emergency shutdown, expressed as a percentage of the emergency shutdown value. For example, if the shutdown temperature is 50° C and the Relative temperature threshold is 10%, the OutofRange event occurs if the temperature exceeds 45° C.

Relative voltage threshold

Indicates how close the current voltage value can be to the value that triggers an emergency shutdown, expressed as a percentage of the emergency shutdown value. For example, if the shutdown value is +30V and the Relative voltage threshold is 10%, the OutofRange event occurs if the voltage exceeds +27V.

Environment - Temperature Sensor Settings

Temperature threshold

Temperature threshold in degrees Celsius.

Ethernet Threshold Categories

There are several threshold categories for Ethernet interfaces, ports, and trunks. These threshold categories configure the monitoring of an Ethernet network adapter's performance characteristics.

The following parameters are included in the Ethernet threshold categories.

Broadcast threshold

The upper threshold for broadcast traffic, expressed as a percentage of the total bandwidth.

Collision threshold

The upper threshold for collisions, expressed as a percentage of the total number of output packets. This threshold applies only to Ethernet settings for ports, trunks, and interfaces.

Discard threshold

The upper threshold for dropped packets, expressed as a percentage of the total number of packets.

Error threshold

The upper threshold for packet errors, expressed as a percentage of the total number of packets. If you have not installed IDU 2 or later, ITM generates the HighErrorRate event when Error threshold is exceeded. Otherwise, ITM generates the HighErrorRate event when both Error threshold and Error traffic threshold are reached or exceeded.

Error traffic threshold

---

Note Error traffic threshold is available only if you have downloaded and installed Incremental Device Update (IDU) 2 or later from the ITM download site: http://www.cisco.com/pcgi-bin/tablebuild.pl/item-3des.

---

The upper threshold for packet rate, expressed as a percentage of the total bandwidth. ITM generates the HighErrorRate event when both Error threshold and Error traffic threshold are reached or exceeded. The value for Error traffic threshold can include up to two decimal places.

---

Note If you have not installed IDU 2 or later, see Error threshold.

---

Queue drop threshold

The acceptable percentage of packets dropped because of full queues, expressed as a percentage of the total number of packets.

Utilization threshold

The upper threshold for link utilization, expressed as a percentage of the total bandwidth.

Generic Interface and Port Performance Threshold Categories

Several threshold categories apply to interfaces and port performance. These threshold categories configure the monitoring of a non-Ethernet network adapter's performance characteristics. The categories include basic parameters—such as utilization, errors, broadcast, and packet drops—common to all media types.

Broadcast threshold

The upper threshold for broadcast traffic, expressed as a percentage of the total bandwidth.

Discard threshold

The upper threshold for dropped packets, expressed as a percentage of the total number of packets.

Error threshold

The upper threshold for packet errors, expressed as a percentage of the total number of packets. If you have not installed IDU 2 or later, ITM generates the HighErrorRate event when Error threshold is exceeded. Otherwise, ITM generates the HighErrorRate event when both Error threshold and Error traffic threshold are reached or exceeded.

Error traffic threshold

---

Note Error traffic threshold is available only if you have downloaded and installed Incremental Device Update (IDU) 2 or later from the ITM download site: http://www.cisco.com/pcgi-bin/tablebuild.pl/item-3des.

---

The upper threshold for packet rate, expressed as a percentage of the total bandwidth. ITM generates the HighErrorRate event when both Error threshold and Error traffic threshold are reached or exceeded. The value for Error traffic threshold can include up to two decimal places.

---

Note If you have not installed IDU 2 or later, see Error threshold.

---

Queue drop threshold

The acceptable percentage of packets dropped because of full queues, expressed as a percentage of the total number of packets.

Utilization threshold

The upper threshold for link utilization, expressed as a percentage of the total bandwidth.

Inactive Phone Settings

This threshold category monitors the number of inactive phones connected to the Cisco CallManager.

Inactive phone threshold

Represents the upper threshold for inactive phones. Inactive phone threshold is expressed as a percentage of the total number of phones connected to the Cisco CallManager cluster.

---

Note When you update the Inactive phone threshold, the change goes into effect immediately. You do not need to use Apply Changes as described in the "Updating Polling Parameters and Thresholds" section.

---

Interface and Port Flapping Threshold Categories

There are several threshold categories for interface and port flapping. These categories control the analysis of network adapters (ports and interfaces) that are continually going up and down, or flapping. Flapping analysis monitors SNMP link down traps to identify a flapping network adapter. ITM reports flapping as a fault condition. For more information, see "How ITM Calculates Repeated Restarts and Flapping."

Link trap threshold

The number of SNMP link down traps that must be received within the Link trap window for ITM to consider the interface or port flapping. A value of 0 disables flapping analysis.

Link trap window

The amount of time used to monitor flapping analysis of a port or interface. If the number of link down traps meets or exceeds the Link trap threshold during this window of time, the interface or port is considered to be flapping.

Interface - backup settings

The Interface - backup settings threshold category configures an interface as a backup. When an interface is identified as a backup:

•The InterfaceOperationallyDown event is not generated if the interface is down.

•The ExceededMaximumUptime event is generated if the interface stays up too long.

The following parameter is included in the Interface - backup settings threshold categories.

Maximum Uptime

The maximum length of time, in seconds, that the interface may be up before the ExceededMaximumUptime event is generated. If the value of this parameter is 0, the ExceededMaximumUptime event is disabled.

Interface - dial on demand settings

This threshold category identifies an interface as dial on demand. In this case:

•The InterfaceOperationallyDown event is not generated if the interface is down.

•The ExceededMaximumUptime event is generated if the interface stays up too long.

The following parameter is included in the Interface - dial on demand settings threshold category.

Maximum uptime

The maximum length of time that the interface may be up before the ExceededMaximumUptime event is generated. If the value of this parameter is 0, the ExceededMaximumUptime event is disabled.

Interface - ISDN B channel backup settings

The Interface - ISDN B channel backup settings threshold category configures an interface as a backup. When an interface is identified as a backup:

•The InterfaceOperationallyDown event is not generated if the interface is down.

•The ExceededMaximumUptime event is generated if the interface stays up too long.

The following parameter is included in the Interface - ISDN B channel backup settings threshold category.

Maximum Uptime

The maximum length of time, in seconds, that the interface may be up before the ExceededMaximumUptime event is generated. If the value of this parameter is 0, the ExceededMaximumUptime event is disabled.

MWI Threshold Settings

MWI on time threshold

Number of seconds within which the Unity message waiting indicator (MWI) light must appear.

Processor and Memory Settings for Hosts, Routers, Switches, and Optical Switches

Backplane utilization threshold

The upper threshold for a switch's backplane utilization, expressed as a percentage of the total backplane bandwidth.

Free memory threshold

The lower threshold for the acceptable amount of free memory, as measured by the ratio of free memory to the total memory.

Memory buffer miss threshold

The upper threshold for the number of buffer misses, expressed as a percentage of the total number of buffer requests.

Memory buffer utilization threshold

The upper threshold for the number of buffers used, expressed as a percentage of the total number of buffers.

Memory fragmentation threshold

The lower threshold for memory fragmentation. The fragmentation value is the ratio of the largest number of contiguous unallocated bytes to the total amount of free memory. For example, a value of 5 indicates that the largest free buffer must be at least 5% of the free memory.

Processor utilization threshold

The upper threshold for processor utilization, expressed as a percentage of the total capacity of the processor.

Processor and Memory Settings for Media Server

Processor and Memory settings configure the performance monitoring of a system's CPU and its associated memory elements.

Free physical memory threshold

Contains minimum acceptable free physical memory, expressed as a percentage of the total amount of physical memory.

Processor utilization threshold

The upper threshold for processor utilization, expressed as a percentage of the total capacity of the processor.

Processor and Memory Settings for VG248 (Voice Gateways)

Processor and Memory settings configure the performance monitoring of a system's CPU and its associated memory elements.

VG248 free physical memory threshold

Contains minimum acceptable free physical memory, expressed as a percentage of the total amount of physical memory.

VG248 processor utilization threshold

The upper threshold for processor utilization, expressed as a percentage of the total capacity of the processor.

Reachability Settings

The reachability settings configure reachability parameters for network adapters (ports and interfaces). They also control the analysis of systems that repeatedly restart, triggering Repeated Restarts and Flapping events. The following parameters are included in the Reachability Settings threshold category.

Restart trap threshold

The number of SNMP cold or warm start traps that must be received within the amount of time set by the Restart trap window parameter for ITM to consider a system to be performing excessive restarts. A value of 0 disables restart analysis. For more information, see "How ITM Calculates Repeated Restarts and Flapping."

---

Note If you want cold and warm start traps to generate events to be displayed immediately in the Alerts and Activities display, set the value of Restart trap threshold to 1.

---

Restart trap window

The amount of time used to monitor a system's repeated restarts. If the number of start traps meets or exceeds the Restart trap threshold during this window of time, the system is considered to be performing excessive restarts.

The minimum value is 30 seconds, and the maximum value is 3600 seconds.

Threshold Parameter Values and Events

Table 17-8 lists threshold categories, the threshold parameters in each category, minimum and maximum values for the threshold parameters, and the events that ITM generates when values pass the threshold.

---

Note Most thresholds are upper thresholds, representing the highest acceptable value. Lower thresholds are the exception and are footnoted as such.

---

Table 17-8 Minimum and Maximum Threshold Parameter Values and Related Events 

Threshold Category	Applicable Threshold Parameters (with unit of measure)	Values Min Max		Events Generated after Value Passes Threshold
Access port - ATM settings Access port - other settings Trunk port - other settings	Broadcast threshold (%) Discard threshold (%) Error threshold (%) Error traffic threshold (%)1 Queue drop threshold (%) Utilization threshold (%)	0 0 0 0.00 0 0	100 100 100 100.00 100 100	HighBroadcastRate HighDiscardRate HighErrorRate HighQueueDropRate HighUtilization
Access port - 1 GB Ethernet settings Access port - 10/100 MB Ethernet settings Trunk port - 1 GB Ethernet settings Trunk port - 10/100 MB Ethernet settings	Broadcast threshold (%) Collision threshold (%) Discard threshold (%) Error threshold (%) Error traffic threshold (%)1 Queue drop threshold (%) Utilization threshold (%)	0 0 0 0 0.00 0 0	100 100 100 100 100.00 100 100	HighBroadcastRate HighCollisionRate HighDiscardRate HighErrorRate HighQueueDropRate HighUtilization
Confidence test settings	Confidence test tolerance (%)	0	100	TooManyFailedConfidenceTests
Disk usage and virtual memory settings	Free virtual memory threshold (%) Free hard disk threshold (%)2	0 0	100 100	InsufficientFreeVirtual Memory InsufficientFreeHardDisk
Environment settings	Relative temperature threshold (%) Relative voltage threshold (%)	0 0	100 5	OutofRange OutofRange
Environment - RIB card settings	Battery percent charged threshold (%)2	0	100	BatteryLow
Environment - temperature sensor settings	Temperature threshold (C)	1	146	Temperature High
Inactive phone settings	Inactive phone threshold (%)	0	100	InsufficientFreeVirtual Memory
Interface - backup settings Interface - dial on demand settings Interface - ISDN B channel backup settings	Maximum uptime (seconds)	0	86400	ExceededmaximumUptime
Interface - 1 GB Ethernet settings Interface - 10/100 MB Ethernet settings	Broadcast threshold (%) Collision threshold (%) Discard threshold (%) Error threshold (%) Error traffic threshold (%)1 Queue drop threshold (%) Utilization threshold (%)	0 0 0 0 0.00 0 0	100 100 100 100 100.00 100 100	HighBroadcastRate HighCollisionRate HighDiscardRate HighErrorRate HighQueueDropRate HighUtilization
Interface - ATM interface/port flapping settings Interface - ISDN D channel interface flapping settings Interface - ISDN physical interface flapping settings Interface - other interface/port flapping settings Interface - serial interface/port flapping settings Interface - voice interface flapping settings	Link trap threshold (count) Link trap window (seconds)	0 30	10 3600	Repeated Restarts Flapping
Interface - ATM generic interface/port performance settings Interface - FDDI settings Interface - ISDN physical interface generic performance settings Interface - token ring settings Interface - serial generic interface/port performance settings Interface - voice interface generic performance settings Interface - other generic interface/port performance settings	Broadcast threshold (%) Discard threshold (%) Error threshold (%) Error traffic threshold (%)1 Queue drop threshold (%) Utilization threshold (%)	0 0 0 0.00 0	100 100 100 100.00 100 100	HighBroadcastRate HighDiscardRate HighErrorRate HighQueueDropRate HighUtilization
MWI threshold settings	MWI on time threshold (seconds)	5	240	MWIOnTimeExceeded
Processor and memory settings (Host, Router, Switch, Optical Switch)	Free memory threshold (%)2 Backplane utilization threshold (%) Memory buffer miss threshold (%) Memory buffer utilization threshold (%) Memory fragmentation threshold (%)2 Processor utilization threshold (%)	0 0 0 0 0 0	100 100 100 100 100 100	Insufficient Free Memory High BackPlane Utilization HighBufferMissRate HighBufferUtilization ExcessiveFragmentation High Utilization
Processor and memory settings (Media Server)	Free physical memory threshold (%)2 Processor utilization threshold (%)	0 0	100 100	Insufficient Free Physical Memory HighProcessorUtilization
Processor and memory settings (Voice Gateways)	VG248 free physical memory threshold (%)2 VG248 processor utilization threshold (%)	0 0	100 100	Insufficient Free Physical Memory HighProcessorUtilization
Reachability settings	Restart trap threshold (count) Restart trap window (seconds)	0 30	10 3600	Repeated Restarts Flapping
SPE - Confidence test settings	Confidence test tolerance (%)	0	100	TooManyFailedConfidenceTests
SPE - disk virtual memory settings	Free hard disk threshold (%)2 Free virtual memory threshold (%)2	0	100	InsufficientFreeHardDisk
SPE—MWI threshold settings	MWI on time threshold (seconds)	5	240	MWIOnTimeExceeded

1 Error traffic threshold is available only if you have downloaded and installed Incremental Device Update (IDU) 2 or later from the ITM download site: http://www.cisco.com/pcgi-bin/tablebuild.pl/item-3des. 2 Lower threshold—event is generated when the parameter value is lower than the value you set for it.