]> granicus.if.org Git - apache/commitdiff
update transformation
authorAndré Malo <nd@apache.org>
Wed, 25 Feb 2004 05:36:04 +0000 (05:36 +0000)
committerAndré Malo <nd@apache.org>
Wed, 25 Feb 2004 05:36:04 +0000 (05:36 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@102769 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/mod/mod_log_forensic.html.en

index b7269f0914fc992b4de330d8970c7c04c441dd1b..0935bc15eeda2cadda80f1b47f6286da0d8b3d7f 100644 (file)
     <p>This module provides for forensic logging of client
     requests. Logging is done before and after processing a request, so the
     forensic log contains two log lines for each request.
-    The forensic logger works very strict, which means:</p>
+    The forensic logger is very strict, which means:</p>
 
     <ul>
     <li>The format is fixed. You cannot modify the logging format at
     runtime.</li>
-    <li>If it cannot write its data, the particular child process
-    exits immediately and possibly dumps core (depends on your
+    <li>If it cannot write its data, the child process
+    exits immediately and may dump core (depending on your
     <code class="directive"><a href="../mod/mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></code>
     configuration).</li>
     </ul>
 
-    <p>In order to evaluate the log output there's a script
-    <code>check_forensic</code>, which can be found in the support directory
-    of the distribution.</p>
+    <p>The <code>check_forensic</code> script, which can be found in the
+    distribution's support directory, may be helpful in evaluating the
+    forensic log output.</p>
 </div>
 <div id="quickview"><h3 class="directives">Directives</h3>
 <ul id="toc">
@@ -69,9 +69,9 @@
     where normal logging occurs.</p>
 
     <p>In order to identify each request, a unique request ID is assigned.
-    This forensic id can be cross logged in the normal transfer log using the
+    This forensic ID can be cross logged in the normal transfer log using the
     <code>%{forensic-id}n</code> format string. If you're using
-    <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> its generated ID will be used.</p>
+    <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>, its generated ID will be used.</p>
 
     <p>The first line logs the forensic ID, the request line and all received
     headers, separated by pipe characters (<code>|</code>). A sample line
 
     <p>The plus character at the beginning indicates that this is first log
     line of this request. The second line just contains a minus character and
-    the id again:</p>
+    the ID again:</p>
 
     <div class="example"><p><code>
       -yQtJf8CoAB4AAFNXBIEAAAAA
     </code></p></div>
 
-    <p>The <code>check_forensic</code> script gets as its argument the name
+    <p>The <code>check_forensic</code> script takes as its argument the name
     of the logfile. It looks for those <code>+</code>/<code>-</code> ID pairs
     and complains if a request was not completed.</p>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in version 2.1 and later</td></tr>
 </table>
     <p>The <code class="directive">ForensicLog</code> directive is used to
-    log requests to the server for forensic analysis. Each log entry
-    gets assigned unique id which can be associated with the request
+    log requests to the server for forensic analysis. Each log entry
+    is assigned a unique ID which can be associated with the request
     using the normal <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>
-    directive. <code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> leaves a note called
-    <code>forensic-id</code> which can be added to the transfer log by
+    directive. <code class="module"><a href="../mod/mod_log_forensic.html">mod_log_forensic</a></code> creates a token called
+    <code>forensic-id</code>, which can be added to the transfer log
     using the <code>%{forensic-id}n</code> format string.</p>
 
     <p>The argument, which specifies the location to which