本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
針對 MediaPackage、CDN 和 MediaTailor 整合進行故障診斷
AWS Elemental MediaTailor 與 AWS Elemental MediaPackage 和 內容交付網路 (CDN) 的整合可能會遇到影響播放、快取或其他整合功能的常見問題。當您遇到播放問題、快取問題或其他與整合相關的錯誤時,請使用本指南。
如需全面 CDN 故障診斷指引,包括通用快取效能問題、HTTP 錯誤解決、測試程序和適用於所有 MediaTailor 實作的診斷技術,請參閱 故障診斷 CDN 整合。本節著重於 MediaPackage 特定的疑難排解需求。
在疑難排解之前,請確定您已正確完成基本整合設定。如果您尚未設定整合,或需要檢閱設定步驟,請參閱 整合 MediaTailor 與 MediaPackage 和 CDN 。如需在解決問題後最佳化快取效能的指引,請參閱 CDN 快取。
資訊清單篩選錯誤
根據記錄的錯誤條件,MediaPackage 資訊清單篩選功能的問題:
- 具有資訊清單篩選的 HTTP 400 錯誤
-
症狀:具有
aws.manifestfilter
參數的請求會傳回 HTTP 400 錯誤請求驗證原因 (來自 AWS 文件):
-
篩選條件會產生空白資訊清單 (沒有串流符合篩選條件)
-
無效的篩選條件參數名稱或值
-
格式錯誤的查詢字串語法
-
重複或重複的篩選條件參數
-
篩選條件參數字串超過 1024 個字元
-
套用至媒體播放清單或客群的查詢參數 (不支援)
解決方案:
-
檢閱您的篩選條件參數,以確保它們符合可用的內容串流。如果篩選導致沒有相符的串流,MediaPackage 會傳回 HTTP 400。
-
根據支援的參數名稱和值格式驗證篩選條件語法。
-
檢查查詢字串中是否有重複的參數。
-
確保篩選條件參數僅套用至多變量播放清單,而非媒體播放清單或區段。
-
確認您的總參數字串少於 1024 個字元。
-
- 資訊清單篩選無法運作 (HTTP 200 但未套用篩選)
-
症狀:請求傳回 HTTP 200,但資訊清單包含所有串流,而不是篩選子集
可能原因:
-
CDN 未轉送
aws.manifestfilter
查詢參數至 MediaPackage -
在可用串流中找不到篩選條件參數 (傳回 HTTP 200 的未篩選資訊清單)
解決方案:
-
確認您的 CDN 快取政策
aws.manifestfilter
包含在轉送的查詢字串清單中。 -
直接針對 MediaPackage 端點 (繞過 CDN) 測試篩選條件參數,以驗證它們是否如預期般運作。
-
檢查篩選條件值是否符合內容串流的實際特性。
-
診斷程序
系統化診斷程序可協助您快速且有效率地識別整合問題的根本原因。遵循結構化方法可避免浪費時間在不正確的假設上,並確保您解決實際的問題,而不是症狀。這些以證據為基礎的診斷步驟旨在隔離問題,並引導您找到適當的解決方案。
請依照這些以證據為基礎的診斷步驟來識別問題:
分析快取效能
快取效能分析對於 EMP 整合至關重要,因為快取效率不佳會導致原始伺服器負載增加、成本增加和潛在的播放問題。
如需全面的快取效能疑難排解,包括快取命中率分析、快取金鑰最佳化和系統診斷步驟,請參閱主要 CDN 疑難排解指南CDN 快取效能問題中的 。
EMP 特定的快取考量事項:
-
EMP 快取控制標頭:確認您的 CDN 遵守 EMP 的快取控制標頭,而不是覆寫它們
-
EMP 查詢參數:確保快取金鑰中僅包含必要的 EMP 查詢參數
-
EMP TTL 行為:確認不同的 EMP 內容類型具有適當的快取持續時間
如需最佳化 EMP 快取政策和 TTL 設定的詳細指引,請參閱 最佳化 MediaTailor 和 MediaPackage 內容交付的 CDN 快取。
驗證資訊清單篩選組態
資訊清單篩選驗證至關重要,因為篩選問題可能會導致瀏覽者收到不正確的內容、不支援的格式或他們不應存取的內容。系統化測試有助於識別問題是否與 CDN 組態、篩選條件參數語法或內容可用性相關。
有系統地測試資訊清單篩選功能:
-
直接針對 MediaPackage 端點 (繞過 CDN) 測試篩選條件參數,以驗證它們是否正常運作。
-
比較篩選和未篩選的資訊清單,以確認包含/排除預期的串流。
-
確認您的 CDN 快取政策轉送
aws.manifestfilter
查詢參數。 -
檢查 HTTP 400 錯誤,並根據記錄的錯誤條件進行比對。
如果您需要在解決問題後實作或修改資訊清單篩選,請參閱 使用 MediaTailor、MediaPackage 和 CDN 設定資訊清單篩選 以取得完整的設定指引。
驗證查詢參數組態
確保您的 CDN 僅轉送必要的查詢參數:
-
檢閱您的 CDN 快取政策以確認其僅包含 AWS 建議的參數:
-
aws.manifestfilter
- 用於資訊清單篩選 -
aws.manifestsettings
- 用於時間轉移檢視 -
_HLS_msn
和_HLS_part
- 適用於 LL-HLS 支援
-
-
從快取金鑰移除任何其他查詢參數,因為 MediaPackage 會忽略它們並降低快取效率。
參考:使用 AWS Elemental MediaPackage 和 CDN CDNs
錯誤碼參考
記載錯誤條件及其原因的參考:
- HTTP 400 錯誤請求 (資訊清單篩選)
-
記錄的原因:
-
套用篩選條件會導致空白資訊清單
-
無效的參數名稱或值
-
格式錯誤的查詢字串語法
-
重複的篩選條件參數
-
參數字串超過 1024 個字元
-
媒體播放清單或客群上的查詢參數
-
- HTTP 200 OK (未套用篩選)
-
記錄的原因:
-
在可用串流中找不到篩選條件參數 (傳回未篩選的資訊清單)
-
只有篩選後存在的字幕串流 (傳回未篩選的資訊清單)
-
其他疑難排解資源
對於本主題未涵蓋的問題,請參閱下列官方 AWS 資源:
-
從 預覽資訊清單 AWS Elemental MediaPackage - 使用資訊清單預覽來疑難排解內容封裝問題
-
提高 CloudFront 快取命中率 - CDN 快取最佳化的完整指南
-
資訊清單篩選 - MediaPackage 篩選功能的完整指南