tracelogapp.aspx

书籍教程 >> .Net教程 >> asp.net编程精彩百例


<!-- #include virtual="/quickstart/aspplus/include/header.inc" -->

<h4>应用程序级跟踪记录</h4>

除了页级跟踪功能外，ASP.NET 还提供为整个应用程序启用跟踪输出的方法。在应用程序级启用跟踪相当于在此应用程序内为所有页启用页级跟踪（如果没有显式禁用跟踪的页级指令）。当启用应用程序级跟踪后，ASP.NET 运行库还收集几种附加的统计信息，如控件层次结构状态、会话内容和应用程序状态、窗体和 querystring 输入值以及其他的请求执行特性。这些统计信息是为指定数目的请求收集的，具体数目由应用程序的配置文件决定。若要为应用程序启用跟踪，请在应用程序根目录下的应用程序 web.config 文件中放入以下内容：
<p>

<div class="code"><pre>
&lt;configuration&gt;
  &lt;system.web&gt;
    &lt;trace enabled="true"/&gt;
  &lt;/system.web&gt;
&lt;/configuration&gt;
</pre></div>

<p>
使用以上配置后，应用程序中的每一页都将运行其页级跟踪语句，并且这些语句将在客户端浏览器中输出。若要访问附加的页统计信息，请从应用程序根目录请求特别映射的“trace.axd”URL。例如，如果应用程序的 URL 是 <span style="color:blue"><u>http://localhost/myapplication</u></span>，应请求 URL <span style="color:blue"><u>http://localhost/myapplication/trace.axd</u></span> 以访问此应用程序的跟踪统计信息。
<p>

<div class="indent">
  <img src="/quickstart/aspplus/images/trace1.gif"><br>
</div>

<p>
默认情况下收集最多 10 个请求的跟踪信息（可以使用“清除当前跟踪”链接重置请求计数器）。配置文件的跟踪节还支持一个属性，该属性控制跟踪语句是输出到客户端浏览器，还是仅能通过 trace.axd 利用。下表列出了跟踪配置节中支持的属性：
<p>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th width="150"><b>值</b></th><th><b>说明</b></th></tr>
<tr><td>enabled</td><td>设置为 true | false，指示是否为应用程序启用跟踪（默认为 false）</td></tr>
<tr><td>pageOutput</td><td>设置为 true | false， 指示跟踪信息是呈现在每页的最后，还是仅能通过 trace.axd 实用工具访问（默认为 false）</td></tr>
<tr><td>requestLimit</td><td>存储在服务器上的跟踪请求的数目（默认为 10）</td></tr>
<tr><td>traceMode</td><td>设置为 SortByTime | SortByCategory，指示跟踪消息的显示顺序（默认为 SortByTime）</td></tr>
<tr><td>localOnly</td><td>设置为 true | false，指示是为本地主机用户还是为所有用户启用跟踪（默认为 true）</td></tr>
</table>
</div>

<p>
例如，下列配置收集最多 40 个请求的跟踪信息，并禁止跟踪语句输出到请求浏览器（如果没有显式启用跟踪的页级别指令）。消息按类别顺序显示：
<p>

<div class="code"><pre>
&lt;configuration&gt;
  &lt;system.web&gt;
    &lt;trace
      enabled="true"
      traceMode="SortByCategory"
      requestLimit="40"
      pageOutput="false"
      localOnly="true"
    /&gt;
  &lt;/system.web&gt;
&lt;/configuration&gt;
</pre></div>


<h5>应用程序跟踪请求详细信息</h5>
向应用程序发出一系列请求后，访问 trace.axd 将按时间顺序列出这些请求。可以选择“查看详细信息”链接，深入了解每个请求的详细信息。
<p>

<div class="indent">
  <img src="/quickstart/aspplus/images/trace2.gif"><br>
</div>

<p>
跟踪应用程序为每个请求显示以下详细信息：
<p>

<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>请求详细信息</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>会话 Id</td><td>此请求的会话 Id</td></tr>
<tr><td>请求的时间</td><td>发出请求的时间</td></tr>
<tr><td>状态代码</td><td>为此请求返回的状态代码</td></tr>
<tr><td>请求类型</td><td>GET | POST</td></tr>
<tr><td>请求编码</td><td>此请求的编码</td></tr>
<tr><td>响应编码</td><td>此响应的编码</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>跟踪信息</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>类别</td><td>写入 TraceContext 的跟踪语句的类别</td></tr>
<tr><td>消息</td><td>此跟踪语句的消息字符串</td></tr>
<tr><td>自第一个跟踪语句以来的时间（秒） </td><td>自第一个跟踪语句以来的时间（以秒为单位）</td></tr>
<tr><td>自上一个跟踪语句以来的时间（秒）</td><td>自上一个跟踪语句以来的时间（以秒为单位）</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>控件层次结构</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
<tr><td>控件 ID</td><td>控件的 ID </td></tr>
<tr><td>类型</td><td>控件的完全限定类型</td></tr>
<tr><td>呈现大小</td><td>控件的呈现大小（以字节为单位，包括子级）</td></tr>
<tr><td>视图状态大小</td><td>控件的视图状态大小（以字节为单位，不包括子级）</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>会话状态</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>键</td><td>会话状态下的对象的键</td></tr>
<tr><td>类型</td><td>对象的完全限定类型</td></tr>
<tr><td>值</td><td>对象的值</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>应用程序状态</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>键</td><td>应用程序状态下的对象的键</td></tr>
<tr><td>类型</td><td>对象的完全限定类型</td></tr>
<tr><td>值</td><td>对象的值</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>Cookies 集合</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>名称</td><td>Cookie 的名称</td></tr>
<tr><td>值</td><td>Cookie 的值，如果是多值的，则为子键/值</td></tr>
<tr><td>大小</td><td>以字节为单位的 Cookie 呈现大小</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>标头集合</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>名称</td><td>标头的名称</td></tr>
<tr><td>值</td><td>标头的值</td></tr>
</table>
</div>


<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>窗体集合</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>名称</td><td>窗体变量的名称</td></tr>
<tr><td>值</td><td>窗体变量的值</td></tr>
</table>
</div>

<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>QueryString 集合</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>名称</td><td>querystring 变量的名称</td></tr>
<tr><td>值</td><td>querystring 变量的值</td></tr>
</table>
</div>


<p>
<div class="indent">
<table class="table" width="90%" cellpadding="3">
<tr><th colspan="2">
<nobr><font size="2" style="text-indent:3;">
<b>服务器变量</b>
</font></nobr>
</th>
</tr>
<tr><td width="150"><b>值</b></td><td><b>说明</b></td></tr>
<tr><td>名称</td><td>服务器变量的名称</td></tr>
<tr><td>值</td><td>服务器变量的值</td></tr>
</table>
</div>

<h4>本节小结</h4>
<ol>
<li>应用程序级跟踪通过应用程序根目录下的配置文件中的“跟踪”节启用。
<li>应用程序级跟踪为应用程序内的每一页启用跟踪日志输出（如果没有显式禁用跟踪的页级指令）。
<li>发出一系列请求后，可以通过从应用程序根目录请求“trace.axd”来访问这些请求的详细信息。
</ol>

<!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->