Author: rjung
Date: Sun Jun 19 11:22:20 2011
New Revision: 1137338
URL: http://svn.apache.org/viewvc?rev=1137338&view=rev
Log:
Add new timestamp formatting info to AccessLogValve
docs.
Modified:
tomcat/trunk/webapps/docs/config/valve.xml
Modified: tomcat/trunk/webapps/docs/config/valve.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/config/valve.xml?rev=1137338&r1=1137337&r2=1137338&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/config/valve.xml (original)
+++ tomcat/trunk/webapps/docs/config/valve.xml Sun Jun 19 11:22:20 2011
@@ -209,8 +209,9 @@
</ul>
<p>
- There is also support to write information from the cookie, incoming
- header, the Session or something else in the ServletRequest.
+ There is also support to write information incoming or outgoing
+ headers, cookies, session or request attributes and special
+ timestamp formats.
It is modeled after the apache syntax:
<ul>
<li><b><code>%{xxx}i</code></b> for incoming headers</li>
@@ -218,17 +219,38 @@
<li><b><code>%{xxx}c</code></b> for a specific cookie</li>
<li><b><code>%{xxx}r</code></b> xxx is an attribute in the
ServletRequest</li>
<li><b><code>%{xxx}s</code></b> xxx is an attribute in the HttpSession</li>
+ <li><b><code>%{xxx}t</code></b> xxx is an enhanced SimpleDateFormat
pattern</li>
</ul>
</p>
+ <p>All formats supported by SimpleDateFormat are allowed in
<code>%{xxx}t</code>.
+ In addition the following extensions have been added:
+ <ul>
+ <li><b><code>sec</code></b> - number of seconds since the epoch</li>
+ <li><b><code>msec</code></b> - number of milliseconds since the epoch</li>
+ <li><b><code>msec_frac</code></b> - millisecond fraction</li>
+ </ul>
+ These formats can not be mixed with SimpleDateFormat formats in the same
format
+ token.</p>
- <p>The shorthand pattern name <code>common</code> (which is also the
- default) corresponds to <strong>'%h %l %u %t "%r" %s %b'</strong>.</p>
+ <p>Furthermore one can define whether to log the timestamp for the request
start
+ time or the response finish time:
+ <ul>
+ <li><b><code>begin</code></b> or prefix <b><code>begin:</code></b> chooses
+ the request start time</li>
+ <li><b><code>end</code></b> or prefix <b><code>end:</code></b> chooses
+ the response finish time</li>
+ </ul>
+ By adding multiple <code>%{xxx}t</code> tokens to the pattern, one can
+ also log both timestamps.</p>
- <p>The shorthand pattern name <code>combined</code> appends the
- values of the <code>Referer</code> and <code>User-Agent</code> headers,
- each in double quotes, to the <code>common</code> pattern
- described in the previous paragraph.</p>
+ <p>The shorthand pattern <code>pattern="common"</code>
+ corresponds to the Common Log Format defined by
+ <strong>'%h %l %u %t "%r" %s %b'</strong>.</p>
+
+ <p>The shorthand pattern <code>pattern="combined"</code>
+ appends the values of the <code>Referer</code> and <code>User-Agent</code>
+ headers, each in double quotes, to the <code>common</code> pattern.</p>
</subsection>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
