本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon CloudWatch Logs 監控頻道
MediaLive 會產生頻道日誌，其中包含頻道中活動的詳細資訊。該日誌提供頻道中發生活動的一系列敘述。當提醒 ([使用 Amazon CloudWatch Events 監控頻道或多工](monitoring-via-cloudwatch.md)) 中提供的資訊不足以解決頻道問題時，這些日誌便很有用。
**Topics**
+ [關於頻道日誌](monitoring-logs-about.md)
+ [啟用頻道編碼器日誌](enabling-disabling-logs.md)
+ [使用日誌](working-with-logs.md)
# 關於頻道日誌
MediaLive 會產生頻道日誌，其中包含頻道中活動的詳細資訊。該日誌提供頻道中發生活動的一系列敘述。當提醒 ([使用 Amazon CloudWatch Events 監控頻道或多工](monitoring-via-cloudwatch.md)) 中提供的資訊不足以解決頻道問題時，這些日誌便很有用。
頻道日誌有兩組：
+ 頻道編碼器日誌。您必須[啟用](enabling-disabling-logs.md)這些日誌。
+ 通道即執行日誌。MediaLive 一律會產生這些日誌。
## 比較日誌類型
**兩種日誌類型中相同的功能**
這兩種類型的日誌都會傳送至 Amazon CloudWatch Logs。您可以使用 CloudWatch Logs 的標準功能來檢視和管理日誌。如需更多資訊，請參閱 [Amazon CloudWatch Logs 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)。
**兩種日誌類型中不同的功能**
下表說明頻道編碼器日誌和頻道執行中日誌之間的差異。
| | 編碼器日誌 | 執行中日誌 |
| --- | --- | --- |
| 建立的觸發條件 | 您必須[啟用這些日誌](enabling-disabling-logs.md)，MediaLive 才能產生它們。 | MediaLive 一律會產生這些日誌。 |
| 詳細資訊層級 | 您可以設定記錄層級來控制所收集的詳細資訊。 | 您無法變更記錄層級。 |
| Cost | 這些日誌會產生費用，這是 Amazon CloudWatch Logs 費用的一部分。請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing/)。刪除頻道後，請記得[移除日誌](working-with-logs.md#manage-log-storage)。 | 這些日誌是免費的。 |
| CloudWatch 日誌串流 | 日誌串流是依 ARN/管道命名。 | 日誌串流是以\$1as\$1run附加至名稱的 ARN/管道命名。 |
| 自動化 | 您不應根據這些日誌中的措辭自動化任何處理，因為該措辭可能會有所變更。（透過比較，您可以根據使用 CloudWatch Events 存取的警示中的措辭來自動化，因為警示的措辭不會變更。) | 您可以根據這些日誌中的措辭來自動化。 |
# 啟用頻道編碼器日誌
您可以在 MediaLive 主控台上為個別頻道啟用頻道編碼器日誌。您將啟用日誌記錄並依每個頻道設定日誌記錄層級 (錯誤、警告、資訊、或偵錯)。該頻道必須為閒置以啟用或停用記錄。
您不需要啟用執行中日誌。MediaLive 一律會產生這些日誌。
**啟用頻道編碼器日誌 (MediaLive 主控台）**
1. 如果您是 MediaLive 的傳回使用者，請洽詢您的管理員，您的部署是否已在 AWS IAM 中設定以支援頻道日誌。
1. 您的管理員可能會指示您在其中一個頻道中更新 `MediaLiveAccessRole` 許可。如果您獲得此指示，您必須[編輯頻道](editing-deleting-channel.md#editing-a-channel) (選擇任何閒置頻道)、[顯示 **Channel and input details (頻道和輸入詳細資訊)** 頁面](role-and-remember-arn.md)，然後選擇 **Update (更新)** 按鈕。當角色在一個頻道中更新時，該變更將套用到所有頻道。
1. 若要在新頻道中啟用編碼器日誌，請在[建立](creating-channel-scratch.md)期間設定記錄。
若要在現有頻道中啟用編碼器日誌，[請編輯頻道](editing-deleting-channel.md#editing-a-channel)；此頻道必須處於閒置狀態。
在這兩種情況下，請在 **General settings (一般設定)** 頁面的 **Channel logging (頻道記錄)** 部分中，選擇 **Logging (記錄)**。請選擇層級而非 **DISABLED (停用)**。如需詳細資訊，請參閱[日誌](creating-a-channel-step3.md#channel-logging)。
1. 您或管理員也可以前往 CloudWatch Logs 並設定日誌的過期日期。
## 停用頻道編碼器日誌
您可以在 MediaLive 主控台上停用個別頻道編碼器相關記錄資訊的擷取。編輯該頻道，並在 **General settings (一般設定)** 頁面的 **Channel logging (頻道記錄)** 部分中，選擇 **Logging (記錄)**。將層級設為 **DISABLED (停用)**。
# 使用日誌
您可以在 CloudWatch Logs 主控台上檢視編碼器日誌和執行中日誌，方式與檢視任何服務的日誌相同。
您不需要在 CloudWatch Logs 主控台上設定日誌、日誌群組或日誌串流，因為 MediaLive 會自動為您設定它們。
+ 日誌群組 – 日誌群組一律為下列項目：**ElementalMediaLive**。
+ 日誌串流 – 日誌串流的名稱如下：
+ 編碼器日誌 – 以 ARN/管道命名。
+ 執行中日誌 – 以`_as_run`附加的 ARN/管道命名。
例如：
`arn_aws_medialive_us-west-2_111122223333_channel_5106412_0`
`arn_aws_medialive_us-west-2_111122223333_channel_5106412_0_as_run`
其中 `5106412` 是頻道 ID，而 `0`是管道。
## 編碼器日誌的內容
日誌為 JSON 格式：
```
{
"encoder_pipeline": 0,
"severity": "I",
"timestamp": "2018-05-21T16:36:41.650318",
"channel_arn": "arn:aws:medialive:us-west-2:111122223333:channel:5106412",
"logger_name": "",
"message": "Probing input media..."
},
.
.
.
]
```
資料如下：
+ `encoder_pipeline`：`0` 或 `1` (如果頻道設定為[標準頻道](channel-class.md)則有兩個管道)。
+ `severity`：字母。記錄層級 (在啟用記錄時設定) 控制可出現在日誌中的嚴重程度。如需詳細資訊，請參閱[記錄層級和詳細資訊](#log-levels)。
+ `timestamp`：ISO 8601 時間格式：yyyy – mm – dd T hh: mm: ss：秒數的小數部分。
+ `channel_arn`：ARN 加上頻道 ID。在上述範例中，頻道 ID 為 `5106412`。
+ `logger_name`：此可能為空白或可能指定一個結合一系列相關訊息的名稱。
+ `message`：訊息。請記住措詞可能會變更，因此您不應依這些措辭進行自動化。
## 編碼器日誌的日誌層級和詳細資訊
若要使用此表格，請在第一欄中找出層級，完整閱讀以識別將在具有此日誌記錄層級日誌中顯示的訊息嚴重性。
| Level | 偵錯訊息 | 資訊訊息 | 警告訊息 | 關鍵訊息 | 嚴重訊息 |
| --- | --- | --- | --- | --- | --- |
| DEBUG | 是 | 是 | 是 | 是 | 是 |
| INFO | | 是 | 是 | 是 | 是 |
| WARNING | | | 是 | 是 | 是 |
| ERROR | | | | 是 | 是 |
## 管理日誌儲存
當您刪除頻道時，相關聯的日誌會保留在 CloudWatch Logs 中。在將其儲存刪除之前，您將持續進行付費。若要刪除日誌，請變更日誌資料保留期間。所有在您指定保留期間設定之前的資料都會被刪除。如需更多資訊，請參閱 [Amazon CloudWatch Logs 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。日誌的 **Log group (日誌群組)** 為 **ElementalMediaLive (ElementalMediaLive)**。