Cisco UCS Server System Event Log Viewer Utility User Guide
Working with the Logs
Downloads: This chapterpdf (PDF - 113.0KB) The complete bookPDF (PDF - 326.0KB) | Feedback

Working with the Logs

Table Of Contents

Working with the Logs

Overview of the Tasks

Viewing the Logs

Viewing the Summary of the Logs

Sorting the Logs

Filtering the Logs

Saving the Log Details

Opening a File

Clearing the Logs

Using the Online and Offline Modes

Using the Command Line Interface


Working with the Logs


This chapter discusses the following topics:

Overview of the Tasks

Viewing the Logs

Sorting the Logs

Filtering the Logs

Saving the Log Details

Clearing the Logs

Using the Online and Offline Modes

Using the Command Line Interface

Overview of the Tasks

Using the SEL Viewer utility, you can perform the following tasks with the logs:

View and sort logs

Filter logs based on severity, event generator, and sensor information of the event.

Save log details to a file outside the utility

Switch between online and offline modes

Viewing the Logs

When you start the utility, and if it is running in the online mode, you can view all logs that have been generated. On the top-right pane, the Entries per page field displays the number of events that are displayed on each page. Using this field, you can modify the number of events that are displayed on each page. You can select one of the following options:

All

50

100

200

Each log entry has the following details displayed:

Record ID - The ID of the event.

Timestamp - The time at which this event occurred. It is displayed in the yyyy-mm-dd hh:mm:ss format.

Severity - It can be Critical, Non-Recoverable, Informational, Warning, or Normal.

Generator - The generator of the event. It can be BIOS, CIMC, OEM or unknown.

Events that have the generator listed as OEM are not decoded and are displayed with the HEX value.

Sensor Information

Event Description

Event State

To view additional information on any specific log, double-click the log entry. The Record Information page is displayed.

You can use the << First, < Prev, Next >, and Last >> options to navigate across the pages of generated events. When you use these options, the Page field displays the number of the page that you are viewing the events on.

Viewing the Summary of the Logs

In the top pane of the utility, a summary of all events that are generated is displayed. Information such as the total number of logs, number of critical logs, and number of non-recoverable logs is displayed.

You can also view the current SEL information by clicking SEL > SEL Info. The subsequent screen displays the following information:

Total number of entries

Percentage space left

Timestamp of last added event

Timestamp of last deleted event


Note In the offline mode, the SEL Info option is disabled.


Sorting the Logs

When you open the utility in the online mode, all logs that have been generated are displayed. You can sort these log details to view the information in the format that suits you. You can click any column headers to sort the list of logs.

Alternatively, you can select a row and press F9 to sort the logs based on the sensor type. For example, if you click an entry that is listed with chipset as the sensor type, and then press F9, all logs that have the sensor type specified as chipset are displayed.

Filtering the Logs

In addition to sorting the logs, you can use the Filter option to view the logs that are important for you. You can filter the logs based on sensor type, generator, and severity.

After you filter the logs with one criteria, subsequent filtering tasks occur within the results of the previous filtering task. For example, after filtering for logs that are marked as critical severity, if you select BMC as the generator, and then click Go, all logs that have the severity marked as Critical, and have BMC as the generator are displayed. To run a filtering task on the original set of logs, you must first click Clear Filter.

To filter the logs displayed, follow these steps:


Step 1 From the top pane of the utility, under Filter, select an option either for Severity, Generator, or Sensor Info.

Step 2 To filter the list of events based on the severity, select one of the following options:

None

Critical

Non-Recoverable

Informational

Warning

Normal

Step 3 To filter the list of events based on the generator, select one of the following options:

None

BMC

BIOS

OEM

Unknown

Step 4 To filter the list based on the sensor type, enter the type of sensor in the text box.

Step 5 Click Go. A progress bar indicates that the filtering task is in progress.

The screen is updated with the logs filtered based on the criteria you selected. The bottom pane of the utility displays the total number of records that match the filtering criteria.

Step 6 To clear the filtering criteria, click Clear Filter.


Saving the Log Details

Using the SEL Viewer utility, you can save the log details to a file outside the utility. You can save the file either as a .csv file or as a .bin file. When you save the log details to a .csv file, you can open it with Microsoft Excel. If you save the file with the .bin extension, you can open it later in this utility.

To save the log details to a file, follow these steps:


Step 1 Click File > Save As.

Step 2 Select Binary or Csv.

You are prompted to either save the file or find a program to open the file.

Step 3 Click Save.

Step 4 Specify the location where you want the file to be saved and click OK.


When the utility is running in the offline mode, you can choose to open the log file and view it within this utility. Although you can save the log details in either the .csv or .bin format, to view the log details from a file within this utility, you can only use the .bin file.

Opening a File

When the utility is in the offline mode, you can open the file that contains all the log information. You can open only the .bin file in this utility. Also, the .bin file should have been saved from the SEL Viewer utility earlier on, either through the GUI or the CLI.


Note In the offline mode, when you open a file that contains the logs from CIMC in the SEL Viewer utility, the Save option is disabled.


To open the saved log files, follow these steps:


Step 1 Click File > Open.

Step 2 In the dialog box that appears, specify the path of the file.

Optionally, you can click Browse to locate the file.

Step 3 Click OK.

The file is opened in the utility.


Clearing the Logs

The utility provides you with an option to clear the logs from the utility and from the CIMC. After the logs are cleared from the utility and the CIMC, you cannot retrieve them. We recommend that you use the Clear option only when you are sure you want to clear all the logs from the CIMC.

To clear the logs from the utility, click SEL > Clear. You are prompted to confirm that you want to clear all SEL records. Click OK to clear all logs. All logs from the utility and from CIMC are cleared.

Using the Online and Offline Modes

When the utility establishes a communication channel with the CIMC, it runs in the online mode. In this mode, you can view and work with the most recent logs that have been generated. If a communication channel is not established with the CIMC, this utility runs in the offline mode. In addition, you can run the SEL Viewer utility only in the offline mode on Windows XP SP2 systems.

Also, if you would prefer not to install the GUI on the server, you can use the CLI and capture a snapshot of all logs from the server and save it as a .bin file. You can then log in to the GUI of this utility on your system and analyze the file in the offline mode.

In the offline mode, you cannot view the recent data. You can only open a .bin file that contains the log files displayed in the utility earlier on. In the offline mode, most options are disabled. You cannot save or clear the logs, and you cannot use the SEL Info option. However, you can attempt to establish a connection with the CIMC by clicking SEL > Reload.

Using the Command Line Interface

The following table lists the commands that you can use to work with the event logs in the CLI of the SEL Viewer utility.

Table 3-1

Command
Description

selview help

Displays the help for the SEL Viewer Utility.

selview [display|show] {hex|xml} {abc.bin}

Displays the event log data in one of the following formats:

Text

HEX

XML

If the filename is provided, then the event details are displays from the file.

selview save abc.bin

Saves the SEL data in a binary file.

selview save abc.csv

Saves the SEL data in a CSV file.

selview clear

Clears the event log details from the utility and from the CIMC. This action cannot be reverted.

selview write abc.bin

Reloads the SEL records. This command reads the contents from the .bin file and writes it back to the utility.


Command Description