本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用偵錯日誌來疑難排解 MediaTailor 廣告插入播放工作階段問題。若要產生偵錯日誌，請將日誌模式設定為玩家對 MediaTailor 的請求中的偵錯。對於伺服器端報告，請在播放請求中設定日誌模式。對於用戶端報告，請在工作階段初始化請求中設定日誌模式。
當日誌模式設定為除錯時，MediaTailor 會將所有日誌事件類型寫入 CloudWatch Logs。日誌提供下列事件的相關資訊。如需偵錯日誌中產生之資料的完整清單，請參閱偵錯日誌欄位。
-
原始伺服器互動 – MediaTailor 與原始伺服器互動的詳細資訊。例如，原始伺服器資訊清單回應、資訊清單類型和原始伺服器 URL。
-
產生的資訊清單 – 從 MediaTailor 播放工作階段回應的詳細資訊。例如，MediaTailor 產生的資訊清單。
-
工作階段初始化 – 工作階段初始化詳細資訊，例如工作階段 ID。
若要自訂每個工作階段收到的日誌事件類型，請參閱 篩選日誌和事件。
先決條件
若要將日誌模式設定為除錯，首先，如果您尚未將日誌傳送至 CloudWatch，您需要授予 MediaTailor 許可。授予 MediaTailor 存取 CloudWatch 的許可後，您就可以啟用偵錯日誌模式。如需如何授予 MediaTailor 存取 CloudWatch 的許可的詳細資訊，請參閱設定 Amazon CloudWatch 的許可。
如何將日誌模式設定為除錯
本節說明如何將日誌模式設定為偵錯伺服器端報告和用戶端報告。
伺服器端報告
對於伺服器端報告，請在播放器播放GET HTTP請求中將?aws.logMode=DEBUG查詢參數和值包含到 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 Logs。如果您在工作階段的 CloudWatch Logs 中看不到偵錯日誌，您可能已達到此限制。若要確認是否已達到限制，請參閱 Verify that the debug log mode is active for your playback session。
偵錯日誌欄位
下表列出 MediaTailor 寫入 CloudWatch 的偵錯日誌欄位。
| 欄位 | 描述 |
|---|---|
awsAccountId |
您的 AWS 帳戶 ID。 |
customerId |
您的 MediaTailor 客戶 ID。 |
eventTimestamp |
與偵錯日誌事件相關聯的 ISO 8601 時間戳記。 |
eventType |
除錯日誌事件的類型。 數值：
|
originRequestUrl |
針對此請求擷取的原始伺服器 URL。 |
mediaTailorPath |
呼叫的 MediaTailor 端點，包括在初始資訊清單請求中傳遞給 MediaTailor 的任何參數。 |
requestId |
MediaTailor 特定 HTTP 請求的 ID。 |
responseBody |
MediaTailor 回應內文中的資訊清單。這是原始原始來源資訊清單或 MediaTailor 產生的資訊清單。 |
sessionId |
播放工作階段 ID。 |
sessionType |
播放工作階段的類型。 值： |
讀取偵錯日誌
MediaTailor 會將偵錯日誌寫入 Amazon CloudWatch Logs。一般 CloudWatch Logs 會收取費用。使用 CloudWatch Insights 讀取偵錯日誌。如需有關如何使用 CloudWatch Logs Insights 的資訊，請參閱《AWS CloudWatch Logs 使用者指南》中的使用 CloudWatch Logs Insights 分析日誌資料。 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"
