針對 MediaPackage、CDN 和 MediaTailor 整合進行故障診斷 - AWS Elemental MediaTailor

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

針對 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 個字元

  • 套用至媒體播放清單或客群的查詢參數 (不支援)

解決方案

  1. 檢閱您的篩選條件參數,以確保它們符合可用的內容串流。如果篩選導致沒有相符的串流,MediaPackage 會傳回 HTTP 400。

  2. 根據支援的參數名稱和值格式驗證篩選條件語法。

  3. 檢查查詢字串中是否有重複的參數。

  4. 確保篩選條件參數僅套用至多變量播放清單,而非媒體播放清單或區段。

  5. 確認您的總參數字串少於 1024 個字元。

參考AWS Elemental MediaPackage 資訊清單篩選錯誤條件

資訊清單篩選無法運作 (HTTP 200 但未套用篩選)

症狀:請求傳回 HTTP 200,但資訊清單包含所有串流,而不是篩選子集

可能原因:

  • CDN 未轉送aws.manifestfilter查詢參數至 MediaPackage

  • 在可用串流中找不到篩選條件參數 (傳回 HTTP 200 的未篩選資訊清單)

解決方案

  1. 確認您的 CDN 快取政策aws.manifestfilter包含在轉送的查詢字串清單中。

  2. 直接針對 MediaPackage 端點 (繞過 CDN) 測試篩選條件參數,以驗證它們是否如預期般運作。

  3. 檢查篩選條件值是否符合內容串流的實際特性。

參考AWS Elemental MediaPackage 資訊清單篩選錯誤條件

診斷程序

系統化診斷程序可協助您快速且有效率地識別整合問題的根本原因。遵循結構化方法可避免浪費時間在不正確的假設上,並確保您解決實際的問題,而不是症狀。這些以證據為基礎的診斷步驟旨在隔離問題,並引導您找到適當的解決方案。

請依照這些以證據為基礎的診斷步驟來識別問題:

分析快取效能

快取效能分析對於 EMP 整合至關重要,因為快取效率不佳會導致原始伺服器負載增加、成本增加和潛在的播放問題。

如需全面的快取效能疑難排解,包括快取命中率分析、快取金鑰最佳化和系統診斷步驟,請參閱主要 CDN 疑難排解指南CDN 快取效能問題中的 。

EMP 特定的快取考量事項:

  • EMP 快取控制標頭:確認您的 CDN 遵守 EMP 的快取控制標頭,而不是覆寫它們

  • EMP 查詢參數:確保快取金鑰中僅包含必要的 EMP 查詢參數

  • EMP TTL 行為:確認不同的 EMP 內容類型具有適當的快取持續時間

如需最佳化 EMP 快取政策和 TTL 設定的詳細指引,請參閱 最佳化 MediaTailor 和 MediaPackage 內容交付的 CDN 快取

驗證資訊清單篩選組態

資訊清單篩選驗證至關重要,因為篩選問題可能會導致瀏覽者收到不正確的內容、不支援的格式或他們不應存取的內容。系統化測試有助於識別問題是否與 CDN 組態、篩選條件參數語法或內容可用性相關。

有系統地測試資訊清單篩選功能:

  1. 直接針對 MediaPackage 端點 (繞過 CDN) 測試篩選條件參數,以驗證它們是否正常運作。

  2. 比較篩選和未篩選的資訊清單,以確認包含/排除預期的串流。

  3. 確認您的 CDN 快取政策轉送aws.manifestfilter查詢參數。

  4. 檢查 HTTP 400 錯誤,並根據記錄的錯誤條件進行比對。

如果您需要在解決問題後實作或修改資訊清單篩選,請參閱 使用 MediaTailor、MediaPackage 和 CDN 設定資訊清單篩選 以取得完整的設定指引。

驗證查詢參數組態

確保您的 CDN 僅轉送必要的查詢參數:

  1. 檢閱您的 CDN 快取政策以確認其僅包含 AWS 建議的參數:

    • aws.manifestfilter - 用於資訊清單篩選

    • aws.manifestsettings - 用於時間轉移檢視

    • _HLS_msn_HLS_part - 適用於 LL-HLS 支援

  2. 從快取金鑰移除任何其他查詢參數,因為 MediaPackage 會忽略它們並降低快取效率。

參考使用 AWS Elemental MediaPackage 和 CDN CDNs

錯誤碼參考

記載錯誤條件及其原因的參考:

HTTP 400 錯誤請求 (資訊清單篩選)

記錄的原因

  • 套用篩選條件會導致空白資訊清單

  • 無效的參數名稱或值

  • 格式錯誤的查詢字串語法

  • 重複的篩選條件參數

  • 參數字串超過 1024 個字元

  • 媒體播放清單或客群上的查詢參數

參考MediaPackage 資訊清單篩選錯誤條件

HTTP 200 OK (未套用篩選)

記錄的原因

  • 在可用串流中找不到篩選條件參數 (傳回未篩選的資訊清單)

  • 只有篩選後存在的字幕串流 (傳回未篩選的資訊清單)

參考MediaPackage 資訊清單篩選錯誤條件

其他疑難排解資源

對於本主題未涵蓋的問題,請參閱下列官方 AWS 資源: