Administration Guide › Configuring the SPS Server Settings › General Server Settings in the server.conf File › HttpClient Logging › Configure HttpClient Logging

Configure HttpClient Logging

You can configure various aspects of HttpClient logging by setting values to parameters in the httpclientlogging.properties file. This file is located in the sps_home\Tomcat\properties directory.

Important! Because of potential performance degradation, do not enable HttpClient logging in a production environment.

The httpclientlogging.properties file has the following configurable parameters:

java.util.logging.FileHandler.formatter

Description: Specifies the name of the formatter class

Limits:

java.util.logging.SimpleFormatter — writes brief summaries of log records

java.util.logging.XMLFormatter — writes detailed descriptions in XML format

Default: java.util.logging.SimpleFormatter

java.util.logging.FileHandler.pattern

Description: Specifies the name of the HttpClient log file.

Limits:

sps_home\proxy-engine\logs\httpclient%g.log

%g represents the generation number of the rotated log file.

java.util.logging.FileHandler.count

Description: Specifies the number of output files in a cycle

Default: 10

java.util.logging.FileHandler.limit

Description: Specifies an approximate maximum number of bytes to write to any on log file.

Limits: If set to zero, there is no limit.

Default: 5,000,000

In addition, you can specify the content of the logs with the following parameters:

Note: The value is always FINEST.

org.apache.commons.httpclient.level=FINEST

Specifies context logging only

httpclient.wire.header.level=FINEST

org.apache.commons.httpclient.level=FINEST

Specifies header wire and context logging

httpclient.wire.level=FINEST

org.apache.commons.httpclient.level=FINEST

Specifies full wire (header and content) and context logging