User Guide for IP Telephony Monitor
Using the Alerts and Activities Display

Table Of Contents

Using the Alerts and Activities Display

How to Use the Alerts and Activities Display

Starting the Alerts and Activities Display

Understanding the Layout of the Alerts and Activities Display

Getting Alert Details

Customizing the Alerts and Activities Display

Selecting Views for Alerts and Activities

Filtering Alerts and Activities

Getting Event Details

Starting the Alerts and Activities Detail Page

Understanding the Layout of the Alerts and Activities Detail Page

Command Button Area

Viewing Events Associated with an Alert

Viewing Event Properties

Getting Device Information

Starting the Detailed Device View

Understanding the Layout of the Detailed Device View

Viewing Device Elements in Detail

Information Shown (by Device Class) in the Detailed Device View

How to Use the Detailed Device View

Viewing Cascaded Phones on the Detailed Device View

Suspending Device Monitoring

Suspending/Resuming Devices

Suspending/Resuming a Device Component

Acknowledging, Annotating, and Sending E-Mail Notifications of Alerts

Acknowledging an Alert

Annotating an Alert

Sending E-Mail in Response to an Alert


Using the Alerts and Activities Display


These topics describe how to use the Alerts and Activities display:

How to Use the Alerts and Activities Display

Starting the Alerts and Activities Display

Getting Alert Details

Customizing the Alerts and Activities Display

Getting Event Details

Getting Device Information

Suspending Device Monitoring

Acknowledging, Annotating, and Sending E-Mail Notifications of Alerts

How to Use the Alerts and Activities Display

The Alerts and Activities display provides real-time information about the operational status of your network. The displays are designed so that you can set them up and leave them running, providing an ongoing monitoring tool that signals you when something needs attention. When a fault occurs in your network, IP Telephony Monitor (ITM) generates an event or events that are rolled up into an alert. If the alert occurs on an element in your active view (a logical grouping of device groups), it is shown on your Alerts and Activities display.

You can also change the names of ITM events to names that are more meaningful to you. These customized names will be reflected in both the Alerts and Activities display and any Fault History reports you generate. This function, called Notification Customization, is only available if you have downloaded and installed Incremental Device Update 4 (or later) from the ITM download site: http://www.cisco.com/cgi-bin/tablebuild.pl/item-3des. For information on changing ITM event names using Notification Customization, see the "Customizing the Names of ITM Events" section.

You can monitor all devices that IP Telephony Monitor supports, once you have added those devices using Device Management and ensured that the devices are in your view. However, the following are not reported:

Alerts on suspect phones. You can get this information by starting Fault History from the CiscoWorks navigation tree, using IP Telephony Monitor > Fault History. (A suspect phone is a phone that cannot register to a Cisco CallManager.)

Alerts on entire device groups. With the exception of Cisco CallManager or Cluster groups, alerts are reported only on specific devices or device components.

You start the Alerts and Activities display from the CiscoWorks navigation tree.


Note All Fault History reports generated from within the Alerts and Activities display provide information from the past 24 hours. To generate a Fault History report on time spans beyond the last 24 hours, use Fault History from the CiscoWorks navigation tree by selecting IP Telephony Monitor > Fault History. For more information, see the "Starting Fault History from the CiscoWorks Navigation Tree" section.


Starting the Alerts and Activities Display

To start the Alerts and Activities display, select IP Telephony Monitor > Alerts and Activities. Figure 3-1 shows an example of an Alerts and Activities display.


Tip After you become familiar with the Alerts and Activities display, you can modify the information it provides as described in the "Customizing the Alerts and Activities Display" section.


Figure 3-1 Alerts and Activities Display

1

View pane. See the "View Pane" section.

3

Tabular display pane. See the "Tabular Display Pane" section.

2

Launch information and view status bar area. See the "Launch Information and View Status Bar Area" section.

4

Window tools area. See the "Window Tools Area" section.


Understanding the Layout of the Alerts and Activities Display

These topics provide details about the information in the Alerts and Activities display.

View Pane

The view pane lists the currently available views, or logical groupings of device groups. Views must be created and activated before they will be shown in the Alerts and Activities display. By default, two views—All Alerts and Suspended Devices—are always shown, and cannot be deleted from your Alerts and Activities display. (To create and activate a view or remove an unwanted view from your display, see the "Configuring Views for the Alerts and Activities Display" section.)

The current view is highlighted in the view pane. The contents of the current view are shown in the tabular display pane to the right of the view pane. To select another view, simply click the view name in the view pane.

Figure 3-2 shows five active views; the current view is All Alerts. Icons next to the views indicate the severity of the alerts received from devices in those views, signaling you that the devices may need attention.

Figure 3-2 Alerts and Activities Display—View Pane and Severity Icons

For the current view, All Alerts, severity icons also appear next to the alerts in the tabular display, as shown in Figure 3-2, to help you quickly locate a specific alert.

The view pane is updated every two minutes. You can have up to 18 views in the view pane in a single Alerts and Activities display.

Launch Information and View Status Bar Area

The launch information area shows the time on the server when the Alerts and Activities display was started.

The view status bar lists the selected view, which is shown in the tabular display pane, and the number of alerts in that view.

Tabular Display Pane

The tabular display pane is the core of the Alerts and Activities display. It contains a list of all alerts that are occurring on the devices in your current view. This pane is refreshed every 30 seconds. For an explanation for all of the items in the tabular display, see the "Getting Alert Details" section.

Icons alert you to what needs attention; for example:

The severity icons indicate which views and alerts require attention.

The diamond symbols in the Last Change column indicate which alerts have experienced recent activity. When no icon appears in the Last Change column, the alert is no longer current, or stale.

The tabular display pane is scrollable and can store up to 1,000 records. See Figure 3-4 for an illustration of the tabular display pane.

Window Tools Area

The top-right corner of the Alerts and Activities display contains available tools buttons. All buttons are described in Table 3-1.

Table 3-1 Alerts and Activities Display—Window Tools Buttons 

Icon
Meaning
Described in...

Exports the current tabular display to a PDF file.

Exporting Data from Tabular Displays

Opens the Filter page, for refining the tabular display in the Alerts and Activities display.

Filtering Alerts and Activities

Opens a printer-friendly version for printing.

Printing Tabular Displays

Opens a 24-hour Fault History tabular display of information about all alerts on all devices in the current view.1

Understanding the Fault History: Alerts and Activities Display

Opens an ITM Tools window with links to available tools.2

ITM Tools Window

1 The Fault History button is available if you have not installed Incremental Device Update (IDU) 2 or later.

2 The ITM Tools button is available only if you have downloaded and installed IDU 2 or later from the ITM download site: http://www.cisco.com/cgi-bin/tablebuild.pl/item-3des.


ITM Tools Window

Figure 3-3 provides an example of the ITM Tools window.

Figure 3-3 Tools

You can open the following from the ITM Tools window:

Fault History—Opens a 24-hour Fault History tabular display of information about all alerts on all devices in the current view. See the "Understanding the Fault History: Alerts and Activities Display" section.

IP Phone Reachability—Opens the Phone Reachability Test Details window. See the "Viewing Phone Reachability Test Details" section.

RME Synchronization—Opens the RME Synchronization window. See the "Using RME Synchronization" section.

You can open one ITM Tools window for each Alerts and Activities Display on your desktop. Each ITM Tools window remains open until you close it.

Getting Alert Details

Use the tabular display in the Alerts and Activities display to obtain more information about the alerts that are occurring in your current view. In the tabular display, as shown in Figure 3-4, alerts are grouped by their severity: critical, warning, or informational. Within these severity groupings, or buckets, alerts with the latest change are listed first.

When an alert is generated, it remains in the Alerts and Activities display until it expires . ITM sets an alert state to Expired when ITM performs its normal polling and determines that the alarm has been in the Cleared state for 30 minutes or longer (from the time of polling).  While the alert is in the display, if any of its events recur, the alert is updated. If an expired alert recurs, a new alert with a new ID is shown.

Figure 3-4 provides an example of an Alerts and Activities tabular display. This display is refreshed every 30 seconds.

Figure 3-4 Alerts and Activities—Tabular Display

Table 3-2 defines the table elements. All elements are updated every 30 seconds.


Tip You can generate a 24-hour Fault History report on all alerts that occurred on devices in your view by opening Fault History from the window tools area of the Alerts and Activities display.


Table 3-2 Alerts and Activities Tabular Display—Contents 

Heading
Description
!

Severity of alert

Critical

Warning

Informational Unidentified Trap alert

(no icon)

Informational (for all other alerts)

Alert ID

Alert identifier number. Clicking this link opens an Alerts and Activities Detail page (see the "Starting the Alerts and Activities Detail Page" section).

Device

Device type. Learning indicates that ITM was discovering the device when the alert occurred. The actual device type is reflected when new events occur. For more information, see "Using Device Management."

Duration

Time span since alert creation, depending upon alert status:

Active or Acknowledged

Time span between alert creation and current server time.

Cleared

Time span between alert creation and Last Change time (the Last Change time may also represent when the alert was cleared).

Last Change

Date and time alert last occurred or was changed. Diamonds indicate alert activity, such as a new event, alert acknowledgement, new user annotation, and so forth; no diamonds indicates that the alert is stale. Alerts are grouped by severity, and within severities, alerts with the latest change are listed first.

Alert was updated within last 15 minutes.

Alert was updated within last 16-30 minutes.

Alert was updated within last 31-45 minutes.

No diamonds

Alert was updated over 46 minutes ago.

Device Name

Device name or IP address. Clicking this link opens the Detailed Device View (see the "Viewing Device Elements in Detail" section).

Description

Event category, one of the following: Application, Connectivity, Environment, Interface, Other, Reachability, System Hardware, Utilization. For alerts containing multiple events, the tabular display shows the category of the event with the most recent change.

Status

Alert status, based on last polling.

Active

Alert is live. (Note that alerts on suspended devices remain active; see the "Sending E-Mail in Response to an Alert" section.)

Cleared

Alert is no longer live. If the alarm has been in the Cleared state for 30 minutes or more (from the time of polling), the alert expires and is removed from the display.

Acknowledged

Alert was manually acknowledged by a user (from Alerts and Activities Detail page).


Customizing the Alerts and Activities Display

After adding your devices to a view, you can customize your Alerts and Activities display by selecting specific views and using filters:

Views control the device groups that appear on the Alerts and Activities display. See the "Selecting Views for Alerts and Activities" section.

Filters control the specific device types you monitor, along with alert severities and their status. See the "Filtering Alerts and Activities" section.

You can also change the names of ITM events to names that are more meaningful to you. These names will also be reflected in both the Alerts and Activities display and in any Fault History reports you generate. This function, called Notification Customization, is available in IDU 4 (or later). For information on changing ITM event names using Notification Customization, see the "Customizing the Names of ITM Events" section.

Selecting Views for Alerts and Activities

When you select IP Telephony Monitor > Alerts and Activities to open the Alerts and Activities display, all available views are listed in the view pane on the left side of the display. If the views shown do not meet your needs, you can create a new view as described in the "Creating a View" section.

The view pane is updated every two minutes. You can have up to 18 views in the view pane in a single Alerts and Activities display. See the "Activating and Deactivating a View" section for information on how to manage your views.

Filtering Alerts and Activities

Filters allow you to manipulate the Alerts and Activities display to show alerts based on their severity, status, and originating device.


Note Once you use an alert filter, the filter is applied to all of your views until you change the filter; other clients are not affected. When you end your session, your filters are lost. Filters do not affect severity icons in the view pane.



Step 1 Select IP Telephony Monitor > Alerts and Activities. The Alerts and Activities display opens.

Step 2 Click the filtering button in the tool button area at the top-right of the Alerts and Activities display.

Figure 3-5 shows the Alert Filters page. You can populate the Device Type box by selecting device types from the button to the right of the Device Type box. By default, all device types are selected.

Figure 3-5 Alerts and Activities—Alert Filters Dialog Box

Step 3 To see all device types that you can filter, click the button to the right of the Device Type box. A Device Types popup window opens, as shown in Figure 3-6.

Figure 3-6 Alerts and Activities—Device Types Dialog Box

Step 4 Verify that only the filtering criteria you want to use are selected.

Step 5 Click OK.


Getting Event Details

These topics address how to start and use the Alerts and Activities Detail page to get more information on events:

Starting the Alerts and Activities Detail Page

Understanding the Layout of the Alerts and Activities Detail Page

Viewing Events Associated with an Alert

Viewing Event Properties

Starting the Alerts and Activities Detail Page

The Alerts and Activities Detail page provides information about all of the events that were rolled up into a specific alert.


Step 1 Select IP Telephony Monitor > Alerts and Activities. The Alerts and Activities display opens.

Step 2 Locate the alert you want to investigate and click the alert ID. The Alerts and Activities Detail page opens.


Figure 3-7 Alerts and Activities Detail Page

1

Alerts status bar. See the "Alert Status Bar" section.

5

Tools list. Select a tool, such as Fault History. See the "Tools" section.1

2

Launch information area. See the "Launch Information Area" section.

6

Command button area. See the "Command Button Area" section.

3

Tabular display pane. See the "Tabular Display Pane" section.

7

Notes pane. See the "Notes Pane" section.

4

Window tools area. See the "Window Tools Area" section.

   

1 If you have not installed IDU 2 or later, the Alerts and Activities Detail page looks a bit different; a Fault History link is provided.


Understanding the Layout of the Alerts and Activities Detail Page

These topics provide details about the information in the Alerts and Activities display.

Alert Status Bar

The alert status bar lists details about the alert with which the listed events are associated. Table 3-3 explains the contents of the alert status bar area.

Table 3-3 Alerts and Activities Detail  Page—Alert Status Bar Contents 

Field
Description
Device Name

Device name or IP address.

Device

Device type. Learning indicates that ITM was discovering the device when the alert occurred. The actual device type is reflected when new events occur. For more information, see "Using Device Management."

Status

Alert status, based on last polling.

Active

Alert is live. (Note that alerts on suspended devices remain active; see the "Sending E-Mail in Response to an Alert" section.)

Cleared

Alert is no longer live. If the alarm has been in the Cleared state for 30 minutes or more (from the time of polling), the alert expires and is removed from the page.

Acknowledged

Alert was manually acknowledged by a user (from Alerts and Activities Detail page). If an event on the alert recurs, the alert state reverts back to Active.

Alert ID

Alert identifier number

Duration

Time span since alert creation, depending upon alert status:

Active or Acknowledged

Time span between alert creation and current server time.

Cleared

Time span between alert creation and Last Change time (the Last Change time may also represent when the alert was cleared).

Last Change

Time and date of last alert update (indicates activity, such as an event recurrence, alert acknowledgement, the addition of an annotation, and so forth). Alerts are grouped by severity, and within severities, alerts with the latest change are listed first.


Tabular Display Pane

In the Alerts and Activities Detail page, the tabular display pane contains a table that lists details about events. These events are associated with the alert listed in the alert status bar. You can refresh the display by clicking Refresh at the bottom of the pane. For an explanation of all of the items in the table, see the "Getting Event Details" section.

The diamond symbols in the Last Change column indicate which alerts have experienced recent activity. When no icon appears in the Last Change column, the alert is stale.

The tabular display is scrollable and can store up to 1,000 records. See Figure 3-4 for an illustration of the actions you can perform from this window.

Launch Information Area

The launch information area shows the time on the server when the Alerts and Activities Detail page was started.

Window Tools Area

The top-right corner of the Alerts and Activities Detail page contains a printer tool button, as described in Table 3-4.

Table 3-4 Alerts and Activities Detail Page—Window Tools Button

Icon
Meaning
Described in...

Opens a printer-friendly version for printing

Printing Tabular Displays


Tools

The tools list includes Fault History. Selecting Fault History opens a 24-hour Fault History report on the component. See the "Understanding the Fault History: Events Display" section.


Note The tools list is available only if you have downloaded and installed IDU 2 or later.


Notes Pane

The notes pane lists any alert annotations that users have entered. The notes pane is a convenient tool for making sure that all users see alert information. You can add an annotation by clicking the Annotate button. Adding an annotation is described in the "Starting the Alerts and Activities Display" section.

Command Button Area

In addition to the Annotate button in the notes pane, the command button area provides other ways to respond to alerts.

Table 3-5 Alerts and Activities Detail  Page—Command Buttons 

Button
Action

Refresh

Refreshes the tabular display.

Acknowledge

Changes the event status to Acknowledged. See the "Acknowledging an Alert" section for more information.

Suspend

Suspends polling and trap processing on the device or device component by opening a Detailed Device View, from which you can perform the suspend command. The Detailed Device View is described in the "Starting the Detailed Device View" section.

Notify

Sends e-mail notification of the alert. See the "Sending E-Mail in Response to an Alert" section for more information.

Close

Closes the Alerts and Activities Detail page.


Viewing Events Associated with an Alert

Use the tabular display in the Alerts and Activities Detail page to obtain more information about all of the events associated with a specific alert. In the tabular display, as shown in Figure 3-8, events with the latest change are listed first.

Events remain in the Alerts and Activities Detail page until the parent alert expires. If you suspend a device, all the events are cleared, but the alert remains active. (This way, users cannot remove important information from the display, and that you can easily resume the device.)

If an event recurs, the existing event is not updated. Instead, the recurrence is shown as a new event with a new event ID.

Figure 3-8 provides an example of an Alerts and Activities Detail table. This table is refreshed every 30 seconds.

Figure 3-8 Alerts and Activities Detail Page—Tabular Display

Table 3-6 defines the table elements. Click Refresh at the bottom of the pane to refresh the table contents.


Tip Remember that you can generate a 24-hour Fault History report on all events that occurred on a selected component by opening Fault History from the window tools area of the Alerts and Activities display.


Table 3-6 Alerts and Activities Detail Tabular Display—Contents 

Column
Description
Event ID

Event identifier number. Clicking this link opens the event properties page (see the "Getting Event Details" section). Note that this Event ID is not the same as the Event Code provided by Notification Services in IDU 4. For more information, see the "Customizing the Names of ITM Events" section.

Description

ITM event name (as described in the "Events Processed" section). You can also change the names of ITM events to something that is more meaningful to you. This function, called Notification Customization, is only available if you have downloaded and installed IDU 4 or later. For information on changing ITM event names using Notification Customization, see the "Customizing the Names of ITM Events" section.

Component

Device element on which the event occurred.

Time

Time at which the event occurred.

Status

Event status, based on last polling.

Active

Event is live.

Cleared

Event is no longer live. (Note that events on suspended devices are moved to cleared, but the alert remains active. See the "Sending E-Mail in Response to an Alert" section.)

Suspended

Device is suspended.

Resumed

Device is being resumed.

Deleted

Device has been deleted.

Tools

Links to tools that provide more information on the event.

Note Selecting Fault History opens a 24-hour Fault History report on the component (see the "Understanding the Fault History: Events Display" section).


Viewing Event Properties

The event properties page provides additional details about the event, such as the values of MIB attributes at the time of the event, polling and threshold information, and utilization information.


Step 1 Select IP Telephony Monitor > Alerts and Activities. The Alerts and Activities display opens.

Step 2 Locate the alert you want to investigate and click the alert ID. The Alerts and Activities Detail page appears.

Step 3 Locate the event you want to investigate, and click the event ID. The event properties page appears.


Figure 3-9 shows a typical event properties page.

Figure 3-9 Event Properties Page

The information that is shown in the event properties page depends on the event type.

Getting Device Information

The Detailed Device View provides extensive information on the devices and device components listed in the "Starting the Detailed Device View" section. You can view information on devices that ITM is currently managing, as well as devices whose management you have suspended.


Note Selecting IP Telephony Monitor > Device Management > View Device Details also provides device details, but only basic information: IP address, status, when the device was first added and last discovered, and the device function.


View hardware and software information on system, environment, connectivity, and interface components

View hardware and software information on subcomponents of aggregate devices (for example, MRPs and SPEs on the ICS 7750)

View application status for Cisco CallManager, Voice Services, Work Flow, and Confidence Tests, and provide launch points for administrative pages, if appropriate

Suspend or resume management of a device or a device component so the device is no longer polled, or polling is resumed

See these topics for more information:

Starting the Detailed Device View

Understanding the Layout of the Detailed Device View

Viewing Device Elements in Detail

Starting the Detailed Device View

You can start the Detailed Device View from within the Alerts and Activities display, either by clicking a device link, or by starting the Alerts and Activities Detail page and clicking Suspend or Resume.


Note You cannot display a Detailed Device View for unidentified trap devices or suspect phones. (A suspect phone is a phone that cannot register to a Cisco CallManager.) For more information on unidentified traps, refer to the "Processed and Pass-through Traps, and Unidentified Traps and Events" section.



Step 1 From the Alerts and Activities display, click a device in the Device Name column. The Detailed Device View opens. (See Figure 3-10 for an example.)

Step 2 Select an instance from the device tree. The details table is populated.

Step 3 If the item you select is the subdevice of an aggregated device—for example, an MRP in a Cisco ICS 7750, or an MSFC/RSM in a phone access switch—the Detailed Device View will show the subdevice's managed state and device capability. To display a complete Detailed Device View of the subcomponent, click the Launch new DDV for this device button. (See Figure 3-11, Figure 3-12, and Figure 3-13 for examples.)

Step 4 If you want to suspend a managed device so it is no longer polled and its traps are no longer processed (or if you want to resume a suspended device):

Click Suspend to change the device's managed state to Suspended. ITM no longer polls any device components, nor does it process any traps. All alerts and activities change to the Cleared state, and the device is moved to the Suspended Devices view. Subsequent events (including traps) are ignored and no longer processed.

Click Resume to change the device's managed state to Active. ITM resumes polling and trap processing on the device, and the device is moved out of the Suspended Devices view and back into its previous view.


Note If you resumed any devices (and you are finished making all of your monitoring status changes), select IP Telephony Monitor > Configuration > Apply Changes for your changes to take effect. (Because this action is CPU-intensive, wait until you have made all of your monitoring status changes before you apply them.)



Figure 3-10 provides an example of device information for a Cisco Catalyst 6506 switch.

Figure 3-10 Detailed Device View—Cisco Catalyst 6506 Switch

1

Component categories pane. See the "Component Categories Pane" section.

4

Command button area. See the "Command Buttons Area" section.

2

System information pane. See the "System Information Pane" section.

5

Launch information area. See the "Launch Information" section.

3

Record count. See the "Record Count" section.

   

Understanding the Layout of the Detailed Device View

These topics provide details about the information in the Detailed Device View.

Component Categories Pane

The component categories pane lists the components of the device or cluster. Selecting a component allows you to view detailed information pertaining to that component, such as CPU usage for a processor, TotalUsedMemory for memory, and so forth.

System Information Pane

The system information pane provides information such as the system name, IP address, SysObjectID, system contact, and so forth. Table 3-8 lists the Detailed Device View information you will see for each device type. Examples of different Detailed Device Views are provided in the "Viewing Device Elements in Detail" section.

If the system information pane lists an attribute with no value, it is because of one of the following reasons:

The attribute is not populated.

The attribute is not configured correctly.

The attribute does not apply to the device.

You can suspend or resume device or component monitoring by clicking the Suspend or Resume button (the button shown depends on the component's current managed state). These functions are described in these sections:

Suspending/Resuming Devices

Suspending/Resuming a Device Component

Record Count

The record count lists the number of information types available on the device.

Command Buttons Area

In addition to the Suspend and Resume button in the system information pane, the command button area provides other ways to respond to alerts.

Table 3-7 Detailed Device View—Command Buttons

Button
Action

Refresh

Refreshes the Detailed Device View page. (The Detailed Device View is not automatically refreshed; you must do so manually.)

Close

Closes the Detailed Device View page.


Launch Information

The launch information tells you when the Detailed Device View was started. If you refresh the page, the time is updated.

Viewing Device Elements in Detail

These topics explain how to use the Detailed Device View, and what the Detailed Device View displays for different device classes. These topics also provide examples of different Detailed Device Views:

Information Shown (by Device Class) in the Detailed Device View

How to Use the Detailed Device View

Viewing Cascaded Phones on the Detailed Device View

Information Shown (by Device Class) in the Detailed Device View

Table 3-8 shows the types of device information displayed for the various device classes that IP Telephony Monitor supports.

Table 3-8 Device Information Provided by the Detailed Device View 

Device Class
Status Reported by Detailed Device View
Subcomponents Reported by Detailed Device View1
Environment
System
Interface
Connectivity
Application2

Switches

X

X

X

   

RSM, MSM, MSFC

Routers

X

X

X

   

RSM, MSM, MSFC

Voice Gateways

X

X

X

X

 

RSM, MSM, MSFC

Cisco CallManager or Cluster

         

Media Servers, Digital Voice Gateways,
Voice Gateways, VoiceMail Gateways

Media Server

X

X

X

 

X

 

Unity

X

X

X

 

X

 

Gatekeeper

X

X

X

X

   

Phone Access Switch

X

X

X

     

PRPhone3

     

X

   

MonitoredPhone4

     

X

   

VoiceMail Gateway

 

X

X

X

   

Digital Voice Gateway

   

X

X

   

SRSTDevice3

X

X

X

     

ICS

X

       

MRP, SSP, SPE

MRP

 

X

X

X

   

SSP

 

X

X

     

SPE

 

X

   

X

 

1 You can display a new Detailed Device View for each of these subcomponents.

2 Voice applications and confidence testing.

4 MonitoredPhone is available only if you have not installed IDU 2 or later.


The status categories—Environment, System, Interface, and so forth—list different entries depending upon the device class. The following are some examples of what you may see under the status categories:

Environment: Temperature, fan, power supply, voltage information

System: Hard disk, RAM, processor, virtual memory information

Interface: Card, interface, port, voice port information


Note The Voice Port entry displays information for T1, E1, FXS, and FXO ports, as well as Ethernet and Gigabit Ethernet ports that have IP phones connected to them. When new Ethernet ports with phones connected to them are discovered, the Voice Port information is updated after a manual refresh of the Detailed Device View.


Connectivity: Cluster connectivity information such as cluster name, CallManager status, CallManager list, Active CallManager

Application: Voice Services, Cisco CallManager information

How to Use the Detailed Device View

To start a Detailed Device View, click a device link from the Alerts and Activities Detail page. The information shown by the Detailed Device View depends on the type of device you select, as shown in Table 3-8.

For example, Figure 3-11 shows a Cisco ICS 7750, an aggregate device with subcomponents (MRPs, SSPs, and SPEs).

Figure 3-11 Detailed Device View—Cisco ICS 7750

If you select one of the subcomponents—for example, one of the MRPs under the MRP folder—the Detailed Device View displays the managed state of the subcomponent on the right side of the display (see Figure 3-12), and a new Detailed Device View launch point is provided.

Figure 3-12 Launching a Detailed Device View for an ICS 7750 MRP

To display a Detailed Device View for the MRP, click Launch New DDV for This Device. The new Detailed Device View appears (see Figure 3-13).

Figure 3-13 Detailed Device View—Cisco ICS 7750 MRP

Figure 3-14 shows a Cisco CallManager or Cluster with aggregate devices, an aggregate device with subcomponents (Voice Gateway, Phone Access Switch, Access Gateway, Router, and Switch).

Figure 3-14 Detailed Device View—Cisco CallManager or Cluster

If you select one of the Voice Gateways, the Detailed Device View displays the managed state of the subcomponent (see Figure 3-15), and a new Detailed Device View launch point is provided.

Figure 3-15 Launching a Detailed Device View for a Voice Gateway

To display a Detailed Device View for the MRP, click Launch New DDV For This Device, and the new Detailed Device View appears (see Figure 3-16).

Figure 3-16 Detailed Device View—Cisco Catalyst 4604-GWY Access Gateway

For voice applications such as Cisco CallManager, the Detailed Device View provides version and status information, and a launch point for the Cisco CallManager administration page, as shown in Figure 3-17.

Figure 3-17 Detailed Device View—Media Server with Cisco CallManager

Besides viewing device information from the Detailed Device View, you can also change the managed state of devices and their components, as explained in the "Suspending Device Monitoring" section.

Viewing Cascaded Phones on the Detailed Device View

ITM does not display the switch information for cascaded phones. A cascaded phone connects to another phone that is connected to a switch, but is not itself connected directly to the switch.

ITM phone discovery discovers the switch ports that have phones connected to them. However, ITM does not discover all phones connected to a switch port. Therefore, the Detailed Device View for a cascaded phone will not display switch information.

Suspending Device Monitoring

You can stop monitoring a device by selecting it and clicking the Suspend button in the Detailed Device View. Conversely, you can resume monitoring by clicking the Resume button. These actions are also available for suspending and resuming specific components. See these topics for more information:

Suspending/Resuming Devices

Suspending/Resuming a Device Component

Suspending/Resuming Devices

When you unmanage a device—changing its managed state to false—ITM no longer polls that device for information. Subsequent events (including traps) are ignored and no longer processed.

When you suspend a device, all of the active events on the device are moved to the Cleared state, but the alert remains in the Active state. This happens to ensure that:

You cannot mistakenly remove important information from the display when you suspend a device (when alerts are cleared, they are removed from the Alerts and Activities display).

You can easily resume the device.


Note You cannot suspend or resume monitoring for a phone using the Detailed Device View. Use the following:

When IDU 2 or later is installed on ITM, you can delete or reschedule a phone reachability test. See the "Using the Phone Reachability Testing Manager" section for more information. (You can download and install incremental device updates from the ITM download site: http://www.cisco.com/cgi-bin/tablebuild.pl/item-3des.)

When IDU 2 or later is not installed on ITM, use Phone Monitoring Admin by selecting IP Telephony Monitor > Phone Monitoring Admin > Suspend/Resume Monitoring.



Step 1 From the Alerts and Activities display, start the view that contains your device. (Devices not managed will be in the Suspended Devices view.) The Detailed Device View opens. Depending upon the managed state of the device, either the Suspend or the Resume button is shown.

Step 2 Do one of the following:

Click Suspend to change the device's current managed state to Suspended. ITM no longer polls any device components, nor does it process any traps. All alerts and activities change to the Cleared state, and the device is moved to the Suspended Devices view. Subsequent events (including traps) are ignored and no longer processed.

Click Resume to change the device's current managed state to Active. ITM resumes polling and trap processing on the device, and the device is moved out of the Suspended Devices view and back into its previous view.

Step 3 If you resumed any devices (and you are finished making all of your monitoring status changes), select IP Telephony Monitor > Configuration > Apply Changes for your changes to take effect. (Because this action is CPU-intensive, wait until you have made all of your monitoring status changes before you apply them.)


Figure 3-18 provides an example of the Detailed Device View for a suspended Cisco Catalyst 6506 switch. Note the Resume button at the bottom of the window.

Figure 3-18 Detailed Device View—Suspended Cisco Catalyst 6506 Switch

Suspending/Resuming a Device Component

You can unmanage or remanage device components using the Detailed Device View. When you unmanage a component—changing its managed state to false—ITM no longer polls that component for information. Subsequent events (including traps) are ignored and no longer processed.


Note You cannot resume a device component if the parent device is suspended. You must resume the parent device first.



Note You cannot suspend or resume a phone using the Detailed Device View. Use the following:

When IDU 2 or later is installed on ITM, you can delete or reschedule a phone reachability test. See the "Using the Phone Reachability Testing Manager" section for more information. (You can download and install incremental device updates from the ITM download site:) http://www.cisco.com/cgi-bin/tablebuild.pl/item-3des.

When IDU 2 or later is not installed on ITM, use Phone Monitoring Admin by selecting IP Telephony Monitor > Phone Monitoring Admin > Suspend/Resume Monitoring.



Step 1 From the Alerts and Activities display, click a device in the Device Name column. The Detailed Device View opens.

Step 2 Select the component with the instance you want to unmanage.

Step 3 Locate the instance you want to unmanage, and make your change using the list in the ManagedState column.

Step 4 Click Submit.

Step 5 If you resumed any components (and you are finished making all of your monitoring status changes), select IP Telephony Monitor > Configuration > Apply Changes for your changes to take effect. (Because this action is CPU-intensive, wait until you have made all of your monitoring status changes before you apply them.)


Figure 3-19 shows the location of the ManagedState column for one of the managed interfaces on a Cisco Catalyst 6506 switch.

Figure 3-19 Editing the Managed State of a Device Component

Acknowledging, Annotating, and Sending E-Mail Notifications of Alerts

As shown in Figure 3-20, the Alerts and Activities Detail page provides command buttons in the bottom-right corner of the page. The Suspend button is discussed in the "Suspending Device Monitoring" section. This topic explains how you can use the Acknowledge, Annotate, and Notify buttons to respond to alerts.

Figure 3-20 Alerts and Activities Detail Page

See these topics for more information:

Acknowledging an Alert

Annotating an Alert

Sending E-Mail in Response to an Alert

Acknowledging an Alert

Acknowledging an active alert signals other users that you are aware of the alert. When you click the Acknowledge button in the Alerts and Activities Detail page, this status change is populated to all Alerts and Activities displays.

If an event on the alert recurs, the status reverts to Active.


Step 1 From the Alerts and Activities Detail page, click Acknowledge. A confirmation window opens.

Step 2 Click OK.


Figure 3-21 shows an alert that is to be acknowledged.

Figure 3-21 Acknowledging an Alert (Before the Acknowledgement)

Figure 3-22 shows the Alerts and Activities window. The first line contains the alert that was acknowledged in Figure 3-21. (Note the diamonds in the Last Change column, indicating this change.)

Figure 3-22 Acknowledging an Alert (After the Acknowledgement)

Annotating an Alert

You can annotate an alert by clicking the Annotate button from the Alerts and Activities Detail page. An editable Annotation dialog box opens; in the dialog box, you can enter up to 255 characters. An annotation will be shown whenever other users view the alert from an Alerts and Activities Detail page.


Step 1 From the Alerts and Activities Detail page, click Annotate. The Annotation dialog box opens.

Step 2 Enter your text. Text that exceeds 255 characters will be truncated without warning. (If this happens, you can add another annotation.)

Step 3 Click OK. The annotated text is displayed in the Notes box.


Figure 3-23 shows a typical Annotation dialog box.

Figure 3-23 Alert Annotation Dialog Box

Figure 3-24 shows the Alerts and Activities Detail page containing the annotation created in Figure 3-23.

Figure 3-24 Annotation on the Alerts and Activities Detail Page

Sending E-Mail in Response to an Alert

When you click the Notify button in the Alerts and Activities Detail page, ITM opens a dialog box that you can complete to manually send an e-mail notification to multiple recipients. The e-mail notification will contain only the text you add; it will not append any alert or event information. (If you want to send automatic e-mail notifications when alerts or events occur on certain devices, use Notification Services to set up an e-mail notification subscription. Refer to the "Managing E-Mail Notifications" section.)


Step 1 From the Alerts and Activities Detail page, click Notify. The E-mail Notification Recipient(s) dialog box opens.

Step 2 In the E-mail Notification Recipient(s) dialog box:

a. Select your SMTP server by doing one of the following:

Click the SMTP Server button and select the SMTP server you want to use.

Enter a fully qualified DNS name or IP address for an SMTP server.

b. Click the Domain Names button and select the domain you want to use.

c. Enter your e-mail address in the Sender Address field.

d. Enter a comma-separated list of e-mail addresses in the Recipient Address(es) field.

e. Enter a subject heading in the Header field.

f. (Optional) Enter a message in the Message field.

g. Click Send.


Figure 3-25 shows the dialog box you use to send a notification.

Figure 3-25 Notifying Others of an Alert or Event by E-mail