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

# 接收 AWS Elemental MediaTailor 頻道組件提醒
<a name="channel-assembly-alerts"></a>

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

您可以使用 MediaTailor ListAlerts API，以程式設計方式檢視 AWS 管理主控台、 AWS Command Line Interface (AWS CLI) AWS SDKs 中的提醒。 [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html) 

**重要**  
提醒僅適用於 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 秒的區段。這可能會導致播放期間停滯、字幕遺失或不正確，以及無法插入廣告。 / **備註:** 您的資訊清單包含大於 30 秒的區段。
  - **警示代碼:** TARGET\_DURATION\_MISMATCH / **提醒訊息:** MediaTailor 從 {{url}} 剖析資訊清單時，遇到跨 HLS 資訊清單EXT-X-TARGETDURATION的值不相符的問題。這可能會導致播放期間停滯。 / **備註:** 目標持續時間與來源中的所有資訊清單不相符。

- **來源位置**
  - **警示代碼:** NOT\_PROCESSED
  - **提醒訊息:** MediaTailor 尚未處理資源 {{resourceName}}。
  - **備註:** 

- **節目**
  - **警示代碼:** VOD\_SOURCE\_ALERT / **提醒訊息:** 此程式中的 VOD 來源 {{vodSourceName}} 具有下列提醒：{{vodSourceAlertCode}}： {{vodSourceAlertMessage}} / **備註:** 
  - **警示代碼:** SOURCE\_LOCATION\_ALERT / **提醒訊息:** 此程式中包含的來源位置 {{sourceLocationName}} 具有下列提醒：{{sourceLocationAlertCode}}：{{sourceLocationAlertMessage}} / **備註:** 
  - **警示代碼:** CODEC\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中遇到不相符的轉碼器。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** RESOLUTION\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中遇到不相符的解析度。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** BANDWIDTH\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中遇到不相符的頻寬。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** FRAMERATE\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中遇到不相符的影格率。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** TARGET\_DURATION\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中跨 HLS 資訊清單遇到不相符EXT-X-TARGETDURATION的值。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** SEGMENT\_DURATION\_MISMATCH / **提醒訊息:** MediaTailor 在 {{channelName}} 排程中跨資訊清單遇到不相符的區段持續時間值。在 {{programName1}} 的資訊清單{{manifestUrl}} 和 {{programName2}} 的資訊清單Url 之間，不相符的 {{sourceGroupName}}。 {{manifestUrl}} / **備註:** 
  - **警示代碼:** NO\_COMMON\_SEGMENT\_BOUNDARY\_FOR\_AD\_SLATE / **提醒訊息:** MediaTailor 無法在 {{programName}} 的位{{offsetMillis}}廣告場記板。廣告場的開始時間沒有常見的區段界限。 / **備註:** 
  - **警示代碼:** NOT\_PROCESSED / **提醒訊息:** MediaTailor 尚未處理資源 {{resourceName}}。 / **備註:** 
  - **警示代碼:** TOO\_MANY\_ALERTS / **提醒訊息:** MediaTailor 發現太多提醒，而且不會再為 {{programName}} 提供提醒。清除現有的提醒，以繼續接收 {{programName}} 的提醒。 / **備註:** 

- **Channel**
  - **警示代碼:** PROGRAM\_ALERT
  - **提醒訊息:** 此頻道中包含的 {{programName}} 具有下列提醒：{{programAlertCode}}：{{programAlertMessage}}
  - **備註:** 



## 故障診斷資訊清單相關提醒
<a name="channel-assembly-troubleshooting-manifest-alerts"></a>

當您遇到資訊清單相關警示，例如 `UNPARSABLE_MANIFEST`、 或 `VARIANT_DURATION_MISMATCH`時`TARGET_DURATION_MISMATCH`，請檢查下列項目：

1. **驗證來源需求**：確保您的內容符合 中概述的要求[整合 MediaTailor 廣告插入的內容來源](integrating-origin.md)。

1. **檢查資訊清單日誌**：如需詳細的資訊清單錯誤分析和事件類型，請參閱 [AWS Elemental MediaTailor 資訊清單日誌描述和事件類型](log-types.md)。

1. **檢查錯誤代碼**：如需詳細的錯誤分析，請參閱 [故障診斷 MediaTailor](troubleshooting.md)。

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

## 檢視提醒
<a name="channel-assembly-viewing-alerts-procedure"></a>

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

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

------
#### [ Console ]

**在主控台中檢視提醒**

1. 在 https：//[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) 開啟 MediaTailor 主控台。

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

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

------
#### [ AWS Command Line Interface (AWS CLI) ]

若要列出頻道組件資源的提醒，您需要資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。您可以使用 AWS Command Line Interface (AWS CLI) 中的 `describe-{{resource_type}}`命令來取得資源的 ARN。例如，執行 [describe-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/describe-channel.html) 命令以取得特定頻道的 ARN：

```
aws mediatailor describe-channel --channel-name {{MyChannelName}}
```

然後使用 [aws mediatailor list-alerts](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/list-alerts.html) 命令列出與資源相關聯的提醒：

```
aws mediatailor list-alerts --resource-arn arn:aws:mediatailor:{{region}}:{{aws-account-id}}:{{resource-type}}/{{resource-name}}
```

------
#### [ API ]

若要列出頻道組件資源的提醒，您需要資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。您可以使用 MediaTailor API 中的 `Describe{{Resource}}`操作來取得資源的 ARN。例如，使用 [DescribeChannel](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DescribeChannel.html) 操作來取得特定頻道的 ARN。

然後使用 [ListAlerts](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_ListAlerts.html) API 列出資源的提醒。

------

## 處理提醒
<a name="channel-assembly-handling-alerts"></a>

警示發生時，請在 中檢視警示 AWS 管理主控台，或使用 AWS Command Line Interface (AWS CLI)、 AWS SDKs或 MediaTailor 警示 API 來判斷問題的可能來源。

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