Custom Log File Format

The format in which data generated for CDN activity over the HTTP protocol is stored in a raw log file is determined by the settings defined in the Log Format Settings section of the Raw Log Settings page. These log file formatting settings allow you to:

Typically, data mining tools require a consistent log format when analyzing data over a period of time. If you plan on using a data mining application on your log data, then it is key to keep changes to your log file to a minimum. Please contact your CDN account manager before making any changes.

Base Log File Format

The base log file format determines the basic format that will be used to record HTTP activity in a raw log file. Once you have selected a base log file format, you can adjust other log file format settings (e.g., date/time format) to achieve your optimal log format. When choosing a base log file format, you will need to choose between the following two log file formats:

Key information about the combined log file format:

Date/Time Format

A CDN server records the date and time at which it processed the request for an asset in a log field called "timestamp." The format in which data is recorded in this field can be customized in one of the following ways:

Custom Field

By default, a custom field called "x-ec_custom-1" is included in your raw log files. This field will report "-" unless Rules Engine has been configured to log request/response header data. This type of configuration requires the use of the Custom Log Field 1 feature.

Changing the name of the custom field will not affect whether HTTP request and/or response headers are logged.

Raw log files that use the combined log format will not indicate the name of the custom log field.

When configuring the Custom Log Field 1 feature, specify the name of each request and response header that will be logged in that field. A header can be specified using the following syntax:

Header Type Syntax Example

Request

%{requestheader}i

%{Accept-Encoding}i

Response

%{responseheader}o

%{Content-Type}o

Key information about logging header data:

Content Access Point Logging

A content access point is a relative path that starts directly after the CDN hostname (e.g., /800001/MyOrigin or /000001). By default, this information is reported in the cs-uri-stem field in the log file. The cs-uri-stem field identifies the asset that was requested by the client. The Remove the content access point from the URL option determines whether this information is reported in that field.

Sample cs-uri-stem field values are provided below.