EINBLIQ.IO

Akamai

Akamai DataStream 2 pushes log batches every 30 or 60 seconds to an S3 bucket we manage. A dedicated CMCD field records the player data.

Last checked

Values you receive from us

Value Used for
<BUCKET_NAME> Amazon S3 bucket
<FOLDER_PATH> Folder path inside the bucket
<AWS_REGION> Bucket region
<ACCESS_KEY_ID> Access key ID for the bucket
<SECRET_ACCESS_KEY> Secret access key

Before you start

  • Access to Akamai Control Center with permission to create DataStream streams and, if needed, to edit and activate properties.
  • The delivery properties you want to include. The dedicated CMCD field is available for Adaptive Media Delivery properties.

Create the stream

  1. In Akamai Control Center, open Analytics & monitor → DataStream and select Create stream.
  2. Enter a display name, for example EINBLIQ.IO, and choose the contract.
  3. Under Include properties, select the delivery properties that serve your streams.
  4. If Akamai offers a DataStream-managed stream for your properties, use it: it needs no changes in Property Manager. Otherwise continue with a Property Manager-dependent stream and complete the property steps below.

Select the data set fields

On the data set page, select these fields and choose JSON as the log format.

Field Content
CMCD CMCD values of the request
Request time Request timestamp
Request host Requested host
Request path Path of the requested object
Query string Query string of the request
Client IP IP address of the client
Edge IP IP address of the edge server
User-Agent Client user agent
HTTP status code Response status
Total bytes Response size
Turnaround time Time to serve the request
Transfer time Time to transfer the response
Time to first byte Time until the first response byte
Cache status Cache hit or miss
Referer HTTP Referer header
CP code Content provider code
Error code Akamai error code, if any

Deliver to the S3 bucket

Select Amazon S3 as the destination and enter the values from us:

Setting Value
Name EINBLIQ.IO
Bucket <BUCKET_NAME>
Folder path <FOLDER_PATH>
Region <AWS_REGION>
Access key ID <ACCESS_KEY_ID>
Secret access key <SECRET_ACCESS_KEY>
Push frequency 60 seconds

Select Validate & Save. Akamai checks the connection by writing a small Akamai_access_verification_<TIMESTAMP>.txt file into the bucket, so a file with that name in your first delivery is expected. Leave the remaining delivery options at their defaults, review the summary and activate the stream.

Enable the stream in Property Manager

Only Property Manager-dependent streams need these steps. In Content delivery → CDN → Properties, create a new version of each included property and add two behaviors to the rule that serves your media:

Log Request Details

Setting Value
Log Host Header On
Log Referer Header On
Log User-Agent Header On
Log Akamai Edge Server IP Address On
Log X-Forwarded-For Header On

DataStream

Setting Value
Stream version DataStream 2
Enable On
Stream name The stream you created
Sampling rate 100

Save and activate the property version on production. If the stream was created inactive, also activate it in DataStream.

Keep CMCD out of the cache key

Add the Cache Key Query Parameters behavior to the same rule:

Setting Value
Behavior Exclude only specified parameters
Parameters CMCD
Exact match Yes

CMCD in headers

Players that send CMCD as headers, such as Apple AVPlayer, are covered by the same CMCD field. No additional custom log field is needed.

Check the delivery

DataStream pushes the first batch within a few minutes of activation. Tell us when the stream is active; we confirm that log files arrive with all fields and that the CMCD field is populated for your players.