View a markdown version of this page

Risolvi i problemi di gestione e tracciamento delle sessioni CDN per MediaTailor - AWS Elemental MediaTailor

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risolvi i problemi di gestione e tracciamento delle sessioni CDN per MediaTailor

AWS Elemental MediaTailor La gestione delle sessioni della rete di distribuzione dei contenuti (CDN) è fondamentale per una corretta personalizzazione e tracciamento degli annunci. Se riscontri errori relativi alla sessione o comportamenti incoerenti tra le richieste:

  1. Verifica la coerenza dell'ID di sessione:

    • Verifica che il lettore mantenga lo stesso ID di sessione per tutte le richieste di una singola sessione di riproduzione

    • Controlla i registri CDN per confermare che la sessione venga inoltrata IDs correttamente

    • Assicurati che la sessione sia correttamente codificata IDs in URL nei parametri di interrogazione

    • Utilizza CloudWatch i log per verificare la coerenza dell'ID di sessione tra le richieste (vedi i passaggi di convalida di seguito)

  2. Convalida l'inizializzazione della sessione:

    • Conferma che la prima richiesta manifesta crei correttamente una sessione

    • Verificate il corretto inoltro dei parametri di sessione (ad esempio,) aws.sessionId

    • Verifica l'inizializzazione della sessione utilizzando i registri di debug (vedi la configurazione del registro di debug di seguito)

  3. Abilita la registrazione di debug per una risoluzione dettagliata della sessione:

    • Per i report sul lato server: aggiungi ?aws.logMode=DEBUG alla tua richiesta di riproduzione:

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

    • Per i report sul lato client: includi "logMode": "DEBUG" nel corpo della richiesta di inizializzazione della sessione

    • Importante: il valore fa distinzione tra maiuscole e DEBUG minuscole

    • Sono consentite un massimo di 10 sessioni di debug attive contemporaneamente

  4. Usa le query CloudWatch Logs per convalidare il comportamento della sessione:

    • Verifica che la sessione di debug sia attiva:

      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

    • Visualizza tutti gli eventi di una sessione:

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

    • Controlla la generazione del manifesto per una sessione:

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

  5. Inoltro dei parametri della sessione di test tramite CDN:

    • Testa le richieste manifest con parametri di sessione direttamente (bypassando il CDN MediaTailor)

    • Confronta il comportamento delle sessioni con e senza CDN per identificare i problemi di inoltro

    • Verifica che la configurazione di inoltro dei parametri di interrogazione CDN includa parametri relativi alla sessione

    • Verifica che CDN non memorizzi nella cache le risposte che dovrebbero essere specifiche della sessione

Messaggi di errore di sessione comuni:

  • ConflictException(HTTP 409) - Richieste di playlist multiple simultanee per la stessa sessione. Soluzione: assicurati che il giocatore richieda le playlist una alla volta in base alle specifiche HLS

  • NotFoundException(HTTP 404) - La sessione non è disponibile o la configurazione non esiste. Soluzione: verifica la validità della configurazione e reinizializza la sessione

  • BadRequestException(HTTP 400) - ID di sessione non valido o richiesta formattata in modo errato. Soluzione: verifica la formattazione della richiesta e la validità dell'ID di sessione

Risorse aggiuntive per la risoluzione dei problemi:

Criteri di successo: una volta risolti, le sessioni dovrebbero inizializzarsi correttamente, mantenere una sessione IDs coerente tra le richieste e i log di debug dovrebbero mostrare SESSION_INITIALIZED gli eventi corretti e la generazione di manifesti senza errori.