產生偵錯記錄檔

使用偵錯記錄檔來排解 MediaTailor 廣告插入播放工作階段問題。要生成調試日誌，請將播放器請求中的日誌模式設置為調試 MediaTailor。對於伺服器端報告，請在播放要求中設定記錄模式。對於用戶端報告，請在工作階段初始化要求中設定記錄模式。

當記錄模式設定為偵錯時， MediaTailor 會將偵錯記錄檔資料寫入 CloudWatch 記錄檔。偵錯記錄檔會提供下列事件的相關資訊。如需偵錯記錄檔中產生之資料的完整清單，請參閱偵錯記錄檔欄位。

• 原始互動 — 與原始伺服器互動 MediaTailor的詳細資訊。例如，原始資訊清單回應、資訊清單類型和來源 URL。

• 產生的資訊清單 — 來源播放工作階段回應的詳細資 MediaTailor訊 例如， MediaTailor 產生的資訊清單。

• 階段作業初始化 — 階段作業初始化詳細資訊，例如階段作業 ID

必要條件

要將日誌模式設置為調試，首先您需要授 MediaTailor 予將日誌發送到的權 CloudWatch限（如果尚未發送）。一旦您授予存 MediaTailor 取權限 CloudWatch，您就可以啟用偵錯記錄模式。有關如何授予存取權限的詳細資訊， CloudWatch 請參閱設定 Amazon 的許 MediaTailor 可 CloudWatch。

如何將日誌模式設置為調試

本節說明如何將記錄模式設定為偵錯伺服器端報表和用戶端報告。

伺服端報告

對於伺服器端報告，請將?aws.logMode=DEBUG查詢參數和值包含在GET HTTP播放程式對 HLS 或 DASH MediaTailor 端點的播放請求中。如需伺服器端報表的一般資訊，請參閱伺服器端

重要

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。

用戶端報告

對於用戶端報告，請在用戶端的POST HTTP工作階段初始化要求主體中包含logMode金鑰和DEBUG值到 MediaTailor /v1/session 端點。如需用戶端報告的一般資訊，請參閱用戶端報告

重要

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 帳戶 身份證
customerId	您的 MediaTailor 客戶識別碼。
eventTimestamp	與偵錯記錄事件相關聯的 ISO 8601 時間戳記。
eventType	偵錯記錄檔事件的類型。 數值： ORIGIN_INTERACTION— 與原始伺服器互動 MediaTailor的詳細資訊。例如，原始資訊清單回應、資訊清單類型和來源 URL。 GENERATED_MANIFEST— 有關來源播放工作階段回應的詳細資訊 MediaTailor。例如， MediaTailor產生的資訊清單。 SESSION_INITIALIZED— 工作階段初始化詳細資料，例如工作階段 ID。
originRequestUrl	針對此要求擷取的原始伺服器 URL。
mediaTailorPath	呼叫的 MediaTailor 端點，包括在初始資訊清單要求 MediaTailor 中傳遞給的任何參數。
requestId	特定 HTTP 要求的識別碼 MediaTailor。
responseBody	從響應主體中的清單 MediaTailor。這是原始來源資訊清單或產生的資訊清單 MediaTailor。
sessionId	播放工作階段 ID。
sessionType	播放工作階段的類型。 值：HLS、DASH

閱讀除錯記錄檔

MediaTailor 將偵錯日誌寫入 Amazon CloudWatch 日誌。需支付典型 CloudWatch 記錄費用。使用 CloudWatch 深入解析來讀取偵錯記錄檔。如需如何使用 CloudWatch 日誌洞見的詳細資訊，請參閱 AWS CloudWatch 日誌使用者指南中的利用日誌洞察分析 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"