View a markdown version of this page

Amazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング - AWS Elemental MediaTailor

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング

CloudWatch を使用して AWS Elemental MediaTailor メトリクスをモニタリングできます。CloudWatch は、サービスのパフォーマンスに関する raw データを収集し、そのデータを読み取り可能なほぼリアルタイムのメトリクスに処理します。これらの統計は 15 か月間保持されるため、履歴情報にアクセスし、ウェブアプリケーションまたはサービスの動作をより的確に把握できます。また、特定のしきい値を監視するアラームを設定し、これらのしきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、「Amazon CloudWatch ユーザーガイド」を参照してください。

メトリクスは、古いマニフェストを調査するときに便利です。詳細については、「メトリクスを使用して古いマニフェストを診断する」を参照してください。

メトリクスはまずサービスの名前空間ごとにグループ化され、次に各名前空間内のさまざまなディメンションの組み合わせごとにグループ化されます。

CloudWatch コンソールを使用してメトリクスを表示するには
  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. ナビゲーションペインで [Metrics (メトリクス)] を選択してください。

  3. [すべてのメトリクス] で、[MediaTailor] 名前空間を選択します。

  4. メトリクスを表示するメトリクスディメンション (originID など) を選択します。

  5. 表示する期間を指定します。

AWS Command Line Interface (AWS CLI) を使用してメトリクスを表示するには
  • コマンドプロンプトで、次のコマンドを使用します。

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

AWS Elemental MediaTailor CloudWatch メトリクス

AWS Elemental MediaTailor 名前空間には、次のメトリクスが含まれます。これらのメトリクスはデフォルトでユーザーのアカウントに発行されます。

チャネルアセンブリ (CA) メトリクス

次の表では、すべてのメトリクスをチャネルまたはチャネル出力で使用できます。

メトリクス 説明
4xxErrorCount

4xx エラーの数。

5xxErrorCount

5xx エラーの数。

RequestCount

リクエストの総数。トランザクション数は、プレイヤーが更新されたマニフェストをリクエストする頻度とプレイヤーの数に大きく依存します。プレイヤーリクエストのそれぞれがトランザクションとして計上されます。

TotalTime

アプリケーションサーバーがリクエストの処理にかかった時間。クライアントとネットワークとの間でのバイトの受信と書き込みに使用された時間が含まれます。

サーバー側の広告挿入 (SSAI) メトリクス

次の表に、サーバー側の広告挿入メトリクスを示します。

メトリクス 説明
AdDecisionServer.Ads

ユーザー指定の CloudWatch 期間内において、広告決定サーバー (ADS) レスポンスに含まれていた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

AdDecisionServer.Duration

ユーザー指定の CloudWatch 期間内において、MediaTailor が ADS から受信したすべての広告の合計継続時間 (ミリ秒単位)。この期間は、Avail.Duration指定した よりも長くすることができます。

ディメンション: ConfigurationName

AdDecisionServer.Errors

ユーザー指定の CloudWatch 期間内において、MediaTailor が ADS から受信した HTTP 200 以外のステータスコードを持つレスポンス、空のレスポンス、およびタイムアウトレスポンスの数。

ディメンション: ConfigurationName

AdDecisionServer.FillRate

ユーザー指定の期間中に、ADS からのレスポンスが対応する個々の ad avail を埋めた率の単純平均。

加重平均を取得するには、AdDecisionServer.DurationAvail.Duration の割合 (%) で計算します。単純平均および加重平均の詳細については、「単純平均と加重平均」を参照してください。

ディメンション: ConfigurationName

AdDecisionServer.Latency

MediaTailor から ADS へのリクエストの応答時間をミリ秒単位で表します。

ディメンション: ConfigurationName

AdDecisionServer.Timeouts

ユーザー指定の CloudWatch 期間中の ADS に対するタイムアウトリクエストの数。

ディメンション: ConfigurationName

AdNotReady

ユーザー指定の期間中に、内部トランスコーダーサービスによるトランスコードが未完了の広告を ADS が参照した回数。

このメトリクスの値が大きいと、全体的な Avail.FillRate が低くなる可能性があります。

ディメンション: ConfigurationName

AdsBilled

MediaTailor が挿入に基づいて顧客に請求する広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

Avail.Duration

CloudWatch 期間内における、ad avail の計画された合計ミリ秒数。計画された合計は、オリジンマニフェスト内の ad avail 継続時間に基づきます。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

Avail.FilledDuration

CloudWatch 期間内に MediaTailor が広告で埋める ad avail 時間の計画された合計ミリ秒数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

Avail.FillRate

CloudWatch 期間内に MediaTailor が個々の ad avail を埋める率の計画された単純平均。

加重平均を取得するには、Avail.FilledDurationAvail.Duration の割合 (%) で計算します。単純平均および加重平均の詳細については、「単純平均と加重平均」を参照してください。

MediaTailor が達成できる最大 Avail.FillRateAdDecisionServer.FillRate によって制限されます。Avail.FillRate が低い場合は、AdDecisionServer.FillRate と比較してください。AdDecisionServer.FillRate が低い場合は、avail の継続時間に対して ADS が十分な広告を返していない可能性があります。

ディメンション: ConfigurationName

Avail.Impression

MediaTailor がサーバー側のレポート中にインプレッションビーコンを発した広告の数。MediaTailor は、最終的にビーコンが配信されたかどうかにかかわらず、少なくとも 1 つのインプレッション URI を持つ広告ごとに 1 つのカウントを出力します。このメトリクスを分母として使用して、ビデオ完了率 (VCR) を計算します (「」を参照)Avail.Complete

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

Avail.Complete

MediaTailor がサーバー側のレポート中に完全なビーコンを発射した広告の数。MediaTailor は、ビーコンが最終的に配信されたかどうかにかかわらず、少なくとも 1 つの完全な追跡 URI を持つ広告ごとに 1 つのカウントを出力します。動画完成率 (VCR) を計算するには、 の合計を の合計Avail.Completeで割りますAvail.Impression

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

Avail.ObservedDuration

CloudWatch 期間内に発生した、ad avail の観測された合計ミリ秒数。Avail.ObservedDuration は ad avail の終了時点で発行され、ad avail 間のマニフェストで報告されたセグメントの継続時間に基づきます。

ディメンション: ConfigurationName

Avail.ObservedFilledDuration

CloudWatch 期間内に MediaTailor が広告で埋めた ad avail 時間の観測されたミリ秒数。

ディメンション: ConfigurationName

Avail.ObservedFillRate

CloudWatch 期間内に MediaTailor が個々の ad avail を埋めた率の観測された単純平均。

最初のCUE-INタグで HLS マニフェストに対してのみ出力されます。CUE-IN タグがない場合、MediaTailor はこのメトリクスを出力しません。

ディメンション: ConfigurationName

Avail.ObservedSlateDuration

CloudWatch 期間内に挿入されたスレートの観測された合計ミリ秒数。

ディメンション: ConfigurationName

GetManifest.Age

マニフェストの合計経過時間をミリ秒単位で表します。オリジンがマニフェストを作成する時点から、MediaTailor がパーソナライズされたマニフェストを送信する時点まで測定されます。

マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してくださいメトリクスを使用して古いマニフェストを診断する

ディメンション: ConfigurationName

GetManifest.Errors

ユーザー指定の CloudWatch 期間中、MediaTailor がマニフェストを生成する間に受信されたエラーの数。

ディメンション: ConfigurationName

GetManifest.Latency

マニフェストを生成するリクエストの MediaTailor 応答時間をミリ秒単位で表します。

マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してくださいメトリクスを使用して古いマニフェストを診断する

ディメンション: ConfigurationName

GetManifest.MediaTailorAge

マニフェストが MediaTailor に保存された時間をミリ秒単位で表します。MediaTailor がオリジンレスポンスを受信したときから、MediaTailor がパーソナライズされたマニフェストを送信するときに測定されます。

マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してくださいメトリクスを使用して古いマニフェストを診断する

ディメンション: ConfigurationName

Origin.Age

オリジンにマニフェストがあるミリ秒単位の時間。オリジンがマニフェストを作成するときから MediaTailor がオリジンリクエストを送信するときまで測定されます。

すべてのorigin.*メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。

マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してくださいメトリクスを使用して古いマニフェストを診断する

ディメンション: ConfigurationName

Origin.Errors

ユーザー指定の CloudWatch 期間中、MediaTailor がオリジンサーバーから受信した HTTP 200 以外のステータスコードを持つレスポンスとタイムアウトレスポンスの数。

すべてのorigin.*メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。

ディメンション: ConfigurationName

Origin.ManifestFileSizeBytes

HLS と DASH の両方のオリジンマニフェストのファイルサイズをバイト単位で指定します。通常、このメトリクスは と組み合わせて使用されますOrigin.ManifestFileSizeTooLarge

すべてのorigin.*メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。

ディメンション: ConfigurationName

Origin.ManifestFileSizeTooLarge

マニフェストサイズが設定された量より大きいオリジンからのレスポンスの数。通常、このメトリクスは と組み合わせて使用されますOrigin.ManifestFileSizeBytes

すべてのorigin.*メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。

ディメンション: ConfigurationName

Origin.Timeouts

ユーザー指定の CloudWatch 期間中のオリジンサーバーに対するタイムアウトリクエストの数。

すべてのorigin.*メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。

ディメンション: ConfigurationName

Requests

すべてのリクエストタイプにおける 1 秒あたりの同時トランザクションの数。トランザクション数は、主にプレイヤーの数と、プレイヤーが更新されたマニフェストをリクエストする頻度によって異なります。プレイヤーリクエストのそれぞれがトランザクションとして計上されます。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.DurationExceeded

ADS が指定された表示期間よりも長い広告期間を返したために表示に挿入されなかった広告の数。このメトリクスの値が大きいと、 AdsBilledメトリクスと AdDecisionServer.Adsメトリクスの間に不一致が生じる可能性があります。広告がスキップされた理由の詳細については、「」を参照してください広告スキップのトラブルシューティング

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.EarlyCueIn

早期 のためにスキップされた広告の数CUE-IN

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.ImportError

インポートジョブのエラーによりスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.ImportInProgress

既存のアクティブなインポートジョブのためにスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.InternalError

MediaTailor の内部エラーのためにスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.NewCreative

アセットがクライアントによって初めてリクエストされたために avail に挿入されなかった広告の数。このメトリクスの値が高いと、アセットが正常にトランスコードされるまでAvail.FillRate、一時的に 全体の が低くなる可能性があります。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.NoVariantMatch

広告とコンテンツの間にバリアントが一致しないためにスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.PersonalizationThresholdExceeded

この設定でパーソナライゼーションしきい値設定を超える広告の期間。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.ProfileNotFound

トランスコードプロファイルが見つからないためにスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.TranscodeError

トランスコードエラーによりスキップされた広告の数。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

SkippedReason.TranscodeInProgress

広告がまだトランスコードされていないために表示に挿入されなかった広告の数。このメトリクスの値が高いと、アセットが正常にトランスコードされるまでAvail.FillRate、一時的に全体的な が低くなる可能性があります。

ディメンション:

  • ConfigurationName

  • アカウントレベル (ディメンションなし)

注記

HLS Interstitials セッションでは、広告決定の遅延バインド性により、一部のメトリクスの動作が異なります。

  • Avail.ObservedFilledDuration MediaTailor は実際のクライアント側の再生動作を観測できないAvail.FilledDurationため、 は一致します。

  • Avail.ObservedSlateDuration は、再生が観察されるのではなく、アセットリストレスポンスから計画されたスレート期間を報告します。

  • 「Observed」というプレフィックスが付いたメトリクスは、HLS Interstitials セッションの推定値を提供します。

関数メトリクス

再生設定で Functions を使用すると、次のメトリクスが発行されます。これらのメトリクスは、関数がライフサイクルフックに設定されているときに常に出力されます。オプトインやログの設定は必要ありません。

フックレベルのメトリクス — ライフサイクルフックの実行ごとに 1 つのデータポイント:

メトリクス 説明
PreSessionInitHook.Invocations

セッション前の初期化フックが呼び出された回数。

ディメンション: ConfigurationName

PreSessionInitHook.Errors

エラーが発生したセッション前の初期化フック実行の数。

ディメンション: ConfigurationName

PreSessionInitHook.Latency

セッション前の初期化フックの実行時間をミリ秒単位で表します。

ディメンション: ConfigurationName

PreAdsRequestHook.Invocations

pre-ads リクエストフックが呼び出された回数。

ディメンション: ConfigurationName

PreAdsRequestHook.Errors

エラーが発生した事前広告リクエストフック実行の数。

ディメンション: ConfigurationName

PreAdsRequestHook.Latency

pre-ads リクエストフックの実行時間をミリ秒単位で表します。

ディメンション: ConfigurationName

関数レベルのメトリクス — 関数の実行ごとに 1 つのデータポイント。これらのメトリクスには追加のディメンション (FunctionIdFunctionTypeHookType) が含まれているため、どの関数が遅いか失敗しているかを特定できます。

メトリクス 説明
Function.Invocations

個々の関数が実行された回数。

ディメンション:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Errors

エラーが発生した個々の関数実行の数。

ディメンション:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

Function.Latency

個々の関数の実行時間をミリ秒単位で表します。

ディメンション:

  • ConfigurationName

  • ConfigurationName, FunctionId, FunctionType, HookType

単純平均と加重平均

MediaTailor からの広告リクエストに対する ADS からのレスポンスと、MediaTailor が ad avail を埋める方法に関する単純平均と加重平均を取得できます。

  • 単純平均は、AdDecisionServer.FillRate および Avail.FillRate で提供されます。これらは、対象期間の個々の avail に対するフィルレート割合 (%) の平均です。単純平均では、個々の avail の継続時間の違いは考慮されません。

  • 加重平均は、すべての avail 継続時間の合計に対するフィルレート (%) です。これらの値は、(AdDecisionServer.Duration×100)÷Avail.Duration および (Avail.FilledDuration×100)÷Avail.Duration として計算されます。これらの平均値には、各 ad avail の継続l時間における違いが反映されており、継続時間が長いものほど重みが大きくなります。

単一の ad avail のみを含む期間の場合、AdDecisionServer.FillRate によって算出される単純平均は、(AdDecisionServer.Duration×100)÷Avail.Duration で算出される加重平均と同等です。Avail.FillRate で算出される単純平均は、(Avail.FilledDuration×100)÷Avail.Duration で算出される加重平均と同等です。

指定した期間に次の 2 つの ad avail が含まれるとします。

  • 最初の ad avail の継続時間は 90 秒です。

    • この avail に対する ADS レスポンスは、45 秒の広告を提供します (50% 満稿)。

    • MediaTailor は、利用可能な広告時間の 45 秒分を埋めます (50% 満稿)

  • 2 つめの ad avail の継続時間は 120 秒です。

    • この avail に対する ADS レスポンスは、120 秒の広告を提供します (100% 満稿)。

    • MediaTailor は、利用可能な広告時間の 90 秒分を埋めます (75% 満稿)

メトリクスは以下のとおりです。

  • Avail.Duration は 210 (2 つの ad avail 継続時間の合計: 90+120) です。

  • AdDecisionServer.Duration は 165 (2 つのレスポンス継続時間の合計: 45+120) です。

  • Avail.FilledDuration は 135 (2 つの埋められた継続時間の合計: 45+90) です。

  • AdDecisionServer.FillRate は 75% (avail ごとの満稿割合 (%) の平均: (50%+100%)÷2) です。これは単純平均です。

  • ADS フィルレートの加重平均は 78.57% (Avail.Duration の割合としての AdDecisionServer.Duration: (165×100)÷210) です。この計算では、継続時間の違いが考慮されます。

  • Avail.FillRate は 62.5% (avail ごとの満稿割合 (%) の平均: (50%+75%)÷2) です。これは単純平均です。

  • MediaTailor の avail フィルレートの加重平均は 64.29% (Avail.Duration の割合としての Avail.FilledDuration: (135×100)÷210) です。この計算では、継続時間の違いが考慮されます。

MediaTailor が ad avail に対して達成できる最高の Avail.FillRate は 100% です。ADS は、avail で利用可能な時間よりも長い広告時間を返す場合がありますが、MediaTailor が埋めることができるのは利用可能な時間のみです。

AWS Elemental MediaTailor CloudWatch ディメンション

次のディメンションを使用して AWS Elemental MediaTailor データをフィルタリングできます。

ディメンション 説明

ConfigurationName

メトリクスが属する設定を示します。すべてのメトリクスで使用できます。

FunctionId

関数の識別子。Function.* メトリクスでのみ使用できます。

FunctionType

関数のタイプ: CUSTOM_OUTPUTHTTP_REQUESTSEQUENTIAL_EXECUTOR、または CONCURRENT_EXECUTORFunction.* メトリクスでのみ使用できます。

HookType

関数をトリガーしたライフサイクルフック: PRE_SESSION_INITIALIZATIONまたは PRE_ADS_REQUESTFunction.* メトリクスでのみ使用できます。