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 Debug-Protokolle werden generiert
Verwenden Sie Debug-Protokolle, um Probleme bei der Wiedergabesitzung beim Einfügen von MediaTailor Anzeigen zu beheben. Um Debug-Logs zu generieren, stellen Sie in der Anfrage des Players den Protokollmodus auf Debuggen ein. MediaTailor *Stellen Sie für serverseitige Berichte den Protokollmodus in der Wiedergabeanforderung ein.* Für clientseitige Berichte legen Sie den Protokollmodus in der Anforderung zur *Sitzungsinitialisierung* fest.
Wenn der Protokollmodus auf Debug gesetzt ist, werden alle Protokollereignistypen in Logs MediaTailor geschrieben. CloudWatch Die Protokolle enthalten Informationen zu den folgenden Ereignissen. Eine vollständige Liste der in den Debug-Protokollen erzeugten Daten finden Sie unter [Debug-Protokollfelder](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html#debug-log-mode-fields).
+ **Origin-Interaktion** — Details zu MediaTailor Interaktionen mit dem Ursprungsserver. Zum Beispiel die Antwort auf das Ursprungs-Manifest, der Manifesttyp und die Quell-URL.
+ **Generiertes Manifest** — Details zur Antwort auf die Playback-Sitzung von MediaTailor. Zum Beispiel das Manifest, das MediaTailor generiert wird.
+ **Sitzung initialisiert** — Details zur Sitzungsinitialisierung, z. B. die Sitzungs-ID.
Informationen zum Anpassen der Protokollereignistypen, die Sie pro Sitzung erhalten, finden Sie unter. [Filterung von Protokollen und Ereignissen](logs-filter.md)
## Voraussetzungen
Um den Protokollmodus auf Debug einzustellen, müssen Sie zunächst die MediaTailor Erlaubnis zum Senden von Protokollen an erteilen CloudWatch, falls Sie dies noch nicht getan haben. Sobald Sie die Zugriffsberechtigung MediaTailor erteilt haben CloudWatch, können Sie den Debug-Protokollmodus aktivieren. Informationen zum Erteilen von MediaTailor Zugriffsberechtigungen CloudWatch finden Sie unter [Berechtigungen für Amazon einrichten CloudWatch](https://docs.aws.amazon.com/mediatailor/latest/ug/monitoring-permissions.html).
## Wie stelle ich den Protokollmodus auf Debug ein
In diesem Abschnitt wird erklärt, wie Sie den Protokollmodus für serverseitige und clientseitige Berichte auf Debug einstellen.
### Serverseitige Berichterstattung
Fügen Sie für serverseitige Berichte den `?aws.logMode=DEBUG` Abfrageparameter und den Wert in die Wiedergabeanforderung Ihres `GET HTTP` Players an den HLS- oder DASH-Endpunkt ein. MediaTailor [Allgemeine Informationen zur serverseitigen Berichterstattung finden Sie unter Serverseitige Berichterstattung.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-server-side.html)
**Wichtig**
Bei `DEBUG`-Wert ist die Groß- und Kleinschreibung zu beachten.
Eine Wiedergabeanforderung, die Folgendes beinhaltet, `?aws.logMode=DEBUG` sieht wie folgt aus:
**Example Wiedergabeanforderung an einen HLS-Endpunkt**
```
GET {{}}/v1/master/{{}}/{{}}/{{}}?aws.logMode=DEBUG
```
Nachdem Sie den Protokollmodus auf Debug gesetzt haben, empfehlen wir Ihnen, zu überprüfen, ob die Debug-Protokollierungssitzung aktiv ist. Um zu überprüfen, ob die Debug-Sitzung aktiv ist, überprüfen Sie, ob CloudWatch Protokolle für die Sitzungs-ID vorhanden sind. Die Sitzungs-ID ist im Wiedergabeendpunkt enthalten, der dies MediaTailor bereitstellt. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
### Clientseitige Berichterstattung
Für die clientseitige Berichterstattung fügen Sie den `logMode` Schlüssel und den `DEBUG` Wert in den Text der Anfrage zur `POST HTTP` Sitzungsinitialisierung Ihres Clients in den /v1/session-Endpunkt ein. MediaTailor [Allgemeine Informationen zur clientseitigen Berichterstattung finden Sie unter Clientseitige Berichterstattung.](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-reporting-client-side.html)
**Wichtig**
Bei `DEBUG`-Wert ist die Groß- und Kleinschreibung zu beachten.
Nachdem Sie den Protokollmodus auf Debug gesetzt haben, empfehlen wir Ihnen, zu überprüfen, ob die Debugsitzung aktiv ist. Um zu überprüfen, ob die Debug-Sitzung aktiv ist, vergewissern Sie sich, dass in den Protokollen ein `SESSION_INITIALIZED` Ereignis mit der Sitzungs-ID verknüpft ist. CloudWatch Die Sitzungs-ID ist im Wiedergabeendpunkt enthalten, der Folgendes MediaTailor bereitstellt. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
## Maximale Anzahl aktiver Debug-Sitzungen
Sie können maximal 10 aktive Debug-Protokollsitzungen haben. Wenn Ihr Player seine Anfrage zur Sitzungsinitialisierung oder Wiedergabe an sendet MediaTailor, wird MediaTailor überprüft, ob das Limit erreicht wurde. Ist dies der Fall, wird MediaTailor überprüft, ob es veraltete Sessions gibt. Eine Sitzung ist veraltet, wenn innerhalb eines bestimmten Zeitraums nicht darauf zugegriffen wurde. Bei Live-Streams beträgt dieser Zeitraum 10 Minuten, bei VOD-Streams 30 Minuten.
Wenn das maximale Limit für aktive Debug-Protokollsitzungen erreicht wurde, werden Debug-Protokolle für Ihre Sitzung nicht in die CloudWatch Protokolle geschrieben. Wenn Sie in den Protokollen für Ihre Sitzung keine CloudWatch Debug-Protokolle sehen, haben Sie dieses Limit möglicherweise erreicht. Informationen darüber, ob das Limit erreicht wurde, finden Sie unter[Verify that the debug log mode is active for your playback session](#debug-active).
## Debuggen von Protokollfeldern
In der folgenden Tabelle sind die Debug-Logfelder aufgeführt, in die MediaTailor geschrieben wird. CloudWatch
| Feld | Description |
| --- | --- |
| awsAccountId | Ihre AWS-Konto ID. |
| customerId | Ihre MediaTailor Kundennummer. |
| eventTimestamp | Der ISO 8601-Zeitstempel, der dem Debug-Log-Ereignis zugeordnet ist. |
| eventType | Der Typ des Debug-Protokollereignisses. Werte:[See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/mediatailor/latest/ug/debug-log-mode.html) |
| originRequestUrl | Die URL Ihres Ursprungsservers, der für diese Anfrage abgerufen wird. |
| mediaTailorPath | Der MediaTailor Endpunkt, der aufgerufen wurde, einschließlich aller Parameter, die MediaTailor in der ersten Manifestanforderung übergeben wurden. |
| requestId | Die ID einer bestimmten HTTP-Anfrage an MediaTailor. |
| responseBody | Das Manifest im Antworttext von MediaTailor. Dies ist entweder das rohe Ursprungsmanifest oder das von generierte Manifest MediaTailor. |
| sessionId | Die ID der Wiedergabe-Sitzung. |
| sessionType | Die Art der Wiedergabesitzung. Werte: `HLS`, `DASH` |
## Lesen Sie die Debug-Protokolle
MediaTailor schreibt die Debug-Logs in Amazon CloudWatch Logs. Es fallen typische CloudWatch Logs-Gebühren an. Verwenden Sie CloudWatch Insights, um die Debug-Logs zu lesen. Informationen zur Verwendung von CloudWatch Logs Insights finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) im *AWS CloudWatch Logs-Benutzerhandbuch*.
**Anmerkung**
Es kann einige Minuten dauern, bis die Debug-Protokolle angezeigt werden. CloudWatch Wenn Sie die Protokolle nicht sehen, warten Sie ein paar Minuten und versuchen Sie es erneut. Wenn Sie die Protokolle immer noch nicht sehen, haben Sie möglicherweise die maximale Anzahl aktiver Debug-Protokollsitzungen erreicht. Um zu überprüfen, ob dies der Fall ist, führen Sie eine CloudWatch Abfrage aus, um festzustellen, ob für Ihre Playback-Sitzung eine Debug-Sitzung initialisiert wurde. Weitere Informationen finden Sie unter [Verify that the debug log mode is active for your playback session](#debug-active).
### Beispiele
Dieser Abschnitt enthält Beispielabfragen, mit denen Sie MediaTailor Debug-Protokolldaten lesen können.
**Example 1: Stellen Sie sicher, dass der Debug-Protokollmodus für Ihre Wiedergabesitzung aktiv ist**
```
fields @timestamp, @message
| filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like “/v1/master" # server-side reporting HLS
or mediaTailorPath like “/v1/dash" # server-side reporting DASH
```
**Example 2: Sehen Sie sich die Antworten von Ihrem Absender an**
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter eventType = "ORIGIN_MANIFEST" and sessionId = "{{32002de2-837c-4e3e-9660-f3075e8dfd90}}"
```
**Example 3: Sehen Sie sich das Manifest an, das von MediaTailor für eine bestimmte Sitzung generiert wurde**
```
fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "{{32002de2-837c-4e3e-9660-f3075e8dfd90}}"
```
**Example 4: Alle Ereignisse für eine bestimmte Zeit anzeigen `requestId`**
Verwenden Sie diese Abfrage, um das Ursprungsmanifest und das von generierte Manifest anzuzeigen MediaTailor.
```
fields @timestamp, responseBody, @message, mediaTailorPath
| filter requestId = "{{e5ba82a5-f8ac-4efb-88a0-55bed21c45b4}}"
```