Résoudre les problèmes liés à l'intégration MediaTailor du CDN - AWS Elemental MediaTailor
Préparation au dépannageGuides de dépannage spécifiques au flux de travail

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ésoudre les problèmes liés à l'intégration MediaTailor du CDN

Ce guide de dépannage complet couvre les problèmes courants d'intégration du réseau de diffusion de contenu (CDN) dans toutes les AWS Elemental MediaTailor implémentations, notamment l'insertion de publicités côté serveur (SSAI), l'assemblage des canaux et l'intégration. AWS Elemental MediaPackage Lorsque votre CDN et votre MediaTailor intégration rencontrent des problèmes, utilisez cette approche diagnostique systématique pour identifier rapidement les causes profondes et mettre en œuvre des solutions validées.

Ce guide s'applique à toutes les intégrations de MediaTailor CDN, quel que soit votre flux de travail spécifique. Pour les problèmes spécifiques à des services ou à des flux de travail particuliers, consultez les sections de résolution des problèmes connexes référencées à la fin de ce guide.

Avant de commencer : Préparez les éléments suivants pour un dépannage efficace :

  • Exemple de lecture URLs illustrant le problème

  • Journaux d'accès au CDN datant de la période au cours de laquelle les problèmes sont survenus

  • MediaTailor nom de configuration et AWS région

  • Type et version du lecteur (par exemple, HLS.js 1.4.0, Video.js 8.0)

  • Informations sur l'appareil et le navigateur à l'origine des problèmes

Sujets connexes :

Préparation au dépannage

Configurez des outils et des processus pour simplifier le dépannage lorsque des problèmes d'intégration du CDN surviennent. La préparation proactive permet de résoudre les problèmes plus rapidement et plus efficacement en cas de problème.

Activez la journalisation complète

Des journaux détaillés sont essentiels pour diagnostiquer les problèmes d'intégration du CDN. Configurez la journalisation pour saisir les informations dont vous aurez besoin lors du dépannage.

  1. Activez les journaux d'accès détaillés au CDN :

    • Configurer la journalisation pour tous les comportements de cache qui traitent les MediaTailor demandes

    • Inclure des chaînes de requête et des en-têtes personnalisés dans les entrées du journal

    • Configurer des outils d'analyse des journaux pour identifier les modèles et les anomalies

    • Activez les journaux en temps réel pour détecter immédiatement les problèmes lors d'événements en direct

    • Configurer les politiques de conservation des journaux pour conserver l'historique des données de dépannage

  2. Configurer la MediaTailor journalisation :

    • Activez les journaux d'accès pour vos MediaTailor configurations

    • Configuration de groupes de CloudWatch journaux pour une gestion centralisée des journaux

    • Configurer des filtres de journal pour identifier les modèles d'erreur

  3. Configurer la journalisation du serveur d'origine :

    • Activez des journaux d'accès détaillés sur vos serveurs d'origine de contenu

    • Inclure les en-têtes de demande et les codes de réponse dans les journaux

    • Surveillez les indicateurs de performance du serveur d'origine

Ajouter des en-têtes de demande de diagnostic

Les en-têtes personnalisés permettent de suivre les demandes via votre CDN et d'identifier les problèmes de routage.

  1. Configurez les en-têtes de diagnostic du CDN :

    • Ajoutez un identifiant unique à chaque demande (par exemple,X-Request-ID)

    • Inclure des informations spécifiques au CDN dans les en-têtes de demande

    • Ajoutez des informations de localisation périphérique ou de point de présence (POP) pour suivre l'itinéraire géographique

    • Inclure les en-têtes d'état du cache (Hit, Miss, RefreshHit) pour l'analyse du comportement du cache

  2. Ajoutez des en-têtes de réponse pour le débogage :

    • Inclure les en-têtes d'identification du serveur

    • Ajoutez des informations temporelles pour l'analyse des performances

    • Inclure les en-têtes de contrôle du cache pour les demandes de manifeste

Établir des indicateurs de performance de référence

Documentez les plages de performances normales pour identifier rapidement les anomalies lors du dépannage :

  1. Enregistrez les mesures de base :

    • Taux de réussite du cache pour différents types de contenu

    • Percentiles de temps de réponse (P50, P95, P99)

    • Taux d'erreur par code d'état

    • Modèles de volume des demandes par heure de la journée

  2. Documenter les attentes en matière de performance

    • Taux de réussite du cache cible (95 % et plus pour le contenu, plus de 90 % pour les publicités)

    • Temps de réponse acceptables (<100 ms en cache, <500 ms en origine)

    • Taux d'erreur maximaux acceptables (< 1 % pour 4xx, < 0,1 % pour 5xx)

  3. Créez des tableaux de bord de performance : configurez des tableaux de bord de surveillance qui présentent les mesures actuelles par rapport aux valeurs de référence.

Préparer des outils de résolution des problèmes

Configurez les outils et les autorisations d'accès nécessaires pour un dépannage efficace :

  1. Outils de ligne de commande :

    • curlpour tester les requêtes et réponses HTTP

    • digou nslookup pour le dépannage du DNS

    • Outils de validation HLS/DASH pour la vérification des manifestes

    • Outils d'analyse de journaux (grep, awk ou analyseurs de journaux spécialisés)

  2. Autorisations d'accès :

    • Accès à la console de gestion du CDN pour la révision de la configuration

    • MediaTailor accès à la console pour la vérification de la configuration

    • CloudWatch accès aux métriques et à l'analyse des journaux

    • Accès au serveur Origin pour le dépannage du backend

  3. Documentation :

    • Schémas d'architecture réseau

    • CDN et documentation MediaTailor de configuration

    • Informations de contact pour les procédures d'escalade

    • Résolution des problèmes liés aux runbooks pour les scénarios courants

Guides de dépannage spécifiques au flux de travail

Ce guide de dépannage universel couvre les problèmes courants liés à toutes les intégrations de MediaTailor CDN. Pour les problèmes spécifiques à des flux de travail ou à des services particuliers, consultez ces ressources de dépannage spécialisées :

Résolution des problèmes liés à l'insertion de publicités côté serveur (SSAI)

Pour les problèmes spécifiques au SSAI, notamment les échecs d'insertion de publicités, les problèmes de transition des annonces et les problèmes de personnalisation, consultez la documentation de dépannage du SSAI spécifique au flux de travail.

Problèmes courants spécifiques à la SSAI :

  • Échecs d'insertion d'annonces et pauses publicitaires vides

  • Problèmes de synchronisation et de synchronisation liés à la transition des annonces

  • Problèmes de personnalisation et de ciblage

  • Divergences entre le suivi et les analyses des publicités

Résolution des problèmes d'assemblage des canaux

Pour les problèmes spécifiques à l'assemblage des canaux, notamment les problèmes de génération de manifestes et la fonctionnalité de décalage temporel, consultez la documentation du flux de travail d'assemblage des canaux.

Problèmes courants d'assemblage des canaux :

  • Erreurs de génération et de compilation de manifestes

  • Problèmes liés à la fenêtre de décalage horaire et au fonctionnement du DVR

  • Problèmes de disponibilité du contenu source et de basculement

  • Planification du programme et synchronisation des métadonnées

MediaPackage résolution des problèmes d'intégration

Pour MediaPackage des problèmes spécifiques tels que le filtrage des manifestes et les problèmes liés aux terminaux EMP, consultezRésolution des problèmes d'intégration au CDN.

Problèmes MediaPackage d'intégration courants :

  • Erreurs liées aux paramètres de filtrage du manifeste

  • MediaPackage problèmes de connectivité des terminaux

  • Problèmes de comportement du cache spécifiques à l'EMP

  • MediaPackage problèmes d'authentification d'origine

CloudFront résolution de problèmes spécifiques

Pour les problèmes de configuration et d'installation CloudFront spécifiques, consultez la documentation CloudFront d'intégration.

CloudFront Problèmes courants :

  • Configuration de la distribution et configuration du comportement du cache

  • Identité d'accès à l'origine et configuration de sécurité

  • CloudFront codes d'erreur et réponses spécifiques

  • Restrictions géographiques et problèmes de localisation périphérique

Ressources supplémentaires :