[TIP: Focusing the table of contents and search results]
Log Analyzer main window
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.
To view this page, launch the Log Analyzer from the app_server_root/bin/waslogbr directory.
To view The Appearance page of the Log Analyzer Preferences
notebook, launch the Log Analyzer from the app_server_root\bin\waslogbr.bat directory.
Click Help > Tasks.
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 might 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 you 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, you 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 you 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.
You 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. You 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. You 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 you 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.
|
