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 AWS Elemental MediaTailor registri di debug
Utilizza i log di debug per risolvere i problemi relativi all'inserimento di MediaTailor annunci e alle sessioni di riproduzione. Per generare registri di debug, imposta la modalità di registro su debug nella richiesta del giocatore. MediaTailor Per i report sul lato server, imposta la modalità di registro nella richiesta di riproduzione. Per la segnalazione sul lato client, imposta la modalità di registro nella richiesta di inizializzazione della sessione.
Quando la modalità di registro è impostata su debug, MediaTailor scrive tutti i tipi di eventi di registro in Logs. CloudWatch I log forniscono informazioni sui seguenti eventi. Per un elenco completo dei dati prodotti nei log di debug, consulta i campi dei log di debug.
-
Interazione con l'origine: dettagli sulle MediaTailor interazioni 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.
Per personalizzare i tipi di eventi di registro che ricevi per sessione, consulta. Filtraggio di registri ed eventi
Prerequisiti
Per impostare la modalità di registro per il debug, devi prima concedere MediaTailor l'autorizzazione a inviare i log a CloudWatch, se non l'hai già fatto. Una volta concessa l'autorizzazione MediaTailor per l'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 la segnalazione lato server e la segnalazione lato client.
Server-side creazione di report
Per la segnalazione 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 sulla segnalazione lato server, consulta Reporting. Server-side
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 per il 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 di sessione. L'ID di sessione è incluso nell'endpoint di riproduzione fornito MediaTailor . Per ulteriori informazioni, consulta Verify that the debug log mode is active for your playback session.
Client-side segnalazione
Per la segnalazione lato client, includi la logMode chiave e il DEBUG valore nel corpo della richiesta di inizializzazione della POST HTTP sessione del cliente nell' MediaTailor endpoint /. v1/session Per informazioni generali sulla reportistica lato client, consulta Reporting. Client-Side
Importante
Il valore DEBUG prevede la distinzione tra lettere maiuscole e minuscole.
Dopo aver impostato la modalità di registro per il debug, si consiglia di verificare che la sessione di debug sia attiva. Per verificare che la sessione di debug sia attiva, conferma che nei log sia presente un SESSION_INITIALIZED evento associato all'ID di sessione. CloudWatch L'ID di sessione è incluso nell'endpoint di riproduzione fornito 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 log di debug attive. Quando il giocatore invia la richiesta di inizializzazione o riproduzione della sessione a MediaTailor, MediaTailor controlla se il limite è stato raggiunto. In caso MediaTailor affermativo, controlla se ci sono sessioni obsolete. Una sessione è obsoleta se non è stata effettuata l'accesso entro un determinato 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 debug attive, i log di debug non vengono scritti in Logs per CloudWatch la sessione. Se non vedi i log di debug in CloudWatch Logs per la tua sessione, potresti aver raggiunto questo limite. Per confermare se il limite è stato raggiunto, Verify that the debug log mode is active for your playback session consulta.
Campi del registro di debug
La tabella seguente elenca i campi del registro di debug in cui si MediaTailor scrive. CloudWatch
| Campo | Description |
|---|---|
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 del manifesto iniziale. |
requestId |
L'ID di una richiesta HTTP specifica a MediaTailor. |
responseBody |
Il manifest 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 in Amazon CloudWatch Logs. Si applicano le tariffe tipiche di CloudWatch Logs. 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 Guida per l'utente di AWS CloudWatch Logs.
Nota
La visualizzazione dei log di debug può richiedere alcuni minuti. CloudWatch Se non vedi i log, attendi qualche minuto e riprova. Se ancora non vedi i log, è possibile che tu abbia raggiunto il numero massimo di sessioni di log di debug attive. Per verificare se questo è il caso, esegui una CloudWatch query per vedere se è stata inizializzata una sessione di debug per la tua sessione di riproduzione. Per ulteriori informazioni, consulta Verify that the debug log mode is active for your playback session.
Esempi
Questa sezione include domande di esempio che è possibile utilizzare per leggere i dati del registro di MediaTailor debug.
Esempio 1: Verifica che la modalità di registro di debug sia attiva per la tua 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 un determinato RequestID
Usa 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"
