接收 AWS Elemental MediaTailor 頻道組件提醒 - AWS Elemental MediaTailor

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

接收 AWS Elemental MediaTailor 頻道組件提醒

MediaTailor 會針對頻道組件資源發生的問題或潛在問題建立提醒。提醒會說明問題、問題發生的時間,以及受影響的資源。

您可以使用 MediaTailor ListAlerts API,以程式設計方式檢視 AWS Management Console、 AWS Command Line Interface (AWS CLI) AWS SDKs 中的提醒。 ListAlerts

重要

提醒僅適用於 2021 年 7 月 14 日當天或之後建立的頻道組件資源。

頻道組件提醒
提醒類型 警示代碼 提醒訊息 備註
VOD 來源 NOT_PROCESSED MediaTailor 尚未處理套件configurationPath
UNREACHABLE 我們無法連線到 URL URL URL URL URL。
UNAUTHORIZED url 未授權請求。
TIMEOUT URL 的連線逾時。
UNPARSABLE_MANIFEST MediaTailor 從 url 剖析資訊清單時遇到問題。
VARIANT_DURATION_MISMATCH MediaTailor 從 url 剖析資訊清單時遇到總持續時間不相符的變體。這可能會導致播放期間停滯。 您的資訊清單在變體/代表之間具有不同的持續時間。這可能會導致字幕遺失或不正確,以及 MediaTailor 無法插入廣告。
SEGMENT_DURATION_TOO_LONG MediaTailor 從 url 剖析資訊清單時遇到持續時間大於三十秒的區段。這可能會導致播放期間停滯、字幕遺失或不正確,以及無法插入廣告。 您的資訊清單包含大於 30 秒的區段。
TARGET_DURATION_MISMATCH MediaTailor 從 url 剖析資訊清單時,遇到跨 HLS 資訊清單EXT-X-TARGETDURATION的值不相符的問題。這可能會導致播放期間停滯。 目標持續時間與來源中的所有資訊清單不相符。
來源位置 NOT_PROCESSED MediaTailor 尚未處理資源 resourceName
節目 VOD_SOURCE_ALERT 此程式中的 VOD 來源 vodSourceName 具有下列提醒:vodSourceAlertCodevodSourceAlertMessage
SOURCE_LOCATION_ALERT 此程式中包含的來源位置 sourceLocationName 具有下列提醒:sourceLocationAlertCodesourceLocationAlertMessage
CODEC_MISMATCH MediaTailor 在 channelName 排程中遇到不相符的轉碼器。在 programName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間,不相符的 sourceGroupName
RESOLUTION_MISMATCH MediaTailor 在 channelName 排程中遇到不相符的解析度。在 programName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間,不相符的 sourceGroupName
BANDWIDTH_MISMATCH MediaTailor 在 channelName 排程中遇到不相符的頻寬。在 programName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間,不相符的 sourceGroupName
FRAMERATE_MISMATCH MediaTailor 在 channelName 排程中遇到不相符的影格率。programNameprogramName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間的 sourceGroupName 不相符。
TARGET_DURATION_MISMATCH MediaTailor 在 channelName 排程中跨 HLS 資訊清單遇到不相符EXT-X-TARGETDURATION的值。programNameprogramName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間的 sourceGroupName 不相符。
SEGMENT_DURATION_MISMATCH MediaTailor 在 channelName 排程中跨資訊清單遇到不相符的區段持續時間值。programNameprogramName1 的資訊清單manifestUrlprogramName2 的資訊manifestUrl 之間的 sourceGroupName 不相符。
NO_COMMON_SEGMENT_BOUNDARY_FOR_AD_SLATE MediaTailor 無法在 programName 的位offsetMillis廣告場記板。廣告場的開始時間沒有常見的區段界限。
NOT_PROCESSED MediaTailor 尚未處理資源 resourceName
TOO_MANY_ALERTS MediaTailor 發現太多提醒,而且不會再為 programName 提供提醒。清除現有的提醒,以繼續接收 programName 的提醒。
頻道 PROGRAM_ALERT 此頻道中包含的 programName 具有下列提醒:programAlertCodeprogramAlertMessage

故障診斷資訊清單相關警示

當您遇到資訊清單相關警示,例如 UNPARSABLE_MANIFEST、 或 VARIANT_DURATION_MISMATCHTARGET_DURATION_MISMATCH,請檢查下列項目:

  1. 驗證來源需求:確保您的內容符合 中概述的要求整合 MediaTailor 廣告插入的內容來源

  2. 檢查資訊清單日誌:如需詳細的資訊清單錯誤分析和事件類型,請參閱 AWS Elemental MediaTailor 資訊清單日誌描述和事件類型

  3. 檢查錯誤代碼:如需詳細的錯誤分析,請參閱 故障診斷 MediaTailor

  4. 檢閱資訊清單格式:確認您的資訊清單遵循串流通訊協定 (HLS 或 DASH) 的正確格式規格。

檢視提醒

您可以檢視任何 MediaTailor 頻道組件資源的提醒。當您檢視頻道和節目的提醒時,MediaTailor 會包含頻道或節目中包含的所有相關資源。例如,當您檢視特定程式的提醒時,也會看到程式包含的來源位置和 VOD 來源的提醒。

若要檢視提醒,請執行下列程序。

Console
在主控台中檢視提醒
  1. 在 https://https://console.aws.amazon.com/mediatailor/ 開啟 MediaTailor 主控台。

  2. 選擇您要檢視提醒的資源。

  3. 選取提醒索引標籤以檢視提醒。

AWS Command Line Interface (AWS CLI)

若要列出頻道組件資源的提醒,您需要資源的 Amazon Resource Name (ARN)。您可以使用 AWS Command Line Interface (AWS CLI) 中的 describe-resource_type命令來取得資源的 ARN。例如,執行 describe-channel 命令以取得特定頻道的 ARN:

aws mediatailor describe-channel --channel-name MyChannelName

然後使用 aws mediatailor list-alerts 命令列出與資源相關聯的提醒:

aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:region:aws-account-id:resource-type/resource-name
API

若要列出頻道組件資源的提醒,您需要資源的 Amazon Resource Name (ARN)。您可以使用 MediaTailor API 中的 DescribeResource操作來取得資源的 ARN。例如,使用 DescribeChannel 操作來取得特定頻道的 ARN。

然後使用 ListAlerts API 列出資源的提醒。

處理提醒

警示發生時,請在 中檢視警示 AWS Management Console,或使用 AWS Command Line Interface (AWS CLI)、 AWS SDKs或 MediaTailor 警示 API 來判斷問題的可能來源。

在您解決問題後,MediaTailor 會清除提醒。