Enable the DataStream behavior

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 this behavior disabled even if they're part of active streams.

For streams linked to properties that belongs to a Cloud Wrapper product (e. g. Ion Premier), you can skip this procedure, but you need to enable DataStream (ID: 6105) in the MultiCDN section of Cloud Wrapper and reach out to your Akamai account team to enable the data sets you want to monitor.

When enabling the DataStream behavior, you can configure it to:

  • Collect logs from the stream that monitors a property of your choice.

  • 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 ​Akamai Control Center​ account with access to the applicable product.

  2. Access Property Manager configuration associated with the selected ​Akamai 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:

    • Set the Enable switch to On.

    • In DataStream names, enter the name of the active streams associated with the property.

    • Optionally, you can enable the Collect midgress traffic option to collect traffic data from within the Akamai platform, such as between two edge servers. If logging midgress traffic is not enabled on your contract, contact the Akamai support team.


Using the search box

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.

  • In Sampling rate, specify the sample percentage of data for this property that you want the stream to send to your destination.
  1. Click Save.

  2. Enable logging custom data set parameters in the Log Request Details behavior. See Log custom parameters.

Do this step only if you want to monitor these Data set parameters:

  • User-Agent

  • Accept-Language

  • X-Forwarded-For

  • Referer

  • Host

  • Cookie

  • Custom field

  1. 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.