Surveillez et dépannez votre CloudFront intégration MediaTailor

AWS Elemental MediaTailor l'intégration avec Amazon CloudFront nécessite une surveillance et un dépannage continus pour maintenir des performances optimales. Après avoir mis en œuvre 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 pour votre intégration

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

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 Real-time Journaux, 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- Demander le chemin de l'URI

      • cs-user-agent- Agent utilisateur

      • x-edge-result-type- Type de résultat (succès, échec, erreur)

   6. Sélectionnez Enregistrer les modifications.

3. Créez des CloudWatch tableaux de bord :

   1. Dans la CloudWatch console, choisissez Tableaux de bord.

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

   3. Ajoutez des widgets pour les CloudFront statistiques suivantes :

      • Requêtes

      • BytesDownloaded

      • 4xx ErrorRate

      • 5xx ErrorRate

      • TotalErrorRate

      • CacheHitRate

4. Configurez CloudWatch les alarmes :

   1. Dans la CloudWatch console, choisissez Alarmes.

   2. Sélectionnez Créer une alerte.

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

      • 5xx ErrorRate > 1 % pendant 5 minutes

      • 4xx ErrorRate supérieur à 5 % pendant 5 minutes

      • CacheHitRate moins de 80 % pendant 30 minutes

Surveillance des performances du MQAR

Lorsque vous utilisez le MQAR, la surveillance vous aide à comprendre comment CloudFront vous choisissez entre vos origines et si les scores de qualité répondent aux attentes. Real-time les journaux indiquent ces décisions au fur et à mesure qu'elles sont prises.

Pour surveiller les performances du 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 sur la base de ces indicateurs pour suivre les scores de qualité et les décisions de sélection de l'origine.

Exemple Exemple de CloudWatch tableau de bord pour la surveillance MQAR

Créez un CloudWatch tableau de bord avec les statistiques suivantes :

• La sélection de l'origine compte 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 Real-time relative aux journaux dans le guide du CloudFront développeur.

Dépannage des problèmes courants

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

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

Problèmes de mise en cache des manifestes

Symptôme : manifestes périmés ou publicités non mises à 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 ne tient pas compte des 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 orientés vers l'origine Lambda @Edge.

É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 du 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 dépannage suivantes :

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

2. Utilisez 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 Résolution des problèmes du guide de MediaTailor l'utilisateur.

Workflow de dépannage

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

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

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 des 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 transmettent 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 la solution pour référence ultérieure

Étapes suivantes

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

• Mettez en œuvre un déploiement automatique à l'aide de AWS CloudFormation (voirAutomatisez MediaTailor et créez un CDN avec CloudFormation)

• Créez des runbooks pour les scénarios opérationnels courants et les procédures de dépannage

• Mettre en place une solution automatique pour les problèmes courants