|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
|
2 <html> |
|
3 <head> |
|
4 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> |
|
5 <title>Configuring logging for traces</title> |
|
6 <link href="../../book.css" type="text/css" rel="stylesheet"> |
|
7 </head> |
|
8 |
|
9 <body> |
|
10 <h2>Configuring logging for traces</h2> |
|
11 |
|
12 <p>You can create a log out of the received traces. The log can be either a |
|
13 plain text (ASCII) log file that can be opened in a normal text editor, or a |
|
14 binary log file that will contain all the data in the same form as coming from |
|
15 the trace source. Note that the binary file can only be opened in TraceViewer. |
|
16 </p> |
|
17 |
|
18 <p>Some typical cases for logging could be: </p> |
|
19 <ul> |
|
20 <li>To work the with trace data independently of the device (uses binary |
|
21 logs).</li> |
|
22 <li>To compare two logs taken from the same test case, run at different times |
|
23 (uses ASCII logs).</li> |
|
24 <li>To analyse the log in other applications (uses ASCII logs). </li> |
|
25 </ul> |
|
26 |
|
27 <p>To start logging, do the following: </p> |
|
28 <ol> |
|
29 <li>From the TraceViewer menu, select <b>Log...</b>. |
|
30 <p>A submenu containing options is displayed. You have multiple choices:</p> |
|
31 </li> |
|
32 <li><p>To open a previously written ASCII or Binary log file, select <b>Open |
|
33 log</b>. A file selection dialog is displayed where you can select your log |
|
34 file.</p> |
|
35 </li> |
|
36 <li><p>To write a new Binary log, select <b>New Binary log</b>. A file |
|
37 selection dialog is displayed where you can select where to create your log |
|
38 file.</p> |
|
39 </li> |
|
40 <li><p>To save currently shown traces to a Binary log file, select <b>Save |
|
41 current traces to Binary log</b>. A file selection dialog is displayed |
|
42 where you can select where to create your log file.</p> |
|
43 </li> |
|
44 <li><p>To stop currently ongoing Binary logging, select <b>Close Binary |
|
45 log</b>. This option is not selectable if Binary logging is not ongoing. |
|
46 </p> |
|
47 </li> |
|
48 <li><p>To write a new ASCII log, select <b>New ASCII log</b>. A file |
|
49 selection dialog is displayed where you can select where to create your log |
|
50 file. After file selection, a dialog is displayed where you can select few |
|
51 options:</p> |
|
52 <ul> |
|
53 <li><p>(Optional) To omit timestamps from the plain text log files for a |
|
54 better comparability between the log files, select <b>Omit timestamps |
|
55 from the log</b>.</p> |
|
56 <p>This option is useful for situations where the timestamp information |
|
57 does not bring additional value to the analysis of data.</p> |
|
58 </li> |
|
59 <li><p>(Optional) To write a machine readable plain text log file, select |
|
60 <b>Write machine readable ASCII log</b>.</p> |
|
61 <p>This log file format is easy to read using automatic scripts.</p> |
|
62 </li> |
|
63 </ul> |
|
64 </li> |
|
65 <li><p>To save currently shown traces to a ASCII log file, select <b>Save |
|
66 current traces to ASCII log</b>. A file selection dialog is displayed where |
|
67 you can select where to create your log file.</p> |
|
68 </li> |
|
69 <li><p>To stop the currently ongoing ASCII logging, select <b>Close ASCII |
|
70 log</b>. This option is not selectable if ASCII logging is not ongoing. </p> |
|
71 </li> |
|
72 </ol> |
|
73 |
|
74 <p><b>Note:</b> If you have added comments to the traces, they will get written |
|
75 to a separate file called <log_file_name>.meta. To see the comments when |
|
76 you open the log file to TraceViewer, the .meta file must be in the same |
|
77 directory as the log file itself.</p> |
|
78 |
|
79 <h5>Related concepts</h5> |
|
80 <ul> |
|
81 <li><a href="../concepts/tracing.htm">Tracing</a></li> |
|
82 </ul> |
|
83 |
|
84 <div id="footer"> |
|
85 Copyright © 2007-2010 Nokia Corporation and/or its subsidiary(-ies). All rights |
|
86 reserved.</div> |
|
87 </body> |
|
88 </html> |