Log Analyzer main window

To view this page, launch the Log Analyzer, install_root/bin/waslogbr on UNIX systems or install_root\bin\waslogbr.bat on Windows NT or Windows 2000 systems. Click Help > Tasks.

The Log Analyzer takes one or more service or activity logs, merges all the data, and, by default, displays the entries in unit of work (UOW) groupings. It analyzes event and error conditions in the log entries to provide message explanations. The Log Analyzer main window interface has the following elements:

  • Three window panes

  • Status line

  • Menu bar

  • Pop-up actions

 

Window panes

The Log Analyzer window has three panes:

Logs pane (left)

By default, Log Analyzer Logs pane displays log entries by UOW. It lists all the UOW instances and its associated entries from the logs that you have opened. You may find the UOW grouping useful when you are trying to find related entries in the service or activity log or when you are diagnosing problems across multiple machines. The file name of the first log you open appears in the pane title bar. There is a root folder and under it, each UOW has a folder icon which one can expand to show all the entries for that UOW. All log entries without any UOW identification are grouped into a single folder in this tree view. The UOW folders are sorted to show the UOW with the latest timestamp at the top of the list. The entries within each UOW are listed in the reverse sequence, that is the first (earliest) entry for that UOW is displayed at the top of the list. If you have merged several logs in the Log Analyzer, all the log entries are merged in timestamp sequence within each UOW folder, as if they all came from the same log.

Every log entry is assigned an entry number, Rec_nnnn, when a log is opened in the Log Analyzer. If more than one file is opened in the Log Analyzer (merged files), the Rec_nnnn identification will not be unique because the number is relative to the entry sequence in the original log file and not to the merged data that the Log Analyzer is displaying. This Rec_nnnn appears in the first line (RecordId) in the Records pane.

By default, each entry in this pane is color-coded to help you quickly identify the ones that have high severity errors. The values listed here are the default values, one can configure your own colors.

  • Non-selected log entry with background color of:

    • Pink indicates that it has a severity 1 error.

    • Yellow indicates that it has a severity 2 error.

    • White indicates that it has a severity 3 error.

  • Selected log entry with background color of:

    • Red indicates that it has a severity 1 error.

    • Green indicates that it has a severity 2 error.

    • Blue indicates that it has a severity 3 error.

These colors are configurable and can be changed in the Log Analyzer Preferences Log page. See the help for the Severity page in the Log Analyzer Preferences notebook for different error severity levels and for more information on how to do this.

The Log Analyzer can display the log entries in different groupings. Use the Log Analyzer Preferences notebook: Logs page to set the grouping filters.

After the Analyze action has been invoked, each analyzed log entry has the following icons:

  • A check icon indicates that the entry has some analysis information in one or more pages in the Analysis pane.

  • A cascading plus sign (+) icon indicates that the entry has some analysis information and that it has a reraised or remapped exception. You may want to look at the log entry prior to this one when diagnosing problems.

  • A question mark icon indicates that the entry has either a severity 1 or 2 error but no additional analysis information is available for it.

  • An "x" icon indicates that the entry has a severity 3 error and it has no analysis information.

Record pane (upper right)

When you select an entry in the Logs pane, you see the entry in the Record pane. The entry identification appears in the pane title bar. Right-click in the Record pane to see actions that one can perform on the selected entry. A drop down arrow next to Record lets you look at the last ten records you have viewed. The cache for the historical data (10, by default) is set in the Preferences General page.

Note:

  • The page does not display associated analysis data for these cached records. To see analysis information for cached data, reselect the entry from the Logs pane.

We can enable or disable line wrap mode for the Record Pane using the Log Analyzer Preferences notebook: Record. To print contents of this pane, select Record > Print when the Record pane is in focus.

Analysis pane (lower right)

When the analyze action has been invoked and additional information is available, the information will appear in the Symptom page. If the page tab is grayed out, there is no information in that page. The pages of the Analysis pane are:

Symptom

The Log Analyzer provides a database of information on common events and errors to help you recover from some common errors. As a part of the analyze action, if such information is found in the database for the selected log entry, the information is displayed in this page.

 

Status line

There is a status line at the bottom of the window showing the status of actions.

 

Menu bar

The menu bar in the Log Analyzer main window,

has the following selections:

File

Open...

Opens a new log file. We can select either a service or activity log or a previously saved XML file. If you want the Log Analyzer to format a raw log file (by running the showlog command) prior to opening it, name the log file with suffix.log. If the Log Analyzer finds that the .log file contains formatted data, it skips the showlog formatting step.

If you want to merge data from another log, select Merge with.

Merge with...

When another log file is already opened in the Log Analyzer, use the Merge with action to open subsequent logs. The Log Analyzer merges the data from all the logs that it opens and displays all the entries within timestamp sequence in the UOW folders. The data appears as if they came from one log.

If you want the Log Analyzer to format a raw log file (by running the showlog command) prior to opening it, name the log file with suffix.log. If the Log Analyzer finds that the .log file contains formatted data, it skips the showlog formatting step.

Redisplay logs

To redisplay the logs using the recently set filters.

Save as...

Saves the log as an XML file (or text file). If analyze action has been performed, all the Symptom analysis information is also saved. If logs are merged in the Log Analyzer, the saved file contains entries of all the merged logs in the sequence that is shown in the Logs pane.

Note: If the merged logs have different timestamp formats, you should not save the merged information because the Log Analyzer only recognizes a single timestamp format for each file that it opens.

Save

Is only enabled if the first file that you opened is an XML file. It resaves the XML file with all the data that is currently displayed in the Log Analyzer. If analyze action has been performed, all the Symptom analysis information is also saved. If logs are merged in the Log Analyzer, the saved file contains entries of all the merged logs in the sequence that is shown in the Logs pane.

Note: If the merged logs have different timestamp formats, you should not save the merged information because the Log Analyzer only recognizes a single timestamp format for each file that it opens.

Print Log...

Prints all the entries that the Log Analyzer is displaying. If logs are merged in the Log Analyzer, the output contains entries of all the merged logs in the sequence that is shown in the Logs pane. If analyze action has been performed, all Symptom analysis information is also printed. To print parts of the log, use Record > Print.

Close

Closes the opened log.

Update Database

Updates the symptom database which is used for Symptom analysis. It downloads the latest version of the symptom database from the URL specified in the ivblogbr.properties file.

Preferences...

Lets you configure and change the appearance of the Log Analyzer window and its contents.

Exit

Exits the Log Analyzer and closes its window.

Edit

Copy

Copies the selected text in the Record or Analysis pane to the clipboard. If you have not selected any text, Copy does not appear in the menu.

Find

Allows you to find text strings in the focused pane.

View

Logs

Toggles the visibility of the Logs pane.

Record

Toggles the visibility of the Record pane.

Symptom

Toggles the visibility of the Symptom page in the Analysis pane.

Record

All the actions under this menu applies to the focused pane.

To select several entries, hold down the Ctrl key when making the selection. When a folder is selected, the action applies to all the entries in that folder.

Analyze

Retrieves and displays additional documentation on known events and event messages in the Analysis pane (Symptom page). Select the folders and entries in the Logs pane, right-click to select the Analyze action, or from the menu bar, select Record > Analyze.

Note: If you invoke Analyze for the root folder, then all the entries in the log that you are viewing will be analyzed. If some analysis information is available for an entry, it will either have a check icon or a cascading plus sign (+) icon next to it in the Logs pane. If the analyze action has already been performed, the selection will be grayed out.

Save to file

Saves the selected entries in the Logs pane. If folders are selected, all the entries in the folder are saved. Any retrieved analysis information is also saved. If the focused pane is either the Records or Analysis pane, then only information in that pane is saved.

Print

  • If the focused pane is Logs, the action prints the selected folders and entries. Any retrieved analysis information for those entries is also printed.

  • If the focused pane is Record, the action prints the entry that is currently in the Record pane. Any retrieved analysis information is not printed.

  • If the focused pane is Analysis, the action prints Symptom page contents.

Windows

If you detach the Symptom page in the Analysis pane into separate windows, all windows appear under this menu. We can select windows to bring them to the foreground.

Help

Provides a list of online documentation for additional information.

 

Pop-up actions

In the focused pane, right-click to bring up a list of actions in a pop-up menu. Actions that one cannot perform are grayed out. When a folder is selected in the Logs pane, the action applies to all entries in that folder. To select several folders or entries in the Logs pane, hold down the Ctrl key when making the selection.