HP Cache Server Appliance Administrator Guide

172
Appendix D Configuration Files
CONFIG proxy.config.log2.xml_logs_config
When the proxy.config.log2.xml_logs_config variable is set to 1, Traffic Server refers to the XML-
based log configuration file specified in
proxy.config.log2.xml_config_file to determine the
extended custom logging specifications. This file,
logs_xml.config, serves as the default XML-based
configuration file.
For information about setting
records.config variables, refer to records.config‚ on page 182.
Format
You define all custom log files, formats, and filters in a single XML-based configuration file. This file contains
specifications of the following types:
•
LogFormat specifies the fields to be gathered from each protocol event access.
•
LogFilter specifies the filters that are used to include or exclude certain entries being logged based on
the value of a field within that entry.
•
LogObject specifies an object that contains a particular format, a local file name, filters, and potentially
multiple collation servers.
LogFormat
LogFormat specifications can consist of the following tags:
NOTE The
logs_xml.config file ignores extra white-space, blank lines, and all comments.
Field Allowed Inputs
<Name = "valid_format_name"/> (Required) Valid format names include any name except squid,
common, extended, or extended2, which are pre-defined formats.
There is no default for this tag.
<Format =
"valid_format_specification"/>
(Required) A valid format specification is a printf-style string
describing each log entry when formatted for ascii output. Use
'%<field>' as placeholders for valid HPhp field names. For more
information, refer to HP custom logging fields‚ on page 222.The
specified field can be of two types:
• Simple. For example, %<cqu>
• A field within a container, such as an HTTP header or an HP stat.
Fields of this type have the syntax: '%<{field}container>'.
<Interval =
"aggregate_interval_secs"/>
Use this tag when the format contains aggregate operators. The
value "aggregate_interval_secs" represents the number of seconds
between individual aggregate values being produced. The valid set
of aggregate operators are:
• COUNT
• SUM
• AVG
• FIRST
• LAST