

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights
<a name="monitor-cloudwatch-ads-logs"></a>

Mit Amazon CloudWatch Logs Insights können Sie AWS Elemental MediaTailor ADS-Protokolle (Ad Decision Server) anzeigen und abfragen. MediaTailor sendet Ereignisprotokolle CloudWatch für normale Verarbeitungs- und Fehlerbedingungen an. Die Protokolle entsprechen einem JSON-Schema. Mit CloudWatch Logs Insights können Sie Protokolle nach Zeitrahmen auswählen und dann Abfragen für sie ausführen. 

Allgemeine Informationen finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). 

**Anmerkung**  
Um auf die Protokolle zugreifen zu können, benötigen Sie Berechtigungen für den Zugriff auf Amazon CloudWatch. Detaillierte Anweisungen finden Sie unter [Berechtigungen für Amazon CloudWatch Logs](monitoring-permissions.md). 

**Um ADS-Protokolle über die CloudWatch Konsole anzuzeigen und abzufragen**

1. Öffnen Sie die CloudWatch Konsole unter[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Wählen Sie im Navigationsbereich unter **Logs**, (Protokolle) die Option **Insights**(Einblicke) aus.

1. Geben Sie in der Suchleiste ein**AdDec**, und wählen Sie dann in der Dropdownliste aus`MediaTailor/AdDecisionServerInteractions`.

1. (Optional) Passen Sie den Zeitraum an, den Sie untersuchen möchten. 

1. (Optional) Ändern Sie die Abfrage im Dialogfeld. Allgemeine Hinweise finden Sie unter [CloudWatch Logs Insights-Abfragesyntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). Beispiele für Abfragen für MediaTailor ADS finden Sie unter [Abfragen der ADS-Protokolle](querying-the-ads-logs.md).

1. Wählen Sie **Abfrage ausführen**. Die Abfrage kann einige Sekunden dauern. Während dieser Zeit erscheint **Cancel** (Abbrechen) anstelle von **Run query** (Abfrage ausführen). 

1. (Optional) Um die Ergebnisse als CSV-Datei zu exportieren, wählen Sie **Actions** (Aktionen) und dann **Download query results (CSV)** (Abfrageergebnisse herunterladen) aus. 

**Anmerkung**  
Die Konsole begrenzt die Anzahl der Datensätze, die sie in Abfrageergebnissen zurückgibt und die sie exportiert. Verwenden Sie daher für Massendaten die API, das AWS Command Line Interface (AWS CLI) oder ein SDK.

**Topics**
+ [Abfragen der ADS-Protokolle](querying-the-ads-logs.md)

# Abfragen der ADS-Protokolle
<a name="querying-the-ads-logs"></a>

CloudWatch Logs Insights bietet eine Vielzahl von Optionen zum Abfragen Ihrer Logs. Ausführliche Informationen zur Abfragesyntax finden Sie unter [CloudWatch Logs Insights-Abfragesyntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html). In diesem Abschnitt finden Sie Beispiele für gängige Abfragen für den Einstieg in Ihre ADS-Protokollabfragen. Alle Abfragen werden über die Protokolle für die aktuelle Zeitbereichseinstellung ausgeführt.

Die folgende Abfrage ruft alle Informationen aus den ADS-Protokollen ab. 

```
fields @timestamp, eventType, sessionId, requestId, @message
| sort sessionId, @timestamp asc
```

Die folgende Abfrage ruft alle Anforderungen an den ADS ab. Diese Abfrage zeigt eine Möglichkeit, den Inhalt des Anforderungsheaders für MediaTailor Logs abzurufen. 

```
fields @timestamp, adsRequestUrl, requestHeaders.0.value as @userAgent, requestHeaders.1.value as @xForwardedFor, sessionId, requestId
| filter eventType = "MAKING_ADS_REQUEST"
| sort @timestamp asc
```

Die folgende Abfrage ruft die Anzeigen ab, die für eine bestimmte Sitzung MediaTailor eingefügt wurden.

```
fields @timestamp, sessionId, requestId, @message
| filter eventType = "FILLED_AVAIL"
| sort @timestamp asc
```

Die folgende Abfrage ruft das Tracking ab URLs , das im MediaTailor Namen des Spielers aufgerufen wurde.

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

Die folgende Abfrage ruft Informationen für eine bestimmte Wiedergabesitzung ab, indem die Ergebnisse nach `sessionId` gefiltert werden. 

```
fields @timestamp, eventType, sessionId, requestId, @message
| filter sessionId = "0aaf6507-c6f9-4884-bfe7-f2f841cb8195"
| sort @timestamp asc
```

Die folgende Abfrage ruft Informationen für eine einzelne Anforderung ab, indem die Ergebnisse nach `requestId` gefiltert werden.

```
fields @timestamp, eventType, sessionId, requestId, @message
| filter requestId = "f5d3cf39-6258-4cf1-b3f6-a34ff8bf641d"
| sort @timestamp asc
```

Die folgende Abfrage ruft die Anzahl der Protokolleinträge für jeden Ereignistyp ab, der protokolliert wurde.

```
fields eventType
| stats count() as @eventCount by eventType
```

Die folgende Abfrage ruft die Avail-ID und die Liste übersprungener Anzeigen für alle Avails ab, für die Anzeigen übersprungen wurden.

```
fields avail.availId
| parse @message '"skippedAds":[*]' as @skippedAdsList
| filter ispresent(@skippedAdsList)
```