Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor

AWS Elemental MediaTailor l'integrazione AWS Elemental MediaPackage e la rete di distribuzione dei contenuti (CDN) possono riscontrare problemi comuni che influiscono sulla riproduzione, sulla memorizzazione nella cache o su altre funzionalità di integrazione. Utilizza questa guida in caso di problemi di riproduzione, problemi di memorizzazione nella cache o altri errori relativi all'integrazione.

Per una guida completa alla risoluzione dei problemi CDN, compresi i problemi di prestazioni della cache universale, la risoluzione degli errori HTTP, le procedure di test e le tecniche diagnostiche applicabili a tutte le implementazioni, consulta. MediaTailor Risolvi i problemi di integrazione CDN Questa sezione si concentra sui requisiti MediaPackage specifici per la risoluzione dei problemi.

Prima della risoluzione dei problemi, assicurati di aver completato correttamente la configurazione di base dell'integrazione. Se non hai ancora configurato l'integrazione o devi rivedere i passaggi di configurazione, consultaIntegrazione MediaTailor con MediaPackage e CDN . Per indicazioni sull'ottimizzazione delle prestazioni della cache dopo la risoluzione dei problemi, consulta. Memorizzazione nella cache CDN

Errori di filtraggio manifesti

Problemi con la funzionalità di filtraggio dei MediaPackage manifesti, in base a condizioni di errore documentate:

Errori HTTP 400 con filtro manifesto

Sintomi: le richieste con aws.manifestfilter parametri restituiscono HTTP 400 Bad Request

Cause convalidate (dalla AWS documentazione):

• I criteri di filtro generano un manifesto vuoto (nessun flusso soddisfa le condizioni del filtro)

• Nomi o valori dei parametri di filtro non validi

• Sintassi della stringa di query non valida

• Parametri di filtro duplicati o ripetuti

• La stringa dei parametri di filtro supera i 1024 caratteri

• Parametri di interrogazione applicati a playlist o segmenti multimediali (non supportati)

Soluzioni:

1. Controlla i parametri del filtro per assicurarti che corrispondano ai flussi di contenuti disponibili. Se il filtraggio non produce flussi corrispondenti, MediaPackage restituisce HTTP 400.

2. Convalida la sintassi del filtro rispetto ai nomi dei parametri e ai formati di valori supportati.

3. Verifica la presenza di parametri duplicati nella stringa di query.

4. Assicurati che i parametri del filtro vengano applicati solo alle playlist multivarianti, non alle playlist o ai segmenti multimediali.

5. Verifica che la stringa totale dei parametri sia inferiore a 1024 caratteri.

Riferimento: condizioni di errore di filtro AWS Elemental MediaPackage manifesto

Il filtro dei manifesti non funziona (HTTP 200 ma nessun filtro applicato)

Sintomi: le richieste restituiscono HTTP 200 ma il manifesto contiene tutti i flussi anziché un sottoinsieme filtrato

Possibili cause:

• Il CDN non inoltra il parametro di query a aws.manifestfilter MediaPackage

• Parametro di filtro non trovato negli stream disponibili (restituisce un manifesto non filtrato con HTTP 200)

Soluzioni:

1. Verifica che la policy della cache CDN sia inclusa aws.manifestfilter nell'elenco delle stringhe di query inoltrate.

2. Testa i parametri del filtro direttamente rispetto agli MediaPackage endpoint (bypassando il CDN) per verificare che funzionino come previsto.

3. Verifica che i valori del filtro corrispondano alle caratteristiche effettive dei tuoi flussi di contenuti.

Riferimento: condizioni di errore di filtraggio AWS Elemental MediaPackage manifesto

Procedure diagnostiche

Le procedure diagnostiche sistematiche aiutano a identificare la causa principale dei problemi di integrazione in modo rapido ed efficiente. Seguendo un approccio strutturato si evita di perdere tempo sulla base di ipotesi errate e si assicura di affrontare il problema reale anziché i sintomi. Questi passaggi diagnostici basati sull'evidenza sono progettati per isolare i problemi e guidare l'utente verso la soluzione appropriata.

Segui questi passaggi diagnostici basati sull'evidenza per identificare i problemi:

Analizza le prestazioni della cache

L'analisi delle prestazioni della cache è fondamentale per le integrazioni EMP perché una scarsa efficienza della cache comporta un aumento del carico di origine, costi più elevati e potenziali problemi di riproduzione.

Per una risoluzione completa dei problemi relativi alle prestazioni della cache, tra cui l'analisi del rapporto di successo della cache, l'ottimizzazione delle chiavi della cache e procedure diagnostiche sistematiche, Problemi di prestazioni della cache CDN consultate la guida principale alla risoluzione dei problemi CDN.

Considerazioni sulla cache specifiche per EMP:

• Intestazioni di controllo della cache EMP: verificate che il vostro CDN rispetti le intestazioni di controllo della cache di EMP anziché sovrascriverle

• Parametri di query EMP: assicuratevi che nelle chiavi della cache siano inclusi solo i parametri di query EMP necessari

• Comportamento EMP TTL: verifica che diversi tipi di contenuto EMP abbiano una durata di cache appropriata

Per indicazioni dettagliate sull'ottimizzazione delle politiche della cache EMP e delle impostazioni TTL, vedere. Ottimizza la memorizzazione nella cache CDN MediaTailor e MediaPackage la distribuzione dei contenuti

Convalida della configurazione del filtraggio dei manifesti

La convalida del filtro manifesto è essenziale perché i problemi di filtraggio possono far sì che gli spettatori ricevano contenuti errati, formati non supportati o contenuti a cui non dovrebbero avere accesso. I test sistematici aiutano a identificare se i problemi sono correlati alla configurazione CDN, alla sintassi dei parametri di filtro o alla disponibilità dei contenuti.

Verifica sistematicamente la funzionalità di filtraggio dei manifesti:

1. Testa i parametri del filtro direttamente sugli MediaPackage endpoint (bypassando il CDN) per verificare che funzionino correttamente.

2. Confronta i manifesti filtrati e non filtrati per confermare che gli stream previsti siano inclusi/esclusi.

3. Verifica che la politica della cache CDN inoltri il parametro di query. aws.manifestfilter

4. Verifica la presenza di errori HTTP 400 e confrontali con le condizioni di errore documentate.

Se è necessario implementare o modificare il filtro dei manifesti dopo aver risolto i problemi, consulta Configurare il filtraggio dei manifesti con MediaTailor MediaPackage, e CDN per una guida completa alla configurazione.

Convalida la configurazione dei parametri di interrogazione

Assicurati che il tuo CDN inoltri solo i parametri di query richiesti:

1. Rivedi la tua politica sulla cache CDN per confermare che includa solo AWS i parametri consigliati:

   • aws.manifestfilter- per il filtraggio dei manifesti

   • aws.manifestsettings- per la visualizzazione a intervalli di tempo

   • _HLS_msne _HLS_part - per il supporto LL-HLS

2. Rimuovi tutti gli altri parametri di interrogazione dalla tua chiave di cache, poiché li MediaPackage ignora e riducono l'efficienza della cache.

Riferimento: lavorare con e AWS Elemental MediaPackage CDNs

Riferimento al codice di errore

Riferimento per le condizioni di errore documentate e le relative cause:

Richiesta non valida HTTP 400 (filtro del manifesto)

Cause documentate:

• Applicazione dei risultati del filtro in un manifesto vuoto

• Nomi o valori dei parametri non validi

• Sintassi della stringa di query non valida

• Parametri di filtro duplicati

• La stringa dei parametri supera i 1024 caratteri

• Interroga i parametri su playlist o segmenti multimediali

Riferimento: condizioni di errore di filtraggio MediaPackage manifesto

HTTP 200 OK (nessun filtro applicato)

Cause documentate:

• Parametro di filtro non trovato negli stream disponibili (restituisce un manifesto non filtrato)

• Dopo il filtraggio sono presenti solo i flussi di sottotitoli (restituisce un manifesto non filtrato)

Riferimento: condizioni di errore di filtro manifesto MediaPackage

Altre risorse per la risoluzione dei problemi

Per problemi non trattati in questo argomento, consulta queste AWS risorse ufficiali:

• Visualizzazione in anteprima di un manifesto da AWS Elemental MediaPackage: utilizza l'anteprima del manifesto per risolvere i problemi relativi alla confezione dei contenuti

• Aumenta il rapporto di accesso alla CloudFront cache - Guida completa all'ottimizzazione della cache CDN

• Filtraggio dei manifesti: guida completa alla MediaPackage funzionalità di filtraggio