AWS Elemental MediaTailor

Overview

AWS Elemental MediaTailor is a personalization and monetization service that allows scalable server-side ad insertion.

Enable this integration to see all your Elemental MediaTailor metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that MediaTailor is enabled under the Metric Collection tab.
  2. Install the Datadog - AWS Elemental MediaTailor integration.

Log collection

Enable logging

Configure AWS Elemental MediaTailor to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_mediatailor is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS Elemental MediaTailor logs in the AWS console:

Data Collected

Metrics

aws.mediatailor.4xx_error_count
(count)
The number of 4xx errors.
Shown as error
aws.mediatailor.5xx_error_count
(count)
The number of 5xx errors.
Shown as error
aws.mediatailor.ad_decision_server_ads
(count)
The count of ads included in ad decision server (ADS) responses for the time period that you specified.
aws.mediatailor.ad_decision_server_duration
(gauge)
The total duration in milliseconds of all ads that MediaTailor received from the ADS in the time period that you specified.
Shown as millisecond
aws.mediatailor.ad_decision_server_errors
(count)
The number of non-HTTP 200 status code responses empty responses and timed-out responses that MediaTailor received from the ADS in the time period that you specified.
Shown as error
aws.mediatailor.ad_decision_server_fill_rate
(gauge)
The simple average of the rates at which the responses from the ADS fill the times available for the corresponding ad avails.
Shown as percent
aws.mediatailor.ad_decision_server_latency
(gauge)
The response time in milliseconds for requests made by MediaTailor to the ADS.
Shown as millisecond
aws.mediatailor.ad_decision_server_timeouts
(count)
The number of timed-out requests to the ADS in the time period that you specified.
aws.mediatailor.ad_not_ready
(count)
The number of times that the ADS pointed at an ad that wasn't yet transcoded by the internal transcoder service.
aws.mediatailor.ads_billed
(count)
The number of ads for which MediaTailor bills customers based on insertion.
aws.mediatailor.avail_duration
(gauge)
The total duration in milliseconds of all ad avails that MediaTailor encountered in the time period that you specified.
Shown as millisecond
aws.mediatailor.avail_fill_rate
(gauge)
The simple average of the rate at which MediaTailor filled ad avails.
Shown as percent
aws.mediatailor.avail_filled_duration
(gauge)
The total duration in milliseconds of all ad avails that MediaTailor filled in the time period that you specified.
Shown as millisecond
aws.mediatailor.avail_impression
(count)
The number of ads with impression tracking events that MediaTailor sees during server-side beaconing (not the number of impressions).
aws.mediatailor.avail_observed_duration
(gauge)
The observed total number of milliseconds of ad avails that occurred within the CloudWatch time period. Avail.ObservedDuration is emitted at the end of the ad avail, and is based on the duration of the segments reported in the manifest during the ad avail.
Shown as millisecond
aws.mediatailor.avail_observed_fill_rate
(gauge)
The observed simple average of the rates at which MediaTailor filled individual ad avails within the CloudWatch time period.
Shown as percent
aws.mediatailor.avail_observed_filled_duration
(gauge)
The observed number of milliseconds of ad avail time that MediaTailor filled with ads within the CloudWatch time period.
Shown as millisecond
aws.mediatailor.avail_observed_slate_duration
(gauge)
The observed total number of milliseconds of slate that was inserted within the CloudWatch period.
Shown as millisecond
aws.mediatailor.get_manifest_errors
(count)
The number of errors received when MediaTailor is generating manifests.
Shown as error
aws.mediatailor.get_manifest_latency
(gauge)
The MediaTailor response time in milliseconds for the request to generate manifests.
Shown as millisecond
aws.mediatailor.origin_errors
(count)
The number of non-HTTP 200 status code responses and timed-out responses that MediaTailor received from the origin server in the time period that you specified.
Shown as error
aws.mediatailor.origin_latency
(gauge)
The response time for requests made by MediaTailor to your content origin server.
Shown as millisecond
aws.mediatailor.origin_manifest_file_size_bytes
(gauge)
The file size of the origin manifest in bytes for both HLS and DASH. Typically this metric is used in conjunction with Origin.ManifestFileSizeTooLarge.
Shown as byte
aws.mediatailor.origin_manifest_file_size_too_large
(count)
The number of responses from the origin that have a manifest size larger than the configured amount. Typically this metric is used in conjunction with Origin.ManifestFileSizeBytes.
aws.mediatailor.origin_timeouts
(count)
The number of timed-out requests to the origin server in the time period that you specified.
aws.mediatailor.request_count
(count)
The total number of requests. The transaction count depends largely on how often players request updated manifests and the number of players. Each player request counts as a transaction.
Shown as request
aws.mediatailor.requests
(count)
The number of concurrent transactions per second across all request types. The transaction count depends mainly on the number of players and how often the players request updated manifests. Each player request counts as a transaction.
Shown as request
aws.mediatailor.skipped_reason_duration_exceeded
(count)
The number of ads that were not inserted into an avail because the ADS returned a duration of ads that was greater than the specified avail duration. A high value for this metric might contribute to a discrepancy between the Avail.Ads and AdDecisionServer.Ads metric.
aws.mediatailor.skipped_reason_early_cue_in
(count)
The number of ads skipped due to an early CUE-IN.
aws.mediatailor.skipped_reason_internal_error
(count)
The number of ads skipped due to a MediaTailor internal error.
aws.mediatailor.skipped_reason_new_creative
(count)
The number of ads that were not inserted into an avail because it was the first time the asset had been requested by a client. A high value for this metric might temporarily contribute to a low overall Avail.FillRate, until assets can be successfully transcoded.
aws.mediatailor.skipped_reason_no_variant_match
(count)
The number of ads skipped due to there being no variant match between the ad and content.
aws.mediatailor.skipped_reason_personalization_threshold_exceeded
(count)
The duration of ads exceeding the Personalization Threshold setting in this configuration.
aws.mediatailor.skipped_reason_profile_not_found
(count)
The number of ads skipped due to the transcoding profile not being found.
aws.mediatailor.skipped_reason_transcode_error
(count)
The number of ads skipped due to a transcode error.
aws.mediatailor.skipped_reason_transcode_in_progress
(count)
The count of the number of ads that were not inserted into an avail because the ad had not yet been transcoded. A high value for this metric might temporarily contribute to a low overall Avail.FillRate, until the assets can be successfully transcoded
aws.mediatailor.total_time
(gauge)
The amount of time that the application server took to process the request, including the time used to receive bytes from and write bytes to the client and network.
Shown as millisecond

Events

The AWS Elemental MediaTailor integration does not include any events.

Service Checks

The AWS Elemental MediaTailor integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.