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/pcgi-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
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.
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
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
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 View 1
|
Environment
|
System
|
Interface
|
Connectivity
|
|
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
|
|
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/pcgi-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/pcgi-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