Class JDBCAccessLogValve
- All Implemented Interfaces:
- MBeanRegistration,- AccessLog,- Contained,- JmxEnabled,- Lifecycle,- Valve
This Tomcat extension logs server access directly to a database, and can be used instead of the regular file-based access log implemented in AccessLogValve. To use, copy into the server/classes directory of the Tomcat installation and configure in server.xml as:
      <Valve className="org.apache.catalina.valves.JDBCAccessLogValve"
          driverName="your_jdbc_driver"
          connectionURL="your_jdbc_url"
          pattern="combined" resolveHosts="false"
      />
 
 
 Many parameters can be configured, such as the database connection (with driverName and
 connectionURL), the table name (tableName) and the field names (corresponding to the
 get/set method names). The same options as AccessLogValve are supported, such as resolveHosts and
 pattern ("common" or "combined" only).
 
When Tomcat is started, a database connection is created and used for all the log activity. When Tomcat is shutdown, the database connection is closed. This logger can be used at the level of the Engine context (being shared by all the defined hosts) or the Host context (one instance of the logger per host, possibly using different databases).
The database table can be created with the following command:
CREATE TABLE access ( id INT UNSIGNED AUTO_INCREMENT NOT NULL, remoteHost CHAR(15) NOT NULL, userName CHAR(15), timestamp TIMESTAMP NOT NULL, virtualHost VARCHAR(64) NOT NULL, method VARCHAR(8) NOT NULL, query VARCHAR(255) NOT NULL, status SMALLINT UNSIGNED NOT NULL, bytes INT UNSIGNED NOT NULL, referer VARCHAR(128), userAgent VARCHAR(128), PRIMARY KEY (id), INDEX (timestamp), INDEX (remoteHost), INDEX (virtualHost), INDEX (query), INDEX (userAgent) );
Set JDBCAccessLogValve attribute useLongContentLength="true" as you have more then 4GB outputs. Please, use long SQL datatype at access.bytes attribute. The datatype of bytes at oracle is number and other databases use bytes BIGINT NOT NULL.
If the table is created as above, its name and the field names don't need to be defined.
 If the request method is "common", only these fields are used:
 remoteHost, user, timeStamp, query, status, bytes
 
TO DO: provide option for excluding logging of certain MIME types.
- Author:
- Andre de Jesus, Peter Rossbach
- 
Nested Class SummaryNested classes/interfaces inherited from interface org.apache.catalina.LifecycleLifecycle.SingleUse
- 
Field SummaryFields inherited from class org.apache.catalina.valves.ValveBaseasyncSupported, container, containerLog, next, smFields inherited from interface org.apache.catalina.AccessLogPROTOCOL_ATTRIBUTE, REMOTE_ADDR_ATTRIBUTE, REMOTE_HOST_ATTRIBUTE, SERVER_NAME_ATTRIBUTE, SERVER_PORT_ATTRIBUTEFields inherited from interface org.apache.catalina.LifecycleAFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidclose()Close the specified database connection.longbooleanbooleanvoidThis method is invoked by Tomcat on each query.voidAdd the request/response to the access log using the specified processing time.protected voidopen()Open (if necessary) and return a database connection for use by this AccessLogValve.voidsetBytesField(String bytesField) Sets the name of the field containing the number of bytes returned.voidsetConnectionName(String connectionName) Set the username to use to connect to the database.voidsetConnectionPassword(String connectionPassword) Set the password to use to connect to the database.voidsetConnectionURL(String connectionURL) Sets the JDBC URL for the database where the log is stored.voidsetDriverName(String driverName) Sets the database driver name.voidsetMethodField(String methodField) Sets the name of the field containing the HTTP request method.voidsetPattern(String pattern) Sets the logging pattern.voidsetQueryField(String queryField) Sets the name of the field containing the URL part of the HTTP query.voidsetRefererField(String refererField) Sets the name of the field containing the referer.voidsetRemoteHostField(String remoteHostField) Sets the name of the field containing the remote host.voidsetRequestAttributesEnabled(boolean requestAttributesEnabled) Should this valve use request attributes for IP address, hostname, protocol and port used for the request?voidsetResolveHosts(String resolveHosts) Determines whether IP host name resolution is done.voidsetStatusField(String statusField) Sets the name of the field containing the HTTP response status code.voidsetTableName(String tableName) Sets the name of the table where the logs are stored.voidsetTimestampField(String timestampField) Sets the name of the field containing the server-determined timestamp.voidsetUseLongContentLength(boolean useLongContentLength) voidsetUserAgentField(String userAgentField) Sets the name of the field containing the user agent.voidsetUserField(String userField) Sets the name of the field containing the remote user name.voidsetVirtualHostField(String virtualHostField) Sets the name of the field containing the virtual host information (this is in fact the server name).protected voidStart this component and implement the requirements ofLifecycleBase.startInternal().protected voidStop this component and implement the requirements ofLifecycleBase.stopInternal().Methods inherited from class org.apache.catalina.valves.ValveBasebackgroundProcess, getContainer, getDomainInternal, getNext, getObjectNameKeyProperties, initInternal, isAsyncSupported, setAsyncSupported, setContainer, setNext, toStringMethods inherited from class org.apache.catalina.util.LifecycleMBeanBasedestroyInternal, getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister, unregisterMethods inherited from class org.apache.catalina.util.LifecycleBaseaddLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stop
- 
Constructor Details- 
JDBCAccessLogValvepublic JDBCAccessLogValve()Class constructor. Initializes the fields with the default values. The defaults are:driverName = null; connectionURL = null; tableName = "access"; remoteHostField = "remoteHost"; userField = "userName"; timestampField = "timestamp"; virtualHostField = "virtualHost"; methodField = "method"; queryField = "query"; statusField = "status"; bytesField = "bytes"; refererField = "referer"; userAgentField = "userAgent"; pattern = "common"; resolveHosts = false; 
 
- 
- 
Method Details- 
setRequestAttributesEnabledpublic void setRequestAttributesEnabled(boolean requestAttributesEnabled) Should this valve use request attributes for IP address, hostname, protocol and port used for the request? The attributes used are:- org.apache.catalina.RemoteAddr
- org.apache.catalina.RemoteHost
- org.apache.catalina.Protocol
- org.apache.catalina.ServerName
- org.apache.catalina.ServerPost
 true.- Specified by:
- setRequestAttributesEnabledin interface- AccessLog
- Parameters:
- requestAttributesEnabled-- truecauses the attributes to be used,- falsecauses the original values to be used.
 
- 
getRequestAttributesEnabledpublic boolean getRequestAttributesEnabled()- Specified by:
- getRequestAttributesEnabledin interface- AccessLog
- Returns:
- trueif the attributes will be logged, otherwise- false
- See Also:
 
- 
getConnectionName- Returns:
- the username to use to connect to the database.
 
- 
setConnectionNameSet the username to use to connect to the database.- Parameters:
- connectionName- Username
 
- 
setDriverNameSets the database driver name.- Parameters:
- driverName- The complete name of the database driver class.
 
- 
getConnectionPassword- Returns:
- the password to use to connect to the database.
 
- 
setConnectionPasswordSet the password to use to connect to the database.- Parameters:
- connectionPassword- User password
 
- 
setConnectionURLSets the JDBC URL for the database where the log is stored.- Parameters:
- connectionURL- The JDBC URL of the database.
 
- 
setTableNameSets the name of the table where the logs are stored.- Parameters:
- tableName- The name of the table.
 
- 
setRemoteHostFieldSets the name of the field containing the remote host.- Parameters:
- remoteHostField- The name of the remote host field.
 
- 
setUserFieldSets the name of the field containing the remote user name.- Parameters:
- userField- The name of the remote user field.
 
- 
setTimestampFieldSets the name of the field containing the server-determined timestamp.- Parameters:
- timestampField- The name of the server-determined timestamp field.
 
- 
setVirtualHostFieldSets the name of the field containing the virtual host information (this is in fact the server name).- Parameters:
- virtualHostField- The name of the virtual host field.
 
- 
setMethodFieldSets the name of the field containing the HTTP request method.- Parameters:
- methodField- The name of the HTTP request method field.
 
- 
setQueryFieldSets the name of the field containing the URL part of the HTTP query.- Parameters:
- queryField- The name of the field containing the URL part of the HTTP query.
 
- 
setStatusFieldSets the name of the field containing the HTTP response status code.- Parameters:
- statusField- The name of the HTTP response status code field.
 
- 
setBytesFieldSets the name of the field containing the number of bytes returned.- Parameters:
- bytesField- The name of the returned bytes field.
 
- 
setRefererFieldSets the name of the field containing the referer.- Parameters:
- refererField- The referer field name.
 
- 
setUserAgentFieldSets the name of the field containing the user agent.- Parameters:
- userAgentField- The name of the user agent field.
 
- 
setPatternSets the logging pattern. The patterns supported correspond to the file-based "common" and "combined". These are translated into the use of tables containing either set of fields.TO DO: more flexible field choices. - Parameters:
- pattern- The name of the logging pattern.
 
- 
setResolveHostsDetermines whether IP host name resolution is done.- Parameters:
- resolveHosts- "true" or "false", if host IP resolution is desired or not.
 
- 
getUseLongContentLengthpublic boolean getUseLongContentLength()- Returns:
- trueif content length should be considered a long rather than an int, defaults to- false
 
- 
setUseLongContentLengthpublic void setUseLongContentLength(boolean useLongContentLength) - Parameters:
- useLongContentLength- the useLongContentLength to set
 
- 
invokeThis method is invoked by Tomcat on each query.- Specified by:
- invokein interface- Valve
- Parameters:
- request- The Request object.
- response- The Response object.
- Throws:
- IOException- Should not be thrown.
- ServletException- Database SQLException is wrapped in a ServletException.
 
- 
logDescription copied from interface:AccessLogAdd the request/response to the access log using the specified processing time.- Specified by:
- login interface- AccessLog
- Parameters:
- request- Request (associated with the response) to log
- response- Response (associated with the request) to log
- time- Time taken to process the request/response in nanoseconds (use 0 if not known); in Tomcat versions prior to 10, the time unit was milliseconds
 
- 
openOpen (if necessary) and return a database connection for use by this AccessLogValve.- Throws:
- SQLException- if a database error occurs
 
- 
closeprotected void close()Close the specified database connection.
- 
startInternalStart this component and implement the requirements ofLifecycleBase.startInternal().- Overrides:
- startInternalin class- ValveBase
- Throws:
- LifecycleException- if this component detects a fatal error that prevents this component from being used
 
- 
stopInternalStop this component and implement the requirements ofLifecycleBase.stopInternal().- Overrides:
- stopInternalin class- ValveBase
- Throws:
- LifecycleException- if this component detects a fatal error that prevents this component from being used
 
- 
getCurrentTimeMillispublic long getCurrentTimeMillis()
 
-