AWS Elemental MediaPackage

Overview

Amazon Elemental MediaPackage is a video delivery service that prepares and protects video streams for distribution to a variety of playback devices. It ingests live or on-demand video, packages it into multiple adaptive bitrate formats, and integrates with AWS services for content protection, scaling, and monitoring.

Hydrolix ingests logs and metrics from MediaPackage using AWS CloudWatch and AWS Data Firehose as intermediaries. The instructions below provide details on how to configure MediaPackage, CloudWatch, and Firehose to deliver logs and metrics to a Hydrolix service.

The default Hydrolix for AWS MediaPackage dashboard uses ingress access logs, egress access logs, and metrics from MediaPackage. When adding MediaPackage as a data source in the Hydrolix web console, Hydrolix creates three Firehose streams as the methods for transporting all three MediaPackage data sources to the Hydrolix service.

Before you begin

Send MediaPackage ingress and egress access logs to Hydrolix

This section covers the configuration of CloudWatch to send the ingress and egress logs to a Firehose stream.

1. Enable MediaPackage access logging to CloudWatch using the instructions in Access logging.

2. Create a CloudWatch Logs subscription to send MediaPackage ingress access logs to Hydrolix.

   1. In the CloudWatch console, open Log groups under Logs.
   2. Select the log group for MediaPackage ingress access logs. The log group name is
      /aws/MediaPackage/IngressAccessLogs by default or the custom name configured when enabling access logging.
   3. From the Actions menu, choose Subscription filters > Create Amazon Data Firehose subscription filter.
   4. On the setup page, select the Data Firehose stream created for MediaPackage ingress logs. If using Hydrolix for AWS, the stream name begins with:
      hdx-logs-mediapackage-ingress...
   5. Create an IAM role that grants CloudWatch Logs permission to write to the Firehose delivery stream.
      • Use steps 8–11 of example 3 for CLI-based instructions or follow the IAM console guide.
   6. Set the Log format to JSON.
   7. Select Start streaming to create the subscription and begin forwarding logs to Hydrolix.

3. Repeat step 2 for MediaPackage egress access logs.

   1. The CloudWatch log group name is /aws/MediaPackage/EgressAccessLogs by default or the custom name configured when enabling access logging.
   2. Set the destination to the Data Firehose stream created for MediaPackage egress logs. If using Hydrolix for AWS, the stream name begins with:
      hdx-logs-mediapackage-egress...

Once both subscriptions are active, MediaPackage ingress and egress access logs stream continuously to the Hydrolix service.

📘

Limit log retention to reduce costs

To reduce CloudWatch storage costs, consider lowering the retention period for these log groups if they're no longer needed in CloudWatch.

Send MediaPackage metrics to Hydrolix

MediaPackage automatically publishes metrics to CloudWatch. To export these metrics from CloudWatch to Hydrolix:

1. In the CloudWatch console, open Streams under Metrics.
2. Select Create metric stream.
3. On the setup page, choose Custom setup with Firehose.

4. Set the destination to the Data Firehose stream created for MediaPackage metrics. If using Hydrolix for AWS, the stream name begins with:
   hdx-logs-mediapackage-metrics...
5. In Change output format (optional), select JSON.

6. (Optional) Overwrite the default name with a Custom metric stream name.
7. Select Create metric stream.

After creation, MediaPackage metrics automatically stream from CloudWatch to the Hydrolix service.

Additional considerations

Cross-region data transfer costs

If AWS Elemental MediaPackage, the Firehose stream, or Hydrolix cluster run in different regions, you may incur additional data transfer costs. All data streaming service costs appear on your AWS bill and aren't included in your Hydrolix subscription.

Confirm which AWS region the Hydrolix cluster is running in on the Product Info page of the Hydrolix web console.

Use the AWS pricing calculator and the Amazon Data Firehose pricing to estimate costs.

Deactivating

You can deprovision the Firehose service provisioned by Hydrolix by selecting de-activate in the Hydrolix web console.