Previous Topic

Book Contents

Book Index

Next Topic

Filter: 'RequestLoggingFilter'

A servlet filter which logs all of the requests. Each request is logged immediately when it arrives, and it is also logged after a response is sent. The request processing time is included.

Filter: 'RequestLoggingFilter'

Parameter Name

Description

Value/Default Value/Possible Value

log.level

Set the level of the logger. The requests are logged on the INFO level (see java.util.logging.Level).

Default: INFO

INFO

log.file

Defines whether the logging should be written to a file.

Value: true/false

Default: true

true

log.console

Defines whether the logging should be written into the console (system out).

Value: true/false

Default: false

false

log.params_to_mask

A comma-separated list of request parameters whose values must not be logged.

Default: pwd, verpwd, newpwd (not to log the provided passwords).

pwd, verpwd, newpwd

log.stats_period

Defines a time period (in seconds) to periodically report basic statistics. When the value is less or equal to 0, the statistics reporting is disabled.

Reported statistics:

- number of started and finished request

- total time (in ms) for processing all requests

- average request processing time (in ms)

- processing time and an ID of the longest request

Default: 60

60

logfile.namepattern

The file name pattern when logging into a file. The pattern is used to create the logging file and its "cycling copies".

If possible, specify the full path (e.g. C:/logs/vm_requets.log).

For more information about the file name pattern, please see 'java.util.logging.FileHandler'.

Default: vm_requests.log

vm_requests.log

log.http_headers

When set to 'true', the HTTP headers are also logged for the requests.

Default: true

true

logfile.append

Defines whether the logging information should be appended to an existing log file or a new log file. Should be created when logging starts.

Values: true/false

When true, the logged information are appended, When false, a new log file is created when server starts.

Default: true

true

logfile.count

Defines the number of backup copies of the log file.

Default: 1

1

logfile.size

Maximum size of the log file in bytes. When the defined amount of bytes is written to the file, the log file is backed up and a new file is created.

Default: 50000000 (=50MB)

50000000

logfile.use_xml

When set to true, the pieces of information are logged in the XML format (see java.util.logging.XMLFormatter). A simple text format is used otherwise.

Value: true/false

Default: false

false

See Also

Web.xml Deployment Descriptor

Servlet: 'vmweb'

Servlet: 'vmsf'

Servlet: 'peconsole'

Servlet 'status'

Filter: 'ResponseHeaderFilter'

Filter: 'CORS'

Filter: 'SecurityFilter'