277 lines
11 KiB
HTML
277 lines
11 KiB
HTML
<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 <20>Open Existing Log File<6C> 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 <20>Log File Name<6D> edit box is where the name of the log
|
||
file (.etl file) to be opened is specified.<2E> The box is initially blank, as no
|
||
log file is specified.<2E> 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 <20><><EFBFBD> button to the right of the <20>Log File Name<6D> 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 <20>Open<65> button will cause TraceView to open the log file
|
||
for reading.<2E> The log file must exist, and a warning will be displayed if it
|
||
does not.<2E> Once a valid log file is selected, and the <20>Open<65> 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 <20>OK<4F> 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.<2E> </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 <20><><EFBFBD> button can be used to browse for a suitable PDB file. <20>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 <20>State<74> 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 <20>Existing<6E>.<2E> 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 <20>OK<4F> 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.<2E> 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.<2E> If the <20>Select
|
||
TMF Files<65> radio button is selected, and the user subsequently clicks <20>OK<4F>, 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 <20>Trace Format and Display Information<6F> list control lists all TMF
|
||
files selected for the given log file.<2E> The list is blank in the screenshot
|
||
above as no TMF files have been selected.<2E> To add a TMF file or files to the
|
||
list the user clicks the <20>Add<64> 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.<2E> Whenever all
|
||
files have been selected, clicking <20>Open<65> returns back to the previous window.<2E>
|
||
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 <20>Done<6E> 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 <20>Set TMF Search Path<74> 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 <20>OK<4F> 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).<2E>
|
||
Only one path can be used for a given log file.<2E> When <20>OK<4F> 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"'><EFBFBD> Microsoft
|
||
Corporation 2002</span></b></p>
|
||
|
||
<h3><span style='font-weight:normal'> </span></h3>
|
||
|
||
</div>
|
||
|
||
</body>
|
||
|
||
</html>
|