MediaPackage、CDN、MediaTailor の統合のトラブルシューティング - AWS Elemental MediaTailor
マニフェストフィルタリングエラー診断手順エラーコードのリファレンスその他のトラブルシューティングリソース

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

MediaPackage、CDN、MediaTailor の統合のトラブルシューティング

AWS Elemental MediaTailor AWS Elemental MediaPackage およびコンテンツ配信ネットワーク (CDN) との統合では、再生、キャッシュ、またはその他の統合機能に影響する一般的な問題が発生する可能性があります。このガイドは、再生の問題、キャッシュの問題、またはその他の統合関連のエラーが発生した場合に使用します。

ユニバーサルキャッシュパフォーマンスの問題、HTTP エラー解決、テスト手順、すべての MediaTailor 実装に適用される診断手法など、包括的な CDN トラブルシューティングガイダンスについては、「」を参照してくださいCDN 統合のトラブルシューティング。このセクションでは、MediaPackage 固有のトラブルシューティング要件に焦点を当てます。

トラブルシューティングを行う前に、基本的な統合設定が正しく完了していることを確認してください。統合をまだセットアップしていない場合、またはセットアップ手順を確認する必要がある場合は、「」を参照してくださいMediaTailor を MediaPackage および CDN と統合する 。問題を解決した後のキャッシュパフォーマンスの最適化に関するガイダンスについては、「」を参照してくださいCDN キャッシュ。

マニフェストフィルタリングエラー

文書化されたエラー条件に基づく MediaPackage マニフェストフィルタリング機能の問題：

マニフェストフィルタリングによる HTTP 400 エラー

症状: aws.manifestfilterパラメータを含むリクエストは HTTP 400 Bad Request を返します

検証済みの原因 (ドキュメントから AWS ）：

  • フィルター条件の結果が空のマニフェストになる (フィルター条件に一致するストリームがない）

  • 無効なフィルターパラメータ名または値

  • 不正な形式のクエリ文字列構文

  • 重複または繰り返されるフィルターパラメータ

  • フィルターパラメータ文字列が 1024 文字を超えています

  • メディアプレイリストまたはセグメントに適用されるクエリパラメータ (サポートされていません）

解決方法

  1. フィルターパラメータを確認して、使用可能なコンテンツストリームと一致することを確認します。フィルタリングの結果に一致するストリームがない場合、MediaPackage は HTTP 400 を返します。

  2. サポートされているパラメータ名と値形式に対してフィルター構文を検証します。

  3. クエリ文字列に重複するパラメータがないか確認します。

  4. フィルターパラメータは、メディアプレイリストやセグメントではなく、多変量プレイリストにのみ適用されます。

  5. 合計パラメータ文字列が 1024 文字未満であることを確認します。

リファレンス: AWS Elemental MediaPackage マニフェストフィルタリングエラー条件

マニフェストフィルタリングが機能しない (HTTP 200 ではあるが、フィルタリングは適用されない）

症状: リクエストは HTTP 200 を返しますが、マニフェストにはフィルタリングされたサブセットではなくすべてのストリームが含まれます

考えられる原因:

  • CDN がaws.manifestfilterクエリパラメータを MediaPackage に転送しない

  • 使用可能なストリームにフィルターパラメータが見つかりません (HTTP 200 でフィルタリングされていないマニフェストを返します）

解決方法

  1. CDN キャッシュポリシーが転送されたクエリ文字列のリストaws.manifestfilterに含まれていることを確認します。

  2. MediaPackage エンドポイントに対して (CDN をバイパスして) フィルターパラメータを直接テストし、期待どおりに動作することを確認します。

  3. フィルター値がコンテンツストリームの実際の特性と一致することを確認します。

リファレンス: AWS Elemental MediaPackage マニフェストフィルタリングエラー条件

診断手順

体系的な診断手順は、統合問題の根本原因を迅速かつ効率的に特定するのに役立ちます。構造化されたアプローチに従うことで、誤った仮定に浪費される時間を防ぎ、症状ではなく実際の問題に対処できます。これらの証拠ベースの診断手順は、問題を分離し、適切なソリューションに導くように設計されています。

以下の証拠ベースの診断手順に従って問題を特定します。

キャッシュのパフォーマンスの分析

EMP 統合ではキャッシュパフォーマンス分析が不可欠です。キャッシュ効率が低いと、オリジンの負荷が増加し、コストが高くなり、再生の問題が発生する可能性があるためです。

キャッシュヒット率分析、キャッシュキーの最適化、体系的な診断手順を含む包括的なキャッシュパフォーマンスのトラブルシューティングについては、メイン CDN トラブルシューティングガイドCDN キャッシュのパフォーマンスの問題の「」を参照してください。

EMP 固有のキャッシュに関する考慮事項：

  • EMP キャッシュコントロールヘッダー: CDN が EMP のキャッシュコントロールヘッダーを上書きするのではなく尊重していることを確認します。

  • EMP クエリパラメータ: 必要な EMP クエリパラメータのみがキャッシュキーに含まれていることを確認します

  • EMP TTL の動作: さまざまな EMP コンテンツタイプに適切なキャッシュ期間があることを確認する

EMP キャッシュポリシーと TTL 設定の最適化に関する詳細なガイダンスについては、「」を参照してくださいMediaTailor および MediaPackage コンテンツ配信の CDN キャッシュを最適化する。

マニフェストフィルタリング設定を検証する

マニフェストフィルタリングの検証は不可欠です。フィルタリングの問題により、ビューワーが誤ったコンテンツ、サポートされていない形式、またはアクセスすべきでないコンテンツを受信する可能性があるためです。体系的なテストは、問題が CDN 設定、フィルターパラメータ構文、またはコンテンツの可用性に関連しているかどうかを特定するのに役立ちます。

マニフェストフィルタリング機能を体系的にテストします。

  1. MediaPackage エンドポイントに対して (CDN をバイパスして) フィルターパラメータを直接テストして、正しく動作することを確認します。

  2. フィルタリングされたマニフェストとフィルタリングされていないマニフェストを比較して、予想されるストリームが含まれているか除外されているかを確認します。

  3. CDN キャッシュポリシーがaws.manifestfilterクエリパラメータを転送することを確認します。

  4. HTTP 400 エラーをチェックし、文書化されたエラー条件と照合します。

問題を解決した後にマニフェストフィルタリングを実装または変更する必要がある場合は、セットアップガイダンスの詳細については、MediaTailor、MediaPackage、CDN でマニフェストフィルタリングを設定する「」を参照してください。

クエリパラメータ設定の検証

CDN が必要なクエリパラメータのみを転送していることを確認します。

  1. CDN キャッシュポリシーを確認して、 AWS 推奨パラメータのみが含まれていることを確認します。

    • aws.manifestfilter - マニフェストフィルタリング用

    • aws.manifestsettings - タイムシフト表示用

    • _HLS_msn LL-HLS サポート用の _HLS_part および -

  2. MediaPackage は他のクエリパラメータを無視し、キャッシュ効率を低下させるため、キャッシュキーから他のクエリパラメータを削除します。

リファレンス: AWS Elemental MediaPackage および CDNsの使用

エラーコードのリファレンス

文書化されたエラー条件とその原因に関するリファレンス：

HTTP 400 不正なリクエスト (マニフェストフィルタリング）

文書化された原因：

  • フィルターを適用すると、空のマニフェストになります。

  • 無効なパラメータ名または値

  • 不正な形式のクエリ文字列構文

  • フィルターパラメータの複製

  • パラメータ文字列が 1024 文字を超えています

  • メディアプレイリストまたはセグメントのクエリパラメータ

リファレンス: MediaPackage マニフェストフィルタリングエラー条件

HTTP 200 OK (フィルタリングは適用されません）

文書化された原因：

  • 使用可能なストリームにフィルターパラメータが見つかりません (フィルタリングされていないマニフェストを返します）

  • フィルタリング後に存在するサブタイトルストリームのみ (フィルタリングされていないマニフェストを返します）

リファレンス: MediaPackage マニフェストフィルタリングエラー条件

その他のトラブルシューティングリソース

このトピックで説明されていない問題については、以下の公式 AWS リソースを参照してください。