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
<a name="diagnose-session-issues"></a>

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)

1. 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)

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

1. 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"
     ```

1. 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:**
+ Per la configurazione completa della registrazione di debug e il riferimento ai campi, vedere [Generazione AWS Elemental MediaTailor registri di debug](debug-log-mode.md)
+ Per esempi di CloudWatch interrogazioni relative ai log e per l'analisi dei log, vedere [Scrittura AWS Elemental MediaTailor accede direttamente ad Amazon CloudWatch Logs](monitoring-cw-logs.md)
+ Per la configurazione dell'inoltro dei parametri delle query CDN, vedere [Configurare i comportamenti di routing CDN per MediaTailor](cdn-routing-behaviors.md)
+ Per un riferimento completo al codice di errore, vedere [Risoluzione dei problemi di riproduzione da MediaTailor](playback-errors.md)

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