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à.
Generazione di registri di debug
Utilizza i log di debug per risolvere i problemi relativi alla sessione di riproduzione di inserzioni MediaTailor pubblicitarie. Per generare registri di debug, imposta la modalità di registro su debug nella richiesta del player. MediaTailor Per la segnalazione lato server, imposta la modalità di registro nella richiesta di riproduzione. Per i report lato client, imposta la modalità di registro nella richiesta di inizializzazione della sessione.
Quando la modalità di registro è impostata su debug, MediaTailor scrive i dati del registro di debug in Logs. CloudWatch I log di debug forniscono informazioni sui seguenti eventi. Per un elenco completo dei dati prodotti nei log di debug, vedete Debug log fields.
-
Interazione con l'origine: dettagli sull'interazione MediaTailor dell'utente con il server di origine. Ad esempio, la risposta del manifesto di origine, il tipo di manifesto e l'URL di origine.
-
Manifesto generato: dettagli sulla risposta della sessione di riproduzione da MediaTailor. Ad esempio, il manifesto che MediaTailor genera.
-
Sessione inizializzata: dettagli di inizializzazione della sessione, come l'ID della sessione.
Prerequisiti
Per impostare la modalità di registro su debug, devi prima concedere l' MediaTailor autorizzazione a inviare i log CloudWatch, se non l'hai già fatto. Dopo aver concesso l'autorizzazione MediaTailor all'accesso CloudWatch, sei pronto per abilitare la modalità di registro di debug. Per informazioni su come concedere l' MediaTailor autorizzazione all'accesso, CloudWatch consulta Configurazione delle autorizzazioni per Amazon CloudWatch.
Come impostare la modalità di registro per il debug
Questa sezione spiega come impostare la modalità di registro per il debug per il reporting lato server e il reporting lato client.
Reportistica lato server
Per i report lato server, includi il parametro e il valore della ?aws.logMode=DEBUG query nella richiesta di GET HTTP riproduzione del lettore all'endpoint HLS o DASH. MediaTailor Per informazioni generali sui report lato server, consulta Server-side Reporting.
Importante
Il valore DEBUG prevede la distinzione tra lettere maiuscole e minuscole.
Una richiesta di riproduzione che include ?aws.logMode=DEBUG è simile alla seguente:
Esempio Richiesta di riproduzione su un endpoint HLS
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUGDopo aver impostato la modalità di registro su debug, si consiglia di verificare che la sessione di registrazione di debug sia attiva. Per verificare che la sessione di debug sia attiva, controlla se ci sono CloudWatch registri per l'ID della sessione. L'ID di sessione è incluso nell'endpoint di riproduzione che lo fornisce. MediaTailor Per ulteriori informazioni, consulta Verify that the debug log mode is active for your playback session.
Reportistica lato client
Per i report lato client, includi la logMode chiave e il DEBUG valore nel corpo della richiesta di inizializzazione della POST HTTP sessione del client all'endpoint /v1/session. MediaTailor Per informazioni generali sui report lato client, consulta Client-Side Reporting.
Importante
Il valore DEBUG prevede la distinzione tra lettere maiuscole e minuscole.
Dopo aver impostato la modalità di registro su debug, si consiglia di verificare che la sessione di debug sia attiva. Per verificare che la sessione di debug sia attiva, verifica che nei registri sia presente un SESSION_INITIALIZED evento associato all'ID di sessione. CloudWatch L'ID di sessione è incluso nell'endpoint di riproduzione che fornisce. MediaTailor Per ulteriori informazioni, consulta Verify that the debug log mode is active for your playback session.
Numero massimo di sessioni di debug attive
È possibile avere un massimo di 10 sessioni di registro di debug attive. Quando il lettore invia la richiesta di inizializzazione della sessione o di riproduzione a MediaTailor, MediaTailor verifica se il limite è stato raggiunto. In caso affermativo, MediaTailor controlla se ci sono sessioni obsolete. Una sessione è obsoleta se non vi si accede entro un certo periodo di tempo. Per i live streaming questo periodo di tempo è di 10 minuti, per gli stream VOD è di 30 minuti.
Se è stato raggiunto il limite massimo di sessioni di registro di debug attive, i log di debug non vengono scritti nei registri della sessione. CloudWatch Se non vedi i log di debug nei CloudWatch log della tua sessione, potresti aver raggiunto questo limite. Per confermare se il limite è stato raggiunto, consulta. Verify that the debug log mode is active for your playback session
Campi di registro di debug
La tabella seguente elenca i campi del registro di debug in cui è possibile MediaTailor scrivere. CloudWatch
| Campo | Descrizione |
|---|---|
awsAccountId |
Il tuo Account AWS ID. |
customerId |
Il tuo ID MediaTailor cliente. |
eventTimestamp |
Il timestamp ISO 8601 associato all'evento del registro di debug. |
eventType |
Il tipo di evento del registro di debug. Valori:
|
originRequestUrl |
L'URL del server di origine recuperato per questa richiesta. |
mediaTailorPath |
L' MediaTailor endpoint che è stato chiamato, inclusi tutti i parametri passati MediaTailor nella richiesta manifesta iniziale. |
requestId |
L'ID di una richiesta HTTP specifica a MediaTailor. |
responseBody |
Il manifesto nel corpo della risposta da MediaTailor. Questo è il manifesto di origine non elaborato o il manifesto generato da MediaTailor. |
sessionId |
L'ID della sessione di riproduzione. |
sessionType |
Il tipo di sessione di riproduzione. Valori: |
Leggi i log di debug
MediaTailor scrive i log di debug su Amazon CloudWatch Logs. Si applicano le tariffe tipiche CloudWatch dei log. Usa CloudWatch Insights per leggere i log di debug. Per informazioni su come utilizzare CloudWatch Logs Insights, consulta Analyzing Log Data with CloudWatch Logs Insights nella CloudWatch AWS Logs User Guide.
Nota
La visualizzazione dei log di debug può richiedere alcuni minuti. CloudWatch Se non vedi i log, attendi qualche minuto e riprova. Se continui a non visualizzare i log, è possibile che tu abbia raggiunto il numero massimo di sessioni di registro di debug attive. Per verificare se questo è il caso, esegui una CloudWatch query per vedere se è stata inizializzata una sessione di debug per la sessione di riproduzione. Per ulteriori informazioni, consulta Verify that the debug log mode is active for your playback session.
Esempi
Questa sezione include interrogazioni di esempio che è possibile utilizzare per leggere MediaTailor i dati del registro di debug.
Esempio 1: Verificate che la modalità di registro di debug sia attiva per la sessione di riproduzione
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
Esempio 2: Visualizza le risposte dalla tua origine
fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
Esempio 3: Visualizza il manifesto generato da MediaTailor per una determinata sessione
fields @timestamp, responseBody, @message | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
Esempio 4: Visualizza tutti gli eventi per una determinata requestId
Utilizzate questa query per visualizzare il manifesto di origine e il manifesto generato da MediaTailor.
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
