Skip to main content

Request Log

Description

Defines and enables request logging.

Log Format

The following directives can be added to the format property to customize the log format:

Directive Description
%a Client IP Address.
%A Local IP Address.
%b Bytes in the response excluding HTTP headers in CLF format: '-' instead of 0 when no bytes are returned.
%B Bytes in the response excluding HTTP headers.
%{attribute}C Attribute from the credential named 'attribute'.
%{cookie}e Contents of the Cookie 'cookie' in the request.
%{cookie}E Contents of the Cookie 'cookie' in the response.
%d Transaction identifier, or session sequence number.
%F Time taken to serve the request in microseconds.
%h Client host.
%H Request protocol.
%{header}i Contents of the Header 'header' in the request.
%j The name of the resource server servicing the request.
%J The length of time, in microseconds, that the resource server server spent processing the request.
This will include the time that it took to send the request to the server,
the length of time that it took the server to process the request,
and the length of time that it took to read and process the response header.
%l Client logname (RFC 1314) (default -).
%m Request method (i.e. GET, POST, HEAD).
%{header}o Contents of the Header 'header' in the response.
%M The time, in Common Log Format, at which the request was received with millisecond precision.
%p Port over which the request was received.
%q The decoded query string (prepended with '?' or empty).
%Q The raw query string (prepended with '?' or empty).
%r First line of the request with decoded URL.
%R First line of the request with decoded URL including HTTP://HOSTNAME.
%s Response status.
%S The hostname of the backend server which serviced this request.
%t Time in Common Log Format format.
%{format}t The time in the given format.
%T Time taken to serve the request in seconds, or part thereof.
%u Remote user.
%U The URL requested.
%v Canonical ServerName of the server servicing the request.
%z The decoded path string.
%Z The raw path string.

Properties

The following table(s) describe the configuration properties for this component:

Name Type Constraints Description
file FILE Object
format string Default:"%h %u %t %r %s %b" The format of the events written to the request log. See the Log Format table above for the available directives.

FILE Object

By default the request log events will be written to the console of the container. By setting the 'file' configuration the request log events can instead be written to a local file.

Name Type Constraints Description
max_file_size number Minimum:1
Maximum:unlimited
The maximum size (in MB) that the file can reach before it is rolled over.
file_name string The name of the generated log file. If the file name is supplied without any path information the file will be written to the '/var/iag/logs' directory. If the file name contains path information the hosting directory must be created and available before the container is started.
max_rollover_files number Minimum:1
Maximum:unlimited
Default:unlimited
The maximum number of rollover files to be kept on disk. When the number of rollover log files reaches the specified threshold, the oldest log file is deleted.
compress boolean Values: true,false
Default:true
A boolean which indicates whether rolled over log files should be automatically compressed to conserve disk space.

Example

 logging:
         request_log:
             file:
                 file_name: request.log
             format: "%t %a %R"