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.
# Écrire AWS Elemental MediaTailor des journaux directement sur Amazon CloudWatch Logs
MediaTailor produit des journaux contenant des informations détaillées sur l'activité des sessions et les interactions avec le serveur de décision publicitaire, et les écrit sur Amazon CloudWatch. Les journaux fournissent une description séquentielle de l'activité qui se produit au cours de la session.
MediaTailor peut également utiliser des journaux vendus pour plus de flexibilité en matière de livraison des journaux et de tarification à prix réduits en fonction du volume. Pour plus d'informations sur les journaux vendus, consultez[Utilisation des journaux vendus](vended-logs.md).
**Topics**
+ [Autorisations pour Amazon CloudWatch Logs](monitoring-permissions.md)
+ [Journal « As Run » pour l'assemblage des AWS Elemental MediaTailor canaux](as-run-log.md)
+ [AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Autorisations pour Amazon CloudWatch Logs
Utilisez Gestion des identités et des accès AWS (IAM) pour créer un rôle donnant AWS Elemental MediaTailor accès à Amazon CloudWatch. Vous devez effectuer ces étapes pour que CloudWatch les journaux soient publiés pour votre compte. CloudWatch publie automatiquement les statistiques de votre compte.
**Pour autoriser MediaTailor l'accès à CloudWatch**
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le volet de navigation de la console IAM, sélectionnez **Roles** (Rôles), puis **Create role** (Créer un rôle).
1. Choisissez le type de rôle **Autre AWS compte**.
1. Pour **ID de compte**, entrez votre identifiant de AWS compte.
1. Sélectionnez **Demander un ID externe** et entrez **Midas**. Cette option ajoute automatiquement une condition à la stratégie d'approbation qui permet au service d'assumer le rôle uniquement si la demande inclut l'élément `sts:ExternalId` approprié.
1. Choisissez **Suivant : Autorisations**.
1. Ajoutez une stratégie d'autorisations qui spécifie les actions que ce rôle peut effectuer. Sélectionnez l'une des options suivantes, puis choisissez **Next : Review** :
+ **CloudWatchLogsFullAccess**pour fournir un accès complet à Amazon CloudWatch Logs
+ **CloudWatchFullAccess**pour fournir un accès complet à Amazon CloudWatch
1. Pour **Nom du rôle**, saisissez **MediaTailorLogger**, puis choisissez **Créer un rôle**.
1. Sur la page **Rôles**, sélectionnez le rôle que vous venez de créer.
1. Modifiez la relation d'approbation pour mettre à jour le mandataire :
1. Sur la page **Récapitulatif** du rôle, choisissez l'onglet **Relation d'approbation**.
1. Choisissez **Modifier la relation d’approbation**.
1. Dans le document de politique, remplacez le principal par le MediaTailor service. Elle doit ressembler à ce qui suit :
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
L'ensemble de la stratégie doit se présenter comme suit :
1. Choisissez **Mettre à jour la politique d'approbation**.
# Journal « As Run » pour l'assemblage des AWS Elemental MediaTailor canaux
Le journal *As Run*, dans le groupe de CloudWatch `MediaTailor/Channel/AsRunLog` journaux, affiche des informations sur les programmes et les pauses publicitaires au fur et à mesure de leur diffusion.
Lorsque vous créez un canal, le journal As Run est désactivé par défaut. À l'aide de la console ou du AWS Command Line Interface (AWS CLI), vous pouvez activer et désactiver l'état du journal As Run pour chaque canal de votre compte.
Lorsque vous activez le journal As Run, un rôle lié au service est MediaTailor automatiquement créé qui permet d'écrire et MediaTailor de gérer le journal As Run dans votre compte CloudWatch Logs. Pour plus d’informations sur les rôles liés à un service, consultez [Utilisation de rôles liés à un service pour MediaTailor](using-service-linked-roles.md).
**Note**
Le journal As Run ne prend actuellement en charge que le programme par défaut. Pour l'instant, il ne prend pas en charge le AlternateMedia créé par les règles du programme. Cela signifie qu'il ne génère actuellement pas le journal As Run pour AlternateMedia.
**Topics**
+ [Activation du journal As Run](enabling-as-run-log.md)
+ [Désactivation du journal As Run](disabling-as-run-log.md)
# Activation du journal As Run
Pour activer le journal As Run, spécifiez le nom du canal et activez le type *de journal As Run* pour ce canal.
------
#### [ Console ]
**Pour activer le journal As Run lors de la création d'une chaîne**
1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**.
1. Dans la barre de navigation, choisissez **Create channel**.
1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, configurez votre canal comme vous le souhaitez.
1. Dans le volet **de contrôle d'accès**, choisissez **Next**.
1. Dans le volet **Journalisation**, sous **Types de journaux**, sélectionnez **Activer en tant qu'exécution** pour activer le journal en cours d'exécution.
**Pour activer le journal As Run lors de la mise à jour d'un canal**
**Note**
Si la chaîne est en cours d'exécution, vous devez d'abord l'arrêter avant de pouvoir la mettre à jour. Après avoir arrêté le canal, vous pouvez choisir **Actions** > **Modifier** pour commencer à le mettre à jour.
1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**.
1. Choisissez le canal que vous souhaitez mettre à jour pour activer le journal As Run.
1. Sélectionnez **Actions** > **Edit** (Modifier).
1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, mettez à jour la configuration de votre canal comme vous le souhaitez.
1. Dans le volet **de contrôle d'accès**, choisissez **Next**.
1. Dans le volet **Journalisation**, sous **Types de journaux**, sélectionnez **Activer en tant qu'exécution** pour activer le journal en cours d'exécution.
**Pour activer le journal As Run depuis l'onglet **Logging****
**Note**
Si le canal est en cours d'exécution, vous devez utiliser l'onglet **Logging** au lieu de choisir **Actions** > **Modifier** pour activer le journal As Run.
1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**.
1. Choisissez le canal pour lequel vous souhaitez activer le journal As Run.
1. Dans la barre de navigation située sous le nom de la chaîne, choisissez **Logging**.
1. Sous **Journalisation** > **Types de journaux**, sélectionnez **En cours d'exécution** pour activer le journal en cours d'exécution.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Pour activer le journal As Run**
Exécutez la [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)commande et spécifiez les valeurs appropriées pour les paramètres requis.
Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Où :
+ `MyChannel`est le nom de la chaîne dont vous êtes propriétaire et pour laquelle vous souhaitez activer le journal As Run.
Si la commande s'exécute correctement, vous recevez une sortie similaire à ce qui suit.
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Désactivation du journal As Run
Pour désactiver le journal As Run pour un canal sur lequel il est activé, spécifiez le nom du canal et désactivez le type de journal As *Run* pour ce canal.
------
#### [ Console ]
**Pour désactiver le journal As Run lors de la mise à jour d'une chaîne**
**Note**
Si la chaîne est en cours d'exécution, vous devez d'abord l'arrêter avant de pouvoir la mettre à jour. Après avoir arrêté le canal, vous pouvez choisir **Actions** > **Modifier** pour commencer à le mettre à jour.
1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**.
1. Choisissez le canal que vous souhaitez mettre à jour pour activer le journal As Run.
1. Sélectionnez **Actions** > **Edit** (Modifier).
1. Dans les volets **Définir les détails du canal**, **Configurer les sorties** et **Contrôle d'accès**, mettez à jour la configuration de votre canal comme vous le souhaitez.
1. Dans le volet **de contrôle d'accès**, choisissez **Next**.
1. Dans le volet **Journalisation**, sous **Types de journaux**, décochez **Activer en tant qu'exécution** pour désactiver le journal en cours d'exécution.
**Pour désactiver le journal As Run dans l'onglet **Logging****
**Note**
Si le canal est en cours d'exécution, vous devez utiliser l'onglet **Logging** au lieu de choisir **Actions** > **Modifier** pour désactiver le journal As Run.
1. Connectez-vous à la MediaTailor console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Dans le volet de navigation, choisissez **Assemblage** de **canaux > Canaux**.
1. Choisissez le canal pour lequel vous souhaitez désactiver le journal As Run.
1. Dans la barre de navigation située sous le nom de la chaîne, choisissez **Logging**.
1. Sous **Journalisation** > **Types de journaux**, désélectionnez **En cours d'exécution** pour désactiver le journal en cours d'exécution.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Pour désactiver le journal As Run**
Exécutez la [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)commande et spécifiez les valeurs appropriées pour les paramètres requis.
Cet exemple est formaté pour Linux, macOS ou Unix et utilise le caractère de continuation de ligne barre oblique inverse (\$1) pour améliorer la lisibilité.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Cet exemple est formaté pour Microsoft Windows et utilise le caractère de continuation de ligne caret (^) pour améliorer la lisibilité.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Où :
+ `MyChannel`est le nom de la chaîne dont vous êtes propriétaire et pour laquelle vous souhaitez désactiver le journal As Run.
Si la commande s'exécute correctement, vous recevez une sortie similaire à ce qui suit.
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights
Vous pouvez consulter et interroger les journaux du serveur de décision AWS Elemental MediaTailor publicitaire (ADS) à l'aide d'Amazon CloudWatch Logs Insights. MediaTailor envoie des journaux d'événements à CloudWatch des fins de traitement normal et de conditions d'erreur. Les journaux respectent un schéma JSON. Grâce à CloudWatch Logs Insights, vous pouvez sélectionner les journaux par période, puis exécuter des requêtes sur ceux-ci.
Pour des informations générales, voir [Analyser les données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html).
**Note**
Pour accéder aux journaux, vous devez disposer d'autorisations pour accéder à Amazon CloudWatch. Pour obtenir des instructions, veuillez consulter [Autorisations pour Amazon CloudWatch Logs](monitoring-permissions.md).
**Pour afficher et interroger les journaux ADS à l'aide de la CloudWatch console**
1. Ouvrez la CloudWatch console à l'adresse[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le volet de navigation, sous **Logs (Journaux)**, choisissez **Insights**.
1. Dans la barre de recherche**AdDec**, entrez, puis dans la liste déroulante, sélectionnez`MediaTailor/AdDecisionServerInteractions`.
1. (Facultatif) Ajustez la période que vous souhaitez étudier.
1. (Facultatif) Modifiez la requête dans la boîte de dialogue. Pour obtenir des conseils généraux, voir [Syntaxe de requête CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Pour obtenir des exemples de requêtes pour ADS MediaTailor, consultez [Consultation des journaux ADS](querying-the-ads-logs.md).
1. Choisissez **Exécuter la requête**. La requête peut prendre quelques secondes, pendant lesquelles **Cancel (Annuler)** apparaît à la place de **Run query (Exécuter la requête)**.
1. (Facultatif) Pour exporter les résultats sous forme de fichier CSV, choisissez **Actions**, puis **Download query results (CSV) (Télécharger les résultats de la requête - CSV)**.
**Note**
La console limite le nombre d'enregistrements qu'elle renvoie dans les résultats des requêtes et qu'elle exporte. Par conséquent, pour les données en masse, utilisez l'API, le AWS Command Line Interface (AWS CLI) ou un SDK.
**Topics**
+ [Consultation des journaux ADS](querying-the-ads-logs.md)
# Consultation des journaux ADS
CloudWatch Logs Insights fournit un ensemble complet d'options pour interroger vos journaux. Pour des informations détaillées sur la syntaxe des requêtes, voir Syntaxe de [requête CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Cette section fournit des exemples de requêtes courantes pour vous aider à démarrer avec vos requêtes de journaux ADS. Toutes les requêtes s'exécutent sur les journaux pour le paramètre de plage de temps actuel.
La requête suivante récupère toutes les informations des journaux ADS.
```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```
La requête suivante récupère toutes les demandes adressées à ADS. Cette requête montre un moyen de récupérer le contenu de l'en-tête de demande pour les MediaTailor journaux.
```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```
La requête suivante permet de récupérer les publicités MediaTailor insérées pour une session donnée.
```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```
La requête suivante permet de récupérer le suivi URLs qui MediaTailor a été appelé au nom du joueur.
```
fields @timestamp, beaconInfo.trackingEvent, beaconInfo.beaconUri, beaconInfo.headers.0.value as @userAgent, beaconInfo.headers.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "BEACON_FIRED"
| sort @timestamp asc
```
La requête suivante récupère des informations pour une session de lecture spécifique, en filtrant les résultats par `sessionId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```
La requête suivante récupère des informations pour une seule demande, en filtrant les résultats par `requestId`.
```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```
La requête suivante récupère un nombre d'entrées de journal pour chaque type d'événement qui a été consigné.
```
fields eventType
| stats count() as @eventCount by eventType
```
La requête suivante récupère l'ID de diffusion et la liste des publicités ignorées pour toutes les diffusions avec des publicités ignorées.
```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```