Debug-Logs 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 die Debug-Protokolldaten in Logs MediaTailor geschrieben. CloudWatch Die Debug-Protokolle enthalten Informationen zu den folgenden Ereignissen. Eine vollständige Liste der in den Debug-Protokollen erzeugten Daten finden Sie unter Debug-Protokollfelder.

• Origin-Interaktion — Details zur MediaTailor Interaktion mit dem Ursprungsserver. Zum Beispiel die Antwort auf das Ursprungs-Manifest, der Manifesttyp und der UrsprungURL.

• 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.

Voraussetzungen

Um den Protokollmodus auf Debug zu setzen, 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.

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ür serverseitige Berichte fügen Sie den ?aws.logMode=DEBUG Abfrageparameter und den Wert in die Wiedergabeanforderung Ihres GET HTTP Players an den HLS DASH MediaTailor OR-Endpunkt ein. Allgemeine Informationen zur serverseitigen Berichterstattung finden Sie unter Serverseitige Berichterstattung.

Wichtig

Bei DEBUG-Wert ist die Groß- und Kleinschreibung zu beachten.

Eine Wiedergabeanforderung, die Folgendes beinhaltet, ?aws.logMode=DEBUG sieht wie folgt aus:

Beispiel Wiedergabeanforderung an einen HLS Endpunkt

GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?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.

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.

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.

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 unterVerify that the debug log mode is active for your playback session.

Debuggen von Protokollfeldern

In der folgenden Tabelle sind die Debug-Logfelder aufgeführt, in die MediaTailor geschrieben wird. CloudWatch

Feld	Beschreibung
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: ORIGIN_INTERACTION— Details zur MediaTailor Interaktion mit dem Ursprungsserver. Zum Beispiel die Antwort auf das Ursprungsmanifest, der Manifesttyp und der UrsprungURL. GENERATED_MANIFEST— Details zur Antwort auf die Wiedergabesitzung von MediaTailor. Zum Beispiel das Manifest, das MediaTailor generiert wird. SESSION_INITIALIZED— Details zur Sitzungsinitialisierung, z. B. die Sitzungs-ID.
originRequestUrl	Der 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 im AWS CloudWatch Logs-Benutzerhandbuch.

Anmerkung

Es kann einige Minuten dauern, bis die Debug-Logs 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.

Beispiele

Dieser Abschnitt enthält Beispielabfragen, mit denen Sie MediaTailor Debug-Protokolldaten lesen können.

Beispiel 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

Beispiel 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"

Beispiel 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"

Beispiel 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"