

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.

# AWS Elemental MediaTailor Analyse des journaux ADS dans Amazon CloudWatch Logs Insights
<a name="monitor-cloudwatch-ads-logs"></a>

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
<a name="querying-the-ads-logs"></a>

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)
```