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

# MediaTailor と CDN の統合に関する問題のトラブルシューティング
<a name="cdn-troubleshooting"></a>

この包括的なトラブルシューティングガイドでは、サーバー側の広告挿入 (SSAI)、チャネルアセンブリ、統合など、すべての AWS Elemental MediaTailor 実装における一般的なコンテンツ配信ネットワーク (CDN) AWS Elemental MediaPackage 統合の問題について説明します。CDN と MediaTailor の統合で問題が発生した場合は、この体系的な診断アプローチを使用して根本原因をすばやく特定し、検証済みのソリューションを実装します。

このガイドは、特定のワークフローに関係なく、すべての MediaTailor CDN 統合に適用されます。特定のサービスまたはワークフローに固有の問題については、このガイドの最後にある関連するトラブルシューティングセクションを参照してください。

**開始する前に、**以下の項目を効率的なトラブルシューティングに備えてください。
+ 問題を示すサンプル再生 URLs 
+ 問題が発生した期間の CDN アクセスログ
+ MediaTailor 設定名と AWS リージョン
+ プレイヤーのタイプとバージョン (HLS.js 1.4.0、Video.js 8.0 など)
+ 問題が発生するデバイスとブラウザの情報

**関連するトピック:**
+ 運用セットアップとトラブルシューティングの準備については、「」を参照してください。 [CDN 統合のトラブルシューティング](#cdn-troubleshooting)
+ ログ分析とエラーコードリファレンスについては、「」を参照してください。 [CDN 統合ログ分析リファレンス](cdn-log-error-reference.md)
+ エスカレーションと追加のヘルプについては、「」を参照してください。 [CDN 統合のサポートを受ける](cdn-get-help.md)

## トラブルシューティングの準備
<a name="troubleshooting-preparation"></a>

CDN 統合の問題が発生した場合のトラブルシューティングを簡素化するためのツールとプロセスを設定します。プロアクティブ準備により、問題発生時のトラブルシューティングを迅速かつ効果的に行うことができます。

### 包括的なログ記録を有効にする
<a name="enable-comprehensive-logging"></a>

詳細なログは、CDN 統合の問題の診断に不可欠です。トラブルシューティング中に必要な情報をキャプチャするようにログ記録を設定します。

1. 詳細な CDN アクセスログを有効にします。
   + MediaTailor リクエストを処理するすべてのキャッシュ動作のログ記録を設定する
   + ログエントリにクエリ文字列とカスタムヘッダーを含める
   + パターンと異常を特定するためのログ分析ツールを設定する
   + ライブイベント中に問題をすぐに検出するためのリアルタイムログを有効にする
   + 履歴トラブルシューティングデータを維持するようにログ保持ポリシーを設定する

1. MediaTailor ログ記録を設定します。
   + MediaTailor 設定のアクセスログを有効にする
   + 一元的なログ管理のために CloudWatch ロググループを設定する
   + エラーパターンを識別するようにログフィルターを設定する

1. オリジンサーバーのログ記録を設定します。
   + コンテンツオリジンサーバーで詳細なアクセスログを有効にする
   + ログにリクエストヘッダーとレスポンスコードを含める
   + オリジンサーバーのパフォーマンスメトリクスをモニタリングする

### 診断リクエストヘッダーを追加する
<a name="add-diagnostic-headers"></a>

カスタムヘッダーは、CDN を介してリクエストを追跡し、ルーティングの問題を特定するのに役立ちます。

1. CDN 診断ヘッダーを設定します。
   + 各リクエストに一意の識別子を追加する (例: `X-Request-ID`)
   + リクエストヘッダーに CDN 固有の情報を含める
   + エッジロケーションまたは POP (ポイントオブプレゼンス) 情報を追加して、地理的ルーティングを追跡する
   + キャッシュ動作分析にキャッシュステータスヘッダー (Hit、Miss、RefreshHit) を含める

1. デバッグ用のレスポンスヘッダーを追加します。
   + サーバー識別ヘッダーを含める
   + パフォーマンス分析のタイミング情報を追加する
   + マニフェストリクエストのキャッシュコントロールヘッダーを含める

### ベースラインパフォーマンスメトリクスを確立する
<a name="establish-baseline-metrics"></a>

通常のパフォーマンス範囲を文書化して、トラブルシューティング中に異常をすばやく特定します。

1. **ベースラインメトリクスを記録します**。
   + さまざまなコンテンツタイプのキャッシュヒット率
   + 応答時間のパーセンタイル (P50、P95, P99)
   + ステータスコード別のエラー率
   + 時刻別のリクエストボリュームパターン

1. 期待される**パフォーマンスを文書化します**。
   + ターゲットキャッシュヒット率 (コンテンツの場合は 95% 以上、広告の場合は 90% 以上)
   + 許容応答時間 (<100ms キャッシュ、<500ms オリジン)
   + 最大許容エラー率 (4xx の場合は <1%、5xx の場合は <0.1%)

1. **パフォーマンスダッシュボードの作成**: ベースライン値と比較した現在のメトリクスを表示するモニタリングダッシュボードを設定します。

### トラブルシューティングツールを準備する
<a name="prepare-troubleshooting-tools"></a>

効果的なトラブルシューティングに必要なツールとアクセス許可を設定します。

1. **コマンドラインツール**:
   + `curl` HTTP リクエストとレスポンスをテストするための
   + `dig` DNS トラブルシューティング`nslookup`用の または
   + マニフェスト検証用の HLS/DASH 検証ツール
   + ログ分析ツール (grep、awk、または特殊なログアナライザー)

1. **アクセス許可**:
   + 設定レビュー用の CDN 管理コンソールアクセス
   + 設定検証のための MediaTailor コンソールアクセス
   + メトリクスとログ分析のための CloudWatch アクセス
   + バックエンドのトラブルシューティングのためのオリジンサーバーアクセス

1. **ドキュメント:**
   + ネットワークアーキテクチャ図
   + CDN と MediaTailor の設定ドキュメント
   + エスカレーション手順の連絡先情報
   + 一般的なシナリオのランブックのトラブルシューティング

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

このユニバーサルトラブルシューティングガイドでは、すべての MediaTailor CDN 統合における一般的な問題について説明します。特定のワークフローまたはサービスに固有の問題については、以下の特殊なトラブルシューティングリソースを参照してください。

サーバー側の広告挿入 (SSAI) のトラブルシューティング  
広告挿入の失敗、広告移行の問題、パーソナライゼーションの問題など、SSAI 固有の問題については、ワークフロー固有の SSAI トラブルシューティングドキュメントを参照してください。  
**SSAI 固有の一般的な問題**:  
+ 広告挿入の失敗と空の広告ブレーク
+ 広告移行のタイミングと同期の問題
+ パーソナライズとターゲティングの問題
+ 広告の追跡と分析の不一致

チャネルアセンブリのトラブルシューティング  
マニフェスト生成の問題やタイムシフト機能などのチャネルアセンブリ固有の問題については、「チャネルアセンブリワークフロードキュメント」を参照してください。  
**一般的なチャネルアセンブリの問題**:  
+ マニフェスト生成エラーとコンパイルエラー
+ タイムシフトウィンドウと DVR 機能の問題
+ ソースコンテンツの可用性とフェイルオーバーの問題
+ プログラムスケジュールとメタデータの同期

MediaPackage 統合のトラブルシューティング  
マニフェストフィルタリングや EMP エンドポイントの問題など、MediaPackage 固有の問題については、「」を参照してください[CDN 統合のトラブルシューティング](cdn-emp-troubleshooting.md)。  
**MediaPackage 統合の一般的な問題**:  
+ マニフェストフィルタリングパラメータエラー
+ MediaPackage エンドポイントの接続の問題
+ EMP 固有のキャッシュ動作の問題
+ MediaPackage オリジン認証の問題

CloudFront 固有のトラブルシューティング  
CloudFront 固有の設定とセットアップの問題については、CloudFront 統合ドキュメント」を参照してください。  
**CloudFront の一般的な問題**:  
+ ディストリビューション設定とキャッシュ動作の設定
+ オリジンアクセスアイデンティティとセキュリティ設定
+ CloudFront 固有のエラーコードとレスポンス
+ 地理的制限とエッジロケーションの問題

**その他のリソース**:
+ パフォーマンス最適化のガイダンスについては、「」を参照してください。 [CDN パフォーマンスの最適化](cdn-optimization.md)
+ モニタリングとアラートの設定については、「」を参照してください。 [CDN モニタリング](cdn-monitoring.md)
+ 一般的なサポートとサポートについては、「」を参照してください。 [CDN 統合のサポートを受ける](cdn-get-help.md)