本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 控制音量 AWS Elemental MediaTailor logs
MediaTailor 广告插入会话日志有时很冗长。为了降低日志成本，您可以定义 MediaTailor 发送到 Amazon Logs 的会话 CloudWatch 日志的百分比。例如，如果您的播放配置有 1000 个广告插入会话，并且您将启用百分比的值设置为`60`，则会将其中 600 个会话的日志 MediaTailor 发送到 CloudWatch 日志。 MediaTailor 随机决定向哪个会话发送日志。如果要查看特定会话的日志，则可以使用[调试日志模式](debug-log-mode.md)。
当您设置日志记录百分比时， MediaTailor 会自动创建一个服务相关角色， MediaTailor 该角色授予向您的账户写入 CloudWatch 日志所需的权限。有关如何 MediaTailor 使用服务相关角色的信息，请参阅[将服务相关角色用于 MediaTailor](using-service-linked-roles.md)。
## 创建日志配置
要控制 MediaTailor 写入日志的会话 CloudWatch 日志的百分比，您需要为播放*配置创建日志*配置。创建日志配置时，需要指定*播放配置名称*和*启用百分比*值。
------
#### [ Console ]
**为创建日志配置 *现有* 播放配置**
1. 登录 AWS 管理控制台 并打开 MediaTailor 控制台，网址为[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)。
1. 在**播放配置**窗格上，选择要为其设置日志配置的播放配置。
1. 选择**编辑**。
1. 在 “**日志配置**” 下，指定**启用百分比**值。
**为创建日志配置 *新* 播放配置**
+ 按照[日志配置](configurations-create.md#configurations-log-configurations)中的程序操作。
------
#### [ AWS Command Line Interface (AWS CLI) ]
**为*现有*播放配置创建日志配置**
要使用创建日志配置，请运行 conf [igure-logs-for-playback-configur](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) ation 命令并为所需参数指定适当的值。 AWS CLI
此示例是针对 Linux、macOS 或 Unix 进行格式化的，它使用反斜杠（\\）行继续符来提高可读性。
```
$ aws mediatailor configure-logs-for-playback-configuration \
--percent-enabled {{10}} \
--playback-configuration-name {{MyPlaybackConfiguration}}
```
此示例是针对 Microsoft Windows 进行格式化的，它使用尖号 (^) 行继续符来提高可读性。
```
C:\> aws mediatailor configure-logs-for-playback-configuration ^
--percent-enabled {{10}} ^
--playback-configuration-name {{MyPlaybackConfiguration}}
```
其中：
+ `{{percent-enabled}}`是 MediaTailor发送到日志的播放配置会话 CloudWatch 日志的百分比。
+ `{{playback-configuration-name}}`是要为其设置日志配置设置的播放配置的名称。
如果命令成功运行，则您将收到类似于以下内容的输出：
```
{
"PercentEnabled": {{10}},
"PlaybackConfigurationName": "{{MyPlaybackConfiguration}}"
}
```
**为创建日志配置 *新* 播放配置**
+ 使用 [put-playback-con](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html) figuration 命令的`configure-logs-for-playback-configuration`选项。
------
## 停用日志配置
创建日志配置后，您无法将其删除，只能将其*停*用。要停用日志配置，请使用 MediaTailor 控制台或 API 将**启用百分比**值设置**为 0**。这将关闭该播放配置的所有会话记录。
如果要删除账户中 MediaTailor 用于日志配置的服务相关角色，则必须先停用所有日志配置。有关如何删除服务相关角色的信息，请参阅[将服务相关角色用于 MediaTailor](using-service-linked-roles.md)。
------
#### [ Console ]
**停用播放配置的日志配置**
1. 登录 AWS 管理控制台 并打开 MediaTailor 控制台，网址为[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)。
1. 在**播放配置**窗格上，选择要停用日志配置的播放配置。
1. 选择**编辑**。
1. 在 “**日志配置”** 下，将**启用百分比**值设置为`0`。这将关闭此播放配置的所有会话记录。
1. 选择**保存**。
------
#### [ AWS Command Line Interface (AWS CLI) ]
**停用日志配置**
+ `0`使用 configu [re-logs-for-playback 配置命令将](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html)该`percent-enabled`值设置为。
------