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.
# Analyse du journal d'intégration du CDN et référence des codes d'erreur pour MediaTailor
AWS Elemental MediaTailor les journaux d'intégration du réseau de diffusion de contenu (CDN) fournissent des informations précieuses sur les performances et les erreurs. Ce guide couvre à la fois les journaux CDN (provenant de votre réseau de diffusion de contenu) et MediaTailor les journaux et codes d'erreur pertinents pour le dépannage de l'intégration du CDN. Utilisez cette référence lorsque vous devez comprendre ce que les journaux et les codes d'erreur de votre réseau de diffusion de contenu vous indiquent à propos de votre MediaTailor intégration. Ce guide vous aide à interpréter les entrées du journal et les messages d'erreur afin d'identifier la cause première des problèmes.
**Sujets connexes :**
+ Pour les procédures de step-by-step dépannage, voir [Résoudre les problèmes liés à l'intégration du CDN](cdn-troubleshooting.md)
+ Pour des stratégies de surveillance et de prévention proactives, voir [Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md)
+ Pour l'escalade et l'obtention d'une aide supplémentaire, voir [Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md)
+ Pour une configuration et des ressources de MediaTailor journalisation complètes, voir [MediaTailor ressources de configuration de journalisation](#mediatailor-logging-resources)
+ Pour une référence CloudFront sur le format du journal, voir [format du journal CloudFront d'accès](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html#LogFileFormat)
+ Pour une référence au code d'état [HTTP, voir Codes d'état de réponse HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)
# Techniques d'interprétation et d'analyse des logs CDN pour MediaTailor
AWS Elemental MediaTailor L'intégration d'un réseau de diffusion de contenu (CDN) génère des journaux détaillés qui vous aident à comprendre les modèles de demandes et à identifier les problèmes. Lorsque vous analysez les journaux du réseau de diffusion de contenu, concentrez-vous sur les indicateurs clés suivants :
**Remarque :** Les exemples suivants utilisent CloudFront la terminologie Amazon. D'autres fournisseurs de CDN peuvent utiliser des termes différents pour des concepts similaires.
Codes d’état HTTP
+ `200`- Demande réussie
+ `404`- Ressource introuvable (vérifiez les règles de routage et MediaTailor la configuration)
+ `403`- Accès refusé (vérifiez les paramètres de sécurité du CDN et les autorisations d'origine)
+ `502/503/504`- Erreurs du serveur d'origine (vérification de l'état MediaTailor du service et de la connectivité d'origine)
Indicateurs de comportement du cache
+ `Hit`- Contenu diffusé depuis le cache du CDN
+ `Miss`- Contenu extrait depuis l'origine
+ `RefreshHit`- Contenu mis en cache validé avec Origin
+ `Error`- La demande a entraîné une erreur
Modèles de demandes à surveiller
+ Les demandes de manifeste doivent généralement résulter `Miss` ou être `RefreshHit` dues à de faibles paramètres TTL
+ Les segments de contenu doivent s'afficher `Hit` pour les contenus populaires
+ Des segments publicitaires peuvent s'afficher `Miss` en raison de la personnalisation
**Surveillance de l'état des services**
Lors de l'analyse des journaux du CDN et de la résolution des problèmes, vérifiez l'état du MediaTailor service pour déterminer si les problèmes sont liés au service :
AWS Tableau de bord du Service Health
Vérifiez l'état actuel du MediaTailor service et tout événement de service en cours
Accès : [AWS Service Health Dashboard](https://status.aws.amazon.com/)
À utiliser lorsque : vous constatez des erreurs 5xx ou des délais d'expiration de service généralisés dans les journaux du CDN
AWS Personal Health Dashboard
Afficher les notifications relatives à l'état du service et les événements de maintenance spécifiques au compte
Accès : [AWS Personal Health Dashboard](https://console.aws.amazon.com/phd/home)
À utiliser lorsque : vous avez besoin d'informations sur l'état du service ou de notifications de maintenance spécifiques au compte
Surveillance CloudWatch des métriques Amazon
Surveillez les indicateurs MediaTailor de santé des services à l'aide CloudWatch de mesures :
+ `GetManifest.Errors`- Suivez les erreurs de génération de manifestes
+ `GetManifest.Latency`- Surveillez les performances du temps de réponse
+ `AdDecisionServer.Errors`- Surveillez les problèmes de connectivité des serveurs publicitaires
+ `Origin.Errors`- Suivez les problèmes de connectivité du serveur d'origine
Accès : [CloudWatchconsole](https://console.aws.amazon.com/cloudwatch/home)
Utilisez-le lorsque : vous avez besoin de mesures de performance de service détaillées et de tendances historiques
**Processus de résolution des problèmes liés à l'état du service**
1. Consultez le AWS Service Health Dashboard pour connaître l'état actuel du service
1. Consultez le AWS Personal Health Dashboard pour les notifications spécifiques au compte
1. Surveillez CloudWatch les métriques pour les indicateurs de performance des services
1. Corrélez l'état de santé du service avec les modèles de journalisation et les taux d'erreur du CDN
1. Si l'état du service est normal, concentrez-vous sur la configuration du CDN et les problèmes liés au serveur d'origine
**Ressources d'analyse des journaux CDN**
+ [CloudFront journaux d'accès](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html) - Guide complet sur le format et les champs des journaux CDN
+ [CloudFront journaux en temps réel](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/real-time-logs.html) - Streaming et analyse des journaux en temps réel
+ [Analyse des données des CloudWatch journaux avec Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) - Requête et analyse avancées des journaux
+ [Surveillez les ressources de charge de travail](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/monitor-workload-resources.html) - Modèles de surveillance Well-Architected
**Topics**
+ [Interprétation du journal CDN](cdn-log-interpretation.md)
+ [Référence des codes d'erreur](emt-error-codes-reference.md)
+ [Outils d'analyse des journaux](log-analysis-techniques.md)
+ [MediaTailor ressources de configuration de journalisation](#mediatailor-logging-resources)
# MediaTailor codes d'erreur et résolution des problèmes liés à l'intégration du CDN
AWS Elemental MediaTailor les codes d'erreur fournissent des informations spécifiques sur les problèmes d'intégration lorsqu'ils sont transmis via votre réseau de diffusion de contenu (CDN). Lorsque des erreurs sont MediaTailor renvoyées par le biais de votre réseau de diffusion de contenu, ces codes indiquent des problèmes spécifiques :
**Remarque :** Ces codes d'erreur sont renvoyés MediaTailor et transmis par votre CDN. Pour les erreurs spécifiques au CDN, consultez la documentation de votre fournisseur de CDN.
400 Requête erronée
**Causes courantes :** paramètres de requête mal formés, paramètres requis manquants, session non valide IDs
**Vérification :** configuration du transfert de chaînes de requêtes CDN, encodage des paramètres
403 Forbidden
**Causes fréquentes :** un joueur client demande un segment qui n'existe pas ou qui n'est pas autorisé à y accéder. Pour les segments publicitaires, MediaTailor il est possible que vous ayez spécifié un segment inexistant (contactez [AWS Support pour en](https://aws.amazon.com/premiumsupport/) savoir plus). Pour les segments de contenu, les restrictions d'accès du fournisseur d'origine ou les problèmes d'authentification
**Vérifiez :** pour les segments publicitaires : contactez le [support AWS](https://aws.amazon.com/premiumsupport/) si le segment généré n' MediaTailor est pas valide URLs. Pour les segments de contenu : vérifiez les autorisations du serveur d'origine, les informations d'authentification et les politiques d'accès. Vérifiez si les segments existent au niveau demandé URLs
404 – Non trouvé
**Causes courantes :** MediaTailor la configuration n'existe pas ou est inactive, chemin d'URL de lecture incorrect, manifeste ou demande de segment vers des ressources inexistantes
**Vérification : vérifiez** que MediaTailor la configuration existe et qu'elle est active, confirmez que l'URL de lecture correspond au formulaire`GetPlaybackConfiguration`, vérifiez les règles `ManifestEndpointPrefix` de routage du CDN, transférez les demandes aux points de terminaison appropriés MediaTailor
500 Erreur de serveur interne
**Causes courantes :** problèmes liés au serveur Origin, problèmes de connectivité ADS, erreurs de traitement des manifestes
**Vérification :** état du serveur Origin, validité de la réponse ADS, état du MediaTailor service
502 Passerelle défectueuse
**Causes courantes :** serveur d'origine inaccessible, réponse d'origine non valide `UnsupportedManifestException` en raison de problèmes d'alignement des listes de lecture HLS (marqueurs SCTE non alignés sur les listes de lecture, marqueurs SCTE manquants sur certaines listes de lecture, temps de pause publicitaire incohérent selon les variantes de débit)
**Vérification :** règles de connectivité et de pare-feu au serveur Origin, résolution DNS, cohérence des playlists HLS sur toutes les variantes de débit, alignement des marqueurs SCTE-35 sur les mêmes segments dans toutes les playlists, vérification que toutes les playlists contiennent les marqueurs de coupure de publicité requis
**Ressources d'analyse des codes d'erreur :**
+ [Résolution des problèmes MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/troubleshooting.html) - Référence complète du code MediaTailor d'erreur
+ [Résolution des problèmes de réponse aux CloudFront erreurs - Analyse des erreurs](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/troubleshooting-response-errors.html) spécifiques au CDN
+ Codes [d'état des réponses HTTP - Référence complète des codes](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status) d'état HTTP
+ [Gestion des défaillances - Modèles de gestion](https://docs.aws.amazon.com/wellarchitected/latest/reliability-pillar/failure-management.html) des erreurs Well-Architected
# Outils d'analyse des journaux CDN et techniques de surveillance pour MediaTailor
AWS Elemental MediaTailor L'intégration d'un réseau de diffusion de contenu (CDN) génère d'importants volumes de données de journal qui nécessitent des outils et des techniques d'analyse efficaces. Utilisez ces approches pour analyser efficacement le réseau de diffusion de contenu et MediaTailor les journaux :
+ **Analyse par ligne de commande :** utilisez des outils tels que `grep``awk`, et `sort` pour filtrer et analyser les modèles de journalisation
+ **Amazon CloudWatch Logs Insights :** CDN de requêtes et MediaTailor journaux avec une syntaxe similaire à celle de SQL pour une analyse avancée
+ **Outils tiers :** pensez aux plateformes d'analyse des journaux pour une surveillance et des alertes complètes
+ **Tableaux de bord personnalisés :** créez des visualisations qui combinent les métriques du CDN avec les données de performance MediaTailor
Si vous avez besoin d'une assistance supplémentaire pour l'analyse des logs ou l'interprétation de modèles d'erreur complexes, consultez[Bénéficiez d'une assistance pour l'intégration du CDN](cdn-get-help.md).
**Outils et ressources d'analyse des journaux :**
+ [CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) - Requêtes de type SQL pour l'analyse des journaux
+ [Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/what-is.html) - Recherche et analyse avancées dans les journaux
+ [CloudWatch tableaux de bord](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) - Visualisation et surveillance personnalisées
+ [Instrumentation des systèmes distribués pour une visibilité opérationnelle - Modèles](https://aws.amazon.com/builders-library/instrumenting-distributed-systems-for-operational-visibility/) d'observabilité avancés
+ Observabilité [de la charge de travail de conception - Guide d'observabilité](https://docs.aws.amazon.com/wellarchitected/latest/operational-excellence-pillar/design-workload-observability.html) de Well-Architected
## MediaTailor ressources de configuration de journalisation
Outre les journaux CDN, MediaTailor fournit des fonctionnalités de journalisation complètes pour surveiller l'insertion des publicités, la génération de manifestes et les interactions entre les services. Utilisez ces ressources pour configurer et analyser les MediaTailor journaux :
MediaTailor manifeste et journaux de service
Configurez et analysez les journaux pour la génération de manifestes, les interactions d'origine et les événements de service :
+ [AWS Elemental MediaTailor description des journaux manifestes et types d'événements](log-types.md)- Référence complète pour les journaux de MediaTailor manifestes et les types d'événements
+ [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md)- Guide de visualisation et d'interprétation MediaTailor des journaux
Configuration des journaux vendus
Configurez la livraison flexible des journaux vers plusieurs destinations avec optimisation des coûts :
+ [Utiliser les journaux vendus pour envoyer AWS Elemental MediaTailor des journaux](vended-logs.md)- Configurer la livraison des journaux vers Amazon S3, Firehose ou Logs CloudWatch
+ [Migration de votre stratégie de AWS Elemental MediaTailor journalisation](vended-logs-migrate.md)- Guide de migration pour les configurations de journalisation existantes
CloudWatch Intégration des journaux
Intégrez MediaTailor les journaux à CloudWatch des fins de surveillance et d'analyse :
+ [Affichage des AWS Elemental MediaTailor journaux](monitoring-through-logs.md)- Configuration et analyse des CloudWatch journaux
+ [CloudWatchInsights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)- Interrogation et analyse avancées des journaux
Journalisation spécifique à la publicité
Surveillez les performances d'insertion des publicités et résolvez les problèmes liés aux publicités :
+ Journaux d'interaction ADS - Surveillez les communications et les erreurs du serveur de décision publicitaire
**Principales différences entre le CDN et les MediaTailor logs :**
+ **Journaux du CDN** : affiche request/response les modèles, le comportement du cache et les erreurs au niveau du réseau provenant de votre réseau de diffusion de contenu
+ **MediaTailor journaux : affiche les** détails d'insertion des annonces, les événements de génération de manifestes, les interactions d'origine et les erreurs spécifiques au service
+ **Analyse combinée** : utilisez les deux types de journaux ensemble pour une visibilité complète de votre flux de travail de streaming
Pour une surveillance complète qui combine à la fois le CDN et la MediaTailor journalisation, voir[Surveillez les opérations et les performances du MediaTailor CDN](cdn-monitoring.md).