diff options
author | Rich Bowen <rbowen@apache.org> | 2011-09-20 13:57:52 +0200 |
---|---|---|
committer | Rich Bowen <rbowen@apache.org> | 2011-09-20 13:57:52 +0200 |
commit | c8de086646f905d0f192560a53fdfd23b4c69a62 (patch) | |
tree | 523cbac6c611ac86ebc11338f006353374b14ddb /docs/manual | |
parent | Rebuild HTML transformations. (diff) | |
download | apache2-c8de086646f905d0f192560a53fdfd23b4c69a62.tar.xz apache2-c8de086646f905d0f192560a53fdfd23b4c69a62.zip |
Replace log example with one that matches 2.4 logging.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1173098 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual')
-rw-r--r-- | docs/manual/logs.html.en | 32 | ||||
-rw-r--r-- | docs/manual/logs.xml | 33 |
2 files changed, 27 insertions, 38 deletions
diff --git a/docs/manual/logs.html.en b/docs/manual/logs.html.en index 074c3170e8..8041931fb1 100644 --- a/docs/manual/logs.html.en +++ b/docs/manual/logs.html.en @@ -107,27 +107,23 @@ <code>syslog</code> or <a href="#piped">pipe them to a program</a>.</p> - <p>The default format of the error log is relatively free-form and - descriptive. But there is certain information that is contained - in most error log entries. For example, here is a typical - message.</p> + <p>The format of the error log is defined by the <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code> directive, with which you + can customize what values are logged. A default is format defined + if you don't specify one. A typical log message follows:</p> <div class="example"><p><code> - [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1] - client denied by server configuration: - /export/home/live/ap/htdocs/test + [Fri Sep 09 10:42:29.902022 2011] [core:error] [pid 35708:tid 4328636416] + [client 72.15.99.187] File does not exist: /usr/local/apache2/htdocs/favicon.ico </code></p></div> <p>The first item in the log entry is the date and time of the - message. The second item lists the severity of the error being - reported. The <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> - directive is used to control the types of errors that are sent - to the error log by restricting the severity level. The third - item gives the IP address of the client that generated the - error. Beyond that is the message itself, which in this case - indicates that the server has been configured to deny the - client access. The server reports the file-system path (as - opposed to the web path) of the requested document.</p> + message. The next is the module producing the message (core, in this + case) and the severity level of that message. This is followed by + the process ID and, if appropriate, the thread ID, of the process + that experienced the condition. Next, we have the client address + that made the request. And finally is the detailed error message, + which in this case indicates a request for a file that did not + exist.</p> <p>A very wide variety of different messages can appear in the error log. Most look similar to the example above. The error @@ -135,9 +131,7 @@ information written to <code>stderr</code> by a CGI script will be copied directly to the error log.</p> - <p>Using the <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code> - directive, you can customize the format of the error log, and what - values are logged. If you have <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code>, you + <p>If <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> is loaded, you can put a <code>%L</code> token in both the error log and the access log, producing a log entry ID with which you can correlate the entry in the error log with the entry in the access log.</p> diff --git a/docs/manual/logs.xml b/docs/manual/logs.xml index 6c01ae7136..bd7c9b4ea4 100644 --- a/docs/manual/logs.xml +++ b/docs/manual/logs.xml @@ -112,27 +112,24 @@ <code>syslog</code> or <a href="#piped">pipe them to a program</a>.</p> - <p>The default format of the error log is relatively free-form and - descriptive. But there is certain information that is contained - in most error log entries. For example, here is a typical - message.</p> + <p>The format of the error log is defined by the <directive + module="core">ErrorLogFormat</directive> directive, with which you + can customize what values are logged. A default is format defined + if you don't specify one. A typical log message follows:</p> <example> - [Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1] - client denied by server configuration: - /export/home/live/ap/htdocs/test + [Fri Sep 09 10:42:29.902022 2011] [core:error] [pid 35708:tid 4328636416] + [client 72.15.99.187] File does not exist: /usr/local/apache2/htdocs/favicon.ico </example> <p>The first item in the log entry is the date and time of the - message. The second item lists the severity of the error being - reported. The <directive module="core">LogLevel</directive> - directive is used to control the types of errors that are sent - to the error log by restricting the severity level. The third - item gives the IP address of the client that generated the - error. Beyond that is the message itself, which in this case - indicates that the server has been configured to deny the - client access. The server reports the file-system path (as - opposed to the web path) of the requested document.</p> + message. The next is the module producing the message (core, in this + case) and the severity level of that message. This is followed by + the process ID and, if appropriate, the thread ID, of the process + that experienced the condition. Next, we have the client address + that made the request. And finally is the detailed error message, + which in this case indicates a request for a file that did not + exist.</p> <p>A very wide variety of different messages can appear in the error log. Most look similar to the example above. The error @@ -140,9 +137,7 @@ information written to <code>stderr</code> by a CGI script will be copied directly to the error log.</p> - <p>Using the <directive module="core">ErrorLogFormat</directive> - directive, you can customize the format of the error log, and what - values are logged. If you have <module>mod_unique_id</module>, you + <p>If <module>mod_unique_id</module> is loaded, you can put a <code>%L</code> token in both the error log and the access log, producing a log entry ID with which you can correlate the entry in the error log with the entry in the access log.</p> |