Enable DataStream in a property

To start collecting logs for properties in a stream, you need to enable the DataStream behavior in each property that is part of any stream. You can't receive logs from properties with disabled DataStream behavior even if they're part of active data streams.

When enabling the DataStream behavior, you can configure it to:
  • Collect logs from the stream that monitors this property.
  • Specify the sample of data for this property that the stream collects and sends to your destination.

Apart from enabling the behavior in the default rule to apply it to all requests, you can enable it in a custom rule to capture data for specific hostnames, paths, status codes, and other requests matching your criteria. See Rules and matches in Property Manager.

If you chose more than one property for a stream, you need to enable the DataStream behavior in each of them.

Before you begin

Check if DataStream has been added to your contract, and that a content provider (CP) code is available for use with DataStream. For assistance, contact your account representative.

If you want to enable DataStream through the Property Manager API, make sure that you have set at least the READ access level to the API service called Datastream. The API client should have the Datastream Config API permission set.

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. In the default rule, click Add Behavior, and select DataStream.
  6. Click Insert Behavior.
    The DataStream behavior appears in your rule.
  7. In Stream version, select DataStream 2.
  8. In the DataStream 2 section:
    1. Set the Enable switch to On.
    2. In DataStream names, enter the name of the active streams associated with the property.
      Tip: You can find the names of all streams that monitor this property by entering the property name in the search box of the DataStream application.
    3. In Sampling rate, specify the sample percentage of data for this property that you want the stream to send to your destination.
  9. Click Save.
  10. Enable logging custom data set parameters in the Log Request Details behavior. See Enable logging custom parameters.
    Do this step only for these parameters:
    • User-Agent
    • Accept-Language
    • Referer
    • Host
    • Cookie
    • Custom field
  11. On the Activate tab, click Activate v# on Production.

Next steps

If you deployed any of the streams monitoring this property in an inactive state, remember to activate them in the DataStream application. Only active streams can collect logs about your properties. See Activate or deactivate a stream.