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
