View a markdown version of this page

Behebt Probleme mit der Verwaltung und Nachverfolgung von CDN-Sitzungen für MediaTailor - AWS Elemental MediaTailor

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.

Behebt Probleme mit der Verwaltung und Nachverfolgung von CDN-Sitzungen für MediaTailor

AWS Elemental MediaTailor Das Content Delivery Network (CDN) -Sitzungsmanagement ist entscheidend für die korrekte Personalisierung und Nachverfolgung von Anzeigen. Wenn Sie auf sitzungsbezogene Fehler oder inkonsistentes Verhalten bei Anfragen stoßen, gehen Sie wie folgt vor:

  1. Prüfen Sie, ob die Sitzungs-IDs konsistent sind:

    • Stellen Sie sicher, dass Ihr Player bei allen Anfragen für eine einzelne Wiedergabe-Sitzung dieselbe Sitzungs-ID verwendet

    • Überprüfe in den CDN-Protokollen, ob IDs die Sitzung korrekt weitergeleitet wurde

    • Stellen Sie sicher, dass IDs die Sitzungen in den Abfrageparametern ordnungsgemäß URL-kodiert sind

    • Verwenden Sie CloudWatch Protokolle, um die Konsistenz der Sitzungs-IDs bei allen Anfragen zu überprüfen (siehe Validierungsschritte unten)

  2. Überprüfen Sie die Sitzungsinitialisierung:

    • Vergewissern Sie sich, dass die erste Manifestanforderung erfolgreich eine Sitzung erstellt

    • Prüfen Sie, ob die Sitzungsparameter ordnungsgemäß weitergeleitet wurden (z. B.aws.sessionId)

    • Überprüfen Sie die Sitzungsinitialisierung mithilfe von Debug-Protokollen (siehe Einrichtung des Debug-Protokolls unten)

  3. Aktivieren Sie die Debug-Protokollierung für eine detaillierte Sitzungsbehandlung:

    • Für serverseitige Berichte: Fügen Sie Ihrer ?aws.logMode=DEBUG Wiedergabeanforderung Folgendes hinzu:

      GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

    • Für clientseitige Berichte: Fügen Sie den Text Ihrer Anfrage zur "logMode": "DEBUG" Initialisierung Ihrer Sitzung hinzu

    • Wichtig: Bei dem Wert wird zwischen Groß- und DEBUG Kleinschreibung unterschieden

    • Maximal 10 aktive Debug-Sitzungen sind gleichzeitig zulässig

  4. Verwenden Sie CloudWatch Protokollabfragen, um das Sitzungsverhalten zu überprüfen:

    • Stellen Sie sicher, dass die Debug-Sitzung aktiv ist:

      fields @timestamp, @message
| filter sessionId = "your-session-id-here"
| 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

    • Alle Ereignisse für eine Sitzung anzeigen:

      fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc

    • Überprüfen Sie die Manifestgenerierung für eine Sitzung:

      fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"

  5. Testen Sie die Weiterleitung von Sitzungsparametern über CDN:

    • Testen Sie Manifestanfragen mit Sitzungsparametern direkt gegen MediaTailor (unter Umgehung von CDN)

    • Vergleichen Sie das Sitzungsverhalten mit und ohne CDN, um Weiterleitungsprobleme zu identifizieren

    • Stellen Sie sicher, dass die Konfiguration für die Weiterleitung von CDN-Abfrageparametern sitzungsbezogene Parameter enthält

    • Stellen Sie sicher, dass CDN keine Antworten zwischenspeichert, die sitzungsspezifisch sein sollten

Häufige Sitzungsfehlermeldungen:

  • ConflictException(HTTP 409) — Mehrere gleichzeitige Playlist-Anfragen für dieselbe Sitzung. Lösung: Stellen Sie sicher, dass Ihr Player Playlisten einzeln gemäß der HLS-Spezifikation anfordert

  • NotFoundException(HTTP 404) — Die Sitzung ist nicht verfügbar oder die Konfiguration ist nicht vorhanden. Lösung: Überprüfen Sie die Gültigkeit Ihrer Konfiguration und initialisieren Sie die Sitzung erneut

  • BadRequestException(HTTP 400) — Ungültige Sitzungs-ID oder falsch formatierte Anfrage. Lösung: Überprüfen Sie die Formatierung der Anfrage und die Gültigkeit der Sitzungs-ID

Zusätzliche Ressourcen zur Problembehandlung:

Erfolgskriterien: Wenn das Problem behoben ist, sollten die Sitzungen korrekt initialisiert werden, eine konsistente Sitzung IDs über alle Anfragen hinweg aufrechterhalten und die Debug-Protokolle sollten die richtigen SESSION_INITIALIZED Ereignisse und die Manifestgenerierung ohne Fehler anzeigen.