Skip to Content
Mux Docs: Home
Welcome to the new Mux Docs.
The old version is still available here

Export video views to an Amazon Kinesis data stream

Learn how to send video view data from Mux to Amazon Kinesis Data Streams.

Streaming Exports are only available on Mux Data Media plans.

In order to stream Mux Data video views to Amazon Kinesis Data Streams, you’ll need to set up a data stream in your AWS account. You should use the us-east-1 region when creating the data stream. This guide covers the high-level steps required for setup.

1Add a new streaming export

To add a new streaming export, go to Settings > Streaming Exports in your Mux dashboard. From that tab, click New streaming export to open the configuration modal.

Select the environment you want to send views from, and select Amazon Kinesis Data Streams as the service.

2Set up a data stream in Amazon Kinesis

You'll need to complete the following setup in your AWS account before you can create a new streaming export in Mux:

  1. Create an Amazon Kinesis data stream in the us-east-1 region.
  2. Create an IAM role for Mux’s AWS account. To create the IAM role, you'll need Mux's AWS account ID and an external ID, which are shown in the configuration modal. See this AWS user guide for more information about how the external ID is used.
  3. Provide the IAM role you created with write access to your data stream. Here’s an example of an IAM policy that grants the necessary permissions (replace the resource with your data stream ARN):
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
          "kinesis:ListShards",
          "kinesis:PutRecord",
          "kinesis:PutRecords"
      ],
      "Resource": [
        "arn:aws:kinesis:{region}:{account-id}:stream/{stream-name}"
      ]
    }
  ]
}

3Finish setup in Mux

In the configuration modal, provide the data stream ARN and IAM role ARN. Make sure the values you provide match these formats:

  • Data stream ARN
    arn:aws:kinesis:{region}:{account-id}:stream/{data-stream-name}
  • IAM role ARN
    arn:aws:iam::{account-id}:role/{role-name}

Click Enable export, and your streaming export will be activated immediately. We will start streaming views as soon as they're completed.

Process video view messages

With your export set up, you can begin consuming incoming messages. For more information on the message format and processing video views, see the main Export raw video view data guide.

Was this page helpful?