

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utiliser les journaux vendus pour envoyer AWS Elemental MediaTailor des journaux
<a name="vended-logs"></a>

Vous pouvez utiliser les journaux automatiques pour plus de flexibilité et de contrôle quant à l'endroit où distribuer les journaux émis à partir de votre configuration de lecture. MediaTailor 

Avec les journaux vendus, MediaTailor envoie toutes les activités des journaux associées à une configuration à Amazon CloudWatch Logs. CloudWatch Logs envoie ensuite le pourcentage de journaux que vous spécifiez à la destination que vous avez choisie. Les destinations prises en charge sont un groupe de CloudWatch journaux Amazon Logs, un bucket Amazon S3 ou un flux Amazon Data Firehose. 

Les journaux vendus étant disponibles à des prix réduits, vous pourriez réaliser des économies par rapport à l'envoi direct des CloudWatch journaux à Logs. Pour connaître les tarifs, consultez la section *Vended Logs* dans l'onglet **Logs** d'[Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).

Pour utiliser les journaux automatiques, vous devez effectuer les opérations suivantes :

1. [Ajout d’autorisations](#vended-logs-perms).

1. [Création de destinations de livraison de journaux](#vended-logs-destinations).

1. [Configurer la livraison des CloudWatch journaux dans Logs](#vended-logs-delivery).

1. [Activer les connexions automatiques MediaTailor](#vended-logs-config).

Pour plus d'informations sur les journaux vendus, voir [Activer la journalisation à partir des AWS services](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) dans le guide de l'utilisateur CloudWatch des journaux. MediaTailor prend en charge la version 2 des journaux vendus. 

## Étape 1 : ajouter des autorisations pour la livraison du MediaTailor journal
<a name="vended-logs-perms"></a>

La personne qui configure les journaux vendus doit être autorisée à créer la destination de livraison, à configurer la livraison des journaux et à activer les connexions vendues. MediaTailor Utilisez les politiques suivantes pour vous assurer que vous disposez des autorisations appropriées pour configurer les journaux de vente. 

**Politiques relatives aux CloudWatch journaux et aux destinations de livraison**  
Les sections suivantes du *guide de l'utilisateur d'Amazon CloudWatch Logs* présentent les politiques qui vous permettent de travailler avec Logs in CloudWatch Logs et vos destinations de livraison. Si vous envoyez des journaux à plusieurs emplacements, vous pouvez combiner les déclarations de politique en une seule politique au lieu de créer plusieurs politiques.   
+ [Logs envoyés à CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-CloudWatchLogs)
+ [Journaux envoyés à Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-S3)
+ [Logs envoyés à Firehose](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-V2-Firehose)

**Politique de configuration depuis la console**  
Si vous configurez la livraison des journaux vendus via la console plutôt que via l'API AWS CLI, vous devez disposer des autorisations supplémentaires suivantes dans votre politique.

**Politique relative aux connexions automatiques MediaTailor**  
Pour créer, consulter ou modifier les journaux de livraison vendus MediaTailor, vous devez disposer des autorisations suivantes dans votre politique.

Pour plus d'informations sur l'ajout d'autorisations et l'utilisation des politiques, consultez[Identity and Access Management pour AWS Elemental MediaTailor](security-iam.md).

## Étape 2 : créer des destinations de livraison pour les MediaTailor journaux
<a name="vended-logs-destinations"></a>

Créez les ressources auxquelles vos journaux seront envoyés. Enregistrez l'ARN de la ressource à utiliser lors de la configuration de la livraison du journal lors d'une étape ultérieure.

**CloudWatch Logs : destination de livraison du groupe de journaux**  
Utilisez l'une des méthodes suivantes pour vous aider à créer un groupe de journaux.  
+ Pour la console, consultez [Créer un groupe de CloudWatch journaux dans Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) du *guide de l'utilisateur Amazon CloudWatch Logs*.
+ Pour l'API, consultez le [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)manuel *Amazon CloudWatch Logs API Reference.* 
+ Pour SDKs et CLI, consultez la section [Utilisation `CreateLogGroup` avec un AWS SDK ou AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_CreateLogGroup_section.html) dans le *guide de l'utilisateur Amazon CloudWatch Logs*. 

**Destination de livraison du compartiment Amazon S3**  
Utilisez l'une des méthodes suivantes pour vous aider à créer un bucket.  
+ Pour la console et la CLI SDKs, consultez la section [Créer un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*.
+ Pour l'API, consultez [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)le manuel *Amazon Simple Storage Service API Reference*. 

**Destination de livraison de Firehose Stream**  
Pour obtenir de l'aide sur la création d'un flux, consultez la section [Créer un flux Firehose depuis la console](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) dans le manuel *Amazon Data Firehose Developer* Guide.

## Étape 3 : activer les journaux vendus pour la configuration de MediaTailor lecture
<a name="vended-logs-config"></a>

Créez ou mettez à jour la configuration de lecture qui enverra les journaux à la destination de livraison que vous avez créée à l'étape précédente. Enregistrez le nom de la configuration à utiliser lors de la configuration de la livraison du journal lors d'une étape ultérieure. 
+ Pour activer les journaux vendus via la console, utilisez [Création d'une configuration](configurations-create.md) ou [Modification des paramètres de configuration](configurations-edit.md) modifiez une configuration pour accéder aux paramètres de **journalisation**. Pour les **stratégies de journalisation**, choisissez **Vended logs**.
+ Pour activer les journaux automatiques via l'API, vous devez disposer d'une configuration existante. `ConfigureLogsForPlaybackConfiguration`À utiliser pour ajouter la stratégie de journalisation`Vended logs`.

Si vous utilisez l'ancienne stratégie de MediaTailor journalisation qui consiste à envoyer des journaux directement vers CloudWatch Logs et que vous souhaitez migrer vers des journaux vendus, consultez[Migration de la stratégie de journalisation](vended-logs-migrate.md).

**Important**  
 Si vous modifiez la stratégie de journalisation de Legacy CloudWatch à celle de vended logs, vous MediaTailor effectuerez cette modification dès que vous aurez enregistré les mises à jour. Vous ne recevrez plus de journaux tant que vous n'aurez pas entièrement configuré la journalisation automatique.

## Étape 4 : configurer la livraison des CloudWatch journaux dans Logs
<a name="vended-logs-delivery"></a>

Dans CloudWatch Logs, vous devez créer trois éléments pour représenter les éléments de livraison des logs. Ces éléments sont décrits en détail [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)dans le manuel *Amazon CloudWatch Logs API Reference*. Les étapes de haut niveau pour configurer la livraison avec l'API CloudWatch Logs sont les suivantes. 

**Pour configurer la livraison des CloudWatch journaux dans 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)À utiliser pour ajouter la source des journaux.

   A `DeliverySource` représente la configuration de lecture qui génère les journaux. Vous avez besoin du nom de la configuration de lecture pour créer le`DeliverySource`. 

1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)À utiliser pour ajouter la destination où les journaux seront écrits.

   A `DeliveryDestination` représente la destination de livraison. Vous avez besoin de l'ARN du groupe de logs, du bucket ou du stream pour créer le`DeliveryDestination`.

1. À utiliser [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)si vous distribuez des journaux entre comptes. 

   Si la destination de livraison se trouve dans un compte différent de celui de la configuration de lecture, vous avez besoin d'un`DeliveryDestinationPolicy`. Cette politique permet à CloudWatch Logs de fournir des journaux au`DeliveryDestination`.

1. [https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)À utiliser pour `DeliverySource` lier le`DeliveryDestination`.

   A `Delivery` représente le lien entre `DeliverySource` et`DeliveryDestination`.

# Migration de votre stratégie de AWS Elemental MediaTailor journalisation
<a name="vended-logs-migrate"></a>

 Si vous modifiez la stratégie de journalisation de Legacy CloudWatch à celle de vended logs, vous MediaTailor effectuerez cette modification dès que vous aurez enregistré les mises à jour. Pour éviter toute interruption de votre flux de journalisation, suivez les étapes ci-dessous pour migrer votre stratégie de journalisation. 

1. Suivez les étapes décrites dans la section [Utilisation des journaux vendus](vended-logs.md). Pour[Activer les connexions automatiques MediaTailor](vended-logs.md#vended-logs-config), sélectionnez *les deux* stratégies de journalisation (**Vended logs** et **Legacy CloudWatch**). 

   MediaTailor enverra les journaux à la fois par le biais de journaux vendus et directement à CloudWatch Logs. 

1. Apportez les modifications nécessaires à votre flux de travail en fonction de votre stratégie de journalisation et de votre destination de livraison.

1. Revisitez [Activer les connexions automatiques MediaTailor](vended-logs.md#vended-logs-config) et supprimez **Legacy CloudWatch** des **stratégies de journalisation**.