Amazon CloudFront Log Collector

Our Amazon CloudFront Log Collector provides an easy way to stream your Amazon CloudFront logs to Datazoom via Kinesis Firehose. Log data can be correlated with player data to provide insight into CDN performance as it relates to video playback performance.

Prerequisites

1. Kinesis Data Streams configuration.

2. An existing Amazon CloudFront distribution configured to send logs to the Kinesis Data Streams setup above. See the Amazon documentation, Creating and using real-time log configurations to configure/enable real-time logging for your Amazon CloudFront distribution. Please be sure to select all available log fields in the configuration options.

Create a Datazoom CloudFront Collector

Review How to add a CDN Collector to start the process.

Give your Collector a name, save it then re-open it. Click the “REVEAL API KEY” and copy your key. You’ll need it in the CloudFront configuration steps below.

Configuring the Kinesis Firehose HTTP endpoint

Follow the steps provided by Amazon to setup a Kinesis Data Firehose Delivery Stream.

1. Give the configuration a name.
   Select “Kinesis Data Stream” as the source and select the Kinesis stream from the popup that you have available from the Prerequisites section above.

   

2. Leave the default items selected on the “Process Records” screen

   

3. Select “HTTP Endpoint” as the destination

   

4. Set the following items:
   HTTP Endpoint URL: https://streaming.datazoom.io/cdn/v1/logs
   Access key: API key copied from the Collector setup above

   

5. Set an S3 bucket as a destination for Failed Data

   

6. Leave the remaining items at their default settings

   

7. Review your settings

   

In order to align Amazon CloudFront logs with player content requests, you will need to configure your video player to send the Datazoom session_id as a query parameter with content requests.

Example:

        videojs.Hls.xhr.beforeRequest = function(options) {
            var myparam = '?datazoom_id=' + (session_id);
            options.uri = options.uri + myparam;
            return options;
        }