View a markdown version of this page

Monitoring AWS Elemental MediaPackage with Amazon CloudWatch metrics - AWS Elemental MediaPackage v2
Live content metricsMediaPackage live dimensionsDynamic Multiview metrics

Monitoring AWS Elemental MediaPackage with Amazon CloudWatch metrics

You can monitor 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.

MediaPackage console

MediaPackage displays metrics throughout the console.

To view metrics using the MediaPackage 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 channel groups, go to the Channel groups page.

    • For metrics on all channels and origin endpoints associated with your channel group in the AWS Region, go to the channel group's details page.

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

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

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

CloudWatch console

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

To view metrics using the CloudWatch console

  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).

AWS CLI
To view metrics using the AWS CLI

At a command prompt, enter the following command:

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

MediaPackage live content metrics

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

Metric Description
ChannelMQCS Segment-level quality score as calculated by MediaPackage for the active input to this channel.

Units: Numeric

Valid statistics:

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

  • Maximum – Largest individual output request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual output request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage outputs over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and TrackType

  • No dimension
ChannelMQCSSequence Aggregated quality score for all segments in the sequence for the active input to this channel, as calculated by MediaPackage.

Units: Numeric

Valid statistics:

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

  • Maximum – Largest individual output request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual output request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage outputs over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • No dimension
EgressBytes

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

Units: Bytes

Valid statistics:

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

  • Maximum – Largest individual output request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual output request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage outputs over the configured interval.

Valid dimensions:

  • ChannelGroup

  • RequestType

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and RequestType

  • Combination of ChannelGroup, Channel, and OriginEndpoint

  • Combination of ChannelGroup, Channel, OriginEndpoint, and RequestType

  • Combination of ChannelGroup, Channel, OriginEndpoint, RequestType, and MultiviewLayout

  • MultiviewLayout

  • No dimension
EgressRequestCount

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

Units: Count

Valid statistics:

  • Sum – Total number of output requests that MediaPackage receives.

Valid dimensions:

  • ChannelGroup

  • RequestType

  • StatusCode

  • OuputType and StatusCode

  • Combination of ChannelGroup and RequestType

  • Combination of ChannelGroup and StatusCode

  • Combination of ChannelGroup, RequestType, and StatusCode

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and RequestType

  • Combination of ChannelGroup, Channel, and OriginEndpoint

  • Combination of ChannelGroup, Channel, and StatusCode

  • Combination of ChannelGroup, Channel, OriginEndpoint, and RequestType

  • Combination of ChannelGroup, Channel, RequestType, and StatusCode

  • Combination of ChannelGroup, Channel, OriginEndpoint, and StatusCode

  • Combination of ChannelGroup, Channel, OriginEndpoint, RequestType, and StatusCode

  • Combination of ChannelGroup, Channel, OriginEndpoint, RequestType, StatusCode, and MultiviewLayout

  • MultiviewLayout

  • No dimension
EgressResponseTime

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

Units: Milliseconds

Valid statistics:

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

  • Maximum – Longest amount of time (in milliseconds) that it takes MediaPackage to process an output request and provide a response.

  • Minimum – Shortest amount of time (in milliseconds) that it takes MediaPackage to process an output request and provide a response.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total amount of time that it takes MediaPackage to process output requests over the configured interval.

Valid dimensions:

  • ChannelGroup

  • RequestType

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and RequestType

  • Combination of ChannelGroup, Channel, and OriginEndpoint

  • Combination of ChannelGroup, Channel, OriginEndpoint, and RequestType

  • Combination of ChannelGroup, Channel, OriginEndpoint, RequestType, and MultiviewLayout

  • MultiviewLayout

  • No dimension
IngressBytes

Number of bytes of content that MediaPackage receives for each input request. If MediaPackage doesn't receive any requests for input in the specified interval, then no data is given.

Units: Bytes

Valid statistics:

  • Average – Average bytes (Sum/SampleCount) that MediaPackage receives over the configured interval.

  • Maximum – Largest individual input request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual input request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage receives over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and IngestEndpoint

  • No dimension
IngressMQCS Segment-level quality score as communicated by AWS Elemental MediaLive for this input.

Units: Numeric

Valid statistics:

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

  • Maximum – Largest individual output request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual output request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage outputs over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and IngestEndpoint

  • Combination of ChannelGroup, Channel, IngestEndpoint, and TrackType

  • No dimension
IngressMQCSSequence Aggregated quality scores for all segments in the sequence, as communicated by AWS Elemental MediaLive.

Units: Numeric

Valid statistics:

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

  • Maximum – Largest individual output request (in bytes) made to MediaPackage.

  • Minimum – Smallest individual output request (in bytes) made to MediaPackage.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total number of bytes that MediaPackage outputs over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and IngestEndpoint

  • No dimension
IngressRequestCount

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

Units: Count

Valid statistics:

  • Sum – Total number of input manifest requests that MediaPackage receives.

Valid dimensions:

  • ChannelGroup

  • StatusCode

  • Combination of ChannelGroup and StatusCode

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and IngestEndpoint

  • Combination of ChannelGroup, Channel, and StatusCode

  • Combination of ChannelGroup, Channel, IngestEndpoint, and StatusCode

  • No dimension
IngressResponseTime

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

Units: Milliseconds

Valid statistics:

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

  • Maximum – Longest amount of time (in milliseconds) that it takes MediaPackage to process an input request and provide a response.

  • Minimum – Shortest amount of time (in milliseconds) that it takes MediaPackage to process an input request and provide a response.

  • SampleCount – Number of requests that's used in the statistical calculation.

  • Sum – Total amount of time that it takes MediaPackage to process input requests over the configured interval.

Valid dimensions:

  • ChannelGroup

  • Combination of ChannelGroup and Channel

  • Combination of ChannelGroup, Channel, and IngestEndpoint

  • No dimension
Note

The MultiviewLayout dimension applies to Dynamic Multiview requests only. For a description of the MultiviewLayout and MultiviewSource dimensions, see MediaPackage live dimensions.

MediaPackage live 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.

CDNAuthorizationStatus

Value: Authorized or Unauthorized

Can be used in combination with ChannelGroup, Channel, OriginEndpoint, and CDNAuthorizationStatusDetails to show metrics for the CDN authorization requests to the specified endpoint.

CDNAuthorizationStatusDetails

Value when CDNAuthorizationStatus is Authorized: HeaderSecretMatched

Value when CDNAuthorizationStatus is Unauthorized: HeaderSecretMismatched, MissingCdnAuthHeaderAndConfiguration, MissingCdnAuthHeader, MissingCdnAuthConfiguration, MissingCdnIdentifierSecretArns, MissingSecretsRoleArn, SecretsManagerInvalidParameterError, SecretsManagerInternalServiceError, SecretsManagerThrottlingError, MediaPackageSecretsValidationError, or OtherErrors.

Can be used in combination with ChannelGroup, Channel, OriginEndpoint, and CDNAuthorizationStatus to show the CDN authorization request details for the specified endpoint.

Channel

Metrics are shown only for the specified channel.

Value: The auto-generated name 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's associated with the specified channel.

ChannelGroup

Metrics are shown only for the specified channel group.

Value: The name of the channel group.

Can be used alone or with other dimensions:

  • Alone to show metrics only for the specified channel group.

  • With the channel dimension to show metrics for the specified channel that's associated with the specified channel group.

  • With the statusCode dimension to show metrics for the specified status code ranges that are associated with the specified channel group.

IngestEndpoint

Metrics are shown only for the specified ingest endpoint on a channel.

Value: The auto-generated GUID of the ingest endpoint.

Can be used with the following dimensions:

  • With the channel dimension to show metrics for the specified ingest endpoint that's associated with the specified channel.

  • With the originEndpoint dimension to show metrics for the specified ingest endpoint that's associated with the specified endpoint.

MultiviewLayout

The tile layout requested for a Dynamic Multiview stream. Applies to Dynamic Multiview requests only.

Value: A layout short name, such as 4E or 3PL.

MediaPackage adds this dimension only when a request specifies a valid layout in the aws.multiview query parameter (for example, aws.multiview=layout:4E;sources:cam1,cam2,cam3,cam4). It isn't emitted for a request that omits aws.multiview, that includes aws.multiview without a layout: value, or that specifies a layout that isn't valid.

Added to the EgressRequestCount, EgressBytes, and EgressResponseTime metrics.

MultiviewSource

The name of a source channel that is used as a view in a Dynamic Multiview stream. Applies to Dynamic Multiview requests only.

Value: The name of a source channel named in the aws.multiview query parameter.

Added to the Dynamic Multiview metrics, such as MultiviewSourceRequestCount and MultiviewSourceSegmentMissing. For more information, see Dynamic Multiview metrics.

OriginEndpoint

Metrics are shown for the specified channel and endpoint combination.

Value: The auto-generated name of the endpoint.

Must be used with the channel dimension.

RequestType

Metrics are shown only for the specified request type.

Value: Either manifest or segment, signifying the type of content being filtered in the metric.

Can be used alone or with other dimensions:

  • Alone to show metrics only for the specified request type.

  • With the statusCode dimension to show metrics for the specified request type that's associated with the specified status code range.

  • With the originEndpoint dimension to show metrics for the specified request type that's associated with the specified origin endpoint.

StatusCode

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 output requests for the specified status range.

  • With the channel dimension to show output 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 output requests with a specific status code range on the specified endpoint that's associated with the specified channel.

TrackType

Metrics are shown for the specified track type.

Value: Video, Audio, or Subtitle.

Can be used alone or with other dimensions:

  • Alone to show quality scores for the specified track type.

  • With the channel dimension to show quality scores for all track types that are associated with the specified channel, with the specified track type.

  • With the channel and IngestEndpoint dimensions to show quality scores with a specific track type on the specified ingest endpoint that's associated with the specified channel.

Dynamic Multiview metrics

When you use Dynamic Multiview, MediaPackage publishes the following additional metrics to the AWS/MediaPackage namespace. These metrics apply to HLS and DASH endpoints. For more information about Dynamic Multiview, see Dynamic Multiview.

MediaPackage also adds the MultiviewLayout dimension to EgressRequestCount, EgressBytes, and EgressResponseTime. The MultiviewLayout and MultiviewSource dimensions are described in MediaPackage live dimensions.

Metric Description
MultiviewSourceRequestCount

The number of Dynamic Multiview segment requests that included a source channel as a view. Use this metric to see per-source demand. Only segment requests emit this metric; manifest requests don't.

Units: Count

Valid statistics:

  • Sum – Total number of source-view requests.

Valid dimensions:

  • Combination of ChannelGroup, Channel, MultiviewSource, and OriginEndpoint

  • Combination of ChannelGroup, Channel, and MultiviewSource

  • Combination of ChannelGroup and MultiviewSource

  • ChannelGroup

  • No dimension

Counting behavior

At the dimension levels that don't include MultiviewSource, the value counts view fetches rather than requests: a single multiview segment request contributes one data point for each source it names. These levels are expected to exceed EgressRequestCount for segment requests by roughly the average number of views per request.
MultiviewSourceSegmentMissing

The number of times a source channel's segment was missing for a Dynamic Multiview request. MediaPackage replaces the missing view with black video and still serves the response. MediaPackage emits this metric once for each distinct missing source in the request.

Units: Count

Valid statistics:

  • Sum – Total number of missing source segments.

Valid dimensions:

  • Combination of ChannelGroup, Channel, MultiviewSource, and OriginEndpoint

  • Combination of ChannelGroup, Channel, and MultiviewSource

  • Combination of ChannelGroup and MultiviewSource
MultiviewSegmentMissing

The aggregate count of missing source segments for Dynamic Multiview requests, without the MultiviewSource dimension. Use this metric to detect whether any view is missing anywhere in a channel group.

Units: Count

Valid statistics:

  • Sum – Total number of missing source segments.

Valid dimensions:

  • Combination of ChannelGroup, Channel, and OriginEndpoint

  • Combination of ChannelGroup and Channel

  • ChannelGroup
MultiviewSegmentIncompatible

The number of Dynamic Multiview segment requests that MediaPackage couldn't assemble because the participating sources' encoder configurations aren't compatible. MediaPackage returns a client error (4xx) for these requests. This metric is aggregate and has no source dimension.

Units: Count

Valid statistics:

  • Sum – Total number of segments that couldn't be assembled.

Valid dimensions:

  • Combination of ChannelGroup, Channel, and OriginEndpoint

  • Combination of ChannelGroup and Channel

  • ChannelGroup