Configuring logging for traces

diff -r ed1c9f64298a -r 5b9d4d8641ce trace/traceviewer/com.nokia.traceviewer.help/html/tasks/log.htm --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/trace/traceviewer/com.nokia.traceviewer.help/html/tasks/log.htm Wed Jun 23 14:49:59 2010 +0300 @@ -0,0 +1,88 @@ + + + + + Configuring logging for traces + + + + +

Configuring logging for traces

+ +

You can create a log out of the received traces. The log can be either a +plain text (ASCII) log file that can be opened in a normal text editor, or a +binary log file that will contain all the data in the same form as coming from +the trace source. Note that the binary file can only be opened in TraceViewer. +

+ +

Some typical cases for logging could be:

To work the with trace data independently of the device (uses binary + logs).
To compare two logs taken from the same test case, run at different times + (uses ASCII logs).
To analyse the log in other applications (uses ASCII logs).

+ +

To start logging, do the following:

From the TraceViewer menu, select Log.... +
A submenu containing options is displayed. You have multiple choices:
+
To open a previously written ASCII or Binary log file, select Open + log. A file selection dialog is displayed where you can select your log + file.
+
To write a new Binary log, select New Binary log. A file + selection dialog is displayed where you can select where to create your log + file.
+
To save currently shown traces to a Binary log file, select Save + current traces to Binary log. A file selection dialog is displayed + where you can select where to create your log file.
+
To stop currently ongoing Binary logging, select Close Binary + log. This option is not selectable if Binary logging is not ongoing. +
+
To write a new ASCII log, select New ASCII log. A file + selection dialog is displayed where you can select where to create your log + file. After file selection, a dialog is displayed where you can select few + options:
+
- (Optional) To omit timestamps from the plain text log files for a + better comparability between the log files, select Omit timestamps + from the log.
  +
  This option is useful for situations where the timestamp information + does not bring additional value to the analysis of data.
  +
- (Optional) To write a machine readable plain text log file, select + Write machine readable ASCII log.
  +
  This log file format is easy to read using automatic scripts.
  +
+
To save currently shown traces to a ASCII log file, select Save + current traces to ASCII log. A file selection dialog is displayed where + you can select where to create your log file.
+
To stop the currently ongoing ASCII logging, select Close ASCII + log. This option is not selectable if ASCII logging is not ongoing.
+

+ +

Note: If you have added comments to the traces, they will get written +to a separate file called <log_file_name>.meta. To see the comments when +you open the log file to TraceViewer, the .meta file must be in the same +directory as the log file itself.

+ +

Related concepts

Tracing

+ + + +