home *** CD-ROM | disk | FTP | other *** search
/ io Programmo 40 / IOPROG_40.ISO / SOFT / NETFrameworkSDK.exe / comsdk.cab / samples.exe / QuickStart / aspplus / doc / tracelogapp.aspx < prev    next >
Encoding:
Text File  |  2000-06-11  |  9.1 KB  |  243 lines
  1.  
  2. <!-- #include virtual="/quickstart/aspplus/include/header.inc" -->
  3.  
  4. <h4>Application-level Trace Logging</h4>
  5.  
  6. In addition to the Page-level Trace funtionality, ASP+ provides a way to enable trace output for an entire application.  Enabling Trace 
  7. at the application level has the effect of enabling Page-level trace for every page within that application.  When application-level 
  8. tracing is enabled, the ASP+ runtime also collects several additional statistics, such as the state of the control hierarchy, the contents of 
  9. session and application state, the form and querystring input values, and other characteristics of request's execution.  These statistics
  10. are collected for a specified number of requests as determined by the application's configuration file.  To enable tracing for an
  11. application, place the following in the application's config.web file at the application root directory:
  12. <p>
  13.  
  14. <div class="code"><pre>
  15. <configuration>
  16.   <trace enabled="true"/>
  17. </configuration>
  18. </pre></div>
  19.  
  20. <p>
  21. Using the above configuration, each page in the application will execute its page-level trace statements to be output in the client browser.  To access the additional page
  22. statistics, request a specially-mapped "trace.axd" URL from the application root.  For example, if the URL to your application 
  23. is <span style="color:blue"><u>http://localhost/myapplication</u></span>, you would request the URL
  24. <span style="color:blue"><u>http://localhost/myapplication/trace.axd</u></span> to access the trace statistics for that application.
  25. <p>
  26.  
  27. <div class="indent">
  28.   <img src="/quickstart/aspplus/images/trace1.gif"><br>
  29. </div>
  30.  
  31. <p>
  32. By default, trace information will be collected for up to 10 requests (you can use the "clear current trace" link to reset the request 
  33. counter).  The trace section of the configuration file also supports an attribute for controlling whether trace statements are output
  34. to the client browser, or whether they are only available from trace.axd.  The attributes supported in the trace configuration section 
  35. are listed in the table below:
  36. <p>
  37.  
  38. <p>
  39. <div class="indent">
  40. <table class="table" width="90%" cellpadding="3">
  41. <tr><th width="150"><b>Value</b></th><th><b>Description</b></th></tr>
  42. <tr><td>Enabled</td><td>Set to true | false, indicates whether Tracing is enabled for the application (default is true)</td></tr>
  43. <tr><td>PageOutput</td><td>Indicates whether trace information should be rendered at the end of each page û or only accessible via the trace.axd utility</td></tr>
  44. <tr><td>RequestLimit</td><td>Number of trace requests to store on the server (default is 10)</td></tr>
  45. </table>
  46. </div>
  47.  
  48. <p>
  49. For example, the following configuration collects trace information for up to 40 requests, and prevents trace statements from being 
  50. output to the requesting browser:
  51. <p>
  52.  
  53. <div class="code"><pre>
  54. <configuration>
  55.   <trace enabled="true" requestlimit="40" pageoutput="false"/>
  56. </configuration>
  57. </pre></div>
  58.  
  59.  
  60. <h5>Application Trace Request Details</h5>
  61. After making a series of requests to the application, accessing trace.axd will list those requests in time-order.  You can drill-down into
  62. the details for each request by selecting the "View Details" link.  
  63. <p>
  64.  
  65. <div class="indent">
  66.   <img src="/quickstart/aspplus/images/trace2.gif"><br>
  67. </div>
  68.  
  69. <p>
  70. The trace application presents the following detailed information for 
  71. each request:
  72. <p>
  73.  
  74. <div class="indent">
  75. <table class="table" width="90%" cellpadding="3">
  76. <tr><th colspan="2">
  77. <nobr><font size="2" style="text-indent:3;">
  78. <b>Request Detail</b>
  79. </font></nobr>
  80. </th>
  81. </tr>
  82. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  83. <tr><td>Session Id</td><td>The Session Id for this request</td></tr>
  84. <tr><td>Time of Request</td><td>The time the request was made</td></tr>
  85. <tr><td>Status Code</td><td>The returned status code for this request</td></tr>
  86. <tr><td>Request Type</td><td>GET | POST</td></tr>
  87. <tr><td>Compiled</td><td>True or False, indicates whether the page was compiled on this request, or pulled from the cache</td></tr>
  88. <tr><td>Cached</td><td>True or False, indicates whether the request was served from the Output Cache</td></tr>
  89. </table>
  90. </div>
  91.  
  92. <p>
  93. <div class="indent">
  94. <table class="table" width="90%" cellpadding="3">
  95. <tr><th colspan="2">
  96. <nobr><font size="2" style="text-indent:3;">
  97. <b>Trace Information</b>
  98. </font></nobr>
  99. </th>
  100. </tr>
  101. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  102. <tr><td>Category</td><td>The category for a Trace statement written to the TraceContext</td></tr>
  103. <tr><td>Warning</td><td>True | False, indicates whether the Trace statement was a warning</td></tr>
  104. <tr><td>Message</td><td>The message string for this Trace statement</td></tr>
  105. <tr><td>From First (s) </td><td>Time in seconds from the first Trace statement</td></tr>
  106. <tr><td>From Last (s)</td><td>Time in seconds from the previous Trace statement</td></tr>
  107. </table>
  108. </div>
  109.  
  110. <p>
  111. <div class="indent">
  112. <table class="table" width="90%" cellpadding="3">
  113. <tr><th colspan="2">
  114. <nobr><font size="2" style="text-indent:3;">
  115. <b>Control Hierarchy</b>
  116. </font></nobr>
  117. </th>
  118. </tr>
  119. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  120. <tr><td>Control ID</td><td>The ID for the control</td></tr>
  121. <tr><td>Type </td><td>The fully qualified type of the control</td></tr>
  122. <tr><td>Render Size</td><td>The size of the controlÆs rendering in bytes (both including and excluding children)</td></tr>
  123. <tr><td>ViewState Size</td><td>The size of the controlÆs viewstate in bytes (both including and excluding children)</td></tr>
  124. </table>
  125. </div>
  126.  
  127. <p>
  128. <div class="indent">
  129. <table class="table" width="90%" cellpadding="3">
  130. <tr><th colspan="2">
  131. <nobr><font size="2" style="text-indent:3;">
  132. <b>Session State</b>
  133. </font></nobr>
  134. </th>
  135. </tr>
  136. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  137. <tr><td>Key</td><td>The key for an object in Session State</td></tr>
  138. <tr><td>Type</td><td>The fully qualified type of the object</td></tr>
  139. <tr><td>Value</td><td>The value of the object</td></tr>
  140. </table>
  141. </div>
  142.  
  143. <p>
  144. <div class="indent">
  145. <table class="table" width="90%" cellpadding="3">
  146. <tr><th colspan="2">
  147. <nobr><font size="2" style="text-indent:3;">
  148. <b>Application State</b>
  149. </font></nobr>
  150. </th>
  151. </tr>
  152. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  153. <tr><td>Key</td><td>The key for an object in Application State</td></tr>
  154. <tr><td>Type</td><td>The fully qualified type of the object</td></tr>
  155. <tr><td>Value</td><td>The value of the object</td></tr>
  156. </table>
  157. </div>
  158.  
  159. <p>
  160. <div class="indent">
  161. <table class="table" width="90%" cellpadding="3">
  162. <tr><th colspan="2">
  163. <nobr><font size="2" style="text-indent:3;">
  164. <b>Cookies Collection</b>
  165. </font></nobr>
  166. </th>
  167. </tr>
  168. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  169. <tr><td>Name</td><td>The name of the cookie</td></tr>
  170. <tr><td>Value</td><td>The value of the cookie, or sub-keys/values if multi-valued</td></tr>
  171. </table>
  172. </div>
  173.  
  174. <p>
  175. <div class="indent">
  176. <table class="table" width="90%" cellpadding="3">
  177. <tr><th colspan="2">
  178. <nobr><font size="2" style="text-indent:3;">
  179. <b>Headers Collection</b>
  180. </font></nobr>
  181. </th>
  182. </tr>
  183. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  184. <tr><td>Name</td><td>The name of the header</td></tr>
  185. <tr><td>Value</td><td>The value of the header</td></tr>
  186. </table>
  187. </div>
  188.  
  189.  
  190. <p>
  191. <div class="indent">
  192. <table class="table" width="90%" cellpadding="3">
  193. <tr><th colspan="2">
  194. <nobr><font size="2" style="text-indent:3;">
  195. <b>Form Collection</b>
  196. </font></nobr>
  197. </th>
  198. </tr>
  199. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  200. <tr><td>Name</td><td>The name of the form variable</td></tr>
  201. <tr><td>Value</td><td>The value of the form variable</td></tr>
  202. </table>
  203. </div>
  204.  
  205. <p>
  206. <div class="indent">
  207. <table class="table" width="90%" cellpadding="3">
  208. <tr><th colspan="2">
  209. <nobr><font size="2" style="text-indent:3;">
  210. <b>QueryString Collection</b>
  211. </font></nobr>
  212. </th>
  213. </tr>
  214. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  215. <tr><td>Name</td><td>The name of the querystring variable</td></tr>
  216. <tr><td>Value</td><td>The value of the querystring variable</td></tr>
  217. </table>
  218. </div>
  219.  
  220.  
  221. <p>
  222. <div class="indent">
  223. <table class="table" width="90%" cellpadding="3">
  224. <tr><th colspan="2">
  225. <nobr><font size="2" style="text-indent:3;">
  226. <b>Server Variables</b>
  227. </font></nobr>
  228. </th>
  229. </tr>
  230. <tr><td width="150"><b>Value</b></td><td><b>Description</b></td></tr>
  231. <tr><td>Name</td><td>The name for the server variable</td></tr>
  232. <tr><td>Value</td><td>TThe value of the server variable</td></tr>
  233. </table>
  234. </div>
  235.  
  236. <h4>Section Summary</h4>
  237. <ol>
  238. <li>Application-level tracing is enabled using a "trace" section in the configuration file at the application root directory.
  239. <li>Application-level tracing enables trace log output for every page within an application.
  240. <li>After making a series of requests, details for those requests may be accessed by requesting "trace.axd" from the application root.
  241. </ol>
  242.  
  243. <!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->