en.help.task-accesslog.html Maven / Gradle / Ivy
Show all versions of console-web-plugin-help
To Configure the HTTP Service
- In the navigation tree, expand the Configuration node.
- Under the Configuration node, select the HTTP Service node.
The HTTP Service page opens.
- Select the SSO Enabled checkbox to enable single sign-on by default for all
web applications on all virtual servers on this server that are configured for
the same realm.
You can override this setting for an individual virtual server. This option is
disabled by default.
- Select the Access Logging Enabled checkbox to enable access logging for all virtual-server
sub-elements that do not specify this property.
If the Access Logging Enabled checkbox is deselected, access logging is disabled for
all virtual-server sub-elements that do not specify this property. This option is
disabled by default.
- Select the Rotation Enabled checkbox to enable log file rotation.
This option is enabled by default.
- From the Rotation Policy drop-down list, select a rotation policy.
The only available rotation policy is time.
- In the Rotation Interval field, type the number of minutes between rotations of
the access log.
This field is valid only if the Rotation Policy is time. The default
value is 1,440 minutes (24 hours).
- In the Rotation Suffix field, type the string value to be added to
the end of the log file name after rotation.
The default value is yyyy-MM-dd.
Ensure that the rotation suffix contains enough values to create a unique suffix
for every log rotation. For example, if the access log is rotated
more frequently than once every day, include the time of day in the
rotation suffix.
A unique suffix is required to ensure that the access log file
is rotated every time that the rotation interval has elapsed. If the rotation
suffix of the new access log file is the same as the rotation
suffix of the existing access log file, the file is not rotated.
- In the Max File Count field, type the maximum number of rotated access
log files that are to be kept.
A negative value indicates that there is no limit to the file count.
The default value is –1.
- In the Buffer Size field, type the size, in bytes, of the
access log buffer.
A value of less than or equal to 0 disables access log buffering.
The default value is 32768.
- In the Write Interval field, type the number of seconds before the log
will be written to the disk.
The access log is written when the buffer is full or when the
interval expires. If the value is less than or equal to 0, then
the buffer is always written even if it is not full. This means
that each time the server is accessed, the log message is stored directly
to the file. The default value is 300.
- In the Format field, type the string value to specify the following properties
of the access log:
The information that is to be captured in the access log
The order in which the information is captured
The default value is as follows:
%client.name% %auth-user-name% %datetime% %request% %status% %response.length%
The following values are available for inclusion in the format string:
- %attribute.name%
Logs the value (by calling its toString method) of the request attribute with the given name
- %auth-user-name%
Name of authorized user
- %client.name%
Client host name
- %client.dns%
Client DNS
- %cookie.name%
The value of the request cookie with the given name
- %cookie.value%
The value of the first cookie found in the request
- %datetime%
System date
- %request%
Full HTTP request line
- %status%
Status
- %response.length%
Response content length
- %header.referer%
Referer header
- %header.user-agent%
User agent header
- %http-method%
HTTP method
- %http-uri%
HTTP URI
- %query-str%
HTTP query string
- %http-version%
HTTP protocol version
- %header.accept%
Accept header
- %header.date%
Date header
- %header.if-mod-since%
If-Modified-Since header
- %header.auth%
Authorization header
- %header.any%
Any valid HTTP header value defined in RFC 2616 (any is also a valid header value; it is specified as a variable here)
- %session.name%
The value of the session attribute with the name name, or NULL-SESSION-ATTRIBUTE-name if the named attribute does not exist in the session, or NULL-SESSION if no session exists
- %time-taken%
Time (in milliseconds) it took to service each request
- %vs.id%
Virtual server ID
- (Optional) In the Additional Properties section, specify additional properties.
For a description of available properties, see Properties Specific to the HTTP Service.
- To add a property, click the Add Property button. In the blank row
that appears, type the property name in the Name field, and type
the property value in the Value field.
- To modify a property, edit that property's Value field.
- To delete a property, select the checkbox to the left of the
Name field of the property that you are deleting, then click the Delete
Properties button.
- Click Save.
Tip - To return to the default settings, click the Load Defaults button, then click
Save.