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

# CloudFront と MediaTailor の統合のモニタリングとトラブルシューティング
<a name="monitoring-and-troubleshooting"></a>

AWS Elemental MediaTailor Amazon CloudFront との統合には、最適なパフォーマンスを維持するために継続的なモニタリングとトラブルシューティングが必要です。CloudFront と MediaTailor の統合を実装したら、パフォーマンスをモニタリングし、問題のトラブルシューティングに備えます。コンテンツ配信ネットワーク (CDN) には、ディストリビューションのパフォーマンスを理解し、潜在的な問題を特定するのに役立つツールが用意されています。

## 統合のモニタリングの設定
<a name="cf-monitoring-setup"></a>

CloudFront と MediaTailor の統合のパフォーマンスを追跡するには、以下のモニタリング戦略を実装します。

**CloudFront と MediaTailor の統合のモニタリングを設定するには**

1. CloudFront 標準ログ記録を有効にします。

   1. CloudFront コンソールで、ディストリビューションを選択します。

   1. [**ログ**] タブを選択します。

   1. **標準ログ**で、**編集** を選択します。

   1. **On **を選択し、ログストレージ用に Amazon S3 バケットを設定します。

   1. **[Save changes]** (変更の保存) をクリックします。

1. CloudFront リアルタイムログを設定します。

   1. CloudFront コンソールで、ディストリビューションを選択します。

   1. [**ログ**] タブを選択します。

   1. **リアルタイムログ**で、**編集** を選択します。

   1. **On **を選択し、Amazon Kinesis Data Streams または Amazon Data Firehose 配信ストリームを設定します。

   1. ログ設定に以下のフィールドを含めます。
      + `time-to-first-byte` - 応答時間
      + `sc-status` - HTTP ステータスコード
      + `c-ip` - ビューワー IP アドレス
      + `cs-uri-stem` - リクエスト URI パス
      + `cs-user-agent` - ユーザーエージェント
      + `x-edge-result-type` - 結果タイプ (ヒット、ミス、エラー)

   1. **[Save changes]** (変更の保存) をクリックします。

1. CloudWatch ダッシュボードを作成する:

   1. CloudWatch コンソールで、**ダッシュボード**を選択します。

   1. **[ダッシュボードを作成]** を選択します。

   1. これらの CloudFront メトリクスのウィジェットを追加します。
      + リクエスト
      + BytesDownloaded
      + 4xxErrorRate
      + 5xxErrorRate
      + TotalErrorRate
      + CacheHitRate

1. CloudWatch アラームを設定します。

   1. CloudWatch コンソールで、**アラーム**を選択します。

   1. [**アラームの作成**] を選択します。

   1. これらの条件のアラームを作成します。
      + 5xxErrorRate > 1% を 5 分間
      + 4xxErrorRate が 5% を 5 分間超える
      + CacheHitRate が 30 分間 80% 未満

## MQAR パフォーマンスのモニタリング
<a name="mqar-monitoring"></a>

MQAR を使用する場合、モニタリングは CloudFront がオリジンを選択する方法と、品質スコアが期待を満たしているかどうかを理解するのに役立ちます。リアルタイムログは、これらの決定を発生時に表示します。

**MQAR のパフォーマンスをモニタリングするには**

1. CloudFront ディストリビューションのリアルタイムログを有効にします。

1. ログ設定に以下のフィールドを含めます。
   + `r-host` - 選択したオリジンのホスト名
   + `sr-reason` - オリジン選択の理由
   + `x-edge-mqcs` - メディア品質信頼スコア

1. Amazon Kinesis Data Streams または Amazon Data Firehose でログ送信先を設定します。

1. これらのメトリクスに基づいてダッシュボードまたはアラートを作成し、品質スコアとオリジン選択の決定をモニタリングします。

**Example MQAR モニタリング用の CloudWatch ダッシュボードのサンプル**  
次のメトリクスを使用して CloudWatch ダッシュボードを作成します。  
+ リージョン別のオリジン選択数
+ 経時的な平均品質スコア
+ フェイルオーバーイベント
+ オリジン別の 4xx および 5xx エラー率

リアルタイムログの設定の詳細については、CloudFront デベロッパーガイドの[「リアルタイムログ](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html)」を参照してください。

## 一般的な問題のトラブルシューティング
<a name="troubleshooting-common-issues"></a>

CloudFront と MediaTailor の統合では、慎重な計画を立てていても問題が発生する可能性があります。一般的な問題と解決策を理解することで、問題をすばやく解決し、視聴者への影響を最小限に抑えることができます。

CloudFront と MediaTailor の統合で問題が発生した場合は、以下の一般的な問題と解決策を確認してください。

マニフェストキャッシュの問題  
**症状:** 古いマニフェストまたは広告が更新されない  
**解決策:** マルチバリアントプレイリスト、メディアプレイリスト、MPD パスに`CachingDisabled`キャッシュポリシーを使用していることを確認します。設定でクエリパラメータが正しく転送されていることを確認します。

CORS エラー  
**症状:** コンテンツにアクセスするときにブラウザコンソールに CORS エラーが表示される  
**解決策:** レスポンスヘッダーポリシーを適切な CORS ヘッダーで設定し、キャッシュ動作に関連付けます。

MQAR が機能しない  
**症状:** オリジン選択が品質スコアを無視する  
**解決策:** オリジングループ設定でメディア品質スコアオプションが有効になっていることを確認します。Lambda@Edge オリジン向けトリガーを使用していないことを確認します。

広告挿入の失敗  
**症状:** 広告が正しく挿入されない  
**解決策:** MediaTailor 設定がコンテンツセグメントプレフィックスの CloudFront ディストリビューションを指していることを確認します。設定で必要なすべてのヘッダーが転送されていることを確認します。

より複雑な問題には、次のトラブルシューティングアプローチを使用できます。

1. CloudFront ディストリビューションログでエラーパターンを確認する

1. ブラウザ開発者ツールを使用してネットワークリクエストを検査する

1. MediaTailor のマニフェストコンテンツと CloudFront 経由で配信されるコンテンツを直接比較する

1. 詳細なログ記録をサポートするシンプルなプレイヤーでテストする

トラブルシューティングの詳細については、MediaTailor ユーザーガイドの[「トラブルシューティング](https://docs.aws.amazon.com//mediatailor/latest/ug/troubleshooting.html)」セクションを参照してください。

## ワークフローのトラブルシューティング
<a name="troubleshooting-workflow"></a>

CloudFront と MediaTailor の統合に関する問題のトラブルシューティングを行うには、次の体系的なアプローチに従います。

**CloudFront と MediaTailor の統合の問題をトラブルシューティングするには**

1. 特定の問題を特定します。

   1. 問題がすべてのビューワーに影響するか、一部のみに影響するかを判断する

   1. 影響を受けるコンテンツタイプ (マニフェスト、セグメント、またはその両方) を特定する

   1. エラーメッセージや症状を書き留める

1. CloudFront ログを確認します。

   1. エラーステータスコードを探す (4xx または 5xx)

   1. キャッシュヒット/ミスパターンを確認する

   1. リクエストが正しいオリジンにルーティングされていることを確認します。

1. 設定を確認します。

   1. キャッシュ動作で正しいパスパターンを確認する

   1. キャッシュポリシーが正しく適用されていることを確認する

   1. オリジンリクエストポリシーが必要なヘッダーを転送していることを確認します。

1. 直接アクセスをテストする:

   1. MediaTailor から直接コンテンツにアクセスしてみてください (CloudFront をバイパス)

   1. 直接アクセスと CloudFront アクセスのレスポンスを比較する

1. ソリューションを実装します。

   1. 検出結果に基づいて適切な修正を適用する

   1. テストして問題が解決されたことを確認する

   1. 今後の参照用に問題とソリューションを文書化する

## 次の手順
<a name="monitoring-next-steps"></a>

CloudFront と MediaTailor の統合のモニタリングとトラブルシューティングを設定したら、次のステップを検討してください。
+ を使用した自動デプロイの実装 AWS CloudFormation (「」を参照[で MediaTailor と CDN を自動化する CloudFormation](automating-cdn-integration.md))
+ 一般的な運用シナリオとトラブルシューティング手順のランブックを作成する
+ 一般的な問題の自動修復を設定する