Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Intégration MediaTailor avec un MediaPackage CDN
AWS Elemental MediaTailor s'intègre AWS Elemental MediaPackage pour diffuser des publicités vidéo personnalisées via un réseau de diffusion de contenu (CDN). MediaPackage est un service de packaging et de création just-in-time vidéo qui prépare et protège votre contenu vidéo en vue de sa diffusion sur Internet. Il prend votre contenu vidéo en direct ou à la demande et le regroupe dans des formats de streaming tels que HLS et DASH, le rendant prêt à être visionné sur différents appareils.
Lorsque vous MediaPackage MediaTailor associez un CDN à un CDN, vous créez un flux de diffusion complet qui diffuse des publicités personnalisées à grande échelle. Le CDN distribue votre contenu dans le monde entier, réduisant ainsi la latence et améliorant l'expérience des spectateurs, tout en MediaTailor insérant des publicités ciblées dans vos flux.
Cette rubrique se concentre sur les étapes d'intégration essentielles pour que votre CDN fonctionne ensemble. MediaTailor MediaPackage Pour les options de configuration avancées, le dépannage et les conseils de surveillance, consultez[Étapes suivantes](#emp-cdn-next-steps).
## Comprendre le flux de travail MediaPackage et le flux de travail du CDN
Avant de configurer votre intégration, il est important de comprendre comment MediaPackage et votre CDN fonctionnent ensemble : MediaTailor
1. **Préparation du contenu** : MediaPackage reçoit votre contenu vidéo en direct ou à la demande et le regroupe dans des formats de streaming (manifestes et segments HLS ou DASH).
1. **Insertion de publicités** : MediaTailor demande des manifestes MediaPackage, insère des publicités personnalisées et diffuse les manifestes modifiés aux spectateurs.
1. **Distribution mondiale** : votre CDN met en cache et distribue à la fois les segments de contenu (de MediaPackage) et les segments publicitaires (de MediaTailor) aux spectateurs du monde entier.
1. **Lecture par les spectateurs** : les lecteurs vidéo demandent des manifestes via le CDN, qui achemine les demandes de manière appropriée entre MediaTailor (pour les manifestes) et MediaPackage (pour les segments de contenu).
Cette architecture présente plusieurs avantages :
+ **Évolutivité** : le CDN gère une charge de visionnage élevée sans affecter vos serveurs d'origine
+ **Performances** : le contenu est diffusé à partir des sites périphériques les plus proches des spectateurs
+ **Rentabilité : réduction** des coûts de bande passante grâce à la mise en cache
+ **Fiabilité** : plusieurs emplacements périphériques assurent la redondance
## Conditions préalables
Avant de commencer, assurez-vous que les composants suivants sont configurés :
1. MediaPackage point de **terminaison** : point de MediaPackage terminaison configuré qui reçoit et emballe votre contenu vidéo. Pour les instructions de configuration, voir [Getting started with MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/getting-started.html) dans le guide de MediaPackage l'utilisateur.
1. **MediaTailor configuration** : MediaTailor configuration qui utilise votre MediaPackage point de terminaison comme origine du contenu. Pour les instructions de configuration, voir[Intégration d'une source de contenu pour l'insertion d' MediaTailor annonces](integrating-origin.md).
1. Distribution **CDN : distribution** CDN (telle que CloudFront) configurée pour fonctionner avec le streaming multimédia. Pour les instructions de configuration, voir [Création d'une distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le guide du CloudFront développeur.
1. Serveur de **décision publicitaire : serveur** de décision publicitaire configuré qui renvoie des réponses VAST ou VMAP pour l'insertion d'annonces.
## Étape 1 : configurer les paramètres essentiels du CDN
Une configuration CDN correcte est essentielle pour une MediaPackage intégration réussie. Des paramètres incorrects peuvent entraîner des échecs de lecture, de mauvaises performances du cache et une augmentation des coûts. Sans les bonnes politiques de cache et le transfert des paramètres de requête, votre CDN risque de ne pas fournir correctement les manifestes ou de contourner complètement la mise en cache, ce qui entraîne une charge de travail élevée sur le serveur d'origine et une dégradation de l'expérience utilisateur.
### Configuration des paramètres de base du cache
La configuration de la mise en cache de base est essentielle car elle MediaPackage utilise des en-têtes de contrôle de cache spécifiques pour optimiser la diffusion du contenu. Sans paramètres de cache appropriés, votre CDN risque d'ignorer ces en-têtes, ce qui entraîne des demandes d'origine inutiles et une latence accrue. Procédez comme suit pour garantir un comportement de mise en cache optimal :
Pour configurer une mise en cache de base compatible avec MediaPackage :
1. Ouvrez vos paramètres CloudFront de distribution dans la CloudFront console.
1. Sélectionnez ou créez une politique de cache pour votre MediaPackage origine.
1. Activez l'option « Origin Cache-Control Headers ».
1. Permet de MediaPackage contrôler le comportement de mise en cache via ses en-têtes de contrôle du cache.
Cette configuration de base permet MediaPackage de définir automatiquement des durées de cache appropriées pour différents types de contenu. Pour implémenter une optimisation avancée du cache avec des valeurs TTL spécifiques et un réglage des performances, effectuez d'abord cette configuration de base, puis passez à[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).
### Configuration des paramètres de requête essentiels
La configuration des paramètres de requête est cruciale pour MediaPackage la fonctionnalité. Votre CDN doit transmettre des paramètres de requête spécifiques pour activer des fonctionnalités telles que l'affichage décalé dans le temps et le streaming à faible latence. Des paramètres de requête incorrects peuvent empêcher ces fonctionnalités de fonctionner et je crains de réduire l'efficacité du cache. Pour configurer le transfert des paramètres de requête, procédez comme suit :
Pour vous assurer que votre CDN transmet les paramètres de requête requis à MediaPackage :
1. Dans vos paramètres CloudFront de distribution, sélectionnez ou créez une politique de cache pour les demandes de manifeste.
1. Sous « Paramètres des clés de cache », sélectionnez « Inclure les chaînes de requête spécifiées ».
1. Ajoutez les paramètres de requête essentiels suivants :
+ `start`et `end` - Pour une fonctionnalité de visualisation décalée dans le temps. Ces paramètres sont transmis pour définir des fenêtres de contenu spécifiques MediaPackage pour le visionnage initial et le visionnage de rattrapage.
+ `_HLS_msn`et `_HLS_part` - Pour prendre en charge les demandes de lecture LL-HLS
+ `m`- Pour capturer la modification ti/compame du point de terminaison. MediaPackage les réponses incluent toujours la `?m=###` balise pour capturer l'heure de modification du point de terminaison. Si le contenu est déjà mis en cache avec une valeur différente pour cette balise, CloudFront demande un nouveau manifeste au lieu de diffuser la version mise en cache
+ `aws.manifestfilter`- Pour la fonctionnalité de filtrage des manifestes. Si vous utilisez le filtrage des manifestes, ce paramètre doit être inclus pour configurer la distribution afin de transmettre la chaîne de `aws.manifestfilter` requête à l' MediaPackageorigine, ce qui est nécessaire pour que la fonctionnalité de filtrage des manifestes fonctionne
1. N'incluez que les chaînes de requête qui MediaPackage utilisent. L'inclusion de chaînes de requête inutiles réduit l'efficacité du cache en créant plusieurs variantes de cache pour le même contenu.
Ces paramètres activent les MediaPackage fonctionnalités de base de votre CDN. Si vous devez implémenter le filtrage du contenu pour différents niveaux d'abonnement ou types d'appareils, effectuez d'abord cette configuration de base des paramètres de requête, puis passez à[Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md).
Pour plus d'informations sur le mode MediaTailor de transmission des paramètres de requête tels que `start` et `end` via MediaPackage pour un affichage décalé dans le temps, voir [MediaTailor gestion des paramètres de requête pour les origines](origin-query-parameters.md) dans[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md).
### Configurer le délai de réponse pour LL-HLS
La configuration du délai d'expiration est essentielle pour le HLS à faible latence, car le LL-HLS utilise un mécanisme de « blocage des demandes » dans le cadre duquel le CDN attend de nouveaux segments de contenu. Si votre délai d'attente est trop court, les demandes échoueront avant de MediaPackage pouvoir répondre avec de nouveaux segments, ce qui entraînera des interruptions de lecture et une mauvaise expérience utilisateur. Configurez les délais d'expiration appropriés pour garantir une lecture fluide du format LL-HLS :
Si vous utilisez le HLS à faible latence, configurez les paramètres de délai d'expiration du CDN :
1. Dans les paramètres de votre CDN, recherchez la configuration du délai d'origine.
1. Définissez la valeur du délai de réponse à au moins trois fois la durée de vos pièces.
1. Par exemple, si la durée de vos pièces est de 0,3 seconde, réglez le délai d'attente à au moins 0,9 seconde.
Cela garantit que le CDN attend suffisamment longtemps pour MediaPackage répondre lorsqu'il utilise le mécanisme de blocage des demandes.
## Étape 2 : vérifier votre intégration
Il est essentiel de tester votre intégration pour garantir que tous les composants fonctionnent correctement ensemble avant que vos utilisateurs ne rencontrent des problèmes. L'échec de l'intégration peut entraîner une lecture interrompue, des publicités manquantes ou des performances médiocres. Ce processus de vérification vous aide à identifier et à résoudre les problèmes dans un environnement contrôlé.
Après avoir configuré les paramètres de votre CDN, vérifiez que votre intégration fonctionne correctement en testant l'ensemble du flux de travail, de la demande de contenu à l'insertion de publicités.
### Étape 2.1 : tester la lecture de base
Les tests de lecture de base vérifient que votre CDN gère correctement les demandes de manifeste et les transmet à. MediaTailor Ce test permet d'identifier les problèmes de configuration liés aux politiques de cache, au transfert des paramètres de requête et à la gestion des manifestes. Pour tester la livraison de manifeste de base, procédez comme suit :
Vérifiez que votre intégration de base fonctionne en demandant un manifeste via votre CDN :
1. Utilisez un navigateur Web ou un curl pour demander une URL de manifeste via votre CDN.
1. Vérifiez que le manifeste se charge correctement et qu'il contient à la fois du contenu et des segments publicitaires.
1. Vérifiez que le segment URLs de contenu du manifeste pointe vers votre domaine CDN.
1. Vérifiez que le segment publicitaire pointe URLs également vers votre domaine CDN.
Si le manifeste se charge correctement et contient les informations attendues URLs, votre intégration de base fonctionne. Pour des méthodologies de test complètes et des procédures de validation avancées, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md). Pour configurer une surveillance complète des performances et de l'état de votre intégration, consultez[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md).
### Étape 2.2 : tester la lecture vidéo
Les tests de lecture vidéo garantissent le bon fonctionnement de votre intégration complète end-to-end, y compris l'insertion de publicités et la diffusion de contenu via votre CDN. Ce test permet de vérifier que les segments de contenu et les segments publicitaires sont correctement mis en cache et diffusés, et que l'expérience utilisateur répond à vos normes de qualité. Pour tester toutes les fonctionnalités de lecture, procédez comme suit :
Vérifiez que la lecture vidéo fonctionne correctement avec les publicités insérées :
1. Utilisez un lecteur vidéo (tel que Video.js ou HLS.js) pour lire votre contenu via le CDN.
1. Vérifiez que la vidéo s'affiche correctement sans problème de mise en mémoire tampon.
1. Vérifiez que les publicités sont insérées aux heures prévues pendant la diffusion.
1. Vérifiez que le contenu et les segments publicitaires se chargent à partir de votre CDN (et non directement à partir des origines).
Si la lecture fonctionne correctement avec les publicités, votre intégration fonctionne correctement. Pour des méthodologies de test complètes et des procédures de validation avancées, voir[Tests et validation pour le CDN et MediaTailor les intégrations](cdn-integration-testing.md). Si vous rencontrez des problèmes de lecture, de mise en mémoire tampon ou d'insertion de publicités, consultez[Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md).
## Étapes suivantes
Une fois l'intégration de base terminée, vous pouvez implémenter des fonctionnalités et des optimisations avancées :
**Optimisation avancée du CDN**
Pour une optimisation détaillée du cache, la configuration TTL et le réglage des performances, consultez[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).
**Filtrage des manifestes**
Pour implémenter le filtrage de contenu pour les services hiérarchisés, l'optimisation des appareils ou le contrôle d'accès, voir[Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md).
**Résolution des problèmes**
Si vous rencontrez des problèmes lors de votre intégration, consultez[Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md).
**Surveillance des performances**
Pour configurer une surveillance complète et comprendre les indicateurs de performance clés, voir[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md).
# Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN
AWS Elemental MediaTailor utilise le filtrage des manifestes AWS Elemental MediaPackage pour personnaliser les flux audio et vidéo inclus dans les manifestes fournis aux différents spectateurs via un réseau de diffusion de contenu (CDN). Cela est particulièrement utile pour mettre en œuvre des offres de services à plusieurs niveaux, des optimisations spécifiques aux appareils ou des contrôles d'accès au contenu.
Cette rubrique se concentre spécifiquement sur la mise en œuvre des fonctionnalités de filtrage des manifestes. Avant de mettre en œuvre le filtrage des manifestes, vous devez terminer la configuration de base de l'intégration du réseau de diffusion de contenu. Si vous n'avez pas encore configuré votre intégration de base MediaPackage et votre réseau de diffusion de contenu, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md).
## Fonctionnalités de filtrage des manifestes
Avant de mettre en œuvre le filtrage des manifestes, découvrez ce que vous pouvez accomplir grâce à cette fonctionnalité :
### Fonctionnalités de filtrage de base
Le filtrage des manifestes fournit plusieurs fonctionnalités clés qui vous aident à contrôler la diffusion du contenu :
+ Restreindre l'accès des spectateurs au contenu premium (tel que le 4K HEVC)
+ Ciblez des types d'appareils spécifiques avec des flux appropriés
+ Filtrez le contenu en fonction des fréquences d'échantillonnage audio, des langues ou des codecs vidéo
+ Proposez différents niveaux de qualité à différents abonnés
### Cas d’utilisation courants
Ces cas d'utilisation montrent comment le filtrage des manifestes peut répondre à des exigences commerciales spécifiques :
**Niveaux d’abonnement**
Offrez aux abonnés de base des flux en basse résolution tout en offrant aux abonnés premium un accès au contenu 4K
Exemple : le niveau de base est limité à 720p, le niveau Premium passe à 4K
**Optimisation de l'appareil**
Diffusez automatiquement les flux appropriés en fonction des capacités de l'appareil
Exemple : les appareils mobiles obtiennent des débits inférieurs, les appareils intelligents TVs obtiennent une meilleure qualité
**Gestion de la bande passante**
Limitez la qualité des flux pendant les périodes de pointe pour gérer les coûts du réseau
Exemple : réduire le débit maximal lors d'événements à fort trafic
**Contenu régional**
Diffusez différentes langues audio ou variantes de contenu en fonction de la localisation du spectateur
Exemple : filtrer automatiquement les pistes audio en langue locale
Pour plus d'informations sur les concepts de filtrage des manifestes, consultez la section [Filtrage des manifestes](https://docs.aws.amazon.com/mediapackage/latest/ug/manifest-filtering.html) dans le guide de AWS Elemental MediaPackage l'utilisateur.
## Configurez votre CDN pour le filtrage des manifestes
La configuration du CDN pour le filtrage des manifestes est essentielle car votre CDN doit transmettre le paramètre de `aws.manifestfilter` requête MediaPackage pour que le filtrage fonctionne. Sans un transfert de chaîne de requête approprié, les paramètres du filtre seront supprimés par le CDN, et tous les spectateurs recevront des manifestes non filtrés, quels que soient leur niveau d'abonnement ou les capacités de leur appareil. Cette configuration garantit que votre logique de filtrage atteint MediaPackage et fonctionne comme prévu.
Pour activer le filtrage des manifestes via votre CDN, vous devez configurer le transfert des chaînes de requête :
1. Dans votre CloudFront distribution, créez ou modifiez le comportement du cache pour les demandes de manifeste.
1. Pour la **politique de cache,** créez une nouvelle politique ou modifiez une politique existante.
1. Sous **Paramètres des clés de cache**, choisissez « Inclure les chaînes de requête spécifiées ».
1. Ajoutez `aws.manifestfilter` à la liste des chaînes de requête autorisées.
1. Si vous utilisez également d'autres MediaPackage fonctionnalités, ajoutez leurs paramètres de requête :
+ `start`et `end` - Pour une visualisation décalée dans le temps
+ `time_delay`- Pour la fonctionnalité de temporisation
+ `_HLS_msn`et `_HLS_part` - Pour LL-HLS
Pour plus d'informations sur la création de distributions, consultez la section [Créer une distribution](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-creating-console.html) dans le guide du CloudFront développeur Amazon.
## Mettre en œuvre le filtrage côté client
L'implémentation côté client vous permet de définir la manière dont vos lecteurs vidéo et vos applications demandent le contenu filtré. Cette configuration détermine le contenu que chaque spectateur reçoit en fonction de son niveau d'abonnement, des capacités de l'appareil ou d'autres critères. Une mise en œuvre appropriée garantit que les utilisateurs ne reçoivent que le contenu auquel ils devraient avoir accès, tout en maintenant une efficacité optimale du cache du CDN.
Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo et applications, procédez comme suit :
### Comment fonctionne le filtrage
Le processus de filtrage fonctionne comme suit :
1. Votre lecteur vidéo ou votre application demande une URL de manifeste qui inclut les paramètres de filtre
1. Le CDN transmet la demande (y compris les paramètres de requête) à MediaTailor
1. MediaTailor transmet les paramètres du filtre MediaPackage lors de la demande du manifeste d'origine
1. MediaPackage applique les filtres et renvoie un manifeste personnalisé contenant uniquement les variantes correspondant à vos critères
1. MediaTailor traite le manifeste filtré pour l'insertion de publicités et le renvoie au lecteur
### Format d'URL pour le filtrage
Comprendre le format d'URL correct est essentiel pour une mise en œuvre réussie du filtrage. Un formatage d'URL incorrect entraînera l'ignorance des paramètres de filtrage ou provoquera des erreurs HTTP. La structure de l'URL doit inclure les paramètres de filtre sous forme de chaînes de requête vers MediaPackage lesquelles votre CDN transmet. Procédez comme suit pour implémenter un formatage d'URL approprié :
Pour implémenter le filtrage des manifestes dans vos lecteurs vidéo, procédez comme suit :
1. Modifiez la demande de manifeste de votre joueur URLs pour inclure les paramètres de filtre appropriés.
1. Utilisez le format d'URL suivant avec les paramètres de requête :
```
https://CloudFront-Domain/v1/master/MediaTailor-Config/index.m3u8?aws.manifestfilter=video_codec:h264;audio_language:en-US
```
1. Lorsque votre joueur demande cette URL, il MediaTailor transmet ces paramètres à MediaPackage, ce qui donne lieu à un manifeste filtré.
## Scénarios de filtrage courants
Utilisez ces exemples pour implémenter des scénarios de filtrage courants :
**Diffusion de contenu spécifique à l'appareil**
Pour filtrer en fonction des capacités de l'appareil, ajoutez ce paramètre à votre demande de manifeste :
```
aws.manifestfilter=video_codec:h264;audio_sample_rate:0-44100
```
Cet exemple limite le contenu à la vidéo et à l'audio H.264 avec des fréquences d'échantillonnage allant jusqu'à 44,1 kHz, adaptées aux appareils mobiles.
**Restriction relative au contenu premium**
Pour limiter l'accès au contenu à haut débit, ajoutez ce paramètre à votre demande de manifeste :
```
aws.manifestfilter=video_bitrate:0-9000000
```
Cet exemple limite les débits vidéo à 9 Mbits/s ou moins, ce qui convient aux niveaux d'abonnement de base.
**Sélection de la langue**
Pour filtrer des langues audio spécifiques, ajoutez ce paramètre à votre demande de manifeste :
```
aws.manifestfilter=audio_language:fr,en-US,de
```
Cet exemple inclut uniquement les pistes audio en français, en anglais américain et en allemand.
**Ciblage par résolution**
Pour filtrer en fonction de résolutions vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :
```
aws.manifestfilter=video_height:240-360,720-1080
```
Cet exemple inclut les flux vidéo dont la hauteur est comprise entre 240 et 360 pixels et 720 à 1080 pixels, à l'exception des résolutions de milieu de gamme.
**Filtrage basé sur les codecs**
Pour filtrer des codecs vidéo spécifiques, ajoutez ce paramètre à votre demande de manifeste :
```
aws.manifestfilter=video_codec:h264,h265
```
Cet exemple inclut uniquement les flux vidéo H.264 et H.265, à l'exclusion des autres codecs.
## Considérations et limites spéciales
Pour éviter les problèmes courants lors de la mise en œuvre du filtrage des manifestes :
### Limites techniques
+ Pour les manifestes TS, utilisez des groupes de rendu audio pour éviter de supprimer les flux vidéo multiplexés avec des flux audio filtrés
+ Dans les manifestes TS et CMAF, le taux d'échantillonnage audio et le débit vidéo ne sont pas facilement visibles dans le manifeste à des fins de vérification
+ Les paramètres de demande ajoutés aux playlists ou aux segments multimédias entraîneront une erreur HTTP 400
### Conditions d'erreur
+ Si le filtrage aboutit à un manifeste vide (aucun flux ne répond aux critères du filtre), une erreur HTTP 400 MediaPackage sera renvoyée
+ Des configurations de filtre conflictuelles (filtres de point de terminaison et paramètres de requête) entraînent des erreurs HTTP 404
+ Une syntaxe de filtre non valide ou des types de filtres non pris en charge entraînent des erreurs HTTP 400
### Considérations sur les performances
+ Chaque combinaison de filtres unique crée une entrée de cache distincte, ce qui peut réduire l'efficacité du cache
+ Des filtres complexes comportant de nombreux critères peuvent avoir un impact sur les performances de génération de manifestes
+ Envisagez d'utiliser des filtres au niveau du point de terminaison pour les scénarios de filtrage statique afin d'améliorer les performances du cache
## Testez votre implémentation de filtrage
Il est essentiel de tester votre mise en œuvre du filtrage des manifestes pour garantir que les spectateurs reçoivent le contenu approprié en fonction de leur niveau d'accès et des capacités de leur appareil. L'échec du filtrage peut se traduire par des niveaux de qualité incorrects, des formats non pris en charge ou des contenus auxquels ils ne devraient pas avoir accès. Des tests complets permettent d'identifier et de résoudre ces problèmes avant qu'ils n'affectent vos spectateurs.
Pour vérifier que le filtrage des manifestes fonctionne correctement, procédez comme suit :
1. Demandez des manifestes avec différents paramètres de filtre et vérifiez les résultats
1. Vérifiez que les manifestes filtrés contiennent uniquement les flux attendus
1. Testez les cas extrêmes (résultats vides, filtres non valides) pour garantir une gestion appropriée des erreurs
1. Vérifiez que votre CDN transmet correctement les paramètres du filtre
1. Testez avec différents appareils et lecteurs pour garantir la compatibilité
Pour résoudre les problèmes de filtrage, consultez *Résoudre les problèmes d'intégration du MediaPackage CDN.*
Si vous rencontrez des erreurs HTTP 400, des manifestes vides ou des paramètres de filtrage qui ne fonctionnent pas comme prévu, consultez des conseils spécifiques de résolution [Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md) des problèmes liés au filtrage des manifestes.
# Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage
AWS Elemental MediaTailor nécessite une configuration de mise en cache appropriée du réseau de diffusion de contenu (CDN) pour des performances optimales lorsque vous l'utilisez AWS Elemental MediaPackage comme origine de contenu. MediaPackage fournit des en-têtes de contrôle de cache spécifiques qui indiquent à votre réseau de diffusion de contenu la durée pendant laquelle les différents types de contenu doivent être mis en cache. Le respect de ces recommandations garantit une lecture fluide et une diffusion efficace du contenu.
Cette rubrique se concentre spécifiquement sur l'optimisation du comportement de mise en cache afin d'optimiser les performances et de minimiser les coûts. Avant de mettre en œuvre l'optimisation avancée de la mise en cache, assurez-vous d'avoir terminé la configuration de base de l'intégration du réseau de diffusion de contenu. Si vous n'avez pas encore configuré votre intégration de base, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md).
## MediaPackage en-têtes de contrôle du cache
MediaPackage définit des valeurs TTL spécifiques pour différents types de contenu afin d'optimiser le comportement de mise en cache :
**Listes de lecture multivariantes (HLS et LL-HLS)**
TTL : la moitié de la durée des segments médiatiques
Raison : ces playlists changent à mesure que de nouveaux segments sont disponibles. Elles nécessitent donc des mises à jour fréquentes
**Listes de lecture multimédia (HLS standard)**
TTL : la moitié de la durée des segments médiatiques
Raison : Comme les playlists multivariantes, elles sont mises à jour au fur et à mesure que le contenu progresse
**Listes de lecture multimédia (LL-HLS)**
TTL : 1 seconde
Raison : le streaming à faible latence nécessite des mises à jour très fréquentes
**Segments multimédias et segments d'initialisation TS**
TTL : 1209600 secondes (14 jours)
Raison : les segments multimédias ne changent pas une fois créés, ils peuvent donc être mis en cache pendant de longues périodes
**Segments multimédias et segments d'initialisation CMAF**
TTL : 1209600 secondes (14 jours)
Raison : comme les segments TS, ils sont immuables une fois créés
Pour obtenir des recommandations TTL complètes pour tous les MediaTailor flux de travail et des stratégies supplémentaires d'optimisation de la mise en cache, voir. [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md)
## Configurer les politiques de cache du CDN
Une configuration correcte des politiques de cache est essentielle pour des performances et une rentabilité optimales. Les différents types de contenu (manifestes, segments, fichiers d'initialisation) ont des exigences de mise en cache différentes. L'utilisation de comportements de cache distincts vous permet d'optimiser la mise en cache pour chaque type de contenu, d'améliorer les taux de réussite du cache et de réduire la charge d'origine. Sans politiques de cache appropriées, vous risquez de rencontrer des demandes d'origine inutiles, d'augmenter les coûts et de réduire les performances de lecture.
Pour respecter correctement les en-têtes de MediaPackage contrôle du cache et optimiser la mise en cache :
1. Ouvrez vos paramètres CloudFront de distribution dans la CloudFront console.
1. Créez des comportements de cache distincts pour les différents types de contenu :
+ Demandes de manifeste (\$1.m3u8, \$1.mpd)
+ Segments multimédias (\$1.ts, \$1.mp4, \$1.m4s)
+ Segments d'initialisation
1. Pour chaque comportement de cache, créez ou sélectionnez une politique de cache avec les paramètres suivants :
+ Activer l'option « Origin Cache-Control Headers »
+ Définissez la « politique de demande d'origine » pour transférer les en-têtes nécessaires
+ Configurer le transfert de chaîne de requête en fonction du type de contenu
### Comportement du cache du manifeste
Pour les demandes de manifeste (\$1.m3u8, \$1.mpd) :
+ **Modèle de chemin** : \$1.m3u8 et\$1.mpd
+ **Politique de cache** : Honor Origin Cache-Control Headers
+ **Chaînes de requête** : Transférer des paramètres spécifiques (voir[Optimisation du transfert de chaînes de requêtes](#cdn-query-string-optimization))
+ **En-têtes** : Transférer tous les en-têtes (pour les exigences minimales, voir) [En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers)
### Comportement du cache des segments multimédias
Pour les segments multimédias (\$1.ts, \$1.mp4, \$1.m4s) :
+ **Modèle de chemin** : \$1.ts, \$1.mp4, \$1.m4s
+ **Politique de cache** : en-têtes de contrôle du cache Honor Origin (TTL de 14 jours)
+ **Chaînes de requête** : aucune (les segments n'utilisent pas les paramètres de requête)
+ **Compression** : activez pour améliorer les performances de diffusion
## Optimisation du transfert de chaînes de requêtes
L'optimisation des chaînes de requête est essentielle à l'efficacité du cache, car des paramètres de requête inutiles créent plusieurs variations de cache pour le même contenu. Chaque combinaison unique de paramètres de requête crée une entrée de cache distincte, ce qui réduit le taux de réussite du cache et augmente le nombre de demandes d'origine. En transférant uniquement les chaînes de requête MediaPackage réellement utilisées, vous optimisez l'efficacité du cache tout en conservant toutes les fonctionnalités.
Configurez votre CDN pour transférer uniquement les chaînes de requête MediaPackage utilisées, améliorant ainsi l'efficacité du cache :
**Chaînes de requête essentielles**
`start`et `end` - Pour les fenêtres de visualisation décalées dans le temps
`time_delay`- Pour appliquer un délai au contenu du manifeste
`_HLS_msn`,`_HLS_m`, et `_HLS_part` - Pour les demandes de lecture LL-HLS
**Chaînes de requête spécifiques aux fonctionnalités**
`aws.manifestfilter`- Pour le [filtrage des manifestes](cdn-emp-manifest-filtering.md)
**Important**
N'incluez aucune autre chaîne de requête dans votre clé de cache. MediaPackage ignore les paramètres non reconnus et leur inclusion réduit l'efficacité du cache en créant des variations inutiles du cache.
## Techniques d'optimisation des performances
Ces optimisations sont configurées sur votre CDN (par exemple CloudFront), et non dans ou. MediaPackage MediaTailor Implémentez ces optimisations supplémentaires pour optimiser les performances du cache :
### Bouclier Origin
Origin Shield fournit une couche de mise en cache supplémentaire entre les emplacements périphériques et MediaPackage les points de terminaison de votre CDN. Cela permet de réduire le nombre de requêtes qui atteignent vos MediaPackage points de terminaison, ce qui peut améliorer les performances et réduire les coûts, en particulier lors de pics de trafic ou lorsque les taux d'accès au cache sont inférieurs aux niveaux optimaux. Origin Shield est particulièrement utile pour la diffusion en direct lorsque plusieurs sites périphériques peuvent demander le même contenu simultanément.
Activez Origin Shield pour réduire la charge sur vos MediaPackage terminaux :
1. Dans votre CloudFront distribution, activez Origin Shield pour votre MediaPackage origine.
1. Sélectionnez une région du bouclier d'origine proche de votre point de MediaPackage terminaison.
1. Cela crée une couche de mise en cache supplémentaire qui réduit les demandes à MediaPackage.
### Configuration de compression
Activez la compression pour les réponses textuelles :
+ Activer la compression pour les fichiers manifestes (\$1.m3u8, \$1.mpd)
+ Ne compressez pas les segments multimédia (déjà compressés)
+ Assurez-vous que tous les en-têtes sont transférés vers MediaPackage (pour les exigences minimales, voir[En-têtes requis pour l'intégration du MediaTailor CDN](cdn-configuration.md#cdn-required-headers))
## Surveiller les performances du cache
Suivez ces indicateurs clés pour garantir des performances de cache optimales :
**Taux de réussite du cache**
Objectif : 90 % ou plus pour les segments médiatiques, 70 % ou plus pour les manifestes
De faibles ratios peuvent indiquer des paramètres TTL incorrects ou des paramètres de requête inutiles
**Volume de demandes d'origine**
Surveillez les demandes qui atteignent les points de MediaPackage terminaison
Des volumes élevés peuvent indiquer des problèmes de mise en cache
**Variations des clés du cache**
Passez en revue les modèles de clés du cache pour identifier les variations inutiles
Trop de variations réduisent l'efficacité du cache
Après avoir mis en œuvre ces optimisations du cache, configurez la surveillance pour suivre leur efficacité. Pour obtenir des conseils sur la surveillance des taux de réussite du cache, des modèles de demandes d'origine et d'autres indicateurs de performance clés, consultez[Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor](cdn-emp-monitoring.md). Si vous observez des performances médiocres du cache ou des demandes d'origine inattendues, consultez [Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor](cdn-emp-troubleshooting.md) les étapes de résolution des problèmes.
# Surveillez les performances pour MediaPackage le CDN et les intégrations MediaTailor
AWS Elemental MediaTailor nécessite une surveillance efficace pour maintenir des performances optimales de votre intégration AWS Elemental MediaPackage et de celle de votre réseau de diffusion de contenu (CDN). Cette rubrique fournit des conseils sur les indicateurs clés à suivre, les outils de surveillance à utiliser et la façon de configurer des alertes pour une détection proactive des problèmes.
Avant de configurer la surveillance, assurez-vous que votre intégration de base fonctionne correctement. Si vous n'avez pas terminé la configuration de base de l'intégration de votre réseau de diffusion de contenu, commencez par[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md). Si vous devez résoudre les problèmes identifiés par le biais de la surveillance, consultez.. [Résolution des problèmes d'intégration au CDN](cdn-emp-troubleshooting.md)
## Indicateurs de performance clés
Surveillez ces indicateurs essentiels pour garantir des performances optimales de votre intégration MediaPackage et de celle du CDN :
### Indicateurs de performance du CDN
Pour obtenir des indicateurs complets des performances du CDN, notamment les objectifs de taux de réussite du cache, la surveillance du volume des demandes d'origine et les tests de temps de réponse, consultez le [Benchmarks de performance pour le CDN et les intégrations MediaTailor](cdn-performance-benchmarks.md) guide d'optimisation du CDN.
Principales considérations spécifiques à l'EMP pour les métriques du CDN :
**En-têtes de contrôle du cache EMP**
**Ce qu'il faut vérifier** : assurez-vous que votre CDN respecte les en-têtes de contrôle du cache d'EMP pour un comportement TTL optimal
**Comportement attendu** : les différents types de contenu doivent avoir des durées de cache différentes en fonction des en-têtes de l'EMP
Pour obtenir des instructions détaillées sur l'optimisation du cache EMP, consultez[Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md).
**Impact des paramètres de requête**
**Éléments à surveiller : suivre l'**impact des paramètres de requête spécifiques à l'EMP sur l'efficacité du cache
**Cible d'optimisation** : assurez-vous que seuls les paramètres de requête EMP nécessaires sont inclus dans les clés de cache
**Temps de réponse du CDN**
**Éléments à surveiller** : suivez les temps de réponse pour les différents types de contenu (manifestes ou segments).
**Valeurs cibles** :
+ Contenu mis en cache : moins de 100 ms
+ Demandes d'origine : moins de 500 ms
### MediaPackage mesures de performance
**Taux d'erreur**
**Éléments à surveiller : surveillez** les taux d'erreur HTTP à la fois sur votre CDN et sur vos points de MediaPackage terminaison. Portez une attention particulière aux erreurs 4xx, qui peuvent indiquer des problèmes de configuration.
**Codes d'erreur clés** :
+ 400 erreurs : souvent liées à des problèmes de filtrage des manifestes
+ Erreurs 404 : cela peut indiquer des problèmes de routage ou de configuration
+ Erreurs 504 : problèmes de temporisation, en particulier avec LL-HLS
**Volume et modèles de demandes**
**Éléments à surveiller** : suivez les modèles de demandes adressées aux MediaPackage terminaux afin d'identifier les tendances d'utilisation et les besoins en capacité.
**Motifs à surveiller** :
+ Heures de pointe d'utilisation
+ Répartition géographique des demandes
+ Distribution du type de contenu (en direct ou à la demande)
### Métriques de latence
**End-to-end latence**
**Éléments à surveiller** : pour les implémentations de LL-HLS, surveillez le temps de end-to-end latence entre l'ingestion du contenu et sa lecture par le lecteur. Une latence élevée peut indiquer des problèmes de configuration du CDN.
**Valeurs cibles** :
+ LL-HLS : moins de 3 secondes de latence glass-to-glass
+ HLS normal : moins de 30 secondes
**Heure de génération du manifeste**
**Éléments à surveiller** : temps nécessaire MediaPackage à la génération des manifestes, en particulier lorsque le filtrage est appliqué.
**Valeurs cibles** : moins de 200 ms pour la génération du manifeste
## Outils de surveillance et configuration
La mise en place d'outils de surveillance complets est essentielle pour maintenir des performances optimales et identifier rapidement les problèmes avant qu'ils n'affectent les spectateurs. Sans surveillance appropriée, la dégradation des performances, l'inefficacité du cache ou les problèmes d'intégration peuvent passer inaperçus jusqu'à ce que les spectateurs constatent une mauvaise qualité de lecture. La bonne configuration de surveillance offre une visibilité sur tous les aspects de votre intégration MediaPackage et de celle du CDN.
Utilisez ces services et outils AWS pour surveiller votre intégration MediaPackage et celle du CDN :
### Amazon CloudWatch
Amazon CloudWatch fournit la base pour surveiller votre intégration MediaPackage et celle du CDN en collectant et en stockant les métriques des deux services. Une CloudWatch configuration appropriée garantit que vous disposez des données nécessaires pour identifier les tendances en matière de performances, résoudre les problèmes et optimiser votre intégration. Sans CloudWatch indicateurs, vous manquerez de visibilité sur les performances du système et vous risquez de ne pas détecter les problèmes avant qu'ils ne deviennent critiques.
Configurez CloudWatch la surveillance pour une collecte complète de métriques :
1. **MediaPackage métriques** : activez CloudWatch les métriques pour vos MediaPackage terminaux afin de suivre les volumes de demandes, les taux d'erreur et les temps de réponse.
1. **Métriques du CDN** : configurez CloudWatch pour collecter des CloudFront métriques, notamment les taux de réussite du cache, le nombre de demandes d'origine et les taux d'erreur.
1. **Mesures personnalisées** : créez des statistiques personnalisées spécifiques à l'entreprise, KPIs telles que l'engagement des spectateurs ou la popularité du contenu.
### CloudWatch tableaux de bord
Créez des tableaux de bord complets pour visualiser vos indicateurs :
1. **Tableau de bord** général : indicateurs de haut niveau indiquant l'état général du système
1. Tableau de **bord des performances du CDN** : mesures détaillées du CDN, notamment les performances du cache et la distribution géographique
1. **MediaPackage tableau de bord des performances** : mesures MediaPackage spécifiques, notamment les modèles de demandes et les taux d'erreur
1. **Tableau de bord de End-to-end latence** : mesures de latence pour différents types de contenu et différentes régions
### Analyse du journal
Configurez l'analyse des journaux pour un dépannage détaillé :
1. **Journaux d'accès au CDN** : activez et analysez les journaux d'accès au CDN pour comprendre les modèles de demandes et identifier les problèmes
1. **MediaPackage CloudWatch journaux** : surveillez les MediaPackage journaux pour détecter les erreurs et les problèmes de performance
1. **Agrégation de journaux** : utilisez Amazon CloudWatch Logs Insights ou des outils tiers pour analyser les modèles de journaux
## Configurer des alertes et des notifications
La configuration des alertes est essentielle à la détection et à la résolution proactives des problèmes. Sans alertes appropriées, les problèmes peuvent passer inaperçus jusqu'à ce qu'ils aient un impact significatif sur l'expérience des utilisateurs ou qu'ils entraînent des interruptions de service. Des alertes bien configurées vous aident à identifier et à résoudre les problèmes avant qu'ils n'affectent vos spectateurs, et à garantir que votre équipe est informée des problèmes critiques nécessitant une attention immédiate.
Configurez des alertes proactives pour identifier les problèmes avant qu'ils n'affectent les utilisateurs :
### Alertes critiques
Configurez des alertes immédiates pour les problèmes critiques :
+ **Taux d'erreur élevés : alerte lorsque les taux** d'erreur 4xx ou 5xx dépassent 5 % sur une période de 5 minutes
+ **Diminution du taux d'accès** au cache : alerte lorsque le taux d'accès au cache tombe en dessous de 70 % pour les manifestes ou de 85 % pour les segments
+ **Latence élevée** : alerte lorsque la end-to-end latence dépasse les seuils cibles
+ Pics de **demandes d'origine** : alerte lorsque les demandes d'origine augmentent de plus de 50 % par rapport à la base de référence
### Alertes d'avertissement
Configurez des alertes d'avertissement pour les tendances susceptibles d'indiquer l'apparition de problèmes :
+ Dégradation **progressive des performances** : alerte lorsque les temps de réponse augmentent de 20 % sur une période de 30 minutes
+ **Tendances en matière d'efficacité du cache** : alerte lorsque les taux d'accès au cache indiquent une tendance à la baisse au fil du temps
+ Modèles de **trafic inhabituels** : alerte en cas de modifications inattendues du volume des demandes ou de la distribution géographique
## Utiliser les données de surveillance pour l'optimisation
Tirez parti des données de surveillance pour améliorer continuellement les performances :
### Évaluations régulières des performances
1. **Examens hebdomadaires** : analysez les tendances de performance hebdomadaires et identifiez les opportunités d'optimisation
1. **Planification mensuelle de la capacité** : utilisez les modèles de trafic pour planifier les besoins en capacité et l'optimisation du CDN
1. **Révisions trimestrielles de l'architecture** : évaluez l'efficacité globale de l'architecture et identifiez les domaines à améliorer
### Actions d'optimisation courantes
Sur la base des données de surveillance, considérez les actions d'optimisation suivantes :
+ **Ajustements de la politique de cache** : modifiez les valeurs TTL en fonction des modèles de mise à jour du contenu réels. Pour obtenir des conseils détaillés sur l'optimisation TTL, consultez[Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md).
+ **Optimisation géographique** : ajoutez des emplacements périphériques CDN dans les régions à fort trafic
+ **Optimisation des paramètres de requête** : supprimez les paramètres de requête inutiles qui fragmentent le cache
+ **Configuration du bouclier d'origine** : implémentez le bouclier d'origine dans les régions où le volume de demandes d'origine est élevé
Pour des instructions de surveillance détaillées spécifiques à MediaPackage, voir [Surveillance MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/monitoring.html) dans le guide de MediaPackage l'utilisateur.
# Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor
AWS Elemental MediaTailor l'intégration au réseau de diffusion de contenu (CDN) AWS Elemental MediaPackage et le réseau de diffusion de contenu (CDN) peuvent rencontrer des problèmes courants qui affectent la lecture, la mise en cache ou d'autres fonctionnalités d'intégration. Utilisez ce guide lorsque vous rencontrez des problèmes de lecture, de mise en cache ou d'autres erreurs liées à l'intégration.
Pour obtenir des conseils complets sur le dépannage du CDN, notamment sur les problèmes de performances du cache universel, la résolution des erreurs HTTP, les procédures de test et les techniques de diagnostic applicables à toutes les MediaTailor implémentations, consultez. [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md) Cette section se concentre sur les exigences MediaPackage spécifiques en matière de dépannage.
Avant de résoudre le problème, assurez-vous d'avoir correctement effectué la configuration de base de l'intégration. Si vous n'avez pas encore configuré votre intégration ou si vous devez passer en revue les étapes de configuration, consultez[Intégration MediaTailor avec un MediaPackage CDN](mediapackage-integration.md). Pour obtenir des conseils sur l'optimisation des performances du cache une fois les problèmes résolus, consultez[Mise en cache du CDN](cdn-emp-caching.md).
## Erreurs de filtrage manifestes
Problèmes liés à la fonctionnalité de filtrage des MediaPackage manifestes, sur la base de conditions d'erreur documentées :
**Erreurs HTTP 400 avec filtrage des manifestes**
**Symptômes : les** requêtes avec `aws.manifestfilter` paramètres renvoient une mauvaise demande HTTP 400
**Causes validées (tirées de AWS la documentation)** :
+ Les critères de filtrage donnent lieu à un manifeste vide (aucun flux ne correspond aux conditions du filtre)
+ Noms ou valeurs de paramètres de filtre non valides
+ Syntaxe de chaîne de requête mal formée
+ Paramètres de filtre dupliqués ou répétés
+ La chaîne de paramètres du filtre dépasse 1 024 caractères
+ Paramètres de requête appliqués aux playlists ou aux segments multimédias (non pris en charge)
**Solutions :**
1. Vérifiez les paramètres de vos filtres pour vous assurer qu'ils correspondent aux flux de contenu disponibles. Si le filtrage n'aboutit à aucun flux correspondant, MediaPackage renvoie HTTP 400.
1. Validez la syntaxe du filtre par rapport aux noms de paramètres et aux formats de valeurs pris en charge.
1. Vérifiez qu'il n'y a pas de doublons dans votre chaîne de requête.
1. Assurez-vous que les paramètres du filtre ne sont appliqués qu'aux listes de lecture multivariantes, et non aux playlists ou aux segments multimédias.
1. Vérifiez que votre chaîne de paramètres totale est inférieure à 1 024 caractères.
**Référence** : [conditions d'erreur de filtrage du AWS Elemental MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**Le filtrage des manifestes ne fonctionne pas (HTTP 200 mais aucun filtrage n'est appliqué)**
**Symptômes : les** requêtes renvoient HTTP 200 mais le manifeste contient tous les flux au lieu d'un sous-ensemble filtré
**Causes possibles :**
+ Le CDN ne transmet pas le paramètre `aws.manifestfilter` de requête à MediaPackage
+ Paramètre de filtre introuvable dans les flux disponibles (renvoie un manifeste non filtré avec HTTP 200)
**Solutions :**
1. Vérifiez que votre politique de cache CDN figure `aws.manifestfilter` dans la liste des chaînes de requête transférées.
1. Testez les paramètres du filtre directement par rapport aux MediaPackage points de terminaison (en contournant le CDN) pour vérifier qu'ils fonctionnent comme prévu.
1. Vérifiez que les valeurs des filtres correspondent aux caractéristiques réelles de vos flux de contenu.
**Référence** : [conditions d'erreur de filtrage du AWS Elemental MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## Procédures de diagnostic
Les procédures de diagnostic systématiques vous aident à identifier rapidement et efficacement la cause première des problèmes d'intégration. L'adoption d'une approche structurée évite de perdre du temps sur des hypothèses erronées et garantit que vous abordez le problème réel plutôt que les symptômes. Ces étapes de diagnostic fondées sur des preuves sont conçues pour isoler les problèmes et vous guider vers la solution appropriée.
Suivez ces étapes diagnostiques fondées sur des données probantes pour identifier les problèmes :
### Analyser les performances du cache
L'analyse des performances du cache est cruciale pour les intégrations EMP, car une faible efficacité du cache entraîne une augmentation de la charge d'origine, des coûts plus élevés et des problèmes de lecture potentiels.
Pour un dépannage complet des performances du cache, notamment une analyse du taux de réussite du cache, une optimisation des clés de cache et des étapes de diagnostic systématiques, consultez [Problèmes de performance du cache CDN](diagnose-performance-issues.md#cache-performance-troubleshooting) le guide de dépannage principal du CDN.
Considérations relatives au cache spécifiques à l'EMP :
+ **En-têtes de contrôle de cache EMP : vérifiez que votre CDN respecte les** en-têtes de contrôle de cache d'EMP plutôt que de les remplacer
+ Paramètres de **requête EMP : assurez-vous que seuls les paramètres** de requête EMP nécessaires sont inclus dans les clés de cache
+ **Comportement TTL EMP** : vérifiez que les différents types de contenu EMP ont des durées de cache appropriées
Pour obtenir des instructions détaillées sur l'optimisation des politiques de cache EMP et des paramètres TTL, consultez. [Optimisation de la mise en cache du CDN MediaTailor et de la diffusion de contenu MediaPackage](cdn-emp-caching.md)
### Valider la configuration du filtrage du manifeste
La validation du filtrage des manifestes est essentielle, car les problèmes de filtrage peuvent entraîner la réception de contenus incorrects, de formats non pris en charge ou de contenus auxquels ils ne devraient pas avoir accès. Les tests systématiques permettent de déterminer si les problèmes sont liés à la configuration du CDN, à la syntaxe des paramètres de filtre ou à la disponibilité du contenu.
Testez systématiquement la fonctionnalité de filtrage des manifestes :
1. Testez les paramètres du filtre directement par rapport aux MediaPackage points de terminaison (en contournant le CDN) pour vérifier qu'ils fonctionnent correctement.
1. Comparez les manifestes filtrés et non filtrés pour confirmer que les flux attendus sont inclus/exclus.
1. Vérifiez que votre politique de cache CDN transmet le paramètre de `aws.manifestfilter` requête.
1. Vérifiez les erreurs HTTP 400 et comparez-les aux conditions d'erreur documentées.
Si vous devez implémenter ou modifier le filtrage des manifestes après avoir résolu les problèmes, consultez [Configurer le filtrage des manifestes avec MediaTailor MediaPackage, et le CDN](cdn-emp-manifest-filtering.md) les instructions de configuration complètes.
### Valider la configuration des paramètres de requête
Assurez-vous que votre CDN transmet uniquement les paramètres de requête requis :
1. Passez en revue votre politique de cache CDN pour vous assurer qu'elle inclut uniquement les paramètres AWS recommandés :
+ `aws.manifestfilter`- pour le filtrage des manifestes
+ `aws.manifestsettings`- pour une visualisation décalée dans le temps
+ `_HLS_msn`et `_HLS_part` - pour le support LL-HLS
1. Supprimez tous les autres paramètres de requête de votre clé de cache, car ils sont MediaPackage ignorés et réduisent l'efficacité du cache.
**Référence** : [Travailler avec AWS Elemental MediaPackage et CDNs](https://docs.aws.amazon.com/mediapackage/latest/userguide/cdns.html)
## Référence du code d'erreur
Référence pour les conditions d'erreur documentées et leurs causes :
**Mauvaise requête HTTP 400 (filtrage des manifestes)**
**Causes documentées** :
+ L'application du filtre entraîne un manifeste vide
+ Noms ou valeurs de paramètres non valides
+ Syntaxe de chaîne de requête mal formée
+ Paramètres de filtre dupliqués
+ La chaîne de paramètres dépasse 1 024 caractères
+ Paramètres de requête sur des playlists ou des segments multimédias
**Référence** : [conditions d'erreur de filtrage du MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
**HTTP 200 OK (aucun filtrage appliqué)**
**Causes documentées** :
+ Paramètre de filtre introuvable dans les flux disponibles (renvoie un manifeste non filtré)
+ Seuls les flux de sous-titres sont présents après le filtrage (renvoie un manifeste non filtré)
**Référence** : [conditions d'erreur de filtrage du MediaPackage manifeste](https://docs.aws.amazon.com/mediapackage/latest/userguide/error-conditions-and-handling.html)
## Ressources supplémentaires pour la résolution des problèmes
Pour les questions non abordées dans cette rubrique, consultez les AWS ressources officielles suivantes :
+ [Prévisualisation d'un manifeste à partir de AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-preview.html) - Utiliser l'aperçu du manifeste pour résoudre les problèmes d'empaquetage de contenu
+ [Augmenter CloudFront le taux de réussite du cache](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cache-hit-ratio.html) - Guide complet sur l'optimisation du cache du CDN
+ [Filtrage des manifestes](https://docs.aws.amazon.com/mediapackage/latest/userguide/manifest-filtering.html) - Guide complet des fonctionnalités MediaPackage de filtrage