An implementation of the W3c Extended Log File Format. See
http://www.w3.org/TR/WD-logfile.html for more information about the format.
The following fields are supported:
c-dns: Client hostnamec-ip: Client ip addressbytes: bytes servedcs-method: request methodcs-uri: The full uri requestedcs-uri-query: The query stringcs-uri-stem: The uri without query stringdate: The date in yyyy-mm-dd format for GMTs-dns: The server dns entry s-ip: The server ip addresscs(XXX): The value of header XXX from client to serversc(XXX): The value of header XXX from server to client sc-status: The status codetime: Time the request was servedtime-taken: Time (in seconds) taken to serve the requestx-A(XXX): Pull XXX attribute from the servlet context x-C(XXX): Pull the first cookie of the name XXX x-R(XXX): Pull XXX attribute from the servlet request x-S(XXX): Pull XXX attribute from the session x-P(...): Call request.getParameter(...)
and URLencode it. Helpful to capture
certain POST parameters.
- For any of the x-H(...) the following method will be called from the
HttpServletRequestObject
x-H(authType): getAuthType x-H(characterEncoding): getCharacterEncoding x-H(contentLength): getContentLength x-H(locale): getLocalex-H(protocol): getProtocol x-H(remoteUser): getRemoteUserx-H(requestedSessionId): getGequestedSessionIdx-H(requestedSessionIdFromCookie):
isRequestedSessionIdFromCookie x-H(requestedSessionIdValid):
isRequestedSessionIdValidx-H(scheme): getSchemex-H(secure): isSecure
Log rotation can be on or off. This is dictated by the rotatable
property.
For UvNIX users, another field called checkExistsis also
available. If set to true, the log file's existence will be checked before
each logging. This way an external log rotator can move the file
somewhere and tomcat will start with a new file.
For JMX junkies, a public method called rotate has
been made available to allow you to tell this instance to move
the existing log file to somewhere else start writing a new log file.
Conditional logging is also supported. This can be done with the
condition property.
If the value returned from ServletRequest.getAttribute(condition)
yields a non-null value. The logging will be skipped.
For extended attributes coming from a getAttribute() call,
it is you responsibility to ensure there are no newline or
control characters.
author:
Tim Funk
version:
$Revision: 522854 $ $Date: 2007-03-27 12:10:45 +0200 (mar., 27 mars 2007) $ | 