Menu
AWS Elemental MediaTailor
User Guide

Monitoring AWS Elemental MediaTailor with Amazon CloudWatch

You can monitor AWS Elemental MediaTailor 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 CloudWatch console

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

  1. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. In the navigation pane, choose Metrics.

  3. Under All metrics, choose the MediaTailor namespace.

  4. Select the metric dimension to view the metrics (for example, originID).

To view metrics using the AWS CLI

At a command prompt, use the following command.

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

AWS Elemental MediaTailor CloudWatch Metrics

The MediaTailor namespace includes the following metrics. These metrics are published by default to your account.

Metric Description
AdDecisionServer.Ads

Count of ads included in ad decision server (ADS) responses for the time period that you specified.

AdDecisionServer.Duration

Total duration (in milliseconds) of all ads that AWS Elemental MediaTailor received from the ad decision server (ADS) in the time period that you specified.
AdDecisionServer.Errors

Number of non-HTTP 200 status code responses or empty responses that AWS Elemental MediaTailor received from the ad decision server (ADS) in the time period that you specified.

AdDecisionServer.FillRate The simple average of the rate that responses from the ad decision server (ADS) were filled. The rate is defined as (AdDecisionServer.Duration)/(Avails.Duration). This number can be higher than 100%.

Example 1

If your ADS returns 120 seconds of ads and the ad break is 180 seconds, then the AdDecisionServer.FillRate is 67% (120/180). The best Avails.FillRate that we can attain for this ad break is therefore 67%.

Example 2

If your ADS returns 120 seconds of ads and the ad break is 90 seconds, then the AdDecisionServer.FillRate is 133% (120/90). The best Avails.FillRate that we can attain for this ad break is therefore 100%.

For information about the simple average, see Simple Average Explanation.

AdNotReady

Number of times that the ADS pointed at an ad that wasn't yet transcoded by the internal transcoder service.

A high incidence of this metric might contribute to a low overall Avails.FillRate.

Avails.Duration Total duration (in milliseconds) of all ad breaks that AWS Elemental MediaTailor encountered in the time period that you specified.
Avails.FilledDuration Total duration (in milliseconds) of all ad breaks that AWS Elemental MediaTailor filled in the time period that you specified.

This metric is calculated as (number of concurrent sessions) x (ad break duration filled).

Avails.FillRate

The simple average of the rate that ad breaks were filled. The rate is defined as (Avails.FilledDuration) / (Avails.Duration).

For information about the simple average, see Simple Average Explanation.

Example

If your ADS returns 90 seconds of ads and the ad break is 120 seconds, then the AdDecisionServer.FillRate is 75% (90/120).

If the Avails.FillRate is low, look at the AdDecisionServer.FillRate compared to the Avails.FillRate. If the AdDecisionServer.FillRate is low (50% or lower) and Avails.FillRate is also low, your ADS might be returning only enough ads for half of a typical break duration, so the maximum Avails.FillRate that we can attain is bounded by 50%.

GetManifest.Errors

Number of errors received when AWS Elemental MediaTailor is generating manifests.

Origin.Errors

Number of non-HTTP 200 status code responses that AWS Elemental MediaTailor received from the origin server in the time period that you specified.

Simple Average Explanation

Simple average means that the durations aren't weighted in the FillRate calculation. The FillRate for each ad break is simply averaged together. This gives an overall view of how successful ad insertions are across all of your ad breaks, independent of how long each ad break is. To get a weighted average, calculate the sum of your total duration and divide by the total filled duration in a time period.

Example

You have the following two ad breaks:

  • Ad break A: 90 seconds total duration, 45 seconds filled (50% filled)

  • Ad break B: 120 seconds total duration, 120 seconds filled (100% filled)

The FillRate metric reported is 75% ( [50% + 100%] / 2).

The actual weighted average FillRate is 79% ( [45 seconds filled + 120 seconds filled] / [90 total seconds + 120 total seconds] ).

AWS Elemental MediaTailor CloudWatch Dimensions

You can filter the AWS Elemental MediaTailor data using the following dimensions.

Dimension Description

Configuration Name

Indicates the configuration that the metric belongs to.