本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 控制 AWS Elemental MediaTailor 日誌的磁碟區
MediaTailor 廣告插入工作階段日誌有時很詳細。若要降低日誌成本，您可以定義 MediaTailor 傳送至 Amazon CloudWatch Logs 的工作階段日誌百分比。例如，如果您的播放組態有 1000 個廣告插入工作階段，而且您設定了 的啟用百分比值`60`，MediaTailor 會將 600 個工作階段的日誌傳送至 CloudWatch Logs。MediaTailor 會隨機決定要傳送日誌的工作階段。如果您想要檢視特定工作階段的日誌，您可以使用[偵錯日誌模式](debug-log-mode.md)。
當您設定記錄百分比時，MediaTailor 會自動建立服務連結角色，授予 MediaTailor 將 CloudWatch Logs 寫入您的帳戶所需的許可。如需有關 MediaTailor 如何使用服務連結角色的資訊，請參閱 [使用 MediaTailor 的服務連結角色](using-service-linked-roles.md)。
## 建立日誌組態
若要控制 MediaTailor 寫入 CloudWatch Logs 的工作階段日誌百分比，您可以為播放*組態建立日誌*組態。建立日誌組態時，您可以指定*播放組態名稱*和*啟用百分比*的值。
------
#### [ Console ]
**為*現有的*播放組態建立日誌組態**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) 開啟 MediaTailor 主控台。
1. 在**播放組態**窗格中，選取您要為其設定日誌組態的播放組態。
1. 選擇**編輯**。
1. 在**日誌組態**下，指定**啟用百分比**的值。
**為*新的*播放組態建立日誌組態**
+ 請遵循 [日誌組態](configurations-create.md#configurations-log-configurations) 中的程序。
------
#### [ AWS Command Line Interface (AWS CLI) ]
**為*現有的*播放組態建立日誌組態**
若要使用 建立日誌組態 AWS CLI，請執行 [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) 命令，並指定所需參數的適當值。
此範例已針對 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 Logs 的播放組態工作階段日誌百分比。
+ `{{playback-configuration-name}}` 是用於設定日誌組態設定的播放組態名稱。
如果此命令成功執行，您會收到類似如下的輸出。
```
{
"PercentEnabled": {{10}},
"PlaybackConfigurationName": "{{MyPlaybackConfiguration}}"
}
```
**為*新的*播放組態建立日誌組態**
+ 使用 [put-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/put-playback-configuration.html) 命令的 `configure-logs-for-playback-configuration`選項。
------
## 停用日誌組態
建立日誌組態之後，就無法刪除它，只能*停用*它。若要停用日誌組態，請使用 MediaTailor 主控台或 API 將**啟用百分比**值設定為 **0**。這會關閉該播放組態的所有工作階段記錄。
如果您想要刪除 MediaTailor 用於帳戶中日誌組態 （服務連結角色） 的角色，您必須先停用所有日誌組態。如需如何刪除服務連結角色的資訊，請參閱 [使用 MediaTailor 的服務連結角色](using-service-linked-roles.md)。
------
#### [ Console ]
**在播放組態上停用日誌組態**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) 開啟 MediaTailor 主控台。
1. 在**播放組態**窗格中，選取您要停用日誌組態的播放組態。
1. 選擇**編輯**。
1. 在**日誌組態**下，將**啟用百分比**值設定為 `0`。這會關閉此播放組態的所有工作階段記錄。
1. 選取**儲存**。
------
#### [ AWS Command Line Interface (AWS CLI) ]
**停用日誌組態**
+ `0` 使用 [configure-logs-for-playback-configuration](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-playback-configuration.html) 命令將 `percent-enabled` 值設定為 。
------