tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rj...@apache.org
Subject svn commit: r1647376 - in /tomcat/jk/trunk/xdocs: reference/apache.xml webserver_howto/apache.xml
Date Mon, 22 Dec 2014 18:57:48 GMT
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 &lt;IfModule directive&gt; (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-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message