

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用已售日志发送 AWS Elemental MediaTailor 日志
<a name="vended-logs"></a>

您可以使用vended logs来提高灵活性，并可以控制将从播放配置中 MediaTailor 发出的日志传送到何处。

使用已出售的日志， MediaTailor 将与配置相关的所有日志活动发送到 Amazon Lo CloudWatch gs。 CloudWatch 然后，Logs 会将您指定的日志百分比发送到您选择的目的地。支持的目标包括亚马逊 CloudWatch 日志组、亚马逊 S3 存储桶或 Amazon Data Firehose 流。

由于销售日志以批量折扣（bolume discount）的价格提供，因此与直接将日志发送到日志相比， CloudWatch 您可以节省成本。有关定价，请参阅 [Amazon CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/) P *ricing 中 “日**志**” 选项卡上的 “销售*日志”。

要使用已出售的日志，您必须执行以下操作：

1. [添加权限](#vended-logs-perms).

1. [创建日志传送目标](#vended-logs-destinations).

1. [在日志中配置 CloudWatch 日志传输](#vended-logs-delivery).

1. [启用 vended 登录 MediaTailor](#vended-logs-config).

有关已售日志的更多信息，请参阅《日志》用户指南中的[启用 AWS 服务 CloudWatch 日志记录](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 日志和传送目的地政策**  
*Amazon CloudWatch Logs 用户指南*中的以下部分提供了允许您使用日志中的 CloudWatch 日志和您的送货目的地的策略。如果您将日志发送到多个位置，则可以将策略声明合并为一个策略，而不必创建多个策略。  
+ [发送到日志的 CloudWatch 日志](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 Managem AWS Elemental MediaTailor](security-iam.md)。

## 步骤 2：为 MediaTailor 日志创建传送目的地
<a name="vended-logs-destinations"></a>

创建将发送日志的资源。记录资源的 ARN，以便在以后的步骤中配置日志传送时使用。

**CloudWatch 日志日志组传送目标**  
使用以下方法之一来帮助创建日志组。  
+ 有关控制台，请参阅 *Amazon CloudWatch 日志用户指南中的日志中的创建 CloudWatch 日志*[组](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group)。
+ 有关 API，请参阅[CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)《*亚马逊 CloudWatch 日志 API 参考》。*
+ 有关 SDKs 和 CLI，请参阅与 [AWS SDK `CreateLogGroup` 配合使用或](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) *Amazon L CloudWatch ogs 用户指南 AWS CLI*中的内容。

**亚马逊 S3 存储桶交付目的地**  
使用以下方法之一来帮助创建存储桶。  
+ 有关控制台 SDKs、和 CLI，请参阅 *Amazon 简单存储服务用户指南中的创建存储*[桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。
+ 有关 API，请参阅[CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)《*亚马逊简单存储服务 API 参考*》。

**Firehose 直播传输目的地**  
有关创建直播的帮助，请参阅《*亚马逊数据 Firehose 开发者指南》中的从控制台创建 Firehose* [直](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html)播。

## 第 3 步：为 MediaTailor 播放配置启用已售日志
<a name="vended-logs-config"></a>

创建或更新播放配置，该配置将向您在上一步中创建的传送目标发送日志。记录配置名称，以便在以后的步骤中配置日志传送时使用。
+ 要通过控制台启用销售日志，请使用[创建配置](configurations-create.md)或[编辑配置设置](configurations-edit.md)编辑配置来访问**日志**设置。对于**日志策略**，请选择 **Vended 日志。**
+ 要通过 API 启用销售日志，您必须具有现有配置。`ConfigureLogsForPlaybackConfiguration`用于添加日志策略`Vended logs`。

如果您使用的是将日志直接发送到 CloudWatch 日志的传统日志 MediaTailor 记录策略，并且想要迁移到销售日志，请参阅[迁移日志策略](vended-logs-migrate.md)。

**重要**  
 如果您将日志策略从 Legacy 更改 CloudWatch 为已售日志，则 MediaTailor 将在保存更新后立即进行此更改。在完全配置 vended 日志之前，您将停止接收日志。

## 步骤 4：在日志中 CloudWatch 配置日志传输
<a name="vended-logs-delivery"></a>

在 CloudWatch Logs 中，必须创建三个元素来表示日志传送的各个部分。这些元素在《*亚马逊 CloudWatch 日志 API 参考*》[CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)中有详细描述。使用 CloudWatch 日志 API 配置交付的高级步骤如下。

**在日志 (API) 中配置 CloudWatch 日志传输**

1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)用于添加日志来源。

   A `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)添加写入日志的目标。

   A `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 日志将日志传送到`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`。

   A `Delivery` 表示`DeliverySource`和之间的连接`DeliveryDestination`。

# 迁移您的 AWS Elemental MediaTailor 日志策略
<a name="vended-logs-migrate"></a>

 如果您将日志策略从 Legacy 更改 CloudWatch 为已售日志，则 MediaTailor 将在保存更新后立即进行此更改。为避免日志记录工作流程中断，请使用以下步骤迁移您的日志策略。

1. 请按照 [使用已售日志](vended-logs.md) 中所述的步骤操作。对于[启用 vended 登录 MediaTailor](vended-logs.md#vended-logs-config)，选择*两种*日志记录策略（**Vended 日志**和**旧**日志 CloudWatch）。

   MediaTailor 将通过两个已售日志发送日志，并直接发送到 CloudWatch 日志。

1. 根据您的日志策略和交付目的地，对工作流程进行必要的更改。

1. 重新访问[启用 vended 登录 MediaTailor](vended-logs.md#vended-logs-config)并 CloudWatch从**日志策略**中删除 **Legacy**。