The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter discusses the following topics:
•Using the Online and Offline Modes
•Using the Command Line Interface
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
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.
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.
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.
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.
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.
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.
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.
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.
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