

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

# 使用付費日誌來傳送 AWS Elemental MediaTailor 日誌
<a name="vended-logs"></a>

您可以使用付費日誌來提高彈性，並控制 MediaTailor 從播放組態發出的日誌交付位置。

使用付費日誌時，MediaTailor 會將與組態相關聯的所有日誌活動傳送至 Amazon CloudWatch Logs。然後，CloudWatch Logs 會將您指定的日誌百分比傳送至您選擇的目的地。支援的目的地是 Amazon CloudWatch Logs 日誌群組、Amazon S3 儲存貯體或 Amazon Data Firehose 串流。

由於 提供的日誌可用於磁碟區折扣定價，相較於將日誌直接傳送到 CloudWatch Logs，您可以節省成本。如需定價，請參閱 [Amazon CloudWatch 定價](https://aws.amazon.com/cloudwatch/pricing/)中日誌索引標籤上的*已修訂***日誌**。

若要使用付費日誌，您必須執行下列動作：

1. [新增許可](#vended-logs-perms).

1. [建立日誌交付目的地](#vended-logs-destinations).

1. [在 CloudWatch Logs 中設定日誌交付](#vended-logs-delivery).

1. [在 MediaTailor 中啟用付費日誌](#vended-logs-config).

如需付費日誌的詳細資訊，請參閱 CloudWatch Logs 使用者指南中的[從 AWS 服務啟用記錄](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)。MediaTailor 支援 V2 的付費日誌。

## 步驟 1：新增 MediaTailor 日誌交付的許可
<a name="vended-logs-perms"></a>

設定付費日誌的人員必須具有在 MediaTailor 中建立交付目的地、設定日誌交付和啟用付費日誌的許可。使用下列政策來確保您擁有適當的許可來設定已結束的日誌。

**CloudWatch Logs 和交付目的地的政策**  
*Amazon CloudWatch Logs 使用者指南*中的下列各節提供可讓您在 CloudWatch Logs 和交付目的地中使用日誌的政策。如果您將日誌傳送到多個位置，您可以將政策陳述式合併為一個政策，而不是建立多個政策。  
+ [傳送至 CloudWatch Logs 的日誌](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [傳送至 Amazon S3 的日誌](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [傳送至 Firehose 的日誌](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)

**從主控台設定 的政策**  
如果您要透過 主控台而非 API 或 設定付費日誌交付 AWS CLI，您必須在政策中擁有下列額外許可。

**MediaTailor 中已發佈日誌的政策**  
若要在 MediaTailor 中建立、檢視或修改付費日誌交付，您必須在政策中擁有下列許可。

如需有關新增許可和使用 政策的資訊，請參閱 [的 Identity and Access Management AWS Elemental MediaTailor](security-iam.md)。

## 步驟 2：建立 MediaTailor 日誌的交付目的地
<a name="vended-logs-destinations"></a>

建立將傳送日誌的資源。記錄資源的 ARN，用於在後續步驟中設定日誌交付。

**CloudWatch Logs 日誌群組交付目的地**  
使用下列其中一項來協助建立日誌群組。  
+ 如需 主控台，請參閱《Amazon [ CloudWatch Logs 使用者指南》中的在 CloudWatch Logs 中建立日誌群組](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group)。 *Amazon CloudWatch *
+ 如需 API，請參閱《Amazon CloudWatch Logs API 參考》中的 [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)。 *Amazon CloudWatch * 
+ 如需 SDKs和 CLI，請參閱《*Amazon CloudWatch Logs 使用者指南*》中的[`CreateLogGroup`搭配使用 AWS SDK 或 AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) 。

**Amazon S3 儲存貯體交付目的地**  
使用下列其中一項協助建立儲存貯體。  
+ 如需主控台、SDKs和 CLI，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[建立儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)體。
+ 如需 API，請參閱《*Amazon Simple Storage Service API 參考*》中的 [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)。

**Firehose 串流交付目的地**  
如需建立串流的說明，請參閱《Amazon Data [Firehose 開發人員指南》中的從主控台建立](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) Firehose 串流。 **

## 步驟 3：啟用 MediaTailor 播放組態的付費日誌
<a name="vended-logs-config"></a>

建立或更新播放組態，以將日誌傳送至您在上一個步驟中建立的交付目的地。記錄組態的名稱，以便在後續步驟中設定日誌交付時使用。
+ 若要透過主控台啟用付費日誌，請使用 [建立組態](configurations-create.md)或 [編輯組態設定](configurations-edit.md) 編輯組態來存取**記錄**設定。針對**記錄策略**，選擇**已結束的日誌**。
+ 若要透過 API 啟用付費日誌，您必須擁有現有的組態。使用 `ConfigureLogsForPlaybackConfiguration`來新增記錄策略 `Vended logs`。

如果您使用的是將日誌直接傳送到 CloudWatch Logs 的舊版 MediaTailor 記錄策略，並且想要遷移到 提供的日誌，請參閱 [遷移記錄策略](vended-logs-migrate.md)。

**重要**  
 如果您將日誌策略從 Legacy CloudWatch 變更為已發佈的日誌，MediaTailor 會在您儲存更新後立即進行此變更。您將停止接收日誌，直到您完全設定結束記錄為止。

## 步驟 4：在 CloudWatch Logs 中設定日誌交付
<a name="vended-logs-delivery"></a>

在 CloudWatch Logs 中，您必須建立三個元素來代表日誌交付的片段。這些元素會在 *Amazon CloudWatch Logs API 參考*中的 [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html) 中詳細說明。使用 CloudWatch Logs API 設定交付的高階步驟如下所示。

**在 CloudWatch Logs (API) 中設定日誌交付**

1. 使用 [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)來新增日誌的來源。

   `DeliverySource` 代表產生日誌的播放組態。您需要播放組態的名稱，才能建立 `DeliverySource`。

1. 使用 [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html) 新增將寫入日誌的目的地。

   `DeliveryDestination` 代表交付目的地。您需要日誌群組、儲存貯體或串流的 ARN 才能建立 `DeliveryDestination`。

1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html) 如果您要跨帳戶交付日誌，請使用 。

   如果交付目的地位於與播放組態不同的帳戶中，則需要 `DeliveryDestinationPolicy`。此政策允許 CloudWatch Logs 將日誌交付至 `DeliveryDestination`。

1. 使用 [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)將 `DeliverySource` 連結至 `DeliveryDestination`。

   `Delivery` 代表 `DeliverySource`和 之間的連線`DeliveryDestination`。

# 遷移您的 AWS Elemental MediaTailor 記錄策略
<a name="vended-logs-migrate"></a>

 如果您將日誌策略從 Legacy CloudWatch 變更為已發佈的日誌，MediaTailor 會在您儲存更新後立即進行此變更。若要避免日誌記錄工作流程中斷，請使用下列步驟來遷移您的日誌記錄策略。

1. 請遵循 [使用 vended 日誌](vended-logs.md)中所述的步驟執行。針對 [在 MediaTailor 中啟用付費日誌](vended-logs.md#vended-logs-config)，選取*兩個*記錄策略 (**已棄用日誌**和**舊版 CloudWatch**)。

   MediaTailor 將透過已提交的日誌和直接傳送至 CloudWatch Logs 的日誌。

1. 在工作流程中進行必要的變更，這取決於您的記錄策略和交付目的地。

1. 從**記錄策略**中重新檢視[在 MediaTailor 中啟用付費日誌](vended-logs.md#vended-logs-config)和移除**舊版 CloudWatch**。