本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon CloudWatch 日志监控频道
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 日志。您可以使用 CloudWatch 日志的标准功能来查看和管理日志。有关更多信息，请参阅 [Amazon CloudWatch 日志用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)。
**两种类型的日志中的不同功能**
下表描述了通道编码器日志和通道 as-run 日志之间的不同之处。
| | 编码器日志 | As-run 日志 |
| --- | --- | --- |
| 创建触发器 | 必须[启用这些日志](enabling-disabling-logs.md) MediaLive 才能生成它们。 | MediaLive 总是生成这些日志。 |
| 细节层次 | 您可以设置日志记录级别来控制收集的详细信息。 | 您无法更改日志记录级别。 |
| 成本 | 这些日志需要付费，这是您对 Amazon L CloudWatch ogs 的费用的一部分。参见 [Amazon CloudWatch 定价](https://aws.amazon.com/cloudwatch/pricing/)。记得在删除通道后[删除日志](working-with-logs.md#manage-log-storage)。 | 这些日志是免费的。 |
| CloudWatch 日志流 | 日志流以 ARN/管道命名。 | 日志流以 the 命名，名称后\$1as\$1run面 ARN/pipeline 附有后缀。 |
| 自动化 | 您不应根据这些日志中的措辞对任何处理实施自动化，因为这些措辞可能会发生变化。（相比之下，您可以根据警报中的措辞进行自动化，使用 CloudWatch 事件访问警报，因为警报的措辞不会改变。） | 您可以根据这些日志中的措辞实施自动化。 |
# 启用通道编码器日志
您可以在 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 日志并设置日志的到期日期。
## 禁用通道编码器日志
您可以禁用控制台上单个频道捕获与编码器相关的日志信息。 MediaLive 编辑通道，并在 **General settings (常规设置)** 页面上的 **Channel logging (通道日志记录)** 部分中，选择 **Logging (日志记录)**。将级别设置为 **DISABLED (已禁用)**。
# 使用日志
您可以在日志控制台上查看编码器日志和运行时 CloudWatch 日志，就像查看任何服务的日志一样。
您无需在日志控制台上设置日志、日志组或 CloudWatch 日志流，因为它们 MediaLive 会自动为您设置。
+ 日志组-日志组始终如下所示：**ElementalMediaLive**。
+ 日志流 – 日志流命名如下：
+ 编码器日志 – 以 ARN/管道命名。
+ as-run 日志 — 以 “” 命名，并 ARN/pipeline `_as_run`附有后缀。
例如：
`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`：消息。请记住，措辞可能会发生变化，因此您不应对其实施自动化。
## 编码器日志的日志级别和详细程度
要使用此表，请先在第一列中找到一个级别，然后往后读，确定将在具有此日志记录级别的日志中显示的消息严重性。
| 级别 | 调试消息 | 信息性消息 | 警告消息 | 关键消息 | 严重消息 |
| --- | --- | --- | --- | --- | --- |
| 调试 | 支持 | 是 | 是 | 是 | 是 |
| INFO | | 支持 | 是 | 是 | 是 |
| WARNING | | | 支持 | 是 | 是 |
| ERROR | | | | 支持 | 是 |
## 管理日志存储
删除频道后，关联的日志将保留在 “日 CloudWatch 志” 中。这些日志的存储将继续产生费用，直至您将其删除。要删除日志，请更改日志数据保留。将删除早于您指定的保留设置的所有数据。有关更多信息，请参阅 [Amazon CloudWatch 日志用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)。**日志的日志组**是**ElementalMediaLive**。