デバッグログの生成

デバッグログを使用して、 MediaTailor 広告挿入再生セッションの問題をトラブルシューティングします。デバッグログを生成するには、プレイヤーの へのリクエストでデバッグするようにログモードを設定します MediaTailor。サーバー側のレポートの場合は、再生リクエストでログモードを設定します。クライアント側のレポートの場合は、セッション開始リクエストでログモードを設定します。

ログモードがデバッグに設定されている場合、 はデバッグログデータを Logs CloudWatch に MediaTailor 書き込みます。デバッグログは、以下のイベントに関する情報を提供します。デバッグログで生成されるデータの完全なリストについては、「デバッグログのフィールド」を参照してください。

• オリジンインタラクション — MediaTailorオリジンサーバーとの のインタラクションに関する詳細。例えば、オリジンマニフェストレスポンス、マニフェストタイプ、オリジン などですURL。

• 生成されたマニフェスト — からの再生セッションレスポンスに関する詳細 MediaTailor。例えば、 が MediaTailor 生成するマニフェストなどです。

• 開始されたセッション - セッション ID などのセッション開始に関する詳細情報。

前提条件

ログモードをデバッグに設定するには、まず にログを送信する MediaTailor アクセス許可を付与する必要があります CloudWatch。 MediaTailor へのアクセス許可を付与したら CloudWatch、デバッグログモードを有効にする準備が整います。アクセス MediaTailor 許可を付与する方法については、「Amazon のアクセス許可の設定 CloudWatch CloudWatch 」を参照してください。

ログモードをデバッグに設定する方法

このセクションでは、サーバー側のレポートとクライアント側のレポートのログモードをデバッグに設定する方法を説明します。

サーバー側のレポート

サーバー側のレポートの場合は、 HLSまたは DASH MediaTailor エンドポイントへのプレイヤーのGET HTTP再生リクエストに?aws.logMode=DEBUGクエリパラメータと値を含めます。サーバー側のレポートに関する一般情報については、「サーバー側のレポート」を参照してください。

重要

DEBUG 値では、大文字と小文字が区別されます。

?aws.logMode=DEBUG が含まれる再生リクエストは、以下のようになります。

例 HLS エンドポイントへの再生リクエスト

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

ログモードをデバッグに設定した後は、デバッグログセッションがアクティブであることを確認することが推奨されます。デバッグセッションがアクティブであることを確認するには、セッション ID の CloudWatch ログがあるかどうかを確認します。セッション ID は、 が提供する MediaTailor再生エンドポイントに含まれます。詳細については、「Verify that the debug log mode is active for your playback session」を参照してください。

クライアント側のレポート

クライアント側のレポートの場合は、/v1 MediaTailor /session エンドポイントへのクライアントのPOST HTTPセッション初期化リクエスト本文にlogModeキーとDEBUG値を含めます。クライアント側のレポートに関する一般情報については、「クライアント側のレポート」を参照してください。

重要

DEBUG 値では、大文字と小文字が区別されます。

ログモードをデバッグに設定した後は、デバッグセッションがアクティブであることを確認することが推奨されます。デバッグセッションがアクティブであることを確認するには、 CloudWatch ログにセッション ID に関連付けられたSESSION_INITIALIZEDイベントがあることを確認します。セッション ID は、 MediaTailor が提供する再生エンドポイントに含まれています。詳細については、「Verify that the debug log mode is active for your playback session」を参照してください。

アクティブなデバッグセッションの最大数

アクティブなデバッグログセッションは、最大 10 個まで設定できます。プレイヤーがセッションの初期化または再生リクエストを に送信すると MediaTailor、 MediaTailor は制限に達したかどうかを確認します。存在する場合は、古いセッションがあるかどうか MediaTailor をチェックします。セッションは、一定期間内にアクセスされなかった場合に古いと見なされます。ライブストリームの場合、この期間は 10 分、ストリームの場合 VOD 30 分です。

アクティブなデバッグログセッションの最大数に達した場合、デバッグログはセッションの CloudWatch ログに書き込まれません。セッションの CloudWatch ログにデバッグログが表示されない場合は、この制限に達した可能性があります。制限に到達したかどうかを確認するには、「Verify that the debug log mode is active for your playback session」を参照してください。

デバッグログのフィールド

次の表に、 が に MediaTailor 書き込むデバッグログフィールドを示します CloudWatch。

フィールド	説明
awsAccountId	の AWS アカウント ID。
customerId	MediaTailor 顧客 ID。
eventTimestamp	デバッグログイベントに関連付けられた ISO 8601 タイムスタンプ。
eventType	デバッグログイベントのタイプ。 値: ORIGIN_INTERACTION - MediaTailorオリジンサーバーとの のインタラクションに関する詳細。例えば、オリジンマニフェストレスポンス、マニフェストタイプ、オリジン などですURL。 GENERATED_MANIFEST – からの再生セッションレスポンスに関する詳細 MediaTailor。例えば、 が生成する MediaTailorマニフェストです。 SESSION_INITIALIZED - セッション ID などのセッション開始に関する詳細情報。
originRequestUrl	このリクエストに対して取得されるURLオリジンサーバーの 。
mediaTailorPath	最初のマニフェストリクエスト MediaTailor で に渡されたパラメータを含む、呼び出された MediaTailor エンドポイント。
requestId	への特定のHTTPリクエストの ID MediaTailor。
responseBody	からのレスポンス本文のマニフェスト MediaTailor。これは raw オリジンマニフェストまたは によって生成されたマニフェストのいずれかです MediaTailor。
sessionId	再生セッション ID。
sessionType	再生セッションのタイプ。 値: HLS、DASH

デバッグログを読み取る

MediaTailor はデバッグログを Amazon CloudWatch Logs に書き込みます。一般的な CloudWatch ログ料金が適用されます。 CloudWatch Insights を使用してデバッグログを読み取ります。 CloudWatch Logs Insights の使用方法については、「 Logs ユーザーガイド」の CloudWatch 「Logs Insights を使用したログデータの分析」を参照してください。 AWS CloudWatch

注記

デバッグログが に表示されるまでに数分かかる場合があります CloudWatch。ログが表示されない場合は、数分待ってから再試行してください。それでもログが表示されない場合は、アクティブなデバッグログセッションの最大数に到達している可能性があります。これが当てはまるかどうかを確認するには、 CloudWatch クエリを実行して、再生セッション用に初期化されたデバッグセッションがあったかどうかを確認します。詳細については、「Verify that the debug log mode is active for your playback session」を参照してください。

例

このセクションでは、 MediaTailor デバッグログデータの読み取りに使用できるクエリの例を示します。

例 1: 再生セッションのデバッグログモードがアクティブであることを確認する

fields @timestamp, @message
 | filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
 | filter eventType = "SESSION_INITIALIZED" # client-side reporting
 or mediaTailorPath like “/v1/master" # server-side reporting HLS
 or mediaTailorPath like “/v1/dash" # server-side reporting DASH

例 2: オリジンからのレスポンスを表示する

fields @timestamp, responseBody, @message, mediaTailorPath
 | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"

例 3: 特定のセッション MediaTailor で によって生成されたマニフェストを表示する

fields @timestamp, responseBody, @message
 | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"

例 4: 所定の requestId に関するすべてのイベントを表示する

このクエリを使用して、オリジンマニフェストと によって生成されたマニフェストを表示します MediaTailor。

fields @timestamp, responseBody, @message, mediaTailorPath
 | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"