You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
276 lines
11 KiB
276 lines
11 KiB
<html>
|
|
|
|
<head>
|
|
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
|
|
<meta name=Generator content="Microsoft Word 10 (filtered)">
|
|
<title>Creating Trace Log Sessions</title>
|
|
|
|
<style>
|
|
<!--
|
|
/* Font Definitions */
|
|
@font-face
|
|
{font-family:Verdana;
|
|
panose-1:2 11 6 4 3 5 4 4 2 4;}
|
|
@font-face
|
|
{font-family:"MS Sans Serif";
|
|
panose-1:0 0 0 0 0 0 0 0 0 0;}
|
|
/* Style Definitions */
|
|
p.MsoNormal, li.MsoNormal, div.MsoNormal
|
|
{margin:0in;
|
|
margin-bottom:.0001pt;
|
|
font-size:12.0pt;
|
|
font-family:"Times New Roman";}
|
|
h1
|
|
{margin-top:12.0pt;
|
|
margin-right:0in;
|
|
margin-bottom:3.0pt;
|
|
margin-left:0in;
|
|
page-break-after:avoid;
|
|
font-size:16.0pt;
|
|
font-family:Arial;
|
|
font-weight:bold;}
|
|
h3
|
|
{margin-right:0in;
|
|
margin-left:0in;
|
|
font-size:13.5pt;
|
|
font-family:"Times New Roman";
|
|
font-weight:bold;}
|
|
h4
|
|
{margin-top:12.0pt;
|
|
margin-right:0in;
|
|
margin-bottom:3.0pt;
|
|
margin-left:0in;
|
|
page-break-after:avoid;
|
|
font-size:14.0pt;
|
|
font-family:"Times New Roman";
|
|
font-weight:bold;}
|
|
a:link, span.MsoHyperlink
|
|
{color:blue;
|
|
text-decoration:underline;}
|
|
a:visited, span.MsoHyperlinkFollowed
|
|
{color:blue;
|
|
text-decoration:underline;}
|
|
p
|
|
{margin-right:0in;
|
|
margin-left:0in;
|
|
font-size:12.0pt;
|
|
font-family:"Times New Roman";}
|
|
@page Section1
|
|
{size:8.5in 11.0in;
|
|
margin:1.0in 1.25in 1.0in 1.25in;}
|
|
div.Section1
|
|
{page:Section1;}
|
|
/* List Definitions */
|
|
ol
|
|
{margin-bottom:0in;}
|
|
ul
|
|
{margin-bottom:0in;}
|
|
-->
|
|
</style>
|
|
|
|
</head>
|
|
|
|
<body lang=EN-US link=blue vlink=blue>
|
|
|
|
<div class=Section1>
|
|
|
|
<h1><span style='font-size:24.0pt;font-family:"Times New Roman"'>Opening
|
|
Existing Log Files</span></h1>
|
|
|
|
<h4><span style='font-size:12.0pt'>Using TraceView To Open An Existing Log File</span></h4>
|
|
|
|
<p style='margin-bottom:12.0pt'>TraceView can be started by running it from the
|
|
command-line with no options, or double clicking its icon in Windows Explorer.
|
|
A new trace logging session may be started by selecting "File"
|
|
and then "Create New Log Session". Alternatively, right
|
|
clicking any blank area of the Log Session window causes a pop-up menu to appear
|
|
from which appropriate action can be selected.</p>
|
|
|
|
<p style='margin-bottom:12.0pt'><br>
|
|
<img width=764 height=209 src="OpeningExistingLogFiles_files/image001.jpg"></p>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'><br>
|
|
Selecting “Open Existing Log File” pops up the </span><span style='font-size:
|
|
12.0pt'>Log File Selection</span><span style='font-size:12.0pt;font-weight:
|
|
normal'> window. The ‘Log File Name’ edit box is where the name of the log
|
|
file (.etl file) to be opened is specified. The box is initially blank, as no
|
|
log file is specified. The other options let the user specify whether or not
|
|
to create listing and/or summary output files, and to name those files.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt'> </span></h3>
|
|
|
|
<h3><span style='font-weight:normal'><img width=431 height=328
|
|
src="OpeningExistingLogFiles_files/image002.jpg"></span></h3>
|
|
|
|
<h3> </h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>The ‘…’ button to the right of the ‘Log File Name’ edit box is a browse
|
|
button that brings up a file open dialog allowing the user to browse the system
|
|
for the appropriate log file as shown below:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=428 height=273
|
|
src="OpeningExistingLogFiles_files/image003.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>Clicking the ‘Open’ button will cause TraceView to open the log file
|
|
for reading. The log file must exist, and a warning will be displayed if it
|
|
does not. Once a valid log file is selected, and the ‘Open’ button selected,
|
|
the </span><span style='font-size:12.0pt'>Log File Selection </span><span
|
|
style='font-size:12.0pt;font-weight:normal'>window is updated with the new log
|
|
file name:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=431 height=328
|
|
src="OpeningExistingLogFiles_files/image004.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'><br>
|
|
Click the ‘OK’ button to bring up the </span><span style='font-size:12.0pt'>Format
|
|
Information Setup</span><span style='font-size:12.0pt;font-weight:normal'>
|
|
window. </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-weight:normal'><img
|
|
width=438 height=302 src="OpeningExistingLogFiles_files/image005.jpg"></span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'> </h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>Two options are available for providing trace event format information
|
|
to TraceView.</span></h3>
|
|
|
|
<h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:13.5pt;margin-left:
|
|
.75in;text-indent:-.25in'><span style='font-size:12.0pt;font-weight:normal'>1.)<span
|
|
style='font:7.0pt "Times New Roman"'> </span></span><span
|
|
style='font-size:12.0pt;font-weight:normal'>A PDB file which contains the
|
|
format GUID information internally.</span></h3>
|
|
|
|
<h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:13.5pt;margin-left:
|
|
.75in;text-indent:-.25in'><span style='font-size:12.0pt;font-weight:normal'>2.)<span
|
|
style='font:7.0pt "Times New Roman"'> </span></span><span
|
|
style='font-size:12.0pt;font-weight:normal'>TMF file(s) which have the format
|
|
GUID information for the trace events.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>A PDB file can be entered directly into the PDB edit box in the window
|
|
above, or the ‘…’ button can be used to browse for a suitable PDB file. If a valid
|
|
PDB file is selected, the previously specified log file is opened and the trace
|
|
event data displayed:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=885 height=315
|
|
src="OpeningExistingLogFiles_files/image006.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>Notice that the ‘State’ column in the </span><span style='font-size:
|
|
12.0pt'>Trace Log Session List</span><span style='font-size:12.0pt;font-weight:
|
|
normal'> window shows the session as ‘Existing’. This is always the state of
|
|
an existing log file opened in TraceView.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>If the user selected the TMF file(s) option back in the </span><span
|
|
style='font-size:12.0pt'>Format Information Setup </span><span
|
|
style='font-size:12.0pt;font-weight:normal'>window, then when the ‘OK’ button
|
|
is clicked, the </span><span style='font-size:12.0pt'>Format Information Source
|
|
Select</span><span style='font-size:12.0pt;font-weight:normal'> window appears.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=287 height=186
|
|
src="OpeningExistingLogFiles_files/image007.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-weight:normal'>The TMF
|
|
location can be specified in two ways. Either the TMF files can be specified directly,
|
|
or a TMF path can be specified which tells TraceView the location of the files,
|
|
but lets TraceView determine which files at that location are needed. If the ‘Select
|
|
TMF Files’ radio button is selected, and the user subsequently clicks ‘OK’, the
|
|
following Trace Format Information Setup window is displayed:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=413 height=294
|
|
src="OpeningExistingLogFiles_files/image008.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>The ‘Trace Format and Display Information’ list control lists all TMF
|
|
files selected for the given log file. The list is blank in the screenshot
|
|
above as no TMF files have been selected. To add a TMF file or files to the
|
|
list the user clicks the ‘Add’ button and a file open dialog appears:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=428 height=273
|
|
src="OpeningExistingLogFiles_files/image009.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>Multiple TMF files can be selected from this dialog. Whenever all
|
|
files have been selected, clicking ‘Open’ returns back to the previous window.
|
|
The window is updated with the new TMF information:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=413 height=294
|
|
src="OpeningExistingLogFiles_files/image010.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>Once all desired TMFs have been listed clicking ‘Done’ causes TraceView
|
|
to open the log file and display the trace event data.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>If the user specifed the ‘Set TMF Search Path’ option in the </span><span
|
|
style='font-size:12.0pt'>Format Information Source Select </span><span
|
|
style='font-size:12.0pt;font-weight:normal'>window, then the </span><span
|
|
style='font-size:12.0pt'>Select Directory</span><span style='font-size:12.0pt;
|
|
font-weight:normal'> window would appear when ‘OK’ is clicked:</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><img width=254 height=250
|
|
src="OpeningExistingLogFiles_files/image011.jpg"></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'>This window allows the user to select the path to the TMF file(s).
|
|
Only one path can be used for a given log file. When ‘OK’ is clicked from this
|
|
window, TraceView will open the log file and display the trace event
|
|
information.</span></h3>
|
|
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|
normal'> </span></h3>
|
|
|
|
<p align=center style='margin-bottom:12.0pt;text-align:center'><b><span
|
|
style='font-size:10.0pt;font-family:Verdana'><a
|
|
href="CreatingNewTraceLogSessions.htm">Top of page</a></span></b></p>
|
|
|
|
<p align=center style='margin-bottom:12.0pt;text-align:center'> </p>
|
|
|
|
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=873
|
|
style='width:654.65pt'>
|
|
<tr style='height:.05in'>
|
|
<td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:.05in'>
|
|
<p class=MsoNormal style='line-height:3.6pt'><span style='font-size:2.0pt'> </span></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><b><span style='font-size:11.0pt;font-family:"MS Sans Serif"'>© Microsoft
|
|
Corporation 2002</span></b></p>
|
|
|
|
<h3><span style='font-weight:normal'> </span></h3>
|
|
|
|
</div>
|
|
|
|
</body>
|
|
|
|
</html>
|