To Configure the HTTP Service Access Log

The Enterprise Server uses the HTTP Service Access Log to enable and configure rotation for the access logs for the virtual servers. These logs are located in the domain_root_dir/domain_dir/logs/access directory and are named as follows: virtual_server_name_access_log.yyyyMMdd-HHhmmmsss.txt

  1. In the navigation tree, expand the Configuration node.
  2. Under the Configuration node, select the HTTP Service node.

    The HTTP Service page opens.

  3. 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.

  4. Select the Rotation Enabled checkbox to enable log file rotation.
  5. From the Rotation Policy drop-down list, select a rotation policy.

    The only available rotation policy is time.

  6. 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 15 minutes.

    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.

  7. 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.

  8. In the Access Log Buffer Size field, type the size, in bytes, of the access log buffer.

    A value of less than or equal to zero disables access log buffering. The default value is 4096.

  9. In the Access Log 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 zero, 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 0.

  10. In the Format field, type the string value to specify the following properties of the access log:

    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:

    %client.name%

    Client host name

    %client.dns%

    Client DNS

    %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)

    %auth-user-name%

    Name of authorized user

    %cookie.value%

    Value of a cookie

    %vs.id%

    Virtual server ID

  11. (Optional) In the Additional Properties section, specify additional properties.

    The Enterprise Server does not define any additional properties for the HTTP Service.

  12. Click Save.