164 lines
6.3 KiB
HTML
164 lines
6.3 KiB
HTML
|
<html>
|
|||
|
|
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
|
|||
|
|
<meta name=Generator content="Microsoft Word 10 (filtered)">
|
|||
|
|
<title>Joining Existing 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";}
|
|||
|
|
h3
|
|||
|
|
{margin-right:0in;
|
|||
|
|
margin-left:0in;
|
|||
|
|
font-size:13.5pt;
|
|||
|
|
font-family:"Times New Roman";
|
|||
|
|
font-weight:bold;}
|
|||
|
|
a:link, span.MsoHyperlink
|
|||
|
|
{color:blue;
|
|||
|
|
text-decoration:underline;}
|
|||
|
|
a:visited, span.MsoHyperlinkFollowed
|
|||
|
|
{color:purple;
|
|||
|
|
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=purple>
|
|||
|
|
|
|||
|
|
<div class=Section1>
|
|||
|
|
|
|||
|
|
<p><b><span style='font-size:24.0pt'>Controlling Trace Log Sessions</span></b></p>
|
|||
|
|
|
|||
|
|
<p style='margin-bottom:12.0pt'>Once a trace log session has been created, as
|
|||
|
|
explained in <a href="CreatingNewTraceLogSessions.htm">Creating New Trace Log
|
|||
|
|
Sessions</a>, TraceView can be used to control activities of that
|
|||
|
|
session. All control options for a given session are
|
|||
|
|
available by right clicking the session<6F>s line in the Trace Log Session List
|
|||
|
|
window in TraceView as shown here:</p>
|
|||
|
|
|
|||
|
|
<p style='margin-bottom:12.0pt'> </p>
|
|||
|
|
|
|||
|
|
<p style='margin-bottom:12.0pt'><img border=0 width=820 height=295
|
|||
|
|
src="ControllingTraceLogSessions_files/image001.jpg"></p>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-family:Verdana'> </span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-weight:normal'>The possible options are:</span></h3>
|
|||
|
|
|
|||
|
|
<ul style='margin-top:0in' type=disc>
|
|||
|
|
<li class=MsoNormal>Start Trace</li>
|
|||
|
|
<li class=MsoNormal>Stop Trace</li>
|
|||
|
|
<li class=MsoNormal>Group Sessions</li>
|
|||
|
|
<li class=MsoNormal>Ungroup Sessions</li>
|
|||
|
|
<li class=MsoNormal>Remove Log Session</li>
|
|||
|
|
</ul>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt'>Starting Trace Log Sessions</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-weight:normal'>Newly created log
|
|||
|
|
sessions are started automatically. But, once stopped a log session has
|
|||
|
|
to be explicitly started again from the the menu above. Starting the log
|
|||
|
|
session both starts the providers associated with the trace log session and starts
|
|||
|
|
TraceView consuming events from those providers. Only stopped trace log
|
|||
|
|
sessions will have Start Trace as an option. Grouped trace log sessions
|
|||
|
|
all start together, and cannot be started individually while grouped.</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt'>Stoping Trace Log Sessions</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-weight:normal'>Stopping a currently
|
|||
|
|
active trace log session causes the providers associated with the trace log
|
|||
|
|
session to stop generating events and it stops TraceView from attempting to
|
|||
|
|
consume events from those providers. Only currently active trace log
|
|||
|
|
sessions will have Stop Trace as an option. Grouped sessions all stop
|
|||
|
|
together and cannot be individually stopped while grouped.</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt'>Grouping Trace Log Sessions</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-weight:normal'>It is possible to group
|
|||
|
|
multiple distinct trace log sessions together in TraceView, such that all trace
|
|||
|
|
log sessions have their events displayed in a single display window.
|
|||
|
|
Grouping is accomplished in a similar fashion to start or stop by right
|
|||
|
|
clicking on the session<6F>s line in the Trace Log Session List window and
|
|||
|
|
selecting the appropriate option from the pop-up menu. Grouping of active
|
|||
|
|
trace log sessions is only supported on .NET and later operating systems.
|
|||
|
|
Grouping of multiple existing log file sessions is supported on all platforms
|
|||
|
|
supporting TraceView. <20>Group Sessions<6E> will only appear as a valid option
|
|||
|
|
if multiple trace log sessions for real-time trace providers are selected, or
|
|||
|
|
multiple existing log file sessions are selected, but not both. Also, for
|
|||
|
|
real-time trace log sessions, the sessions must all be stopped in order for the
|
|||
|
|
<EFBFBD>Group Sessions<6E> to be a valid option. Again, <20>Group Sessions<6E> will not
|
|||
|
|
show up as a valid option for real-time trace log sessions on any platform
|
|||
|
|
prior to the .NET platforms. Once grouped, all trace log session trace
|
|||
|
|
output will displayed to a single display window for all trace log sessions in
|
|||
|
|
the group. Upon grouping, if any display windows end up having no trace
|
|||
|
|
log sessions associated with them, they are removed.</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt'>Ungrouping Trace Log Sessions</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt;font-weight:normal'><EFBFBD>Ungroup Sessions<6E> is
|
|||
|
|
only a valid option for stopped trace log sessions. When ungrouped, all
|
|||
|
|
trace log sessions are automatically restarted. Ungrouped sessions are
|
|||
|
|
given a new display window for output.</span></h3>
|
|||
|
|
|
|||
|
|
<h3><span style='font-size:12.0pt'>Removing Trace Log Sessions</span></h3>
|
|||
|
|
|
|||
|
|
<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
|
|||
|
|
normal'>Only stopped trace log sessions can be removed. Removal of a log session
|
|||
|
|
will cause the removal of the trace log session<6F>s information from the Trace
|
|||
|
|
Log Session List window, and will cause the associated display window to be
|
|||
|
|
deleted, if the trace log session is the last associated session with that
|
|||
|
|
display window.</span></h3>
|
|||
|
|
|
|||
|
|
<p class=MsoNormal style='margin-left:.25in'> </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:10.0pt;font-family:"MS Sans Serif"'><EFBFBD> Microsoft
|
|||
|
|
Corporation 2002</span></b></p>
|
|||
|
|
|
|||
|
|
<h3><span style='font-weight:normal'> </span></h3>
|
|||
|
|
|
|||
|
|
<p style='margin-bottom:12.0pt'> </p>
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
</body>
|
|||
|
|
|
|||
|
|
</html>
|