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à.
# Integrazione MediaTailor con MediaPackage e CDN
AWS Elemental MediaTailor si integra con AWS Elemental MediaPackage per fornire annunci video personalizzati tramite una rete di distribuzione dei contenuti (CDN). MediaPackage è un servizio di creazione e imballaggio di just-in-time video che prepara e protegge i contenuti video per la distribuzione su Internet. Prende i tuoi contenuti video in diretta o su richiesta e li impacchetta in formati di streaming come HLS e DASH, rendendoli pronti per gli spettatori su vari dispositivi.
Combinando MediaPackage con MediaTailor un CDN, crei un flusso di lavoro di streaming completo che offre annunci personalizzati su larga scala. Il CDN distribuisce i tuoi contenuti a livello globale, riducendo la latenza e migliorando l'esperienza degli spettatori, MediaTailor inserendo al contempo annunci pubblicitari mirati nei tuoi stream.
Questo argomento si concentra sui passaggi di integrazione essenziali per far sì che il MediaTailor CDN MediaPackage lavori insieme. Per opzioni di configurazione avanzate, risoluzione dei problemi e indicazioni sul monitoraggio, consulta[Fasi successive](#emp-cdn-next-steps).
## Comprensione del flusso di MediaPackage lavoro e CDN
Prima di configurare l'integrazione, è importante capire in che modo MediaPackage e la CDN interagiscono tra loro: MediaTailor
1. **Preparazione dei contenuti**: MediaPackage riceve i contenuti video in diretta o su richiesta e li impacchetta in formati di streaming (manifesti e segmenti HLS o DASH).
1. **Inserimento di annunci**: MediaTailor richiede manifesti da MediaPackage, inserisce annunci personalizzati e fornisce i manifesti modificati agli spettatori.
1. **Distribuzione globale**: la tua CDN memorizza nella cache e distribuisce sia i segmenti di contenuti (da) che i segmenti di annunci (da MediaPackage) agli spettatori di tutto il mondo. MediaTailor
1. **Riproduzione degli spettatori**: i lettori video richiedono i manifesti tramite il CDN, che indirizza le richieste in modo appropriato tra MediaTailor (per i manifesti) e (per i segmenti di contenuto). MediaPackage
Questa architettura offre diversi vantaggi:
+ **Scalabilità**: il CDN gestisce un elevato numero di utenti senza influire sui server di origine
+ **Prestazioni**: i contenuti vengono distribuiti dalle postazioni periferiche più vicine agli spettatori
+ **Efficienza in termini di costi**: riduzione dei costi della larghezza di banda grazie alla memorizzazione nella cache
+ **Affidabilità**: più sedi periferiche forniscono ridondanza
## Prerequisiti
Prima di iniziare, assicurati di aver configurato i seguenti componenti:
1. **MediaPackage endpoint**: un MediaPackage endpoint configurato che riceve e confeziona i tuoi contenuti video. Per le istruzioni di configurazione, consulta la sezione [Guida introduttiva MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html) nella guida per l' MediaPackage utente.
1. **MediaTailor configurazione**: una MediaTailor configurazione che utilizza l' MediaPackage endpoint come origine del contenuto. Per le istruzioni di configurazione, vedere[Integrazione di una fonte di contenuti per l'inserimento di MediaTailor annunci](integrating-origin.md).
1. **Distribuzione CDN**: una distribuzione CDN (ad esempio CloudFront) configurata per funzionare con contenuti multimediali in streaming. Per le istruzioni di configurazione, consulta [Creazione di una distribuzione](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) nella guida per CloudFront sviluppatori.
1. **Ad decision server**: un server di decisione pubblicitaria configurato che restituisce risposte VAST o VMAP per l'inserimento di annunci.
## Passaggio 1: configura le impostazioni CDN essenziali
Una corretta configurazione CDN è fondamentale per una corretta MediaPackage integrazione. Impostazioni errate possono causare errori di riproduzione, scarse prestazioni della cache e aumento dei costi. Senza le corrette politiche di cache e l'inoltro dei parametri di interrogazione, la rete CDN potrebbe non fornire correttamente i manifest o ignorare completamente la memorizzazione nella cache, con un conseguente carico elevato sul server di origine e un'esperienza di visualizzazione peggiorata.
### Configura le impostazioni di base della cache
La configurazione della cache di base è essenziale perché MediaPackage utilizza intestazioni di controllo della cache specifiche per ottimizzare la distribuzione dei contenuti. Senza impostazioni di cache adeguate, il CDN potrebbe ignorare queste intestazioni, con conseguenti richieste di origine non necessarie e un aumento della latenza. Segui questi passaggi per garantire un comportamento ottimale di memorizzazione nella cache:
Per configurare una cache di base che funzioni con: MediaPackage
1. Apri le impostazioni CloudFront di distribuzione nella CloudFront console.
1. Seleziona o crea una politica di cache per la tua MediaPackage origine.
1. Abilita l'opzione «Origin Cache-Control Headers».
1. Permette di MediaPackage controllare il comportamento della memorizzazione nella cache tramite le sue intestazioni di controllo della cache.
Questa configurazione di base consente di impostare automaticamente MediaPackage le durate della cache appropriate per diversi tipi di contenuto. Per implementare l'ottimizzazione avanzata della cache con valori TTL specifici e l'ottimizzazione delle prestazioni, completa prima questa configurazione di base, quindi continua con. [Ottimizza la memorizzazione nella cache CDN MediaTailor e MediaPackage la distribuzione dei contenuti](cdn-emp-caching.md)
### Configura i parametri di interrogazione essenziali
La configurazione dei parametri di interrogazione è fondamentale per MediaPackage la funzionalità. Il CDN deve inoltrare parametri di query specifici per abilitare funzionalità come la visualizzazione con spostamento temporale e lo streaming a bassa latenza. Le impostazioni errate dei parametri di interrogazione possono impedire il funzionamento di queste funzionalità e temo che riducano l'efficienza della cache. Segui questi passaggi per configurare l'inoltro dei parametri di interrogazione:
Per garantire che il CDN inoltri i parametri di interrogazione richiesti a: MediaPackage
1. Nelle impostazioni di CloudFront distribuzione, seleziona o crea una politica di cache per le richieste manifeste.
1. In «Impostazioni della chiave cache», seleziona «Includi stringhe di query specificate».
1. Aggiungi i seguenti parametri di interrogazione essenziali:
+ `start`e `end` - Per funzionalità di visualizzazione temporizzate. Questi parametri vengono passati per definire finestre MediaPackage di contenuto specifiche per l'avvio e la visualizzazione recuperata
+ `_HLS_msn`e `_HLS_part` - Per supportare le richieste di riproduzione LL-HLS
+ `m`- Per catturare le modifiche dell'endpoint. ti/compame MediaPackage le risposte includono sempre il `?m=###` tag per registrare l'ora modificata dell'endpoint. Se il contenuto è già memorizzato nella cache con un valore diverso per questo tag, CloudFront richiede un nuovo manifesto invece di fornire la versione memorizzata nella cache
+ `aws.manifestfilter`- Per la funzionalità di filtraggio dei manifesti. Se si utilizza il filtro dei manifesti, è necessario includere questo parametro per configurare la distribuzione in modo da inoltrare la stringa di `aws.manifestfilter` query all' MediaPackageorigine, operazione necessaria per il funzionamento della funzionalità di filtraggio dei manifesti
1. Includi solo le stringhe di query che utilizza. MediaPackage L'inclusione di stringhe di query non necessarie riduce l'efficienza della cache creando più varianti della cache per lo stesso contenuto.
Questi parametri abilitano le MediaPackage funzionalità di base del CDN. Se devi implementare il filtraggio dei contenuti per diversi livelli di abbonamento o tipi di dispositivi, completa prima questa configurazione dei parametri di query di base, quindi procedi con. [Configurare il filtraggio dei manifesti con MediaTailor MediaPackage, e CDN](cdn-emp-manifest-filtering.md)
Per informazioni su come trasferire i parametri MediaTailor di interrogazione in modo uniforme `start` e `end` completo MediaPackage per la visualizzazione temporizzata, consulta in. [MediaTailor gestione dei parametri di interrogazione per le origini](origin-query-parameters.md) [MediaTailor parametri di query manifest](manifest-query-parameters.md)
### Configurare il timeout di risposta per LL-HLS
La configurazione del timeout è fondamentale per HLS a bassa latenza perché LL-HLS utilizza un meccanismo di «blocco delle richieste» in cui il CDN attende nuovi segmenti di contenuto. Se il timeout è troppo breve, le richieste falliranno prima di MediaPackage poter rispondere con nuovi segmenti, causando interruzioni della riproduzione e un'esperienza negativa per gli spettatori. Configura i timeout appropriati per garantire una riproduzione LL-HLS fluida:
Se utilizzi HLS a bassa latenza, configura le impostazioni di timeout del CDN:
1. Nelle impostazioni CDN, individua la configurazione del timeout di origine.
1. Imposta il valore del timeout di risposta su almeno tre volte la durata delle parti.
1. Ad esempio, se la durata delle parti è di 0,3 secondi, imposta il timeout su almeno 0,9 secondi.
Ciò garantisce che il CDN attenda abbastanza a lungo per MediaPackage rispondere quando utilizza il meccanismo di blocco delle richieste.
## Fase 2: Verifica l'integrazione
Testare l'integrazione è essenziale per garantire che tutti i componenti funzionino correttamente prima che gli spettatori riscontrino problemi. Un'integrazione non riuscita può causare interruzioni della riproduzione, annunci pubblicitari mancanti o prestazioni scadenti. Questo processo di verifica consente di identificare e risolvere i problemi in un ambiente controllato.
Dopo aver configurato le impostazioni CDN, verifica che l'integrazione funzioni correttamente testando l'intero flusso di lavoro, dalla richiesta di contenuti all'inserimento degli annunci.
### Fase 2.1: Prova la riproduzione di base
I test di riproduzione di base verificano che il CDN gestisca correttamente le richieste manifeste e le inoltri a. MediaTailor Questo test aiuta a identificare i problemi di configurazione relativi alle politiche di cache, all'inoltro dei parametri di query e alla gestione dei manifest. Segui questi passaggi per testare la distribuzione di base del manifesto:
Verifica che la tua integrazione di base funzioni richiedendo un manifesto tramite il tuo CDN:
1. Usa un browser web o curl per richiedere un URL manifesto tramite il tuo CDN.
1. Verifica che il manifesto venga caricato correttamente e contenga sia contenuti che segmenti di annunci.
1. Verifica che il segmento di contenuto URLs nel manifesto punti al tuo dominio CDN.
1. Verifica che il segmento di annunci punti URLs anche al tuo dominio CDN.
Se il manifesto viene caricato correttamente e contiene quanto previsto URLs, l'integrazione di base funziona. Per metodologie di test complete e procedure di convalida avanzate, vedere. [Test e convalida per CDN e integrazioni MediaTailor](cdn-integration-testing.md) Per configurare un monitoraggio completo delle prestazioni e dello stato dell'integrazione, consulta. [Monitora le prestazioni per MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-monitoring.md)
### Passaggio 2.2: Prova la riproduzione del video
I test di riproduzione video garantiscono il corretto funzionamento dell'integrazione completa end-to-end, compresi l'inserimento di annunci e la distribuzione di contenuti tramite il CDN. Questo test verifica che sia i segmenti di contenuto che i segmenti di annunci siano memorizzati nella cache e distribuiti correttamente e che l'esperienza dello spettatore soddisfi gli standard di qualità. Segui questi passaggi per testare la funzionalità di riproduzione completa:
Verifica che la riproduzione video funzioni correttamente con gli annunci inseriti:
1. Usa un lettore video (come Video.js o HLS.js) per riprodurre i tuoi contenuti tramite il CDN.
1. Verifica che il video venga riprodotto senza problemi di buffering.
1. Verifica che gli annunci vengano inseriti negli orari previsti durante la riproduzione.
1. Verifica che sia i contenuti che i segmenti degli annunci vengano caricati dal tuo CDN (non direttamente dalle origini).
Se la riproduzione funziona senza problemi con gli annunci, l'integrazione funziona correttamente. Per metodologie di test complete e procedure di convalida avanzate, vedere. [Test e convalida per CDN e integrazioni MediaTailor](cdn-integration-testing.md) In caso di problemi di riproduzione, buffering o inserimento di annunci, consulta. [Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-troubleshooting.md)
## Fasi successive
Dopo aver completato l'integrazione di base, puoi implementare funzionalità e ottimizzazioni avanzate:
**Ottimizzazione CDN avanzata**
Per l'ottimizzazione dettagliata della cache, la configurazione TTL e l'ottimizzazione delle prestazioni, consulta. [Ottimizza la memorizzazione nella cache CDN MediaTailor e MediaPackage la distribuzione dei contenuti](cdn-emp-caching.md)
**Filtraggio dei manifesti**
Per implementare il filtraggio dei contenuti per servizi a più livelli, ottimizzazione dei dispositivi o controllo degli accessi, consulta. [Configurare il filtraggio dei manifesti con MediaTailor MediaPackage, e CDN](cdn-emp-manifest-filtering.md)
**Risoluzione dei problemi**
Se riscontri problemi con l'integrazione, consulta. [Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-troubleshooting.md)
**Monitoraggio delle prestazioni**
Per impostare un monitoraggio completo e comprendere le metriche chiave delle prestazioni, consulta[Monitora le prestazioni per MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-monitoring.md).
# Configurare il filtraggio dei manifesti con MediaTailor MediaPackage, e CDN
AWS Elemental MediaTailor utilizza il filtro dei manifesti AWS Elemental MediaPackage per personalizzare i flussi audio e video inclusi nei manifesti distribuiti a diversi spettatori tramite una rete di distribuzione dei contenuti (CDN). Ciò è particolarmente utile per implementare offerte di servizi su più livelli, ottimizzazioni specifiche del dispositivo o controlli di accesso ai contenuti.
Questo argomento si concentra in particolare sull'implementazione delle funzionalità di filtraggio dei manifesti. Prima di implementare il filtro dei manifesti, è necessario completare la configurazione di base per l'integrazione della rete per la distribuzione dei contenuti. Se non hai ancora configurato l'integrazione di base MediaPackage e della rete per la distribuzione dei contenuti, inizia con[Integrazione MediaTailor con MediaPackage e CDN](mediapackage-integration.md).
## Funzionalità di filtraggio dei manifesti
Prima di implementare il filtro dei manifesti, scopri cosa puoi ottenere con questa funzionalità:
### Funzionalità di filtraggio di base
Il filtro dei manifesti offre diverse funzionalità chiave che consentono di controllare la distribuzione dei contenuti:
+ Limita l'accesso degli spettatori a contenuti premium (come 4K HEVC)
+ Scegli come target tipi di dispositivi specifici con stream appropriati
+ Filtra i contenuti in base alla frequenza di campionamento audio, alle lingue o ai codec video
+ Offri livelli di qualità diversi a diversi abbonati
### Casi di utilizzo comune
Questi casi d'uso dimostrano come il filtro dei manifesti possa soddisfare requisiti aziendali specifici:
**Livelli di abbonamento**
Offri agli abbonati di base stream a bassa risoluzione e allo stesso tempo offri agli abbonati premium l'accesso a contenuti 4K
Esempio: il livello base è limitato a 720p, il livello Premium arriva fino a 4K
**Ottimizzazione del dispositivo**
Offri automaticamente gli stream appropriati in base alle funzionalità del dispositivo
Esempio: i dispositivi mobili ottengono bitrate inferiori, quelli intelligenti TVs ottengono una qualità superiore
**Gestione della larghezza di banda**
Limita la qualità dello streaming durante i periodi di picco di utilizzo per gestire i costi di rete
Esempio: riduci il bitrate massimo durante gli eventi ad alto traffico
**Contenuti regionali**
Offri diverse lingue audio o varianti di contenuto in base alla posizione dello spettatore
Esempio: filtra automaticamente le tracce audio in lingua locale
Per ulteriori informazioni sui concetti di filtraggio dei manifesti, vedete [Filtraggio dei manifesti nella guida per](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) l' AWS Elemental MediaPackage utente.
## Configura il tuo CDN per il filtraggio dei manifesti
La configurazione CDN per il filtraggio dei manifesti è essenziale perché il CDN deve inoltrare il parametro di `aws.manifestfilter` query a MediaPackage affinché il filtro funzioni. Senza un corretto inoltro delle stringhe di query, i parametri di filtro verranno eliminati dal CDN e tutti gli spettatori riceveranno manifesti non filtrati indipendentemente dal livello di abbonamento o dalle funzionalità del dispositivo. Questa configurazione garantisce che la logica di filtraggio raggiunga e funzioni come previsto. MediaPackage
Per abilitare il filtraggio dei manifesti tramite il CDN, è necessario configurare l'inoltro delle stringhe di query:
1. Nella tua CloudFront distribuzione, crea o modifica il comportamento della cache per le richieste manifeste.
1. Per **la politica della cache,** crea una nuova politica o modificane una esistente.
1. In **Impostazioni della chiave cache**, scegli «Includi stringhe di query specificate».
1. Aggiungi `aws.manifestfilter` all'elenco delle stringhe di query consentite.
1. Se utilizzi anche altre MediaPackage funzionalità, aggiungi i relativi parametri di query:
+ `start`e `end` - Per la visualizzazione con spostamento temporale
+ `time_delay`- Per la funzionalità di ritardo
+ `_HLS_msn`e `_HLS_part` - Per LL-HLS
Per ulteriori informazioni sulla creazione di distribuzioni, consulta [Create a distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) nella Amazon CloudFront Developer Guide.
## Implementa il filtraggio lato client
L'implementazione lato client consente di definire in che modo i lettori video e le applicazioni richiedono contenuti filtrati. Questa configurazione determina il contenuto che ogni spettatore riceve in base al livello di abbonamento, alle funzionalità del dispositivo o ad altri criteri. Una corretta implementazione garantisce che gli utenti ricevano solo i contenuti a cui dovrebbero avere accesso, mantenendo al contempo l'efficienza ottimale della cache CDN.
Per implementare il filtro dei manifesti nei lettori video e nelle applicazioni:
### Come funziona il filtraggio
Il processo di filtraggio funziona nel modo seguente:
1. Il lettore video o l'applicazione richiedono un URL manifesto che includa i parametri di filtro
1. Il CDN inoltra la richiesta (compresi i parametri di interrogazione) a MediaTailor
1. MediaTailor passa i parametri del filtro a MediaPackage quando si richiede il manifest di origine
1. MediaPackage applica i filtri e restituisce un manifesto personalizzato contenente solo le varianti che corrispondono ai criteri
1. MediaTailor elabora il manifesto filtrato per l'inserimento degli annunci e lo restituisce al player
### Formato URL per il filtraggio
La comprensione del formato URL corretto è fondamentale per una corretta implementazione del filtraggio. Una formattazione errata degli URL farà sì che i parametri di filtro vengano ignorati o causino errori HTTP. La struttura dell'URL deve includere i parametri di filtro come stringhe di query a cui inoltrare il CDN. MediaPackage Segui questi passaggi per implementare la corretta formattazione degli URL:
Per implementare il filtro dei manifesti nei tuoi lettori video:
1. Modifica la richiesta del manifesto del lettore URLs per includere i parametri di filtro appropriati.
1. Usa il seguente formato URL con i parametri di query:
```
https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
```
1. Quando il giocatore richiede questo URL, MediaTailor passerà questi parametri a MediaPackage, ottenendo un manifesto filtrato.
## Scenari di filtraggio comuni
Utilizza questi esempi per implementare scenari di filtraggio comuni:
**Distribuzione di contenuti specifici per dispositivo**
Per filtrare in base alle funzionalità del dispositivo, aggiungi questo parametro alla tua richiesta manifest:
```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Questo esempio limita il contenuto a video e audio H.264 con frequenze di campionamento fino a 44,1 kHz, adatte ai dispositivi mobili.
**Restrizione relativa ai contenuti premium**
Per limitare l'accesso a contenuti con bitrate elevato, aggiungi questo parametro alla tua richiesta manifest:
```
aws.manifestfilter=video_bitrate:0-9000000
```
Questo esempio limita il bitrate video a 9 Mbps o meno, adatto per i livelli di abbonamento di base.
**Selezione della lingua**
Per filtrare in base a lingue audio specifiche, aggiungi questo parametro alla tua richiesta manifest:
```
aws.manifestfilter=audio_language:fr,en-US,de
```
Questo esempio include solo tracce audio in francese, inglese americano e tedesco.
**Targeting alla risoluzione**
Per filtrare in base a risoluzioni video specifiche, aggiungi questo parametro alla tua richiesta manifest:
```
aws.manifestfilter=video_height:240-360,720-1080
```
Questo esempio include flussi video con altezze comprese tra 240-360 pixel e 720-1080 pixel, escluse le risoluzioni di fascia media.
**Filtraggio basato su codec**
Per filtrare codec video specifici, aggiungi questo parametro alla tua richiesta manifest:
```
aws.manifestfilter=video_codec:h264,h265
```
Questo esempio include solo flussi video H.264 e H.265, esclusi altri codec.
## Considerazioni e limitazioni speciali
Per evitare problemi comuni durante l'implementazione del filtraggio dei manifesti:
### Limitazioni tecniche
+ Per i manifesti TS, utilizzate i gruppi di resa audio per evitare di rimuovere i flussi video multiplexati con flussi audio filtrati
+ Nei manifesti TS e CMAF, la frequenza di campionamento audio e il bitrate video non sono facilmente visibili nel manifesto per la verifica
+ I parametri di richiesta aggiunti alle playlist o ai segmenti multimediali genereranno un errore HTTP 400
### Condizioni di errore
+ Se il filtraggio dà come risultato un manifesto vuoto (nessun flusso soddisfa i criteri di filtro), MediaPackage restituirà un errore HTTP 400
+ Le configurazioni dei filtri in conflitto (filtri endpoint \$1 parametri di query) generano errori HTTP 404
+ La sintassi del filtro non valida o i tipi di filtro non supportati generano errori HTTP 400
### Considerazioni sulle prestazioni
+ Ogni combinazione di filtri univoca crea una voce di cache separata, riducendo potenzialmente l'efficienza della cache
+ Filtri complessi con molti criteri potrebbero influire sulle prestazioni di generazione dei manifesti
+ Prendi in considerazione l'utilizzo di filtri a livello di endpoint per scenari di filtraggio statico per migliorare le prestazioni della cache
## Testa la tua implementazione di filtraggio
Testare l'implementazione del filtro dei manifesti è fondamentale per garantire che gli spettatori ricevano i contenuti corretti in base al livello di accesso e alle funzionalità del dispositivo. Un filtraggio non riuscito può far sì che gli spettatori ricevano livelli di qualità errati, formati non supportati o contenuti a cui non dovrebbero avere accesso. I test completi aiutano a identificare e risolvere questi problemi prima che si ripercuotano sugli spettatori.
Per verificare che il filtro dei manifesti funzioni correttamente:
1. Richiedi manifesti con parametri di filtro diversi e verifica i risultati
1. Verifica che i manifesti filtrati contengano solo gli stream previsti
1. Prova i casi limite (risultati vuoti, filtri non validi) per garantire una corretta gestione degli errori
1. Verifica che il tuo CDN stia inoltrando correttamente i parametri del filtro
1. Effettua test con diversi dispositivi e lettori per garantire la compatibilità
Per la risoluzione dei problemi di filtraggio, consulta *Risolvere i problemi di integrazione MediaPackage CDN*.
Se riscontri errori HTTP 400, manifesti vuoti o parametri di filtro che non funzionano come previsto, consulta le linee guida specifiche [Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-troubleshooting.md) per la risoluzione dei problemi relativi al filtraggio dei manifesti.
# Ottimizza la memorizzazione nella cache CDN MediaTailor e MediaPackage la distribuzione dei contenuti
AWS Elemental MediaTailor richiede una corretta configurazione di caching della rete di distribuzione dei contenuti (CDN) per prestazioni ottimali quando viene utilizzata AWS Elemental MediaPackage come origine dei contenuti. MediaPackage fornisce intestazioni specifiche per il controllo della cache che indicano alla rete di distribuzione dei contenuti per quanto tempo memorizzare nella cache diversi tipi di contenuti. Il rispetto di questi consigli garantisce una riproduzione fluida e una distribuzione efficiente dei contenuti.
Questo argomento si concentra in particolare sull'ottimizzazione del comportamento di memorizzazione nella cache per massimizzare le prestazioni e ridurre al minimo i costi. Prima di implementare l'ottimizzazione avanzata della memorizzazione nella cache, assicurati di aver completato la configurazione di base per l'integrazione della rete di distribuzione dei contenuti. Se non hai ancora configurato l'integrazione di base, inizia con[Integrazione MediaTailor con MediaPackage e CDN](mediapackage-integration.md).
## MediaPackage intestazioni di controllo della cache
MediaPackage imposta valori TTL specifici per diversi tipi di contenuto per ottimizzare il comportamento di memorizzazione nella cache:
**Playlist multivarianti (HLS e LL-HLS)**
TTL: metà della durata dei segmenti multimediali
Motivo: queste playlist cambiano man mano che diventano disponibili nuovi segmenti, quindi necessitano di aggiornamenti frequenti
**Playlist multimediali (HLS standard)**
TTL: metà della durata dei segmenti multimediali
Motivo: simili alle playlist multivarianti, queste si aggiornano man mano che il contenuto progredisce
**Playlist multimediali (LL-HLS)**
TTL: 1 secondo
Motivo: lo streaming a bassa latenza richiede aggiornamenti molto frequenti
**Segmenti multimediali TS e segmenti di inizializzazione**
TTL: 1209600 secondi (14 giorni)
Motivo: i segmenti multimediali non cambiano una volta creati, quindi possono essere memorizzati nella cache per periodi prolungati
**Segmenti multimediali CMAF e segmenti di inizializzazione**
TTL: 1209600 secondi (14 giorni)
Motivo: come i segmenti TS, questi sono immutabili una volta creati
Per consigli TTL completi su tutti i MediaTailor flussi di lavoro e ulteriori strategie di ottimizzazione della memorizzazione nella cache, consulta. [Ottimizzazione della memorizzazione nella cache per CDN e integrazioni MediaTailor](cdn-optimize-caching.md)
## Configurare le politiche di cache CDN
La corretta configurazione della politica di cache è essenziale per prestazioni ottimali ed efficienza in termini di costi. Diversi tipi di contenuto (manifesti, segmenti, file di inizializzazione) hanno requisiti di memorizzazione nella cache diversi. L'utilizzo di comportamenti di cache separati consente di ottimizzare la memorizzazione nella cache per ogni tipo di contenuto, migliorando i rapporti di accesso alla cache e riducendo il carico di origine. Senza politiche di cache adeguate, potrebbero verificarsi richieste di origine non necessarie, costi maggiori e prestazioni di riproduzione scadenti.
Per rispettare correttamente gli header di MediaPackage controllo della cache e ottimizzare la memorizzazione nella cache:
1. Apri le impostazioni di CloudFront distribuzione nella console. CloudFront
1. Crea comportamenti di cache separati per diversi tipi di contenuto:
+ Richieste manifeste (\$1.m3u8, \$1.mpd)
+ Segmenti multimediali (\$1.ts, \$1.mp4, \$1.m4s)
+ Segmenti di inizializzazione
1. Per ogni comportamento della cache, crea o seleziona una politica di cache con queste impostazioni:
+ Abilita l'opzione «Origin Cache-Control Headers»
+ Imposta «Origin request policy» per inoltrare le intestazioni necessarie
+ Configura l'inoltro delle stringhe di query in base al tipo di contenuto
### Comportamento della cache manifesta
Per le richieste manifest (\$1.m3u8, \$1.mpd):
+ **Schema di** percorso: \$1.m3u8 e \$1.mpd
+ **Politica sulla** cache: header Honor Origin Cache-Control
+ **Stringhe di query**: inoltra parametri specifici (vedi) [Ottimizza l'inoltro delle stringhe di query](#cdn-query-string-optimization)
+ **Intestazioni**: inoltra tutte le intestazioni (per i requisiti minimi, vedi) [Intestazioni richieste per MediaTailor l'integrazione CDN](cdn-configuration.md#cdn-required-headers)
### Comportamento della cache dei segmenti multimediali
Per i segmenti multimediali (\$1.ts, \$1.mp4, \$1.m4s):
+ **Modello di** percorso: \$1.ts, \$1.mp4, \$1.m4s
+ **Politica sulla cache**: header Honor Origin Cache-Control (TTL di 14 giorni)
+ **Stringhe di query: nessuna (i segmenti** non utilizzano parametri di query)
+ **Compressione**: abilita per migliorare le prestazioni di consegna
## Ottimizza l'inoltro delle stringhe di query
L'ottimizzazione delle stringhe di query è fondamentale per l'efficienza della cache, poiché i parametri di query non necessari creano più varianti della cache per lo stesso contenuto. Ogni combinazione di parametri di query univoca crea una voce di cache separata, che riduce i rapporti di accesso alla cache e aumenta le richieste di origine. Inoltrando solo le stringhe di query MediaPackage effettivamente utilizzate, si massimizza l'efficienza della cache mantenendo al contempo la piena funzionalità.
Configura il tuo CDN per inoltrare solo le stringhe di query che MediaPackage utilizza, migliorando l'efficienza della cache:
**Stringhe di query essenziali**
`start`e `end` - Per finestre di visualizzazione alternate nel tempo
`time_delay`- Per applicare il ritardo temporale ai contenuti del manifesto
`_HLS_msn``_HLS_m`, e `_HLS_part` - Per le richieste di riproduzione LL-HLS
**Stringhe di interrogazione specifiche per funzionalità**
`aws.manifestfilter`[- Per il filtraggio dei manifesti](cdn-emp-manifest-filtering.md)
**Importante**
Non includere altre stringhe di query nella chiave della cache. MediaPackage ignora i parametri non riconosciuti e la loro inclusione riduce l'efficienza della cache creando variazioni della cache non necessarie.
## Tecniche di ottimizzazione delle prestazioni
Queste ottimizzazioni sono configurate sulla tua CDN (ad esempio CloudFront), non in MediaPackage o. MediaTailor Implementa queste ottimizzazioni aggiuntive per massimizzare le prestazioni della cache:
### Scudo Origin
Origin Shield fornisce un ulteriore livello di caching tra le edge location e MediaPackage gli endpoint della CDN. Ciò riduce il numero di richieste che raggiungono gli MediaPackage endpoint, il che può migliorare le prestazioni e ridurre i costi, specialmente durante i picchi di traffico o quando i rapporti di accesso alla cache sono inferiori a quelli ottimali. Origin Shield è particolarmente utile per lo streaming live in cui più edge location potrebbero richiedere gli stessi contenuti contemporaneamente.
Abilita Origin Shield per ridurre il carico sugli MediaPackage endpoint:
1. Nella tua CloudFront distribuzione, abilita Origin Shield per la tua MediaPackage origine.
1. Seleziona una regione Origin Shield vicina al tuo MediaPackage endpoint.
1. Questo crea un livello di caching aggiuntivo che riduce le richieste a. MediaPackage
### Configurazione della compressione
Abilita la compressione per le risposte basate su testo:
+ Abilita la compressione per i file manifest (\$1.m3u8, \$1.mpd)
+ Non comprimere i segmenti multimediali (già compressi)
+ Assicurati che tutte le intestazioni vengano inoltrate a (per i requisiti minimi, consulta MediaPackage ) [Intestazioni richieste per MediaTailor l'integrazione CDN](cdn-configuration.md#cdn-required-headers)
## Monitora le prestazioni della cache
Tieni traccia di queste metriche chiave per garantire prestazioni ottimali della cache:
**Rapporto di accesso alla cache**
Obiettivo: 90% o più per i segmenti multimediali, 70% o più per i manifesti
Rapporti bassi potrebbero indicare impostazioni TTL errate o parametri di interrogazione non necessari
**Volume delle richieste Origin**
Monitora le richieste che raggiungono gli MediaPackage endpoint
Volumi elevati potrebbero indicare problemi di memorizzazione nella cache
**Varianti delle chiavi della cache**
Esamina i modelli dei tasti della cache per identificare le variazioni non necessarie
Troppe varianti riducono l'efficienza della cache
Dopo aver implementato queste ottimizzazioni della cache, configura il monitoraggio per monitorarne l'efficacia. Per indicazioni sul monitoraggio dei rapporti di accesso alla cache, dei modelli di richiesta di origine e di altre metriche prestazionali chiave, consulta. [Monitora le prestazioni per MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-monitoring.md) Se riscontri scarse prestazioni della cache o richieste di origine impreviste, consulta le istruzioni [Risoluzione dei problemi MediaPackage, CDN e integrazioni MediaTailor](cdn-emp-troubleshooting.md) per la risoluzione dei problemi.
# Monitora le prestazioni per MediaPackage, CDN e integrazioni MediaTailor
AWS Elemental MediaTailor richiede un monitoraggio efficace per mantenere prestazioni ottimali dell'integrazione con AWS Elemental MediaPackage la rete di distribuzione dei contenuti (CDN). Questo argomento fornisce indicazioni sulle metriche chiave da monitorare, sugli strumenti di monitoraggio da utilizzare e su come impostare avvisi per il rilevamento proattivo dei problemi.
Prima di configurare il monitoraggio, assicurati che l'integrazione di base funzioni correttamente. Se non hai completato la configurazione di base per l'integrazione della rete di distribuzione dei contenuti, inizia con[Integrazione MediaTailor con MediaPackage e CDN](mediapackage-integration.md). Se hai bisogno di risolvere i problemi identificati tramite il monitoraggio, consulta.. [Risoluzione dei problemi di integrazione CDN](cdn-emp-troubleshooting.md)
## Principali metriche prestazionali
Monitora queste metriche essenziali per garantire prestazioni ottimali della tua integrazione con MediaPackage la CDN:
### Metriche delle prestazioni CDN
Per metriche complete sulle prestazioni della CDN, tra cui gli obiettivi del rapporto di accesso alla cache, il monitoraggio del volume delle richieste di origine e i benchmark del tempo di risposta, consulta la guida [Benchmark delle prestazioni per CDN e integrazioni MediaTailor](cdn-performance-benchmarks.md) all'ottimizzazione della CDN.
Considerazioni chiave specifiche di EMP per le metriche CDN:
**Intestazioni EMP cache-control**
**Cosa verificare**: assicuratevi che il vostro CDN rispetti le intestazioni di controllo della cache di EMP per un comportamento TTL ottimale
**Comportamento previsto**: tipi di contenuto diversi devono avere durate di cache diverse in base alle intestazioni di EMP
Per una guida dettagliata sull'ottimizzazione della cache EMP, vedere. [Ottimizza la memorizzazione nella cache CDN MediaTailor e MediaPackage la distribuzione dei contenuti](cdn-emp-caching.md)
**Impatto dei parametri di query**
**Cosa monitorare**: tieni traccia del modo in cui i parametri di query specifici di EMP influiscono sull'efficienza della cache
**Obiettivo di ottimizzazione**: assicurarsi che nelle chiavi della cache siano inclusi solo i parametri di query EMP necessari
**Tempi di risposta CDN**
**Cosa monitorare**: tieni traccia dei tempi di risposta per diversi tipi di contenuti (manifesti e segmenti).
**Valori target:**
+ Contenuto memorizzato nella cache: meno di 100 ms
+ Richieste di origine: meno di 500 ms
### MediaPackage metriche delle prestazioni
**Tassi di errore**
**Cosa monitorare: monitora** i tassi di errore HTTP sia dal CDN che dagli MediaPackage endpoint. Presta particolare attenzione agli errori 4xx, che potrebbero indicare problemi di configurazione.
**Codici di errore chiave**:
+ 400 errori: spesso correlati a problemi di filtraggio dei manifesti
+ Errori 404: potrebbero indicare problemi di routing o di configurazione
+ Errori 504: problemi di timeout, in particolare con LL-HLS
**Volume e modelli delle richieste**
**Cosa monitorare**: traccia i modelli di richiesta sugli MediaPackage endpoint per identificare le tendenze di utilizzo e le esigenze di capacità.
**Schemi da tenere d'occhio**:
+ Tempi di utilizzo di picco
+ Distribuzione geografica delle richieste
+ Distribuzione del tipo di contenuto (live o on-demand)
### Metriche di latenza
**End-to-end latenza**
**Cosa monitorare: per le** implementazioni LL-HLS, monitorate la end-to-end latenza dall'inserimento del contenuto alla riproduzione del visualizzatore. L'elevata latenza potrebbe indicare problemi di configurazione del CDN.
**Valori target**:
+ LL-HLS: latenza inferiore a 3 secondi glass-to-glass
+ HLS normale: meno di 30 secondi
**Tempo di generazione del manifesto**
**Cosa monitorare**: tempo impiegato MediaPackage per generare i manifesti, in particolare con i filtri applicati.
**Valori target**: meno di 200 ms per la generazione di manifesti
## Strumenti di monitoraggio e configurazione
La configurazione di strumenti di monitoraggio completi è essenziale per mantenere prestazioni ottimali e identificare rapidamente i problemi prima che abbiano un impatto sugli spettatori. Senza un monitoraggio adeguato, il peggioramento delle prestazioni, le inefficienze della cache o i problemi di integrazione potrebbero passare inosservati fino a quando gli spettatori non riscontreranno una qualità di riproduzione scadente. La corretta configurazione di monitoraggio offre visibilità su tutti gli aspetti dell'integrazione con la rete CDN. MediaPackage
Usa questi servizi e strumenti AWS per monitorare la tua integrazione con MediaPackage la CDN:
### Amazon CloudWatch
Amazon CloudWatch fornisce le basi per monitorare l'integrazione tra te MediaPackage e la CDN raccogliendo e archiviando i parametri di entrambi i servizi. Una corretta CloudWatch configurazione garantisce la disponibilità dei dati necessari per identificare le tendenze delle prestazioni, risolvere i problemi e ottimizzare l'integrazione. Senza CloudWatch metriche, vi mancherà la visibilità sulle prestazioni del sistema e potreste non rilevare i problemi finché non diventano critici.
Configura il CloudWatch monitoraggio per una raccolta completa delle metriche:
1. **MediaPackage metriche**: abilita le CloudWatch metriche per gli MediaPackage endpoint per tenere traccia dei volumi di richieste, dei tassi di errore e dei tempi di risposta.
1. Metriche **CDN: configura CloudWatch per raccogliere CloudFront metriche** tra cui i rapporti di accesso alla cache, il conteggio delle richieste di origine e i tassi di errore.
1. Metriche **personalizzate: crea metriche** personalizzate per specifiche attività, come il coinvolgimento degli spettatori o la popolarità dei contenuti KPIs .
### CloudWatch dashboard
Crea dashboard complete per visualizzare le tue metriche:
1. **Dashboard panoramica**: metriche di alto livello che mostrano lo stato generale del sistema
1. **Dashboard delle prestazioni CDN**: metriche CDN dettagliate, tra cui le prestazioni della cache e la distribuzione geografica
1. **MediaPackage dashboard delle prestazioni**: metriche MediaPackage specifiche tra cui modelli di richiesta e tassi di errore
1. **Dashboard sulla latenza**: metriche di End-to-end latenza per diversi tipi di contenuti e aree geografiche
### Analisi dei log
Imposta l'analisi dei log per una risoluzione dettagliata dei problemi:
1. **Registri di accesso CDN: abilita e analizza i** log di accesso CDN per comprendere i modelli di richiesta e identificare i problemi
1. **MediaPackage CloudWatch registri: monitora i** log per individuare errori e problemi di MediaPackage prestazioni
1. **Aggregazione dei log**: utilizza Amazon CloudWatch Logs Insights o strumenti di terze parti per analizzare i modelli di log
## Imposta avvisi e notifiche
La configurazione degli avvisi è fondamentale per il rilevamento e la risoluzione proattivi dei problemi. Senza avvisi adeguati, i problemi potrebbero passare inosservati fino a quando non influiscono in modo significativo sull'esperienza degli spettatori o causano interruzioni del servizio. Gli avvisi ben configurati ti aiutano a identificare e risolvere i problemi prima che si ripercuotano sugli spettatori e assicurano che il team venga informato delle questioni critiche che richiedono un'attenzione immediata.
Configura avvisi proattivi per identificare i problemi prima che abbiano un impatto sugli spettatori:
### Avvisi critici
Imposta avvisi immediati per problemi critici:
+ **Tassi di errore elevati: avvisa quando i tassi** di errore 4xx o 5xx superano il 5% in un periodo di 5 minuti
+ **Il rapporto di accesso alla cache diminuisce**: avvisa quando il rapporto di accesso alla cache scende al di sotto del 70% per i manifesti o dell'85% per i segmenti
+ **Latenza elevata**: avvisa quando la latenza supera le soglie end-to-end prefissate
+ **Picchi di richieste di origine**: avvisa quando le richieste di origine aumentano di oltre il 50% rispetto alla linea di base
### Avvisi di avviso
Imposta avvisi di avviso per tendenze che potrebbero indicare problemi in via di sviluppo:
+ **Riduzione graduale delle prestazioni**: avvisa quando i tempi di risposta aumentano del 20% in un periodo di 30 minuti
+ **Tendenze dell'efficienza della cache: avvisa quando i rapporti di accesso alla cache mostrano tendenze** in calo nel tempo
+ **Schemi di traffico insoliti**: avviso in caso di variazioni impreviste nel volume delle richieste o nella distribuzione geografica
## Utilizza i dati di monitoraggio per l'ottimizzazione
Sfrutta i dati di monitoraggio per migliorare continuamente le prestazioni:
### Revisioni periodiche delle prestazioni
1. **Revisioni settimanali**: analizza le tendenze settimanali delle prestazioni e identifica le opportunità di ottimizzazione
1. **Pianificazione mensile della capacità**: utilizza i modelli di traffico per pianificare le esigenze di capacità e l'ottimizzazione della CDN
1. **Revisioni trimestrali dell'architettura**: valuta l'efficienza complessiva dell'architettura e identifica le aree di miglioramento
### Azioni di ottimizzazione comuni
Sulla base dei dati di monitoraggio, prendi in considerazione le seguenti azioni di ottimizzazione:
+ **Modifiche alla politica della cache: modifica** i valori TTL in base agli effettivi modelli di aggiornamento dei contenuti. Per una guida dettagliata all'ottimizzazione del TTL, consulta. [Ottimizzazione della memorizzazione nella cache per CDN e integrazioni MediaTailor](cdn-optimize-caching.md)
+ **Ottimizzazione geografica**: aggiungi edge location CDN nelle regioni ad alto traffico
+ **Ottimizzazione dei parametri di interrogazione**: rimuove i parametri di interrogazione non necessari che frammentano la cache
+ **Configurazione Origin Shield**: implementa Origin Shield nelle regioni con volumi di richieste di origine elevati
Per indicazioni dettagliate sul monitoraggio specifiche per MediaPackage, consulta [Monitoring MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) nella guida MediaPackage per l'utente.
# 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](cdn-troubleshooting.md) 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, vedi[Integrazione MediaTailor con MediaPackage e CDN](mediapackage-integration.md). Per indicazioni sull'ottimizzazione delle prestazioni della cache dopo la risoluzione dei problemi, consulta. [Memorizzazione nella cache CDN](cdn-emp-caching.md)
## 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.
1. Convalida la sintassi del filtro rispetto ai nomi dei parametri e ai formati di valori supportati.
1. Verifica la presenza di parametri duplicati nella stringa di query.
1. Assicurati che i parametri del filtro vengano applicati solo alle playlist multivarianti, non alle playlist o ai segmenti multimediali.
1. Verifica che la stringa totale dei parametri sia inferiore a 1024 caratteri.
**Riferimento**: condizioni di errore di [filtro AWS Elemental MediaPackage manifesto](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**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 politica della cache CDN sia inclusa `aws.manifestfilter` nell'elenco delle stringhe di query inoltrate.
1. Testa i parametri del filtro direttamente rispetto agli MediaPackage endpoint (bypassando il CDN) per verificare che funzionino come previsto.
1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## 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, consulta [Problemi di prestazioni della cache CDN](diagnose-performance-issues.md#cache-performance-troubleshooting) 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](cdn-emp-caching.md)
### 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.
1. Confronta i manifesti filtrati e non filtrati per confermare che gli stream previsti siano inclusi/esclusi.
1. Verifica che la politica della cache CDN inoltri il parametro di query. `aws.manifestfilter`
1. 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](cdn-emp-manifest-filtering.md) 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_msn`e `_HLS_part` - per il supporto LL-HLS
1. 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)
## 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 interrogazione 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**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 ](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)**
## 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](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html): utilizza l'anteprima del manifesto per risolvere i problemi relativi alla confezione dei contenuti
+ [Aumenta il rapporto di accesso alla CloudFront cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Guida completa all'ottimizzazione della cache CDN
+ [Filtraggio dei manifesti](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html): guida completa alla MediaPackage funzionalità di filtraggio