Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor - AWS Elemental MediaTailor
Configuration de la surveillance de votre intégrationSurveillance des performances MQARRésolution des problèmes courantsProcessus de résolution des problèmesÉtapes suivantes

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.

Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor

AWS Elemental MediaTailor l'intégration avec Amazon CloudFront nécessite une surveillance et un dépannage continus afin de maintenir des performances optimales. Après avoir implémenté votre MediaTailor intégration CloudFront et, surveillez les performances et préparez-vous à résoudre les problèmes éventuels. Le réseau de diffusion de contenu (CDN) fournit des outils qui vous aident à comprendre les performances de votre distribution et à identifier les problèmes potentiels.

Configuration de la surveillance de votre intégration

Mettez en œuvre ces stratégies de surveillance pour suivre les performances de votre MediaTailor intégration CloudFront et de votre intégration :

Pour configurer la surveillance de votre MediaTailor intégration CloudFront et

  1. Activez CloudFront la journalisation standard :

    1. Dans la CloudFront console, sélectionnez votre distribution.

    2. Sélectionnez l'onglet Logs (Journaux).

    3. Sous Journaux standard, choisissez Modifier.

    4. Sélectionnez Activé et configurez un compartiment Amazon S3 pour le stockage des journaux.

    5. Sélectionnez Enregistrer les modifications.

  2. Configurez des journaux CloudFront en temps réel :

    1. Dans la CloudFront console, sélectionnez votre distribution.

    2. Sélectionnez l'onglet Logs (Journaux).

    3. Sous Journaux en temps réel, choisissez Modifier.

    4. Sélectionnez Activé et configurez un flux de diffusion Amazon Kinesis Data Streams ou Amazon Data Firehose.

    5. Incluez les champs suivants dans la configuration de votre journal :

      • time-to-first-byte- Temps de réponse

      • sc-status- Code d'état HTTP

      • c-ip- Adresse IP du visualiseur

      • cs-uri-stem- Chemin de l'URI de demande

      • cs-user-agent- Agent utilisateur

      • x-edge-result-type- Type de résultat (Hit, Miss, Error)

    6. Sélectionnez Enregistrer les modifications.

  3. Créez des CloudWatch tableaux de bord :

    1. Dans la CloudWatch console, sélectionnez Tableaux de bord.

    2. Choisissez Create dashboard (Créer un tableau de bord).

    3. Ajoutez des widgets pour ces CloudFront statistiques :

      • Requêtes

      • BytesDownloaded

      • 4 xxErrorRate

      • 5 xxErrorRate

      • TotalErrorRate

      • CacheHitRate

  4. Configurez les CloudWatch alarmes :

    1. Dans la CloudWatch console, sélectionnez Alarmes.

    2. Sélectionnez Créer une alerte.

    3. Créez des alarmes pour les conditions suivantes :

      • 5 xxErrorRate > 1 % pendant 5 minutes

      • 4 xxErrorRate supérieurs à 5 % pendant 5 minutes

      • CacheHitRate moins de 80 % pendant 30 minutes

Surveillance des performances MQAR

Lorsque vous utilisez le MQAR, le suivi vous aide à comprendre comment CloudFront choisir entre vos origines et à déterminer si les scores de qualité répondent aux attentes. Les journaux en temps réel indiquent ces décisions au fur et à mesure qu'elles se produisent.

Pour surveiller les performances de la MQAR

  1. Activez les journaux en temps réel pour votre CloudFront distribution.

  2. Incluez les champs suivants dans la configuration de votre journal :

    • r-host- Le nom d'hôte de l'origine sélectionnée

    • sr-reason- La raison du choix de l'origine

    • x-edge-mqcs- Le score de confiance en matière de qualité des médias

  3. Configurez une destination de journal dans Amazon Kinesis Data Streams ou Amazon Data Firehose.

  4. Créez des tableaux de bord ou des alertes basés sur ces indicateurs pour surveiller les scores de qualité et les décisions de sélection de l'origine.

Exemple de CloudWatch tableau de bord pour la surveillance MQAR

Créez un CloudWatch tableau de bord avec les indicateurs suivants :

  • Nombre de sélections d'origine par région

  • Scores de qualité moyens au fil du temps

  • Événements de basculement

  • Taux d'erreur 4xx et 5xx par origine

Pour plus d'informations sur la configuration des journaux en temps réel, consultez la section Journaux en temps réel du guide du CloudFront développeur.

Résolution des problèmes courants

Des problèmes peuvent survenir en ce qui concerne votre MediaTailor intégration CloudFront et celle de votre entreprise, même avec une planification minutieuse. La compréhension des problèmes courants et des solutions vous permet de résoudre les problèmes rapidement et de minimiser l'impact sur les spectateurs.

Si vous rencontrez des problèmes avec votre MediaTailor intégration CloudFront et votre intégration, consultez les problèmes et solutions courants suivants :

Problèmes de mise en cache des manifestes

Symptôme : les manifestes périmés ou les publicités ne se mettent pas à jour

Solution : vérifiez que vous utilisez la politique de CachingDisabled cache pour les listes de lecture multivariantes, les listes de lecture multimédia et les chemins MPD. Vérifiez que votre configuration transmet correctement les paramètres de requête.

Erreurs CORS

Symptôme : la console du navigateur affiche des erreurs CORS lors de l'accès au contenu

Solution : configurez une politique d'en-têtes de réponse avec les en-têtes CORS appropriés et associez-la au comportement de votre cache.

MQAR ne fonctionne pas

Symptôme : la sélection de l'origine ignore les scores de qualité

Solution : Vérifiez que vous avez activé l'option Niveau de qualité multimédia dans les paramètres de votre groupe d'origine. Vérifiez que vous n'utilisez pas de déclencheurs Lambda @Edge orientés vers l'origine.

Échecs d'insertion d'annonces

Symptôme : les publicités ne s'insèrent pas correctement

Solution : Vérifiez que votre MediaTailor configuration pointe vers votre CloudFront distribution pour le préfixe de segment de contenu. Vérifiez que votre configuration transmet tous les en-têtes requis.

Pour les problèmes plus complexes, vous pouvez utiliser les approches de résolution des problèmes suivantes :

  1. Vérifiez les journaux CloudFront de distribution pour détecter les modèles d'erreur

  2. Utiliser les outils de développement du navigateur pour inspecter les requêtes réseau

  3. Comparez le contenu du manifeste MediaTailor directement par rapport au contenu diffusé via CloudFront

  4. Testez avec un lecteur simple qui prend en charge la journalisation détaillée

Pour plus d'assistance en matière de dépannage, consultez la section Dépannage du guide de MediaTailor l'utilisateur.

Processus de résolution des problèmes

Suivez cette approche systématique pour résoudre les problèmes liés à votre MediaTailor intégration CloudFront et à votre intégration :

Pour résoudre les problèmes d' MediaTailor intégration CloudFront et de résolution

  1. Identifiez le problème spécifique :

    1. Déterminez si le problème concerne tous les spectateurs ou seulement certains

    2. Identifiez les types de contenu concernés (manifestes, segments ou les deux)

    3. Notez les messages d'erreur ou les symptômes

  2. Vérifiez CloudFront les journaux :

    1. Recherchez les codes d'état d'erreur (4xx ou 5xx)

    2. Vérifiez les hit/miss modèles de cache

    3. Vérifiez que les demandes sont acheminées vers la bonne origine

  3. Vérifiez la configuration :

    1. Vérifiez les comportements du cache pour vérifier les modèles de chemin corrects

    2. Vérifiez que les politiques de cache sont correctement appliquées

    3. Vérifiez que les politiques de demande d'origine transfèrent les en-têtes nécessaires

  4. Testez l'accès direct :

    1. Essayez d'accéder au contenu directement depuis MediaTailor (en contournant CloudFront)

    2. Comparez les réponses entre accès direct et CloudFront accès

  5. Mettre en œuvre la solution :

    1. Appliquez le correctif approprié en fonction de vos résultats

    2. Testez pour vérifier que le problème est résolu

    3. Documentez le problème et sa solution pour référence future

Étapes suivantes

Après avoir configuré la surveillance et le dépannage pour votre MediaTailor intégration CloudFront et votre intégration, considérez les étapes suivantes :