Elipse Event Log Viewer, from now on referred only as Log Viewer, views messages of a supervisory system stored on files in Event Trace Logfile (.etl) format. These logs store information about Elipse Software systems on user's computer.
Basically, processes store these messages on disk using pre-configured folders, which are created by the log system when it is started. A service executing on the system is responsible for managing the size of files on the log folder, as well as their lifespan. If this service is disabled or is not executing, users cannot perform a file management.
The main function of Log Viewer is to display system-generated messages to users, by using filter and search functions, making the task of searching for errors easier.
IMPORTANT |
These logs are only enabled by users belonging to Windows Administrator or Performance Log Users groups. For more information, please check topic Security Restrictions. |
Log Viewer presents the following features:
•Opens files in ETL format
•Opens more than one file at a time, merging the content of these files
•Searches for messages
•Filters messages by type and by time
•Views log sessions in use
•Exports events to files with tab-separated columns
•Configures view options
•Configures storage options of messages on disk
•Allows selecting and copying events to the Clipboard
To use Log Viewer, select the Log Viewer item on Windows Start menu. The window on the next figure is opened.
Elipse Event Log Viewer's main window
This program is divided into an area on the left side to view files and an area on the right side to view events. Above these areas there is a toolbar and below there is a status bar. The available options on this toolbar are described on the next table.
Available options on the toolbar
Option |
Description |
|---|---|
Open Event File |
Opens a log file |
Merge Event Files |
Opens several files and merges their events chronologically on the same view |
Close File |
Closes the selected file |
Copy |
Copies the selected events to the Clipboard |
Find |
Opens a window to search for messages |
Filter Editor |
Shows a window to edit filters |
Toggle Filter On/Off |
Turns on or off all filters on the events of the selected file |
Fast Bookmark |
Creates a bookmark with a default name Bookmarkn, where n is an automatically incremented number |
Add Bookmark |
Creates a bookmark, by opening a window to select its name |
Remove Bookmark |
Removes the selected bookmark |
Edit Bookmarks |
Opens an edition window, which allows removing a bookmark, removing all bookmarks, or locating a bookmark |
Previous Bookmark |
Selects the previous bookmark |
Next Bookmark |
Selects the next bookmark |
Running Loggers |
Shows all active log sessions on the system |
Collect Files |
Opens the Elipse Event Log Collector's window |
Export Events |
Opens the Elipse Event Log Export's window |
Refresh View |
Refreshes the view with the last events stored on disk. If there are events in memory, they are stored on disk before refreshing |
Cancel Refresh |
Cancels a view refresh with the files on disk |
Storage Settings |
Displays the file storage configuration window |
Category Fast Filter Selector |
Selects a category to sort a message |
About |
Opens a window with the version of Log Viewer and its components |
The available categories for message sorting are described on the next table.
Available categories for message sorting
Number |
Category |
Color |
|---|---|---|
0 (zero) |
Log header |
Green |
10 |
Error |
Red |
11 |
Warning |
Yellow |
12 |
Information |
Blue |
14 |
Message for general usage |
-- |
15 |
Statistical and performance data |
-- |
16 |
Trace |
-- |
17 |
Additional information about a module |
Purple |
The status bar of Log Viewer's main window is divided into the areas shown on the next table.
Areas of Log Viewer's status bar
Area |
Description |
|---|---|
Number of events |
Number of events of the selected file on the viewing area. If there is no file selected, it displays the text "Ready". In case there is any active filter, the displayed value refers to events visible after applying that filter |
Selection |
Displays information about time interval between two events. The available options are Timespan between events, a time interval between two events, with a precision of milliseconds, Interval, the number of existing events between the selected events, or Average, a time average between two selected events, with a precision of milliseconds. In case there are more than two events selected, this area only displays the number of selected events |
Processing |
Displays the percentage of successfully processed events in the selected file |
Filters |
Displays whether there is any active filter in the selected file |