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 liés aux journaux d'action Amazon ECS
Les journaux d'action vous aident à diagnostiquer les problèmes en fournissant des enregistrements détaillés des opérations initiées par le service Amazon ECS. Chaque entrée de journal contient un horodatage, un niveau de journal, le nom de l'événement et une charge utile détaillée avec un contexte sur ce qui s'est passé et pourquoi. Cette rubrique couvre les scénarios de dépannage courants et fournit des informations prêtes à l'emploi CloudWatch Enregistre les requêtes Insights.
Comprendre les niveaux de journalisation
Les journaux d'action utilisent trois niveaux de journalisation pour indiquer la gravité de chaque événement :
INFO-
Opérations normales telles que le lancement d’un déploiement, le lancement d’une tâche ou l’allocation d’une ressource. Ces événements indiquent qu’Amazon ECS exécute les actions prévues.
WARN-
Non-fatal problèmes susceptibles de nécessiter une attention particulière, tels que les tentatives de nouvelle tentative ou les contraintes de capacité. Amazon ECS continue de progresser, mais l’opération pourrait prendre plus de temps que prévu.
ERROR-
Défaillances nécessitant une action, telles qu’un échec de déploiement, une erreur d’allocation ou un démarrage de tâche défaillant. Passez en revue ces événements pour en identifier la cause racine et prendre des mesures correctives.
Commencez par filtrer pour ERROR ou WARN niveaux de journalisation pour identifier rapidement les problèmes. Vous pouvez ensuite étendre votre recherche à INFO événements pour un contexte supplémentaire.
Débogage d'un déploiement de service qui a échoué
Symptômes
Déploiement bloqué en cours ou automatiquement annulé.
Ce qu’il faut rechercher
Filtre pour ERROR journaux où eventName contient DEPLOYMENT. Vérifiez le detail charge utile pour l'ARN de déploiement, raison de l'état et nombre de tâches ayant échoué.
L'exemple suivant montre un échec de déploiement où aucun candidat au rollback n'était disponible :
{ "resourceArn": "arn:aws:ecs:us-east-1:111122223333:cluster/my-cluster", "actionSourceId": "service/my-cluster/my-service", "logLevel": "ERROR", "eventTimestamp": 1784573730986, "detail": { "statusReason": "No rollback candidate was found to run the rollback.", "serviceDeploymentArn": "arn:aws:ecs:us-east-1:111122223333:service-deployment/my-cluster/my-service/abc123def456", "status": "FAILED", "eventName": "SERVICE_DEPLOYMENT_ROLLBACK_FAILED" } }
Résolution
Vérifiez le detail.statusReason champ pour identifier les raisons pour lesquelles les tâches ont échoué. Utilisez ce qui suit CloudWatch Requête Logs Insights pour trouver toutes les erreurs de déploiement :
fields @timestamp, detail.statusReason | filter logLevel = "ERROR" and detail.deploymentArn like /my-cluster\/my-service/ | sort @timestamp desc | limit 20
Diagnostic des problèmes liés aux démons gérés
Symptômes
Le démon ne démarre pas sur les instances ou le déploiement du démon est bloqué.
Ce qu’il faut rechercher
Filtrez les journaux en fonction de l'ARN du démon pour trouver les événements liés à votre démon. Vous pouvez également filtrer par logLevel pour limiter les résultats aux avertissements ou aux erreurs.
L'exemple suivant montre une tâche de démon qui n'a pas pu démarrer en raison d'une mémoire insuffisante sur l'instance cible :
{ "timestamp": 1719500050000, "logLevel": "WARN", "account": "123456789012", "region": "us-east-1", "resourceArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "actionSourceId": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-logging-daemon", "eventName": "DAEMON_TASK_START_IMPAIRED", "detail": { "statusReason": "RESOURCE:MEMORY - Unable to place daemon task on container instance: insufficient memory", "containerInstanceArn": "arn:aws:ecs:us-east-1:123456789012:container-instance/my-cluster/a1b2c3d4" } }
Résolution
Vérifiez que les instances cibles disposent de suffisamment de ressources pour exécuter la tâche du démon. Si les instances sont épuisées, le démon risque de ne pas démarrer tant que de nouvelles instances ne seront pas disponibles. Utilisez la requête suivante pour filtrer les événements d'un démon spécifique :
fields @timestamp, logLevel, detail.statusReason | filter actionSourceId like /my-logging-daemon/ | filter logLevel in ["ERROR", "WARN"] | sort @timestamp desc | limit 20
Comprendre les raisons de l'arrêt des tâches du démon
Symptômes
Les tâches du démon s'arrêtent de façon inattendue.
Ce qu’il faut rechercher
Filtre pour WARN et ERROR journaux contenant des informations détaillées sur les échecs des tâches du démon. Les champs suivants du detail la charge utile fournit des informations sur les raisons pour lesquelles une tâche de démon s'est arrêtée :
detail.stopCode-
Code lisible par machine qui classe la raison de l'arrêt de la tâche.
detail.statusReason-
Description lisible par l'homme de la raison pour laquelle la tâche s'est arrêtée. Ce champ n'est pas présent dans toutes les entrées du journal.
detail.containerStoppedReason-
Informations contextuelles supplémentaires sur le conteneur spécifique à l'origine de l'arrêt de la tâche.
Pour obtenir la liste complète des codes d'arrêt des tâches et leurs descriptions, voir Messages d’erreurs liées aux tâches Amazon ECS arrêtées.
La tâche du démon attendue s'arrête, telle que UserInitiated, sont filtrés à partir des journaux d'actions. Seuls les arrêts de tâches inattendus ou liés à des erreurs apparaissent.
Utile CloudWatch Requêtes Logs Insights
Utilisez ce qui suit CloudWatch Enregistre les requêtes Insights afin d'étudier les problèmes courants liés à vos services Amazon ECS.
Toutes les erreurs survenues au cours de la dernière heure
fields @timestamp, logLevel, eventName, detail.statusReason | filter logLevel = "ERROR" | sort @timestamp desc | limit 50
Le detail.statusReason le champ n'est pas présent dans toutes les entrées du journal. Si le champ est vide dans vos résultats, utilisez eventName et dans d'autres domaines du detail charge utile pour le contexte.
Événements pour un service spécifique
fields @timestamp, logLevel, detail.statusReason | filter @message like /my-service/ | sort @timestamp desc | limit 50
Calendrier de déploiement pour un déploiement spécifique
fields @timestamp, logLevel, detail.statusReason | filter detail.deploymentArn like /my-cluster\/my-service\/abc123/ | sort @timestamp asc
Les échecs des tâches du démon sont regroupés par raison
filter logLevel = "ERROR" and detail.stopCode != "" | stats count(*) as failureCount by detail.stopCode, detail.statusReason | sort failureCount desc | limit 20