Table Of Contents

Managing Faults

Identifying Alarms

Navigating the Alarm Dashboard

Displaying Alarm Records

Alarm Viewer Toolbar

Alarm Viewer Table

Alarm Viewer Pane

Filtering Alarm Records

Displaying Correlation Records

Managing Faults

---

This chapter provides information on managing faults with Cisco Craft Works Interface (CWI). These sections are provided:

•Identifying Alarms

•Navigating the Alarm Dashboard

•Displaying Alarm Records

•Displaying Correlation Records

Identifying Alarms

CWI Desktop provides multiple locations in which you can identify and manage alarms on the devices that CWI manages. Alarm identification in multiple locations in CWI allows you to receive current information on the status of the managed devices while performing other tasks on the CWI Desktop.

Table 3-1 lists the supported functions for managing alarms.

---

Note The managed device must be configured to send notifications to a specified client for real-time alarms to be enabled. See the "Setting the Minimum Router Configuration" section in Cisco Craft Works Interface Quick Start Guide for information on configuring the device to send notifications to a specified client.

---

The Inventory Tree and Alarm Dashboard provide context-sensitive launching of the Alarm Viewer with active alarms.

Table 3-1 Functions to Manage Alarms 

Name	Task
Inventory Tree	Displays in real-time the highest-severity active alarm status of objects and their children in the Inventory Tree. See the "Inventory Tree" section for information about alarm identification in the Inventory Tree.
Alarm Dashboard	Displays a real-time summary of active alarms based on severity level and a resettable active alarm count. See the "Navigating the Alarm Dashboard" section for information about alarm identification in the Alarm Dashboard.
Alarm Viewer	Displays alarms, filters alarms, browses alarm logs, sorts logs, clears and purges alarms, displays correlated alarms, and optionally displays all alarms or only active alarms. See the "Displaying Alarm Records" section for information about alarm identification and management in the Alarm Viewer.

Table 3-2 provides definitions and associated colors for the default alarm severities used in the CWI Desktop. The lower the numeric value assigned to the alarm, the more serious the event or situation.

Table 3-2 Alarm Severity Descriptions and Associated Color 

Alarm Severity	Color	Description (Logged System Messages)
Emergency	Red	System unusable.
Alert	Purple	Critical system condition exists requiring immediate action.
Critical	Orange	Critical system condition exists.
Error	Yellow	Noncritical errors exist.
Warning	Blue	Warning conditions exist.
Notification	Green	Notifications of changes exist to system configuration.
Informational	Green	Information about changes to system state exists.

Navigating the Alarm Dashboard

The Alarm Dashboard displays an alarm count of all active alarms on all the devices to which you are currently logged in using CWI. The alarms are displayed by severity, and the current agent connectivity status is indicated (see Figure 3-1).

Figure 3-1 Alarm Dashboard

Six alarm severity levels are indicated by six colored buttons in the Alarm Dashboard. Each severity level button indicates the number of active alarms of that severity on the devices. Moving the mouse pointer over a severity button provides a tooltip description of the severity.

The button on the far right side of the Alarm Dashboard indicates a running count of all alarm notifications on the devices since the last reset.

Table 3-2 identifies the default alarm severities and associated colors in the Alarm Dashboard. The NE Connectivity Status icon shows the connection status between Cisco Craft Works Interface (CWI) and the management agent on the device. The icon shows a green connection line if CWI is connected to the management agent and a red connection line if CWI has a broken connection to the management agent.

To navigate the alarm dashboard, you can:

•Double-click the Alarm Dashboard icon on the status bar to open the Alarm Dashboard.

•Double-click a severity level button to open the Alarm Viewer with the alarms of the chosen severity displayed.

---

Note When you click a severity level button, the Alarm Dashboard closes when the Alarm Viewer opens.

---

•Double-click the running count button to reset the alarm count to zero.

Displaying Alarm Records

The Alarm Viewer application is used to dynamically display the alarm records from the alarm management functions of the device controller. The Alarm Viewer (see Figure 3-2) can be opened for all alarms or only active alarms.

To display the alarm records, choose one of the following options:

•From the desktop toolbar, click either the Active Alarms icon or the All Alarms icon (see Figure 1-2).

•From the Inventory Tree:

–Right-click the object and choose Active Alarms to display the details for all active alarms on the chosen object.

–Right-click the object and choose All Alarms to display the alarm log details for all active, cleared, and nonbistate alarms on the chosen object.

–Choose the object. Choose Tools > Active Alarms or Tools > All Alarms.

The following types of alarms are listed:

•Bistate

–Active

–Cleared

•Nonbistate

The Alarm Viewer window (see Figure 3-2) does not change regardless of whether it contains all alarms or active alarms. The only difference between the two is that the Alarm Viewer for all alarms contains active, cleared, and nonbistate alarms, and the Alarm Viewer for active alarms contains active and nonbistate alarms.

Figure 3-2 Alarm Viewer

Alarm Viewer Toolbar

Depending on your location in the Alarm Viewer, the Alarm VIewer tool can be enabled or disabled. A tool appears dimmed when it is not available (see Figure 3-2). When the pointer is positioned over the tool, a tooltip appears describing the function of the tool.

The toolbar is displayed in the Alarm Viewer window (see Figure 3-2).

Table 3-3 lists the tools on the Alarm toolbar.

Table 3-3 Icons for the Alarm Toolbar 

Icon	Task
Clear	Clears the chosen active alarms.
Purge	Removes the chosen nonactive (cleared and nonbistate) alarms from the Alarm Viewer table. These alarms are deleted from the table as soon as the purge command is completed.
Correlation Records	Opens the Correlation Record Viewer from the Alarm Viewer table correlated alarm ID cell or from the Alarm Viewer table.
Filter	Opens the Alarm Filter dialog box to allow you to filter the records in the Alarm Viewer table.

Alarm Viewer Table

The Alarm Viewer table displays alarms in table format. The alarms displayed in the table are the alarms against the objects chosen in the Inventory Tree when the Alarm Viewer is opened. The alarms can be filtered using the Filter tool.

The Severity column is color-coded to indicate the severity of alarms. Table 3-2 identifies the default alarm severities and associated colors.

Alarm Viewer Pane

The Alarm Viewer pane displays a single alarm. When an alarm is chosen in the Alarm Viewer table, the alarm details are displayed in the Alarm Viewer pane.

Table 3-4 identifies the alarm details in the Alarm Viewer table and the Alarm Viewer pane.

Table 3-4 Alarm Details in the Alarm Viewer 

Alarm Detail	Description
Time Stamp	Date and time the alarm was generated by the device.
Severity	Severity of the alarm. See Table 3-2 for a list of the severities.
State	State of the alarm. The options are Cleared, None (nonbistate), and Active.
Alarm ID	Unique ID assigned by the device when the alarm was generated.
Source	Source of the alarm in the following format: device name [rack name, slot number, interface, or process ID] The format is consistent with the inventory records.
Category	High-level category. Examples of categories are: •Communications •Quality of service (QoS) •Processing error •Equipment •Environmental
Correlated ID	Correlated ID. If 0 is indicated, the alarm has not been correlated; otherwise, it is a numeric ID used to find correlated events in the Event Correlation log.
Event Code	Name of the alarm.
Group	External event group. Examples of groups are: •Link •Logging
Additional Text	Additional information about the alarm.

Filtering Alarm Records

You can filter alarms based on source IDs, alarm generation time, severity, state, and ID.

Table 3-5 provides detailed information about the Alarm Filter dialog box (see Figure 3-3).

Table 3-5 Alarm Filter Dialog Box Description 

Field	Range	Description
Select Alarm Source IDs Area
Drag and Drop Objects from Inventory Tree pane	—	Selects and drags objects from the Inventory Tree into this pane.
Add button	—	Opens an Input dialog box to allow you to enter a valid object ID that is added to the Drag and Drop Objects from the Inventory Tree pane.
Delete button	—	Deletes the chosen object ID from the Drag and Drop Objects from the Inventory Tree pane. Multiple choices are allowed.
Delete All button	—	Deletes all object IDs from the Drag and Drop Objects from the Inventory Tree pane.
Select Alarm Generation Time Range Area
From	All alarms with a time stamp between the From time and To time choices are filtered.	Displays the from date specified using the Select From Date/Time dialog box.
From ellipsis button	—	Opens the Select From Date/Time dialog box.
To	All alarms with a time stamp between the From time and To time choices are filtered.	Displays the to date specified using the Select To Date/Time dialog box.
To ellipsis button	—	Opens the Select To Date/Time dialog box.
Select Alarm Severity/State Area
From	All alarm severities between the From severity and the To severity are filtered.	The From list allows you to choose a from alarm severity.
To	All alarm severities between the From severity and the To severity are filtered.	The To list allows you to choose a to alarm severity.
Alarm State check boxes	—	Chooses the alarm states to filter. The options are Active, Cleared, and None (nonbistate).
Select Alarm ID Range Area
From	All alarms with an ID between the From and To Alarm IDs are filtered.	Allows you to enter a from Alarm ID.
To	All alarms with an ID between the From and To Alarm IDs are filtered.	Allows you to enter a to Alarm ID.
Clear button	—	Clears all fields in the Alarm Filter dialog box.
Reset button	—	Resets all fields to the settings that were displayed when the dialog box was opened. The Reset button removes only the settings that have been added since the dialog box was opened.
OK button	—	Saves all settings in the Alarm Filter dialog box and closes the dialog box.
Cancel button	—	Closes the Alarm Filter dialog box without saving any settings that were added since the dialog box was opened.

Filtering Alarms Procedure

To filter alarms in the Alarm Viewer, perform the following steps:

---

Step 1 In the Alarm Viewer, click the Filter icon.

The Filter Alarm dialog box appears (see Figure 3-3).

Figure 3-3 Alarm Filter Dialog Box

Step 2 Choose one of the following options:

a. In the Select Alarm Source IDs area, click Add. In the Drag and Drop Objects from Inventory Tree dialog box, enter an object ID, then click OK.

b. Choose an object from the Inventory Tree (not pictured) and drag the object to the Drag and Drop Objects from the Inventory Tree field.

Step 3 (Optional) In the Select Alarm Generation Time Range area, click the From ellipsis button.

A Select From Date/Time dialog box appears.

Step 4 Choose a date and time or click Current Time to set the date and time to the current time.

Step 5 Click OK.

Step 6 (Optional) In the Select Alarm Generation Time Range area, click the To ellipsis button.

A Select To Date/Time dialog box appears.

Step 7 Choose a date and time or click Current Time to set the date and time to the current time.

Step 8 Click OK.

Step 9 (Optional) In the Select Alarm Severity/State area, choose a severity range from the From drop-down list and from the To drop-down list to set severity range filtering.

Step 10 (Optional) To choose the alarm states to filter, check the Active, Cleared, or None check box.

Step 11 (Optional) In the Select Alarm ID Range, enter a value in the From field and a value in the To field.

Step 12 Click OK.

The Filter dialog box is closed and the Alarm Viewer table is updated to display only the alarms that meet the filter criteria.

---

Displaying Correlation Records

The Correlation Record Viewer displays the list of alarms that were correlated to a single alarm displayed in the Alarm Viewer. The option is enabled when the selected alarm has a valid (nonzero) correlation ID (see Figure 3-4).

The Correlation Record Viewer looks identical to the Alarm View application.

Figure 3-4 Correlation Record Viewer