AWS Elemental MediaPackage
User Guide

Monitoring AWS Elemental MediaPackage with Amazon CloudWatch

You can monitor AWS Elemental MediaPackage using CloudWatch, which collects raw data and processes it into readable, near real-time metrics. These statistics are kept for 15 months, so that you can access historical information and gain a better perspective on how your web application or service is performing. You can also set alarms that watch for certain thresholds, and send notifications or take actions when those thresholds are met. For more information, see the Amazon CloudWatch User Guide.

To view metrics using the AWS Elemental MediaPackage console

AWS Elemental MediaPackage displays metrics throughout the console.

  1. Open the MediaPackage console at https://console.aws.amazon.com/mediapackage/.

  2. Navigate to the appropriate page to view metrics:

    • For metrics on all channels and endpoints in the region, go to the Channels page.

    • For metrics on a specific channel and all of its endpoints, go to the channel's details page.

    • For metrics on a specific endpoint and its channel, go to the endpoint's details page.

  3. (Optional) To refine the metrics view, choose Open in CloudWatch.

To view metrics using the CloudWatch console

Metrics are grouped first by the service namespace, and then by the various dimension combinations within each namespace.

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. Under All metrics, choose the AWS/MediaPackage namespace.

  4. Choose the metric dimension to view the metrics (for example, choose channel to view metrics per channel).

To view metrics using the AWS CLI

At a command prompt, use the following command:

aws cloudwatch list-metrics --namespace "AWS/MediaPackage"

AWS Elemental MediaPackage CloudWatch Metrics

The AWS/MediaPackage namespace includes the following metrics. AWS Elemental MediaPackage publishes metrics to CloudWatch every minute, if not sooner.

Metric Description
ActiveInput

Indicates if an input has been used as the source for an endpoint in AWS Elemental MediaPackage (it has been active). A value of 1 indicates that the input was active, and a 0 (zero) indicates that it wasn't.

Units: None

Valid dimension:

  • Combination of Channel and OriginEndpoint

EgressBytes

Number of bytes that AWS Elemental MediaPackage successfully outputs for each request. If MediaPackage doesn't receive any requests for egress in the specified interval, then no data is given.

Units: Bytes

Valid statistics:

  • Average – average bytes (Sum/SampleCount) that AWS Elemental MediaPackage outputs over the configured interval.

  • Maximum – largest individual output request (in bytes) made to AWS Elemental MediaPackage.

  • Minimum – smallest individual output request (in bytes) made to AWS Elemental MediaPackage.

  • SampleCount – number of requests that is used in the statistical calculation.

  • Sum – total number of bytes that AWS Elemental MediaPackage outputs over the configured interval.

Valid dimensions:

  • Channel

  • Combination of Channel and OriginEndpoint

  • No dimension

EgressRequestCount

Number of content requests that AWS Elemental MediaPackage receives. If MediaPackage doesn't receive any requests for egress in the specified interval, then no data is given.

Units: Count

Valid statistics:

  • Sum – total number of egress requests that AWS Elemental MediaPackage receives.

Valid dimensions:

  • Channel

  • Combination of Channel and OriginEndpoint

  • StatusCodeRange

  • Combination of Channel and StatusCodeRange

  • Combination of Channel, OriginEndpoint, and StatusCodeRange

  • No dimension

EgressResponseTime

The time that it takes AWS Elemental MediaPackage to process each egress request. If MediaPackage doesn't receive any requests for egress in the specified interval, then no data is given.

Units: Milliseconds

Valid statistics:

  • Average – average amount of time (Sum/SampleCount) that it takes AWS Elemental MediaPackage to process egress requests over the configured interval.

  • Maximum – longest amount of time (in milliseconds) that it takes AWS Elemental MediaPackage to process an egress request and provide a response.

  • Minimum – shortest amount of time (in milliseconds) that it takes AWS Elemental MediaPackage to process an egress request and provide a response.

  • SampleCount – number of requests that is used in the statistical calculation.

  • Sum – total amount of time that it takes AWS Elemental MediaPackage to process egress requests over the configured interval.

Valid dimensions:

  • Channel

  • Combination of Channel and OriginEndpoint

IngressBytes

Number of bytes that AWS Elemental MediaPackage ingests for each request. If MediaPackage doesn't receive any requests for egress in the specified interval, then no data is given.

Units: Bytes

Valid statistics:

  • Average – average bytes (Sum/SampleCount) that AWS Elemental MediaPackage ingests over the configured interval.

  • Maximum – largest individual ingest request (in bytes) made to AWS Elemental MediaPackage.

  • Minimum – smallest individual ingest request (in bytes) made to AWS Elemental MediaPackage.

  • SampleCount – number of requests that is used in the statistical calculation.

  • Sum – total number of bytes that AWS Elemental MediaPackage ingests over the configured interval.

Valid dimensions:

  • Channel

  • Combination of Channel and OriginEndpoint

  • No dimension

IngressResponseTime

The time that it takes AWS Elemental MediaPackage to process each ingest request. If MediaPackage doesn't receive any requests for egress in the specified interval, then no data is given.

Units: Milliseconds

Valid statistics:

  • Average – average amount of time (Sum/SampleCount) that it takes AWS Elemental MediaPackage to process ingest requests over the configured interval.

  • Maximum – longest amount of time (in milliseconds) that it takes AWS Elemental MediaPackage to process an ingest request and provide a response.

  • Minimum – shortest amount of time (in milliseconds) that it takes AWS Elemental MediaPackage to process an ingest request and provide a response.

  • SampleCount – number of requests that is used in the statistical calculation.

  • Sum – total amount of time that it takes AWS Elemental MediaPackage to process ingest requests over the configured interval.

Valid dimensions:

  • Channel

  • Combination of Channel and OriginEndpoint

  • No dimension

AWS Elemental MediaPackage CloudWatch Dimensions

You can filter the AWS/MediaPackage data using the following dimensions.

Dimension Description

No Dimension

Metrics are aggregated and shown for all channels, endpoints, or status codes.

Channel

Metrics are shown only for the specified channel.

Value: The auto-generated GUID of the channel.

Can be used alone or with other dimensions:

  • Alone to show metrics for only the specified channel.

  • With the originEndpoint dimension to show metrics for the specified endpoint that is associated with the specified channel.

OriginEndpoint

Metrics are shown for the specified channel and endpoint combination.

Value: The autogenerated GUID of the endpoint.

Must be used in conjunction with the channel dimension.

StatusCodeRange

Metrics are shown for the specified status code range.

Value: 2xx, 3xx, 4xx, or 5xx.

Can be used alone or with other dimensions:

  • Alone to show all egress requests for the specified status range.

  • With the channel dimension to show egress requests for all endpoints that are associated with the specified channel, with the specified status code range.

  • With the channel and originEndpoint dimensions to show egress requests with a specific status code range on the specified endpoint that is associated with the specified channel.