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

# Amazon CloudWatch メトリクス AWS Elemental MediaTailor によるモニタリング
<a name="monitoring-cloudwatch-metrics"></a>

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

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

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

**CloudWatch コンソールを使用してメトリクスを表示するには**

1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

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

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

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

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

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

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

## AWS Elemental MediaTailor CloudWatch メトリクス
<a name="metrics"></a>

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

### チャネルアセンブリ (CA) メトリクス
<a name="metrics.channel-assembly"></a>

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


| メトリクス | 説明 | 
| --- | --- | 
|  4xxErrorCount  | `4xx` エラーの数。 | 
|  5xxErrorCount  | `5xx` エラーの数。 | 
|  RequestCount  |  リクエストの総数。トランザクション数は、プレイヤーが更新されたマニフェストをリクエストする頻度とプレイヤーの数に大きく依存します。プレイヤーリクエストのそれぞれがトランザクションとして計上されます。 | 
|  TotalTime  | アプリケーションサーバーがリクエストの処理にかかった時間。クライアントとネットワークとの間でのバイトの受信と書き込みに使用された時間が含まれます。 | 

#### サーバー側の広告挿入 (SSAI) メトリクス
<a name="metrics.server-side-ad-insertion"></a>

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


| メトリクス | 説明 | 
| --- | --- | 
|  AdDecisionServer.Ads  | ユーザー指定の CloudWatch 期間内において、広告決定サーバー (ADS) レスポンスに含まれていた広告の数。 | 
|  AdDecisionServer.Duration  | ユーザー指定の CloudWatch 期間内において、MediaTailor が ADS から受信したすべての広告の合計継続時間 (ミリ秒単位)。この期間は、`Avail.Duration`指定した よりも長くすることができます。 | 
|  AdDecisionServer.Errors  | ユーザー指定の CloudWatch 期間内において、MediaTailor が ADS から受信した HTTP 200 以外のステータスコードを持つレスポンス、空のレスポンス、およびタイムアウトレスポンスの数。 | 
|  AdDecisionServer.FillRate  | ユーザー指定の期間中に、ADS からのレスポンスが対応する個々の ad avail を埋めた率の単純平均。<br />加重平均を取得するには、`AdDecisionServer.Duration` を `Avail.Duration` の割合 (%) で計算します。単純平均および加重平均の詳細については、「[単純平均と加重平均](#metrics-simple-average)」を参照してください。 | 
|  AdDecisionServer.Latency  | MediaTailor から ADS へのリクエストの応答時間をミリ秒単位で表します。 | 
|  AdDecisionServer.Timeouts  | ユーザー指定の CloudWatch 期間中の ADS に対するタイムアウトリクエストの数。 | 
|  AdNotReady  | ユーザー指定の期間中に、内部トランスコーダーサービスによるトランスコードが未完了の広告を ADS が参照した回数。<br />このメトリクスの値が大きいと、全体的な `Avail.FillRate` が低くなる可能性があります。 | 
|  AdsBilled  | MediaTailor が挿入に基づいて顧客に請求する広告の数。 | 
|  Avail.Duration  | CloudWatch 期間内における、ad avail の計画された合計ミリ秒数。計画された合計は、オリジンマニフェスト内の ad avail 継続時間に基づきます。 | 
|  Avail.FilledDuration  | CloudWatch 期間内に MediaTailor が広告で埋める ad avail 時間の計画された合計ミリ秒数。 | 
|  Avail.FillRate  | CloudWatch 期間内に MediaTailor が個々の ad avail を埋める率の計画された単純平均。<br />加重平均を取得するには、`Avail.FilledDuration` を `Avail.Duration` の割合 (%) で計算します。単純平均および加重平均の詳細については、「[単純平均と加重平均](#metrics-simple-average)」を参照してください。<br />MediaTailor が達成できる最大 `Avail.FillRate` は `AdDecisionServer.FillRate` によって制限されます。`Avail.FillRate` が低い場合は、`AdDecisionServer.FillRate` と比較してください。`AdDecisionServer.FillRate` が低い場合は、avail の継続時間に対して ADS が十分な広告を返していない可能性があります。 | 
|  Avail.Impression  | MediaTailor がサーバー側のビーコン中に表示するインプレッション追跡イベントを含む広告の数 (インプレッションの数ではありません）。 | 
|  Avail.ObservedDuration  | CloudWatch 期間内に発生した、ad avail の観測された合計ミリ秒数。`Avail.ObservedDuration` は ad avail の終了時点で発行され、ad avail 間のマニフェストで報告されたセグメントの継続時間に基づきます。 | 
|  Avail.ObservedFilledDuration  | CloudWatch 期間内に MediaTailor が広告で埋めた ad avail 時間の観測されたミリ秒数。 | 
|  Avail.ObservedFillRate  | CloudWatch 期間内に MediaTailor が個々の ad avail を埋めた率の観測された単純平均。<br />最初の`CUE-IN`タグで HLS マニフェストに対してのみ出力されます。`CUE-IN` タグがない場合、MediaTailor はこのメトリクスを出力しません。 | 
|  Avail.ObservedSlateDuration  | CloudWatch 期間内に挿入されたスレートの観測された合計ミリ秒数。 | 
|  GetManifest.Age  | マニフェストの合計経過時間をミリ秒単位で表します。オリジンがマニフェストを作成する時点から、MediaTailor がパーソナライズされたマニフェストを送信する時点まで測定されます。<br />マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してください[メトリクスを使用して古いマニフェストを診断する](stale-manifest-diagnose.md)。 | 
|  GetManifest.Errors  | ユーザー指定の CloudWatch 期間中、MediaTailor がマニフェストを生成する間に受信されたエラーの数。 | 
|  GetManifest.Latency  | マニフェストを生成するリクエストの MediaTailor 応答時間をミリ秒単位で表します。<br />マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してください[メトリクスを使用して古いマニフェストを診断する](stale-manifest-diagnose.md)。 | 
|  GetManifest.MediaTailorAge  | マニフェストが MediaTailor に保存された時間をミリ秒単位で表します。MediaTailor がオリジンレスポンスを受信したときから、MediaTailor がパーソナライズされたマニフェストを送信するときまで測定されます。<br />マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してください[メトリクスを使用して古いマニフェストを診断する](stale-manifest-diagnose.md)。 | 
|  Origin.Age  | オリジンにマニフェストがあるミリ秒単位の時間。オリジンがマニフェストを作成するときから MediaTailor がオリジンリクエストを送信するときまで測定されます。<br />すべての`origin.*`メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。<br />マニフェストの経過時間を測定するためのメトリクスの詳細については、「」を参照してください[メトリクスを使用して古いマニフェストを診断する](stale-manifest-diagnose.md)。 | 
|  Origin.Errors  | ユーザー指定の CloudWatch 期間中、MediaTailor がオリジンサーバーから受信した HTTP 200 以外のステータスコードを持つレスポンスとタイムアウトレスポンスの数。<br />すべての`origin.*`メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。 | 
|  Origin.ManifestFileSizeBytes  | HLS と DASH の両方のオリジンマニフェストのファイルサイズをバイト単位で指定します。通常、このメトリクスは と組み合わせて使用されます`Origin.ManifestFileSizeTooLarge`。<br />すべての`origin.*`メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。 | 
|  Origin.ManifestFileSizeTooLarge  | マニフェストサイズが設定された量より大きいオリジンからのレスポンスの数。通常、このメトリクスは と組み合わせて使用されます`Origin.ManifestFileSizeBytes`。<br />すべての`origin.*`メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。 | 
|  Origin.Timeouts  | ユーザー指定の CloudWatch 期間中のオリジンサーバーに対するタイムアウトリクエストの数。<br />すべての`origin.*`メトリクスは、オリジンから直接実行されるリクエストに対して出力されます。キャッシュされたオリジンレスポンスに対しては出力されません。 | 
|  Requests  | すべてのリクエストタイプにおける 1 秒あたりの同時トランザクションの数。トランザクション数は、主にプレイヤーの数と、プレイヤーが更新されたマニフェストをリクエストする頻度によって異なります。プレイヤーリクエストのそれぞれがトランザクションとして計上されます。 | 
|  SkippedReason.DurationExceeded  | ADS が指定された表示期間よりも長い広告期間を返したために表示に挿入されなかった広告の数。このメトリクスの値が大きいと、 `Avail.Ads`と `AdDecisionServer.Ads`メトリクスの間に不一致が生じる可能性があります。広告がスキップされた理由の詳細については、「」を参照してください[広告スキップのトラブルシューティング](troubleshooting-ad-skipping-overview.md)。 | 
|  SkippedReason.EarlyCueIn  | 早期 のためにスキップされた広告の数`CUE-IN`。 | 
|  SkippedReason.ImportError  | インポートジョブのエラーによりスキップされた広告の数。 | 
|  SkippedReason.ImportInProgress  | 既存のアクティブなインポートジョブのためにスキップされた広告の数。 | 
|  SkippedReason.InternalError  | MediaTailor の内部エラーによりスキップされた広告の数。 | 
|  SkippedReason.NewCreative  | アセットがクライアントによって初めてリクエストされたために avail に挿入されなかった広告の数。このメトリクスの値が高いと、アセットが正常にトランスコードされるまで`Avail.FillRate`、一時的に全体的な が低くなる可能性があります。 | 
|  SkippedReason.NoVariantMatch  | 広告とコンテンツの間にバリアントが一致しないためにスキップされた広告の数。 | 
|  SkippedReason.PersonalizationThresholdExceeded  | この設定で**パーソナライゼーションしきい値**設定を超える広告の期間。 | 
|  SkippedReason.ProfileNotFound  | トランスコードプロファイルが見つからないためにスキップされた広告の数。 | 
|  SkippedReason.TranscodeError  | トランスコードエラーによりスキップされた広告の数。 | 
|  SkippedReason.TranscodeInProgress  | 広告がまだトランスコードされていないために表示に挿入されなかった広告の数。このメトリクスの値が高いと、アセットが正常にトランスコードされるまで`Avail.FillRate`、一時的に 全体の が低くなる可能性があります。 | 
|  GetAssets.Requests  | CloudWatch 期間内に HLS Interstitials セッションに対して受信したアセットリストリクエストの数。このメトリクスを使用して、遅延バインド広告決定ボリュームをモニタリングし、HLS Interstitials の使用状況のスケールを理解します。 | 
|  GetAssets.Latency  | HLS Interstitials セッションのアセットリストリクエストの応答時間をミリ秒単位で表します。このメトリクスをモニタリングして、最適な広告決定パフォーマンスを確保し、遅延バインディングワークフローの潜在的なボトルネックを特定します。 | 

**注記**  
HLS Interstitials セッションでは、広告決定の遅延バインド性により、一部のメトリクスの動作が異なります。  
`Avail.ObservedFilledDuration` MediaTailor は実際のクライアント側の再生動作を観測できない`Avail.FilledDuration`ため、 は一致します。
`Avail.ObservedSlateDuration` は、観測された再生ではなく、アセットリストレスポンスから計画されたスレート期間を報告します。
「Observed」というプレフィックスが付いたメトリクスは、HLS Interstitials セッションの推定値を提供します。

### 関数メトリクス
<a name="metrics.functions"></a>

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

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


| メトリクス | 説明 | 
| --- | --- | 
|  PreSessionInitHook.Invocations  | セッション前の初期化フックが呼び出された回数。 | 
|  PreSessionInitHook.Errors  | エラーが発生したセッション前の初期化フック実行の数。 | 
|  PreSessionInitHook.Latency  | セッション前の初期化フックの実行時間をミリ秒単位で表します。 | 
|  PreAdsRequestHook.Invocations  | pre-ads リクエストフックが呼び出された回数。 | 
|  PreAdsRequestHook.Errors  | エラーが発生した事前広告リクエストフック実行の数。 | 
|  PreAdsRequestHook.Latency  | pre-ads リクエストフックの実行時間をミリ秒単位で表します。 | 

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


| メトリクス | 説明 | 
| --- | --- | 
|  Function.Invocations  | 個々の関数が実行された回数。 | 
|  Function.Errors  | エラーが発生した個々の関数実行の数。 | 
|  Function.Latency  | 個々の関数の実行時間をミリ秒単位で表します。 | 

### 単純平均と加重平均
<a name="metrics-simple-average"></a>

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 ディメンション
<a name="dimensions"></a>

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


| ディメンション | 説明 | 
| --- | --- | 
| `ConfigurationName` | メトリクスが属する設定を示します。すべてのメトリクスで使用できます。 | 
| `FunctionId` | 関数の識別子。`Function.*` メトリクスでのみ使用できます。 | 
| `FunctionType` | 関数のタイプ: `CUSTOM_OUTPUT`、`HTTP_REQUEST`、`SEQUENTIAL_EXECUTOR`、または `CONCURRENT_EXECUTOR`。`Function.*` メトリクスでのみ使用できます。 | 
| `HookType` | 関数をトリガーしたライフサイクルフック: `PRE_SESSION_INITIALIZATION`または `PRE_ADS_REQUEST`。`Function.*` メトリクスでのみ使用できます。 |