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 Logs direkt in Amazon CloudWatch Logs schreiben
MediaTailor erstellt Protokolle, die detaillierte Informationen über Sitzungsaktivitäten und Interaktionen mit dem Anzeigenentscheidungsserver enthalten, und schreibt sie an Amazon CloudWatch. Die Protokolle enthalten eine sequentielle Beschreibung der Aktivitäten, die während der Sitzung stattfinden.
MediaTailor kann auch verkaufte Holzscheite verwenden, um Flexibilität bei der Holzlieferung und Mengenrabatte zu erzielen. Informationen zu verkauften Protokollen finden Sie unter. [Verwendung von verkauften Protokollen](vended-logs.md)
**Topics**
+ [Berechtigungen für Amazon CloudWatch Logs](monitoring-permissions.md)
+ [Protokoll „As Run“ für AWS Elemental MediaTailor Channel Assembly](as-run-log.md)
+ [AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights](monitor-cloudwatch-ads-logs.md)
# Berechtigungen für Amazon CloudWatch Logs
Verwenden Sie AWS Identity and Access Management (IAM), um eine Rolle zu erstellen, die AWS Elemental MediaTailor Zugriff auf Amazon CloudWatch gewährt. Sie müssen diese Schritte ausführen, damit CloudWatch Logs für Ihr Konto veröffentlicht werden. CloudWatch veröffentlicht automatisch Metriken für Ihr Konto.
**Um den MediaTailor Zugriff zu ermöglichen CloudWatch**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen**, und wählen Sie dann **Rolle erstellen**.
1. Wählen Sie den Rollentyp „**Anderes AWS Konto**“.
1. Geben Sie als **Konto-ID** Ihre AWS Konto-ID ein.
1. Wählen Sie **Require external ID (Externe ID fordern)** und geben Sie **Midas** ein. Mit dieser Option wird automatisch eine Bedingung zur Vertrauensrichtlinie hinzugefügt, die es dem Service nur dann ermöglicht, die Rolle anzunehmen, wenn in der Anforderung die richtige `sts:ExternalId` enthalten ist.
1. Wählen Sie **Weiter: Berechtigungen** aus.
1. Fügen Sie eine Berechtigungsrichtlinie hinzu, in der die Aktionen angegeben werden, die von dieser Rolle ausgeführt werden dürfen. Wählen Sie eine der folgenden Optionen aus und wählen Sie dann **Next: Review (Nächster Schritt: Prüfen)**:
+ **CloudWatchLogsFullAccess**um vollen Zugriff auf Amazon CloudWatch Logs zu gewähren
+ **CloudWatchFullAccess**um vollen Zugriff auf Amazon zu gewähren CloudWatch
1. Geben Sie für **Role name (Rollenname)** den Namen **MediaTailorLogger** ein und klicken Sie auf **Create role (Rolle erstellen)**.
1. Wählen Sie auf der Seite **Roles (Rollen)** die von Ihnen soeben erstellte Rolle aus.
1. Bearbeiten Sie die Vertrauensstellung, um den Prinzipal zu aktualisieren:
1. Wählen Sie auf der Seite **Summary (Übersicht)** der Rolle die Registerkarte **Trust relationship (Vertrauensstellung)** aus.
1. Wählen Sie **Vertrauensstellung bearbeiten** aus.
1. Ändern Sie im Richtliniendokument den Principal in den MediaTailor Service. Das sollte wie folgt aussehen:
```
"Principal": {
"Service": "mediatailor.amazonaws.com"
},
```
Die gesamte Richtlinie sollte folgendermaßen lauten:
1. Wählen Sie **Update Trust Policy** (Trust Policy aktualisieren).
# Protokoll „As Run“ für AWS Elemental MediaTailor Channel Assembly
Das *As Run-Protokoll* in der CloudWatch `MediaTailor/Channel/AsRunLog` Protokollgruppe enthält Informationen zu Programmen und Werbeunterbrechungen, während sie abgespielt werden.
Wenn Sie einen Channel erstellen, ist das As Run-Protokoll standardmäßig deaktiviert. Mit der Konsole oder der AWS Command Line Interface (AWS CLI) können Sie den Protokollstatus „As Run“ für jeden Kanal in Ihrem Konto aktivieren und deaktivieren.
Wenn Sie das As-Run-Protokoll aktivieren, MediaTailor wird automatisch eine dienstbezogene Rolle erstellt, mit der Sie das As-Run-Protokoll in Ihrem CloudWatch Logs-Konto schreiben und verwalten können MediaTailor . Weitere Informationen zu serviceverknüpften Rollen finden Sie unter [Verwenden von serviceverknüpften Rollen für MediaTailor](using-service-linked-roles.md).
**Anmerkung**
Das As Run Log unterstützt derzeit nur das Standardprogramm. Derzeit werden die durch Programmregeln erstellten AlternateMedia nicht unterstützt. Dies bedeutet, dass das As Run Log für AlternateMedia derzeit nicht generiert wird.
**Topics**
+ [Das As Run-Protokoll aktivieren](enabling-as-run-log.md)
+ [Das As Run-Protokoll deaktivieren](disabling-as-run-log.md)
# Das As Run-Protokoll aktivieren
Um das As Run-Protokoll zu aktivieren, geben Sie den Kanalnamen an und aktivieren Sie den Protokolltyp *As Run* für diesen Kanal.
------
#### [ Console ]
**Um das As Run-Protokoll beim Erstellen eines Kanals zu aktivieren**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie in der Navigationsleiste die Option **Kanal erstellen** aus.
1. Konfigurieren Sie Ihren **Kanal in den Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** wie gewünscht.
1. Wählen Sie im Bereich **Zugriffskontrolle** die Option **Weiter** aus.
1. Wählen Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren** aus, um das Protokoll Als Ausführung zu aktivieren.
**Um das As-Run-Protokoll bei der Aktualisierung eines Kanals zu aktivieren**
**Anmerkung**
Wenn der Kanal gerade läuft, müssen Sie ihn zuerst beenden, bevor Sie ihn aktualisieren können. Nachdem Sie den Kanal gestoppt haben, können Sie „**Aktionen****“ > „Bearbeiten“** wählen, um mit der Aktualisierung des Kanals zu beginnen.
1. Melde dich bei an AWS-Managementkonsole und öffne die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktualisieren möchten.
1. Wählen Sie **Actions** (Aktionen) und **Edit** (Bearbeiten).
1. Aktualisieren Sie in den **Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** Ihre Kanalkonfiguration wie gewünscht.
1. Wählen Sie im Bereich „**Zugriffskontrolle**“ die Option **Weiter** aus.
1. Wählen Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren** aus, um das Protokoll Als Ausführung zu aktivieren.
**Um das As-Run-Protokoll auf der Registerkarte **Protokollierung** zu aktivieren**
**Anmerkung**
Wenn der Channel gerade läuft, müssen Sie die Registerkarte **Logging** verwenden, anstatt **Aktionen** > **Bearbeiten** zu wählen, um das As Run-Protokoll zu aktivieren.
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktivieren möchten.
1. Wählen Sie in der Navigationsleiste unter dem Namen des Kanals die Option **Logging** aus.
1. Wählen Sie unter **Protokollierung** > **Protokolltypen** die Option **Als ausgeführt** aus, um das Protokoll Als ausgeführt zu aktivieren.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um das As Run-Protokoll zu aktivieren**
Führen Sie den [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)Befehl aus und geben Sie die entsprechenden Werte für die erforderlichen Parameter an.
Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\$1) zur Verbesserung der Lesbarkeit.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types AS_RUN
```
Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types AS_RUN
```
Wobei Folgendes gilt:
+ `MyChannel`ist der Name des Kanals, der Ihnen gehört und für den Sie das As Run-Protokoll aktivieren möchten.
Wird der Befehl erfolgreich ausgeführt, erhalten Sie eine Ausgabe ähnlich der folgenden:
```
{
"ChannelName": "MyChannel",
"LogTypes": [
"AS_RUN"
]
}
```
------
# Das As Run-Protokoll deaktivieren
Um das As-Run-Protokoll für einen Kanal zu deaktivieren, für den es aktiviert ist, geben Sie den Kanalnamen an und deaktivieren Sie den Protokolltyp *As Run* für diesen Kanal.
------
#### [ Console ]
**Um das As Run-Protokoll bei der Aktualisierung eines Kanals zu deaktivieren**
**Anmerkung**
Wenn der Kanal gerade läuft, müssen Sie ihn zuerst beenden, bevor Sie ihn aktualisieren können. Nachdem Sie den Kanal gestoppt haben, können Sie „**Aktionen****“ > „Bearbeiten“** wählen, um mit der Aktualisierung des Kanals zu beginnen.
1. Melde dich bei an AWS-Managementkonsole und öffne die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll aktualisieren möchten.
1. Wählen Sie **Actions** (Aktionen) und **Edit** (Bearbeiten).
1. Aktualisieren Sie in den **Bereichen Kanaldetails festlegen**, **Ausgänge konfigurieren** und **Zugriffskontrolle** Ihre Kanalkonfiguration wie gewünscht.
1. Wählen Sie im Bereich „**Zugriffskontrolle**“ die Option **Weiter** aus.
1. Deaktivieren Sie im Bereich **Protokollierung** unter **Protokolltypen** die Option **Als Ausführung aktivieren**, um das Protokoll Als Ausführung zu deaktivieren.
**Um das As-Run-Protokoll auf der Registerkarte **Protokollierung** zu deaktivieren**
**Anmerkung**
Wenn der Channel gerade läuft, müssen Sie die Registerkarte **Logging** verwenden, anstatt **Aktionen** > **Bearbeiten** zu wählen, um das As Run-Protokoll zu deaktivieren.
1. Melden Sie sich bei an AWS-Managementkonsole und öffnen Sie die MediaTailor Konsole unter [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/).
1. Wählen Sie im Navigationsbereich **Channel-Assembly > **Channels**** aus.
1. Wählen Sie den Kanal aus, für den Sie das As Run-Protokoll deaktivieren möchten.
1. Wählen Sie in der Navigationsleiste unter dem Namen des Kanals die Option **Logging** aus.
1. Deaktivieren Sie unter **Protokollierung** > **Protokolltypen** die Option **Als ausgeführt**, um das Protokoll Als ausgeführt zu deaktivieren.
------
#### [ AWS Command Line Interface (AWS CLI) ]
**Um das As-Run-Protokoll zu deaktivieren**
Führen Sie den [configure-logs-for-channel](https://docs.aws.amazon.com/cli/latest/reference/mediatailor/configure-logs-for-channel.html)Befehl aus und geben Sie die entsprechenden Werte für die erforderlichen Parameter an.
Dieses Beispiel ist für Linux, macOS oder Unix formatiert und verwendet den umgekehrten Schrägstrich (\$1) zur Verbesserung der Lesbarkeit.
```
$ aws mediatailor configure-logs-for-channel \
--channel-name MyChannel \
--log-types
```
Dieses Beispiel ist für Microsoft Windows formatiert und verwendet das Zeilenfortsetzungszeichen Caret (^), um die Lesbarkeit zu verbessern.
```
C:\> aws mediatailor configure-logs-for-channel ^
--channel-name MyChannel ^
--log-types
```
Wobei Folgendes gilt:
+ `MyChannel`ist der Name des Kanals, dessen Eigentümer Sie sind und für den Sie das As Run-Protokoll deaktivieren möchten.
Wird der Befehl erfolgreich ausgeführt, erhalten Sie eine Ausgabe ähnlich der folgenden:
```
{
"ChannelName": "MyChannel",
"LogTypes": []
}
```
------
# AWS Elemental MediaTailor ADS-Protokollanalyse in Amazon CloudWatch Logs Insights
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
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)
```