Previous Topic: HttpClient Logging

Next Topic: Federation 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 Agent-for-SharePoint_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:

Agent-for-SharePoint_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