Author: rjung
Date: Mon Dec 22 18:57:48 2014
New Revision: 1647376
URL: http://svn.apache.org/r1647376
Log:
- Give access log logging via notes preference
over old-style mod_jk request logging in the
mod_jk log file.
- Remove some Apache 1.3 artefacts from docs.
Modified:
tomcat/jk/trunk/xdocs/reference/apache.xml
tomcat/jk/trunk/xdocs/webserver_howto/apache.xml
Modified: tomcat/jk/trunk/xdocs/reference/apache.xml
URL:
http://svn.apache.org/viewvc/tomcat/jk/trunk/xdocs/reference/apache.xml?rev=1647376&r1=1647375&r2=1647376&view=diff
==============================================================================
--- tomcat/jk/trunk/xdocs/reference/apache.xml (original)
+++ tomcat/jk/trunk/xdocs/reference/apache.xml Mon Dec 22 18:57:48 2014
@@ -562,12 +562,11 @@ set the log level between :
<p>
<b>JkLogStampFormat</b> will configure the date/time format found on mod_jk
log file.
-Using the strftime() format string it's set by<br />
-default to <b>"[%a %b %d %H:%M:%S %Y]"</b>
+See above for details.
</p>
<source>
- JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
+ JkLogStampFormat "[%Y-%m-%d %H:%M:%S.%Q] "
</source>
<p>
@@ -576,41 +575,7 @@ default to <b>"[%a %b %d %H:%M:%S %Y]"</
</p>
<p>
-<b>JkRequestLogFormat</b> will configure the format of mod_jk individual
request logging.
-Request logging is configured and enabled on a per virtual host basis.
-To enable request logging for a virtual host just add a JkRequestLogFormat
config.
-The syntax of the format string is similar to the Apache LogFormat command,
-here is a list of the available request log format options:
-</p>
-
-<p>
-<attributes name="Options">
- <attribute name="%b" required="false">Bytes sent, excluding HTTP headers
(CLF format)</attribute>
- <attribute name="%B" required="false">Bytes sent, excluding HTTP
headers</attribute>
- <attribute name="%H" required="false">The request protocol</attribute>
- <attribute name="%m" required="false">The request method</attribute>
- <attribute name="%p" required="false">The canonical Port of the server
serving the request</attribute>
- <attribute name="%q" required="false">The query string (prepended with a ?
if a query string exists, otherwise an empty string)</attribute>
- <attribute name="%r" required="false">First line of request</attribute>
- <attribute name="%s" required="false">Request HTTP status code</attribute>
- <attribute name="%T" required="false">Request duration, elapsed time to
handle request in seconds '.' micro seconds</attribute>
- <attribute name="%U" required="false">The URL path requested, not including
any query string.</attribute>
- <attribute name="%v" required="false">The canonical ServerName of the server
serving the request</attribute>
- <attribute name="%V" required="false">The server name according to the
UseCanonicalName setting</attribute>
- <attribute name="%w" required="false">Tomcat worker name</attribute>
- <attribute name="%R" required="false">Real worker name</attribute>
-</attributes>
-
-<source>
- JkRequestLogFormat "%w %V %T"
-</source>
-
-<br/>
-<br/>
-</p>
-
-<p>
-You can also log mod_jk information using the Apache standard module
<b>mod_log_config</b>.
+You can log mod_jk information using the Apache standard module
<b>mod_log_config</b>.
The module sets several notes in the Apache httpd notes table.
Most of them are are only useful in combination with a load balancer worker.
</p>
@@ -652,6 +617,42 @@ Most of them are are only useful in comb
</source>
<br/>
+<br/>
+</p>
+
+<p>
+You can also log a request protocol in the mod_jk log file instead of
+the access log. This is not recommended and mostly a backward compatibility
+feature. The directive <b>JkRequestLogFormat</b> will configure the format
+of this protocol. It gets configured and enabled on a per virtual host basis.
+To enable request logging for a virtual host just add a JkRequestLogFormat
config.
+The syntax of the format string is similar to the Apache LogFormat command,
+here is a list of the available request log format options:
+</p>
+
+<p>
+<attributes name="Options">
+ <attribute name="%b" required="false">Bytes sent, excluding HTTP headers
(CLF format)</attribute>
+ <attribute name="%B" required="false">Bytes sent, excluding HTTP
headers</attribute>
+ <attribute name="%H" required="false">The request protocol</attribute>
+ <attribute name="%m" required="false">The request method</attribute>
+ <attribute name="%p" required="false">The canonical Port of the server
serving the request</attribute>
+ <attribute name="%q" required="false">The query string (prepended with a ?
if a query string exists, otherwise an empty string)</attribute>
+ <attribute name="%r" required="false">First line of request</attribute>
+ <attribute name="%s" required="false">Request HTTP status code</attribute>
+ <attribute name="%T" required="false">Request duration, elapsed time to
handle request in seconds '.' micro seconds</attribute>
+ <attribute name="%U" required="false">The URL path requested, not including
any query string.</attribute>
+ <attribute name="%v" required="false">The canonical ServerName of the server
serving the request</attribute>
+ <attribute name="%V" required="false">The server name according to the
UseCanonicalName setting</attribute>
+ <attribute name="%w" required="false">Tomcat worker name</attribute>
+ <attribute name="%R" required="false">Real worker name</attribute>
+</attributes>
+
+<source>
+ JkRequestLogFormat "%w %V %T"
+</source>
+
+<br/>
<br/>
</p>
Modified: tomcat/jk/trunk/xdocs/webserver_howto/apache.xml
URL:
http://svn.apache.org/viewvc/tomcat/jk/trunk/xdocs/webserver_howto/apache.xml?rev=1647376&r1=1647375&r2=1647376&view=diff
==============================================================================
--- tomcat/jk/trunk/xdocs/webserver_howto/apache.xml (original)
+++ tomcat/jk/trunk/xdocs/webserver_howto/apache.xml Mon Dec 22 18:57:48 2014
@@ -319,9 +319,9 @@ Here is a simple configuration:
<source>
# Load mod_jk module
- LoadModule jk_module libexec/mod_jk.so
- # Declare the module for <IfModule directive> (remove this line on
Apache 2.x)
- AddModule mod_jk.c
+ LoadModule jk_module modules/mod_jk.so
+ # Add the module (activate this lne for Apache 1.3)
+ # AddModule mod_jk.c
# Where to find workers.properties
JkWorkersFile /etc/httpd/conf/workers.properties
# Where to put jk shared memory
@@ -330,8 +330,6 @@ Here is a simple configuration:
JkLogFile /var/log/httpd/mod_jk.log
# Set the jk log level [debug/error/info]
JkLogLevel info
- # Select the timestamp log format
- JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# Send servlet for context /examples to worker named worker1
JkMount /examples/servlet/* worker1
# Send JSPs for context /examples to worker named worker1
@@ -406,11 +404,11 @@ set the log level between :
<p>
<b>JkLogStampFormat</b> will configure the date/time format found on mod_jk
logfile.
-Using the strftime() format string it's set by default to <b>"[%a %b %d
%H:%M:%S %Y]"</b>
+See the mod_jk <a href="../reference/apache.html">Apache HTTP server
reference</a> for details.
</p>
<source>
- JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
+ JkLogStampFormat "[%y-%m-%d %H:%M:%S.%Q] "
</source>
<p>
@@ -419,36 +417,36 @@ Using the strftime() format string it's
</p>
<p>
-<b>JkRequestLogFormat</b> will configure the format of mod_jk individual
request logging.
-Request logging is configured and enabled on a per virtual host basis.
-To enable request logging for a virtual host just add a JkRequestLogFormat
config.
-The syntax of the format string is similar to the Apache LogFormat command,
-here is a list of the available request log format options:
+You can log mod_jk information using the Apache standard module
<b>mod_log_config</b>.
+The module sets several notes in the Apache httpd notes table.
+Most of them are are only useful in combination with a load balancer worker.
+See the mod_jk <a href="../reference/apache.html">Apache HTTP server
reference</a> for details.
+</p>
+
+<source>
+ LogFormat "%h %l %u %t \"%r\" %>s %b %{JK_WORKER_NAME}n
%{JK_LB_FIRST_NAME}n \
+ %{JK_LB_FIRST_BUSY}n %{JK_LB_LAST_NAME}n %{JK_LB_LAST_BUSY}n"
mod_jk_log
+ CustomLog logs/access_log mod_jk_log
+</source>
+
+<p>
+<br/>
+<br/>
</p>
<p>
-<table>
- <tr><th>Options</th><th>Description</th></tr>
- <tr><td>%b</td><td>Bytes sent, excluding HTTP headers (CLF format)</td></tr>
- <tr><td>%B</td><td>Bytes sent, excluding HTTP headers</td></tr>
- <tr><td>%H</td><td>The request protocol</td></tr>
- <tr><td>%m</td><td>The request method</td></tr>
- <tr><td>%p</td><td>The canonical Port of the server serving the
request</td></tr>
- <tr><td>%q</td><td>The query string (prepended with a ? if a query string
exists, otherwise an empty string)</td></tr>
- <tr><td>%r</td><td>First line of request</td></tr>
- <tr><td>%s</td><td>Request HTTP status code</td></tr>
- <tr><td>%T</td><td>Request duration, elapsed time to handle request in
seconds '.' micro seconds</td></tr>
- <tr><td>%U</td><td>The URL path requested, not including any query
string.</td></tr>
- <tr><td>%v</td><td>The canonical ServerName of the server serving the
request</td></tr>
- <tr><td>%V</td><td>The server name according to the UseCanonicalName
setting</td></tr>
- <tr><td>%w</td><td>Tomcat worker name</td></tr>
- <tr><td>%R</td><td>Session route name (available with 1.2.19 and
up)</td></tr>
-</table>
+You can also log a request protocol in the mod_jk log file instead of
+the access log. This is not recommended and mostly a backward compatibility
+feature. The directive <b>JkRequestLogFormat</b> will configure the format
+of this protocol. It gets configured and enabled on a per virtual host basis.
+See the mod_jk <a href="../reference/apache.html">Apache HTTP server
reference</a> for details.
+</p>
<source>
JkRequestLogFormat "%w %V %T"
</source>
+<p>
<br/>
<br/>
</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
