Résolution des problèmes MediaPackage, CDN et intégrations MediaTailor - AWS Elemental MediaTailor
Erreurs de filtrage manifestesProcédures de diagnosticRéférence du code d'erreurRessources supplémentaires pour la résolution des problèmes

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.

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 Cette section se concentre sur les exigences de dépannage MediaPackage spécifiques.

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, consultezIntégration MediaTailor avec un MediaPackage CDN . Pour obtenir des conseils sur l'optimisation des performances du cache après résolution des problèmes, consultezMise en cache du CDN.

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)

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

  2. Validez la syntaxe du filtre par rapport aux noms de paramètres et aux formats de valeurs pris en charge.

  3. Vérifiez qu'il n'y a pas de doublons dans votre chaîne de requête.

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

  5. Vérifiez que votre chaîne de paramètres totale est inférieure à 1024 caractères.

Référence : conditions d'erreur de filtrage du AWS Elemental MediaPackage manifeste

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)

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

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

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

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

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.

  2. Comparez les manifestes filtrés et non filtrés pour confirmer que les flux attendus sont inclus/exclus.

  3. Vérifiez que votre politique de cache CDN transmet le paramètre de aws.manifestfilter requête.

  4. 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 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_msnet _HLS_part - pour le support LL-HLS

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

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

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

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 :