Risolvi i problemi relativi all'integrazione MediaTailor CDN - AWS Elemental MediaTailor
Preparazione per la risoluzioneGuide alla risoluzione dei problemi specifiche per i flussi di lavoro

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 relativi all'integrazione MediaTailor CDN

Questa guida completa alla risoluzione dei problemi copre i problemi più comuni di integrazione della rete di distribuzione dei contenuti (CDN) in tutte le AWS Elemental MediaTailor implementazioni, tra cui l'inserimento di annunci sul lato server (SSAI), l'assemblaggio dei canali e l'integrazione. AWS Elemental MediaPackage Quando la CDN e MediaTailor l'integrazione riscontrano problemi, utilizzate questo approccio diagnostico sistematico per identificare rapidamente le cause alla radice e implementare soluzioni convalidate.

Questa guida si applica a tutte le integrazioni MediaTailor CDN indipendentemente dal flusso di lavoro specifico. Per problemi specifici relativi a particolari servizi o flussi di lavoro, consulta le relative sezioni sulla risoluzione dei problemi a cui si fa riferimento alla fine di questa guida.

Prima di iniziare: tieni a portata di mano questi elementi per una risoluzione efficace dei problemi:

  • Esempi di riproduzione URLs che illustrano il problema

  • Registri di accesso al CDN relativi al periodo in cui si sono verificati i problemi

  • MediaTailor nome e regione di configurazione AWS

  • Tipo e versione del lettore (ad esempio, HLS.js 1.4.0, Video.js 8.0)

  • Informazioni sul dispositivo e sul browser in cui si verificano problemi

Argomenti correlati:

Preparazione per la risoluzione

Configura strumenti e processi per semplificare la risoluzione dei problemi in caso di problemi di integrazione CDN. La preparazione proattiva rende la risoluzione dei problemi più rapida ed efficace in caso di problemi.

Abilita la registrazione completa

I log dettagliati sono essenziali per diagnosticare i problemi di integrazione CDN. Configura la registrazione per acquisire le informazioni necessarie durante la risoluzione dei problemi.

  1. Abilita i log di accesso CDN dettagliati:

    • Configura la registrazione per tutti i comportamenti della cache che gestiscono le richieste MediaTailor

    • Includi stringhe di query e intestazioni personalizzate nelle voci di registro

    • Configura strumenti di analisi dei log per identificare modelli e anomalie

    • Abilita i log in tempo reale per il rilevamento immediato dei problemi durante gli eventi dal vivo

    • Configura le politiche di conservazione dei log per conservare i dati storici sulla risoluzione dei problemi

  2. Configura la MediaTailor registrazione:

    • Abilita i log di accesso per le tue configurazioni MediaTailor

    • Configura gruppi di CloudWatch log per la gestione centralizzata dei log

    • Configura i filtri di registro per identificare i modelli di errore

  3. Configura la registrazione del server di origine:

    • Abilita registri di accesso dettagliati sui tuoi server di origine dei contenuti

    • Includi le intestazioni delle richieste e i codici di risposta nei log

    • Monitora le metriche delle prestazioni del server di origine

Aggiungi intestazioni di richiesta diagnostica

Le intestazioni personalizzate aiutano a tenere traccia delle richieste tramite il CDN e a identificare i problemi di routing.

  1. Configura le intestazioni diagnostiche CDN:

    • Aggiungi un identificatore univoco a ciascuna richiesta (ad esempio,) X-Request-ID

    • Includi informazioni specifiche del CDN nelle intestazioni delle richieste

    • Aggiungi informazioni sulla edge location o POP (punto di presenza) per tracciare il routing geografico

    • Includi le intestazioni di stato della cache (Hit, Miss RefreshHit) per l'analisi del comportamento della cache

  2. Aggiungi le intestazioni di risposta per il debug:

    • Includi le intestazioni di identificazione del server

    • Aggiungi informazioni sulla tempistica per l'analisi delle prestazioni

    • Includi le intestazioni di controllo della cache per le richieste manifeste

Stabilisci metriche prestazionali di base

Documenta i normali intervalli di prestazioni per identificare rapidamente le anomalie durante la risoluzione dei problemi:

  1. Registra le metriche di base:

    • Rapporti di accesso alla cache per diversi tipi di contenuto

    • Percentili del tempo di risposta (P50, P95, P99)

    • Tassi di errore per codice di stato

    • Modelli di volume delle richieste per ora del giorno

  2. Documenta le aspettative prestazionali:

    • Individua le percentuali di accesso alla cache (oltre il 95% per i contenuti, oltre il 90% per gli annunci)

    • Tempi di risposta accettabili (<100 ms in cache, <500 ms in origine)

    • Tassi di errore massimi accettabili (< 1% per 4xx, < 0,1% per 5xx)

  3. Crea dashboard delle prestazioni: configura dashboard di monitoraggio che mostrino le metriche correnti rispetto ai valori di base.

Prepara strumenti di risoluzione dei problemi

Configura gli strumenti e le autorizzazioni di accesso necessari per una risoluzione efficace dei problemi:

  1. Strumenti da riga di comando:

    • curlper testare richieste e risposte HTTP

    • digo nslookup per la risoluzione dei problemi DNS

    • strumenti di convalida HLS/DASH per la verifica del manifesto

    • Strumenti di analisi dei log (grep, awk o analizzatori di log specializzati)

  2. Autorizzazioni di accesso:

    • Accesso alla console di gestione CDN per la revisione della configurazione

    • MediaTailor accesso alla console per la verifica della configurazione

    • CloudWatch accesso per metriche e analisi dei log

    • accesso al server Origin per la risoluzione dei problemi di backend

  3. Documentazione:

    • Diagrammi dell'architettura di rete

    • CDN e documentazione di configurazione MediaTailor

    • Informazioni di contatto per le procedure di escalation

    • Runbook per la risoluzione dei problemi relativi agli scenari più comuni

Guide alla risoluzione dei problemi specifiche per i flussi di lavoro

Questa guida universale alla risoluzione dei problemi copre i problemi più comuni a tutte le MediaTailor integrazioni CDN. Per problemi specifici relativi a flussi di lavoro o servizi particolari, consulta queste risorse specializzate per la risoluzione dei problemi:

Risoluzione dei problemi relativi all'inserimento di annunci sul lato server (SSAI)

Per problemi specifici relativi a SSAI, tra cui errori di inserimento degli annunci, problemi di transizione degli annunci e problemi di personalizzazione, consulta la documentazione sulla risoluzione dei problemi SSAI specifica del flusso di lavoro.

Problemi comuni specifici di SSAI:

  • Errori di inserimento degli annunci e interruzioni pubblicitarie vuote

  • Problemi di sincronizzazione e tempistica delle transizioni

  • Problemi di personalizzazione e targeting

  • Discrepanze nel tracciamento degli annunci e nell'analisi

Risoluzione dei problemi relativi all'assemblaggio

Per i problemi specifici relativi all'assemblaggio dei canali, inclusi i problemi di generazione dei manifesti e la funzionalità time-shift, consultate la documentazione sul flusso di lavoro di assemblaggio dei canali.

Problemi comuni di assemblaggio dei canali:

  • Errori di generazione e compilazione del manifesto

  • Problemi relativi alla finestra Time-shift e alla funzionalità del DVR

  • Problemi di disponibilità e failover dei contenuti di origine

  • Pianificazione del programma e sincronizzazione dei metadati

MediaPackage risoluzione dei problemi di integrazione

Per problemi MediaPackage specifici, tra cui il filtraggio dei manifesti e i problemi relativi agli endpoint EMP, vedere. Risoluzione dei problemi di integrazione CDN

Problemi di integrazione comuni: MediaPackage

  • Errori manifesti dei parametri di filtraggio

  • MediaPackage problemi di connettività degli endpoint

  • problemi di comportamento della cache specifici di EMP

  • MediaPackage problemi di autenticazione dell'origine

CloudFront risoluzione dei problemi specifici

Per problemi CloudFront specifici di configurazione e configurazione, consulta la documentazione CloudFront sull'integrazione.

CloudFront Problemi comuni:

  • Configurazione della distribuzione e impostazione del comportamento della cache

  • Identità di accesso all'origine e configurazione della sicurezza

  • CloudFront codici e risposte di errore specifici

  • Restrizioni geografiche e problemi di localizzazione periferica

Risorse aggiuntive: