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.
Generieren AWS Elemental MediaTailor Debug-Protokolle
Verwenden Sie Debug-Protokolle, um Probleme mit der MediaTailor Anzeigeneinblendung bei der Wiedergabe von Sitzungen zu beheben. Um Debug-Logs zu generieren, stellen Sie den Log-Modus in der Player-Anfrage auf „Debuggen“ ein MediaTailor. Stellen Sie für serverseitige Berichte den Protokollmodus in der Wiedergabeanforderung ein. Für die clientseitige Berichterstattung 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.
-
Origin-Interaktion — Details zu MediaTailor Interaktionen mit dem Original-Server. Zum Beispiel die Antwort auf das Original-Manifest, der Manifesttyp und die Ursprungs-URL.
-
Generiertes Manifest — Details zur Antwort der Wiedergabesitzung von MediaTailor. Zum Beispiel das Manifest, das MediaTailor generiert wird.
-
Sitzung initialisiert — Details zur Sitzungsinitialisierung, z. B. die Sitzungs-ID.
Informationen zum Anpassen der Protokollierungsereignistypen, die Sie pro Sitzung erhalten, finden Sie unter. Filterung von Protokollen und Ereignissen
Voraussetzungen
Um den Protokollmodus auf Debuggen einzustellen, müssen Sie zunächst die MediaTailor Erlaubnis erteilen, Protokolle an diese Adresse zu senden CloudWatch, sofern Sie dies noch nicht getan haben. Sobald Sie die Zugriffsberechtigung MediaTailor erteilt haben CloudWatch, können Sie den Debug-Log-Modus aktivieren. Informationen zum Erteilen von MediaTailor Zugriffsberechtigungen CloudWatch finden Sie unter Zugriffsberechtigungen für Amazon einrichten CloudWatch.
Wie setze ich den Log-Modus auf Debug
In diesem Abschnitt wird erklärt, wie Sie den Protokollmodus für serverseitige und clientseitige Berichte auf Debugging einstellen.
Server-side Berichterstattung
Für serverseitige Berichte sollten Sie den ?aws.logMode=DEBUG Abfrageparameter und den Wert in die Wiedergabeanforderung Ihres GET HTTP Players an den HLS- oder MediaTailor DASH-Endpunkt aufnehmen. Allgemeine Informationen zur serverseitigen Berichterstattung finden Sie unter Berichterstattung. Server-side
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=DEBUGNachdem 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 in dem Wiedergabeendpunkt enthalten, der sie MediaTailor bereitstellt. Weitere Informationen finden Sie unter Verify that the debug log mode is active for your playback session.
Client-side Berichterstattung
Für clientseitige Berichte fügen Sie den logMode Schlüssel und den DEBUG Wert in den Anforderungstext Ihres Kunden zur POST HTTP Sitzungsinitialisierung für den MediaTailor Endpunkt/ein. v1/session Allgemeine Informationen zur clientseitigen Berichterstattung finden Sie unter Berichterstattung. Client-Side
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 Debug-Sitzung aktiv ist. Um zu überprüfen, ob die Debug-Sitzung aktiv ist, vergewissern Sie sich, dass in den CloudWatch Protokollen ein SESSION_INITIALIZED Ereignis mit der Sitzungs-ID verknüpft ist. Die Sitzungs-ID ist in dem Wiedergabeendpunkt enthalten, der MediaTailor Folgendes 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 die Initialisierungs- oder Wiedergabeanforderung für die Sitzung an sendet MediaTailor, MediaTailor überprüft er, ob das Limit erreicht wurde. Ist dies der Fall, wird MediaTailor überprüft, ob veraltete Sitzungen vorhanden sind. Eine Sitzung ist veraltet, wenn innerhalb eines bestimmten Zeitraums nicht auf sie zugegriffen wurde. Bei Livestreams beträgt dieser Zeitraum 10 Minuten, bei VOD-Streams 30 Minuten.
Wenn das maximale Limit für aktive Debug-Log-Sitzungen erreicht wurde, werden die Debug-Logs für Ihre Sitzung nicht in die CloudWatch Logs geschrieben. Wenn Sie in den Protokollen für Ihre Sitzung keine CloudWatch Debug-Protokolle sehen, haben Sie möglicherweise dieses Limit erreicht. Informationen zur Bestätigung, ob das Limit erreicht wurde, finden Sie unterVerify that the debug log mode is active for your playback session.
Debug-Protokollfelder
In der folgenden Tabelle sind die Debug-Protokollfelder 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-Protokollereignis zugeordnet ist. |
eventType |
Der Typ des Debug-Protokollereignisses. Werte:
|
originRequestUrl |
Die URL Ihres Ursprungsservers, die für diese Anfrage abgerufen wird. |
mediaTailorPath |
Der MediaTailor aufgerufene Endpunkt, 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 ursprüngliche Ursprungsmanifest oder das von generierte Manifest MediaTailor. |
sessionId |
Die ID der Wiedergabesitzung. |
sessionType |
Die Art der Wiedergabesitzung. Werte: |
Lesen Sie die Debug-Protokolle
MediaTailor schreibt die Debug-Protokolle in Amazon CloudWatch Logs. Es fallen die üblichen 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-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 Wiedergabesitzung 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-Log-Modus 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 Ihrer Herkunft 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 RequestId anzeigen
Verwenden Sie diese Abfrage, um das Original-Manifest und das von generierte Manifest anzuzeigen. MediaTailor
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
