Cisco DCNM Fundamentals Configuration Guide, Release 4.0
Managing Events
Downloads: This chapterpdf (PDF - 206.0KB) The complete bookPDF (PDF - 5.43MB) | Feedback

Managing Events

Table Of Contents

Managing Events

Information About Events

Licensing Requirements for the Events Browser

Prerequisites for Events

Guidelines and Limitations

Using the Event Browser and Events Tabs

Viewing Events in the Events Browser

Applying and Removing an Event Filter

Viewing Events on an Events Tab

Changing the Status of an Event

Adding a Note to One or More Events

Deleting an Event

Field Descriptions for Events

Events Table

Event Details

Related Documents


Managing Events


This chapter describes how to use the Event Browser and feature-specific Events tabs in Cisco Data Center Network Manager (DCNM).

This chapter includes the following topics:

Information About Events

Licensing Requirements for the Events Browser

Prerequisites for Events

Guidelines and Limitations

Using the Event Browser and Events Tabs

Field Descriptions for Events

Related Documents

Information About Events

DCNM allows you to view and manage recent status events. An event can be either of the following:

A status-related system message that DCNM retrieves from managed devices. For more information, see the "Logfile Requirements" section on page 1-7.

A message generated by the DCNM server.

The DCNM client includes the Event Browser and feature-specific Events tabs that appears in the Details pane for features that can have events. The Events Browser shows all recent status events while a feature-specific Events tab shows recent status events that pertain to the feature. The client updates the Event Browser and Events tabs dynamically when it receives new events from the server.

In the Events Browser and on Events tabs, you can change the status of an event, add notes to an event, or delete an event.

In addition, the Event Browser provides a pie chart and a bar chart of events separated by the event severity. You can also delete old events from the events database.

To control the minimum severity of event messages, you configure the logging level for NX-OS features and for DCNM server features. For more information, see the "NX-OS System-Message Logging Requirements" section on page 1-6.


Note DCNM has minimum logging level requirements for managed NX-OS devices. Logging levels on a managed device should never be lower than the minimum requirements.


For more information about DCNM server logging levels, see the "Administering DCNM Server Log Settings" section on page 9-43.


Note Configuring DCNM server log settings does not affect logging levels on managed NX-OS devices.


Licensing Requirements for the Events Browser

The following table shows the licensing requirements for this feature:

Product
License Requirement

DCNM

The Event Browser requires no license. Any feature not included in a license package is bundled with the Cisco DCNM and is provided at no charge to you. For a complete explanation of the DCNM licensing scheme, see the Cisco DCNM Licensing Guide.


Prerequisites for Events

The Event Browser has the following prerequisites:

You should be familiar with NX-OS system messages.

Managed NX-OS devices must be configured to send system messages to the DCNM server.

Guidelines and Limitations

The Event Browser has the following configuration guidelines and limitations:

The Event Browser and feature-specific Events tabs display only status events, which are events generated when the status of a feature or object changes. For example, configuration events do not appear in the Events Browser or on an Events tab.

The Event Browser can display event messages that are no older than 24 hours when you start the DCNM client. By default, the client fetches from the server messages that are no older than 1 hour.

The Events Browser can display up to 5000 events. The events database is limited by the amount of space available to the database.

You cannot use DCNM to control the logging levels of managed NX-OS devices. For more information, see the "NX-OS System-Message Logging Requirements" section on page 1-6.

We recommend that you delete events that you no longer need or that you have resolved. For information about deleting old events from the events database, see the "Deleting Data from the Events Database" section on page 9-35.

Using the Event Browser and Events Tabs

Figure 7-1 shows the Event Browser content pane.

Figure 7-1 Event Browser Content Pane

This section includes the following topics:

Viewing Events in the Events Browser

Applying and Removing an Event Filter

Viewing Events on an Events Tab

Changing the Status of an Event

Adding a Note to One or More Events

Deleting an Event

Viewing Events in the Events Browser

You can use the Event Browser to view recent events. By default, the Event Browser shows events that occurred up to 1 hour prior to starting the DCNM client. For more information, see the "Configuring the Maximum Age of Events Fetched from the Server" section on page 4-15.

DETAILED STEPS

To view events in the Event Browser, follow these steps:


Step 1 From the Feature Selector pane, choose Event Browser.

The event table appears in the Contents pane. The summary charts appear above the Feature Selector pane.

Step 2 (Optional) If you want to sort events, click the column heading that you want to sort by. For example, if you want to see events grouped by the status of the event, click the Status column heading.

Step 3 (Optional) If you want to use an event filter, see the "Applying and Removing an Event Filter" section.

Step 4 (Optional) If you want to filter events by column headings, from the menu bar, choose View > Filter and then use the column headings to filter the events.

Step 5 (Optional) If you want to use quick filtering, in the Event Browser toolbar, enter the text that you want to use to filter the events.

The client shows only the events that contain the text that you enter.


Note To configure quick filtering options, use the drop-down list of the Event Browser toolbar.


Step 6 (Optional) If you want to view details about a specific event, follow these steps:

a. Find the event in the event list.

b. Click the event.

c. Expand the Details pane, if necessary.

Details about the selected event appear in the Details pane.

d. (Optional) To read notes and messages about status changes to the event, read the information in the Action Log field.


Applying and Removing an Event Filter

You can filter events in the Events Browser by the following criteria:

Event date and time—By default, the client displays all events received after you started the client and for a configurable number of hours prior to starting the client (for more information, see the "Configuring the Maximum Age of Events Fetched from the Server" section on page 4-15).

Event severity—By default, the client displays events of all severities.

BEFORE YOU BEGIN

If the message "Filter Applied" appears at the top of the Contents pane, the client is applying an event filter to the Event Browser.

DETAILED STEPS

To apply or remove an event filter in the Event Browser, follow these steps:


Step 1 View events in the Events Browser (see the "Viewing Events in the Events Browser" section).

Step 2 If you want to apply an event filter, follow these steps:

a. From the menu bar, choose View > Event Filter.

b. Check Apply Filter.

c. As applicable, configure the filter criteria.

d. Click OK.

The Event Browser displays events filtered by the criteria that you specified. The message "Filter Applied" appears at the top of the Contents pane.

Step 3 If you want to remove an event filter, follow these steps:

a. From the menu bar, choose View > Event Filter.

b. Uncheck Apply Filter.

c. Click OK.

The Event Browser lists events without filtering them. No message appears at the top of the Contents pane.


Viewing Events on an Events Tab

You can view feature-specific events on the Events tab that appears in the Details pane for a feature. By default, an Events tab shows events received up to 1 hour prior to starting the DCNM client. For more information, see the "Configuring the Maximum Age of Events Fetched from the Server" section on page 4-15.

BEFORE YOU BEGIN

Typically, the Events tab appears when, in the Summary pane, you select an object that can have events associated with it. For example, if you select Interfaces > Physical > Ethernet from the Feature Selector pane, the Summary pane displays devices. Devices contain slots, and slots contain Ethernet ports. When you select a device, slot, or port, the Details pane displays an Events tab.

What you select in the Summary pane affects which events are shown in the tab. Continuing the Ethernet interface example, the scope of the events in the Events tab depends on what you select, as follows:

Device—Events that pertain to the selected device, any slot within the device, and any Ethernet interface within the slot.

Slot—Events that pertain to the selected slot and to any Ethernet interface within the slot.

Port—Events that pertain to the selected Ethernet interface.

DETAILED STEPS

To view an event on an Events tab, follow these steps:


Step 1 From the Feature Selector pane, choose the feature for which you want to view events.

For example, choose Interfaces > Physical > Ethernet.

Step 2 From the Summary pane, select an object.

The Events tab appears in the Details pane. In the Events tab, the events table appears.


Note If no Events tab appears, then DCNM cannot display events for the object you selected.


Step 3 (Optional) If you want to sort events, click the column heading that you want to sort by. For example, if you want to see events grouped by the status of the event, click the Status column heading.

Step 4 (Optional) If you want to filter events by column headings, from the menu bar, choose View > Filter and then use the column headings to filter the events.

Step 5 (Optional) If you want to view details about a specific event, follow these steps:

a. Find the event in the event list.

b. Click the event.

c. Expand the Details pane, if necessary.

Details about the selected event appear in the Details pane.

d. (Optional) To read notes and messages about status changes to the event, read the information in the Action Log field.


Changing the Status of an Event

You can change the status of an event to one of the following statuses:

Acknowledged—Shown as a green check mark.

Critical—Shown as a red circle.

Error—Shown as an orange triangle that points down.

Warning—shown as a yellow triangle that points up.

By default, the status of new event is Unacknowledged, which is indicated in the Status column by a green check mark with a red slash across it.

BEFORE YOU BEGIN

Select an event in the Events Browser or on an Events tab for a specific feature. For more information, see the "Viewing Events in the Events Browser" section or the "Viewing Events on an Events Tab" section.

DETAILED STEPS


Step 1 In the event table, right-click the selected event.

Step 2 Choose the desired status.

The new status appears in the Status column for the selected event.

In the Details pane, the message about the status change appears in the Action Log field.


Adding a Note to One or More Events

As of DCNM 4.0.2, you can add a note to one or more events. Notes can contain 1 to 1000 characters.


Note In Cisco DCNM 4.0.1, you can add a note to one event at a time. To add the same note to more than one event, you must add the note to each event separately, using the Notes field and Add Notes button.


BEFORE YOU BEGIN

Find the events to which you want to add a note. For more information, see the "Viewing Events in the Events Browser" section or the "Viewing Events on an Events Tab" section.

DETAILED STEPS

To add a note to one or more events, follow these steps:


Step 1 Select one or more events. Do one of the following:

To select one event, click the one event that you want to select.

To select two or more adjacent events, click and drag across the events.

To select two more events, press and hold Ctrl and click each event.

Step 2 On one of the selected events, right-click and then choose Add Notes.

The Notes dialog box appears.

Step 3 Enter the note. You can enter up to 1000 case-sensitive, alphanumeric characters.

Step 4 Click OK.

The note appears in the Action Log field for each selected event.


Deleting an Event

You can delete one or more events from the Events Browser or a feature-specific Events tab. A deleted event no longer appears in the Event Browser or on a feature-specific Events tab; however, the event remains in the events database.

For information about deleting old events from the events database, see the "Deleting Data from the Events Database" section on page 9-35.

BEFORE YOU BEGIN

Select an event in the Events Browser or on an Events tab for a specific feature. For more information, see the "Viewing Events in the Events Browser" section or the "Viewing Events on an Events Tab" section.

DETAILED STEPS


Step 1 In the event table, select one or more events that you want to delete.


Note To select more than one event, you can click and drag across the events or you can press and hold Ctrl and click each event.


Step 2 Right-click a selected event.

Step 3 Choose Remove Event.

The selected events disappear from the Event Browser.


Field Descriptions for Events

This section includes the following field descriptions for Events:

Events Table

Event Details

Events Table

The events table appears in the Event Browser and on feature-specific Events tabs.

Table 7-1 Events Table 

Field
Description

Device

Display only. Name and IP address of the device that the event is related to.

Source

Display only. Where the event message originated. Sources are either a feature on a managed NX-OS device or the DCNM server.

Feature

Display only. Name of the NX-OS or DCNM server feature that the event pertains to.

Time

Display only. Date and time that the event occurred.

Severity

Display only. Severity of the event. Possible severities are as follows:

Emergency

Alert

Critical

Error

Warning

Notification

Informational

Debug

Message

Display only. Text of the event.

Status

Status that you assign to the event. Possible statuses are as follows:

Acknowledge

Critical

Error

Warning


Event Details

Event details appear below the events table in the Event Browser and on feature-specific Events tabs.

Table 7-2 Event Details 

Field
Description

Event Type

Display only. Type of the event. Event types are categories that describe the general nature of the event. Possible event types are as follows:

Communication

Environmental

Equipment

Processing Error

Quality of Service

Security

Unknown

Action Log

Shows all actions taken on the event and all notes added to the event.

Life Cycle Type

Display only. Type of life cycle of the event. Possible life cycle types are as follows:

State Change

Attribute Value Change

Instance Creation

Instance Deletion

Informational

Notes

Allows you to enter text about the event. Maximum length is 1000 alphanumeric characters. After you save the note, it appears in the Action Log field.


Related Documents

Related Topic
Document Title

Minimum required NX-OS logging levels

 

DCNM server log settings

Administering DCNM Server Log Settings, page 9-43

Deleting events from the events database

Deleting Data from the Events Database, page 9-35

NX-OS system messages

Cisco NX-OS System Messages Reference