View a markdown version of this page

Monitora e risolvi i problemi relativi all'integrazione CloudFront MediaTailor - AWS Elemental MediaTailor
Configurazione del monitoraggio per l'integrazioneMonitoraggio delle prestazioni MQARRisoluzione dei problemi comuniWorkflow di risoluzione dei problemiFasi successive

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

Monitora e risolvi i problemi relativi all'integrazione CloudFront MediaTailor

AWS Elemental MediaTailor l'integrazione con Amazon CloudFront richiede un monitoraggio e una risoluzione dei problemi continui per mantenere prestazioni ottimali. Dopo aver implementato MediaTailor l'integrazione CloudFront e l'integrazione, monitora le prestazioni e preparati a risolvere eventuali problemi. La rete di distribuzione dei contenuti (CDN) fornisce strumenti per aiutarvi a capire le prestazioni della distribuzione e a identificare potenziali problemi.

Configurazione del monitoraggio per l'integrazione

Implementa queste strategie di monitoraggio per monitorare le prestazioni della tua CloudFront e dell' MediaTailorintegrazione:

Per configurare il monitoraggio CloudFront e l' MediaTailor integrazione

  1. Abilita la registrazione CloudFront standard:

    1. Nella CloudFront console, seleziona la tua distribuzione.

    2. Scegli la scheda Log.

    3. In Registri standard, scegli Modifica.

    4. Seleziona Attivo e configura un bucket Amazon S3 per l'archiviazione dei log.

    5. Scegli Save changes (Salva modifiche).

  2. Configura i log in CloudFront tempo reale:

    1. Nella CloudFront console, seleziona la tua distribuzione.

    2. Scegli la scheda Log.

    3. In Real-time registri, scegli Modifica.

    4. Seleziona Attivato e configura un flusso di distribuzione Amazon Kinesis Data Streams o Amazon Data Firehose.

    5. Includi questi campi nella configurazione del registro:

      • time-to-first-byte- Tempo di risposta

      • sc-status- Codice di stato HTTP

      • c-ip- Indirizzo IP del visualizzatore

      • cs-uri-stem- Richiedere il percorso URI

      • cs-user-agent- Agente utente

      • x-edge-result-type- Tipo di risultato (Hit, Miss, Error)

    6. Scegli Save changes (Salva modifiche).

  3. Crea CloudWatch dashboard:

    1. Nella CloudWatch console, scegli Dashboard.

    2. Seleziona Crea pannello di controllo.

    3. Aggiungi widget per queste CloudFront metriche:

      • Richieste

      • BytesDownloaded

      • 4xx ErrorRate

      • 5xx ErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. Impostare gli CloudWatch allarmi:

    1. Nella CloudWatch console, scegli Allarmi.

    2. Scegli Crea allarme.

    3. Crea allarmi per queste condizioni:

      • 5xx ErrorRate > 1% per 5 minuti

      • 4xx ErrorRate superiore al 5% per 5 minuti

      • CacheHitRate meno dell'80% per 30 minuti

Monitoraggio delle prestazioni MQAR

Quando si utilizza MQAR, il monitoraggio aiuta a capire come CloudFront scegliere tra le proprie origini e se i punteggi di qualità soddisfano le aspettative. Real-time i registri mostrano queste decisioni nel momento in cui avvengono.

Per monitorare le prestazioni MQAR

  1. Abilita i log in tempo reale per la tua CloudFront distribuzione.

  2. Includi questi campi nella configurazione del registro:

    • r-host- Il nome host dell'origine selezionata

    • sr-reason- Il motivo della selezione dell'origine

    • x-edge-mqcs- Il punteggio di affidabilità della qualità dei media

  3. Configura una destinazione di log in Amazon Kinesis Data Streams o Amazon Data Firehose.

  4. Crea dashboard o avvisi in base a queste metriche per monitorare i punteggi di qualità e le decisioni sulla selezione dell'origine.

Esempio Esempio di CloudWatch dashboard per il monitoraggio MQAR

Crea una CloudWatch dashboard con queste metriche:

  • La selezione dell'origine viene conteggiata per regione

  • Punteggi di qualità medi nel tempo

  • Eventi di failover

  • Tassi di errore 4xx e 5xx per origine

Per ulteriori informazioni sulla configurazione dei log in tempo reale, consulta i Real-time log nella guida per gli CloudFront sviluppatori.

Risoluzione dei problemi comuni

Anche con un'attenta pianificazione possono sorgere problemi con l'utente CloudFront e MediaTailor l'integrazione. La comprensione dei problemi e delle soluzioni più comuni consente di risolverli rapidamente e di ridurre al minimo l'impatto sugli spettatori.

Se riscontri problemi con la tua CloudFront e con MediaTailor l'integrazione, controlla questi problemi e soluzioni comuni:

Problemi di caching manifesto

Sintomo: manifesti obsoleti o annunci non aggiornati

Soluzione: verifica di utilizzare i criteri di CachingDisabled cache per playlist multivarianti, playlist multimediali e percorsi MPD. Verifica che la tua configurazione inoltri correttamente i parametri delle query.

Errori CORS

Sintomo: la console del browser mostra errori CORS durante l'accesso ai contenuti

Soluzione: configura una policy sulle intestazioni di risposta con le intestazioni CORS appropriate e associala al comportamento della cache.

MQAR non funziona

Sintomo: la selezione dell'origine ignora i punteggi di qualità

Soluzione: verifica di aver abilitato l'opzione Punteggio di qualità multimediale nelle impostazioni del gruppo di origine. Verifica di non utilizzare trigger orientati all'origine di Lambda @Edge.

Errori di inserimento degli annunci

Sintomo: gli annunci non vengono inseriti correttamente

Soluzione: verifica che la MediaTailor configurazione punti alla CloudFront distribuzione del prefisso del segmento di contenuto. Verifica che la configurazione inoltri tutte le intestazioni richieste.

Per problemi più complessi, puoi utilizzare questi approcci di risoluzione dei problemi:

  1. Controllate i log CloudFront di distribuzione per individuare i modelli di errore

  2. Utilizza gli strumenti di sviluppo del browser per esaminare le richieste di rete

  3. Confronta i contenuti manifesti inviati MediaTailor direttamente con i contenuti distribuiti tramite CloudFront

  4. Effettua il test con un semplice player che supporti la registrazione dettagliata

Per ulteriore assistenza nella risoluzione dei problemi, consulta la sezione Risoluzione dei problemi nella guida per l' MediaTailor utente.

Workflow di risoluzione dei problemi

Segui questo approccio sistematico per risolvere i problemi relativi al tuo CloudFront sistema e all'integrazione: MediaTailor

Per risolvere i problemi e i problemi CloudFront di integrazione MediaTailor

  1. Identifica il problema specifico:

    1. Stabilisci se il problema riguarda tutti gli spettatori o solo alcuni

    2. Identifica i tipi di contenuto interessati (manifesti, segmenti o entrambi)

    3. Annota eventuali messaggi di errore o sintomi

  2. Controlla CloudFront i log:

    1. Cerca i codici di stato degli errori (4xx o 5xx)

    2. Controlla gli schemi della cache hit/miss

    3. Verifica che le richieste vengano indirizzate all'origine corretta

  3. Verifica la configurazione:

    1. Controlla i comportamenti della cache per individuare i modelli di percorso corretti

    2. Verifica che i criteri della cache siano applicati correttamente

    3. Verifica che i criteri di richiesta di origine stiano inoltrando le intestazioni necessarie

  4. Prova l'accesso diretto:

    1. Prova ad accedere ai contenuti direttamente da MediaTailor (bypassando CloudFront)

    2. Confronta le risposte tra accesso diretto e CloudFront accesso

  5. Implementa la soluzione:

    1. Applica la correzione appropriata in base ai risultati

    2. Fai un test per verificare che il problema sia stato risolto

    3. Documenta il problema e la soluzione per riferimenti futuri

Fasi successive

Dopo aver impostato il monitoraggio e la risoluzione dei problemi relativi all'azienda CloudFront e MediaTailor all'integrazione, considera questi passaggi successivi:

  • Implementa l'implementazione automatizzata utilizzando AWS CloudFormation (vedi) Automatizzazione MediaTailor e CDN con CloudFormation

  • Crea runbook per scenari operativi e procedure di risoluzione dei problemi comuni

  • Imposta una soluzione automatica per i problemi più comuni