本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
產生偵錯記錄檔
使用偵錯記錄檔來排解 MediaTailor 廣告插入播放工作階段問題。要生成調試日誌，請將播放器請求中的日誌模式設置為調試 MediaTailor。對於伺服器端報告，請在播放要求中設定記錄模式。對於用戶端報告，請在工作階段初始化要求中設定記錄模式。
當記錄模式設定為偵錯時， MediaTailor 會將偵錯記錄檔資料寫入 CloudWatch 記錄檔。偵錯記錄檔會提供下列事件的相關資訊。如需偵錯記錄檔中產生之資料的完整清單，請參閱偵錯記錄檔欄位。
-
原始互動 — 與原始伺服器互動 MediaTailor的詳細資訊。例如，來源清單響應，清單類型和來源URL。
-
產生的資訊清單 — 播放工作階段回應的詳細資訊 MediaTailor。例如， MediaTailor 產生的資訊清單。
-
階段作業初始化 — 階段作業初始化詳細資訊，例如階段作業 ID
必要條件
要將日誌模式設置為調試，首先您需要授 MediaTailor 予將日誌發送到的權 CloudWatch限（如果尚未發送）。一旦您授予存 MediaTailor 取權限 CloudWatch，您就可以啟用偵錯記錄模式。有關如何授予存取權限的詳細資訊， CloudWatch 請參閱設定 Amazon 的許 MediaTailor 可 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。
用戶端報告
對於用戶端報告，請在用戶端的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 |
偵錯記錄檔事件的類型。 數值：
|
originRequestUrl |
針對URL此要求擷取的原始伺服器。 |
mediaTailorPath |
呼叫的 MediaTailor 端點，包括在初始資訊清單要求 MediaTailor 中傳遞給的任何參數。 |
requestId |
特定HTTP要求的識別碼 MediaTailor。 |
responseBody |
從響應主體中的清單 MediaTailor。這是原始來源資訊清單或產生的清單 MediaTailor。 |
sessionId |
播放工作階段 ID。 |
sessionType |
播放工作階段的類型。 值： |
閱讀除錯記錄檔
MediaTailor 將偵錯日誌寫入 Amazon CloudWatch 日誌。需支付典型 CloudWatch 記錄費用。使用 CloudWatch 深入解析來讀取偵錯記錄檔。如需有關如何使用 CloudWatch 日誌見解的詳細資訊，請參閱記錄使用指南中的使用 CloudWatch 記錄洞察分析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"
