TraceWorX Log Viewer

The TraceWorX Log Viewer is an application that reads TraceWorX log files and presents them in a human-readable format.

Information presented in the TraceWorX Log Viewer includes:

Column	Description
No.	The sequence number of the trace message. This defines the order in which trace messages occurred.
Details	Some trace message might include extra detailed information associated with the message, such as a call stack. If such details are available, a "details" link will be provided to popup a window containing the extra information.
Time	The time and date when this trace event occurred.
Level	The numeric trace level associated with this trace message. This indicates if the message was an Error, a Normal event, a Debug message, etc. This column is color coded so you can easily distinguish important message types such as errors. The numeric trace levels are defined here.
PID	The numeric identifier of the process (application/service instance) that generated this trace message. For example, if you are running two instances of GraphWorX, you will see messages with two different PIDs in the GraphWorX trace log. This column is color coded so you can easily distinguish which messages came from a particular application instance.
TID	The numeric identifier of the thread that generated this trace message. An application may have multiple threads running simultaneously. This column is color coded so you can easily distinguish which messages came from a particular thread.
Message	Text that describes the event. This helps you understand what was happening at that moment in the execution of the application.
Multiline	Normally the text message for a trace event is a single line of text. Occasionally a trace message may be multiple lines of text. In this case, a "multiline" link will be provided to popup a window containing all the lines of the text message.
Source file name	This will normally say "Unknown". This is only used for internal ICONICS development and analysis.
Source file row	This will normally be zero. This is only used for internal ICONICS development and analysis.
Source file column	This will normally be zero. This is only used for internal ICONICS development and analysis.
Assembly name	The full .NET identification of the DLL in which the event occurred.
Assembly code base	The full file path of the DLL in which the event occurred.
Namespace	The organizational container for the class in which application code was executing when the event occurred.
Thread name	The text moniker of the thread that generated this trace message. This is often empty, but may sometimes be a name that indicates the kind of work that the thread performs.
Class name	The organizational container for the function in which application code was executing when the event occurred.
Method info	The function name (and parameters) in which the application code was executing when the event occurred.

Filtering Messages in the Log Viewer

Since a TraceWorX log can contain huge numbers of trace messages, when analyzing logs, it can be useful to filter out certain messages. Filtering allows you to hide messages that are not relevant to the issue you are diagnosing.

Filtering options include:

Option	Description
Filter severity	Select a range of trace levels for messages that you want to see. All trace messages outside of the specified range will be hidden.
Filter time	Select a time range for the messages that you want to see. All trace messages outside of the specified time range will be hidden.
Filter text	Show only messages that include the specified text.

Highlighting Messages in the Log Viewer

When analyzing trace log files, it may be desirable to quickly find certain messages within the log. Highlighting allows you to visually mark messages that you want to more easily see in the overall sequence of events. Rows that include the specified Highlight text will be colored gray in the user interface, and you can use the arrow buttons to quickly navigate through the highlighted rows.