Enable logging custom parameters

You can use the Log Request Details behavior in your property configuration to include specific content in log lines generated by edge servers.

In this behavior, you can control:
  • whether to log the value you set for the custom log field
  • what cookie information is logged
  • which of the following headers are part of your logs:
    • Host
    • Accept-Language
    • User-Agent
    • Referer

Before you begin

Deactivate a stream associated with the property configuration that you want to update. See Activate or deactivate a stream in the DataStream application.

How to

  1. Use the top-right menu in the header to select the appropriate Control Center account (one with access to the applicable product).
  2. Access Property Manager configurations associated with the selected Control Center account. Go to > CDN > Properties (or just enter Properties in the search box).
    The Property Groups page opens.
  3. Click the Property Name link for your property.
  4. On the Property Details page, click the Version of your configuration that you want to access in Manage Versions and Activations.
    The Property Manager Editor appears.
  5. If your property is already active, click Edit New Version to introduce your changes.
  6. Select or create the rule where you want to enable the Logs Request Details behavior:
    • To apply the behavior to all requests, add it in the Default Rule.
    • To apply the behavior to specific hostnames in the property or specific requests, add it in a custom rule.
  7. In the rule, add or edit the Log Request Details behavior.
  8. Enable the headers and specify the custom filed that you want include in your data streams.
    1. Log Host Header. Specifies the domain name of the server for virtual hosting, and optionally the TCP port number on which the server is listening.
    2. Log Referer Header. Contains the address of the previous web page from which a link to the currently requested page was followed. The Referer header allows servers to identify from where people are visiting.
    3. Log User-Agent Header. Contains a characteristic string that allows the network protocol peers to identify the application type, operating system, software vendor, or software version of the requesting client.
    4. Log Accept-Language Header. Advertises which languages the client is able to understand, and which locale variant is preferred.
    5. In Cookie Mode, choose which cookies you want to log.
    • Select Don't log any cookies to disable logging any cookies in your data stream.
    • Select Log all cookies to enable logging all cookies in your data stream
    • Select Log some cookies to specify which cookies to log in your data stream. This option reveals the Cookies field where you can specify the cookie format that you can capture, either sessionid or user_local. You can also click the field and manually input the name of an applicable cookie format you want to use.
    1. Switch Include Custom Log Field to On. This option reveals the Custom Log Field where you can specify an additional data field to append to each log line.
      This filed supports variables. See Variable Support. Note that the system truncates the value from the Custom Log Field to no more than 40 bytes of data.

Next steps

Once you’ve made your changes, activate your property in the production environment.