故障排除返回的回放錯誤MediaTailor - AWS Elemental MediaTailor

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

故障排除返回的回放錯誤MediaTailor

此小節提供有關測試播放器軟體時和播放器請求的一般處理期間可能會收到的 HTTP 錯誤代碼的資訊。

注意

您也可能從 AWS Elemental 收到錯誤MediaTailorAPI,在配置操作期間,如PutPlaybackConfigurationGetPlaybackConfiguration。如需有關這些錯誤類型的詳細資訊,請參AWS ElementalMediaTailorAPI 參考

當您的玩家向 AWS Elemental 發送請求時MediaTailor,無論是直接或通過 CDN,MediaTailor回應狀態碼。如果 MediaTailor 成功處理該請求,它會傳回 HTTP 狀態碼 200 OK,指出成功,以及填入的資訊清單。如果請求未成功,MediaTailor 會傳回 HTTP 狀態碼、例外狀況名稱和錯誤訊息。

AWS ElementalMediaTailor會傳回兩個類型的錯誤:

  • 客戶端錯誤— 通常是因為請求本身的問題造成的錯誤,例如格式錯誤的請求、參數無效或 URL 錯誤。這些錯誤會有 HTTP 4xx 回應代碼。

  • 伺服器錯誤— 通常由MediaTailor或其相依性 (例如廣告決策伺服器 (ADS) 或原始伺服器)。這些錯誤會有 HTTP 5xx 回應代碼。

AWS 元素返回的客户端播放錯誤MediaTailor

一般指導:

  • 您可以在響應的標題和正文中找到大多數錯誤的詳細信息。

  • 對於某些錯誤,您需要檢查配置設置。您可以從 AWS 元素中檢索播放配置的設置MediaTailor。對於 API,資源為GetPlaybackConfiguration/Name。如需詳細資訊,請參AWS ElementalMediaTailorAPI 參考

下表列出 AWS Elemental 的清單操作活動傳回的用户端錯誤代碼MediaTailor、可能的原因,以及您可以採取以便解決問題的動作。

Code 例外名稱 意義 處理方式
400 BadRequestException 由於格式或內容中的一或多個錯誤,MediaTailor 無法為請求提供服務。參數的格式可能錯誤,或是請求可能包含無效的播放組態或工作階段 ID。 確認您的請求格式正確,並包含準確的資訊。確定播放器上的播放端點設定符合 GetPlaybackConfiguration 傳回的 ManifestEndpointPrefix 設定。重試您的請求。
403 AccessDeniedException 請求中提供的主機標頭不符合 MediaTailor 播放 URL 中設定的資訊清單端點字首。您的 CDN 可能設定錯誤。 檢查您的 CDN 設定,並確定您對 MediaTailor 使用正確的資訊清單端點字首。重試您的請求。
404 NotFoundException MediaTailor 找不到指定的資訊。可能的原因包括 URL 未對應到服務中的任何項目、組態未定義,或工作階段不可用。 檢查您的組態與請求的有效性,然後重新初始化工作階段。
409 ConflictException 播放器嘗試對單一工作階段同時載入多個播放清單。因此,MediaTailor 會偵測到工作階段一致性衝突。HLS 播放器會發生此問題。 確定您的播放器一次請求一個播放清單。這會符合 HLS 規格。
410 Gone 同時AWSSupport 操作員已封鎖播放器工作階段或客户配置。AWS在極少數的情況下,當我們偵測到非常大量的 4xx 請求來自單一工作階段或組態的錯誤流量時, 支援會執行此動作。 如果您認為不應封鎖此請求,請聯絡AWS Support。他們可以調查此情況,並在適當時移除封鎖篩選。

如果您需要進一步的協助,請聯絡AWS Support

AWS 元素返回的服務器播放錯誤MediaTailor

一般指導:

  • 您可以在響應的標題和正文中找到大多數錯誤的詳細信息。

  • 對於某些錯誤,您需要檢查配置設置。您可以從 AWS 元素中檢索播放配置的設置MediaTailor。對於 API,資源為GetPlaybackConfiguration/Name。如需詳細資訊,請參AWS ElementalMediaTailorAPI 參考

下表列出 AWS Elemental 的清單操作活動傳回的伺服器錯誤代碼MediaTailor、可能的原因,以及您可以採取以便解決問題的動作。

Code 例外名稱 意義 處理方式
500 InternalServiceError 未處理的例外。 重試請求。如果問題仍存在,請檢查MediaTailor為您的AWS區域位於http://status.aws.amazon.com/
502 BadGatewayException 原始伺服器地址或廣告決策伺服器 (ADS) 地址無效。無效地址的範例為私有 IP 地址和 localhost 請確定您的組態具有 ADS 和原始伺服器的正確設定,然後重試請求。
502 UnsupportedManifestException 可能原始伺服器資訊清單已變更,使得 MediaTailor 無法將它個人化,或是 MediaTailor 不支援原始伺服器的資訊清單格式。 這可能只會影響個別工作階段。重新初始化工作階段。您一般可以透過在檢視器中重新整理頁面來達成此目標。如果問題仍存在,請確認 MediaTailor 支援原始伺服器的資訊清單格式。如需相關資訊,請參閱集成內容來源
503 LoadShed 為您的請求提供服務時,MediaTailor 遇到資源限制。 重試請求。如果問題仍存在,請檢查MediaTailor為您的AWS區域位於http://status.aws.amazon.com/
503 ThrottlingException 您的每秒交易次數已達到您的配額,且 MediaTailor 正在調節您的使用。 重試請求。您還可以檢查MediaTailor為您的AWS區域位於http://status.aws.amazon.com/。您可能想要提高每秒交易次數的配額。如需詳細資訊,請參閱 廣告插入配額
504 GatewayTimeoutException MediaTailor 聯絡原始伺服器時發生逾時。 重試請求。如果問題仍存在,請檢查原始伺服器的運作狀態,並確保在原始伺服器在 廣告插入配額 中所列的內容原始伺服器逾時內回應。

如果您需要進一步的協助,請聯絡AWS Support

播放錯誤範例

本節列出一些您可能會在與 AWS Elemental 的交互的命令行中看到的播放錯誤範例MediaTailor。

以下範例顯示 AWS Elemental 之間發生超時時的結果MediaTailor以及廣告決策伺服器 (ADS) 或原始伺服器)。

~[]> curl -vvv https://111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com/v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd * Trying 54.186.133.224... * Connected to 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com (11.222.333.444) port 555 (#0) * TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 * Server certificate: mediatailor.us-west-2.amazonaws.com * Server certificate: Amazon * Server certificate: Amazon Root CA 1 * Server certificate: Starfield Services Root Certificate Authority - G2 > GET /v1/master/123456789012/Multiperiod_DASH_Demo/index.mpd HTTP/1.1 > Host: 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com > User-Agent: curl/7.43.0 > Accept: */* > < HTTP/1.1 504 Gateway Timeout < Date: Thu, 29 Nov 2018 18:43:14 GMT < Content-Type: application/json < Content-Length: 338 < Connection: keep-alive < x-amzn-RequestId: 123456789012-123456789012 < x-amzn-ErrorType: GatewayTimeoutException:http://internal.amazon.com/coral/com.amazon.elemental.midas.mms.coral/ < * Connection #0 to host 111122223333444455556666123456789012.mediatailor.us-west-2.amazonaws.com left intact {"message":"failed to generate manifest: Unable to obtain template playlist. origin URL:[https://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/444455556666111122223333/index.mpd], asset path: [index.mpd], sessionId:[123456789012123456789012] customerId:[123456789012]"}%