View a markdown version of this page

Capture d'événements Amazon ECS dans la console - Amazon Elastic Container Service

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.

Capture d'événements Amazon ECS dans la console

La console Amazon ECS fournit une fonctionnalité de capture d'événements qui stocke les ECS-generated événements Amazon, tels que les actions de service et les changements d'état des tâches, dans Amazon CloudWatch Logs via EventBridge. Cette fonctionnalité inclut une interface d’interrogation dotée de filtres pour la surveillance et la résolution des problèmes.

Les événements fournissent des informations détaillées sur le fonctionnement de vos déploiements de service, services, tâches et instances. Vous pouvez utiliser ces informations pour résoudre les problèmes de déploiement de vos tâches et services.

Lorsque vous activez la capture d'événements, vous avez accès à tous les événements générés par Amazon ECS pendant la période de conservation de votre choix, allant au-delà des limites natives des 100 derniers événements non filtrés ou des tâches interrompues visibles pendant une heure seulement.

Comment ça marche

La capture d'événements permet EventBridge de stocker les événements dans un groupe de CloudWatch journaux Amazon Logs prédéfini. La console Amazon ECS fournit des requêtes prédéfinies et des options de filtrage, et met en corrélation les événements afin de présenter les cycles de vie des tâches dans un format intuitif.

Vous pouvez interroger et récupérer les types d’événements suivants :

  • Événements liés aux actions de service : permettent d’identifier les problèmes de provisionnement ou d’allocation des ressources

  • Événements liés au cycle de vie des tâches : permettent d’identifier les raisons pour lesquelles les tâches ou les conteneurs ne parviennent pas à démarrer ou cessent de fonctionner.

La console Amazon ECS vous permet de configurer la capture d'événements en un clic et fournit les requêtes et le filtrage les plus courants sans que vous ayez à apprendre les langages des requêtes ou à naviguer entre plusieurs consoles.

Types d’événements

La capture des événements stocke tous les événements générés par Amazon ECS dans les catégories suivantes :

Événements de modification de l'état de la tâche

Les arrêts de conteneurs et autres événements de terminaison, que vous pouvez utiliser pour résoudre les problèmes ou surveiller le calendrier du cycle de vie des tâches.

Actions de service

Atteinte d’un état stable, échec d’un placement de tâche, contraintes en matière de ressources, etc.

Changement d’état du déploiement du service

Des événements tels que des déploiements en cours, terminés ou ayant échoué, déclenchés par des paramètres de disjoncteur et de restauration, pour surveiller l'état du déploiement d'un service.

Changement d’état des instances de conteneur

Pour les charges de travail sur les instances gérées EC2 et Amazon ECS, les événements indiquent l'état de connexion et de déconnexion.

Configuration du groupe de journaux

Lorsque vous activez la capture d'événements, Amazon ECS crée automatiquement les ressources suivantes :

  • Un groupe de CloudWatch journaux Amazon Logs nommé /aws/events/ecs/containerinsights/${clusterName}/performance

  • EventBridge Règle qui ingère tous les événements de la aws.ecs source et les transmet au groupe de journaux

Vous pouvez spécifier une période de conservation pour le groupe de journaux allant de 1 jour à 10 ans. La période de conservation par défaut est de 7 jours.

Considérations

Lorsque vous utilisez la capture d'événements, tenez compte des points suivants :

  • La capture d'événements enregistre tous les événements pour plus de simplicité. Vous ne pouvez pas configurer de règles dans la console Amazon ECS pour capturer uniquement des événements spécifiques.

  • La console Amazon ECS fournit des critères de requête prédéfinis. Pour les requêtes avancées, utilisez Amazon CloudWatch Logs Logs Insights pour interroger directement le groupe de journaux.

  • La fonctionnalité Live Tail n'est pas disponible dans la console Amazon ECS. Utilisez Amazon CloudWatch Logs directement pour Live Tail.

  • Lorsque vous désactivez la capture d'événements, la EventBridge règle est supprimée.

  • La capture d'événements entraîne des coûts supplémentaires pour l'ingestion EventBridge des données, le stockage Amazon CloudWatch Logs et l'exécution des requêtes.

    Pour plus d'informations sur la EventBridge tarification, consultez la section EventBridge Tarification.

    Pour plus d'informations sur la CloudWatch tarification, consultez la section CloudWatch Tarification.

Event-based dépannage

Utilisez les événements générés par Amazon ECS pour répondre aux questions de dépannage courantes.

Analyse de l'échec des tâches

Vous pouvez consulter les événements de changement d'état des STOPPED tâches, les codes d'arrêt et les codes de sortie du conteneur pour déterminer pourquoi une tâche n'a pas pu être lancée ou a échoué en cours d'exécution.

Vous pouvez consulter les événements d'action de service pour détecter les échecs de placement et les informations relatives aux contraintes de ressources afin de déterminer pourquoi une tâche n'a pas pu être exécutée en raison de contraintes de ressources.

Scénarios courants d'échec des tâches

Les échecs de tâches anormaux les plus courants sont liés aux problèmes suivants :

  • CI/CD échecs de déploiement de services

  • Pannes de dimensionnement automatique

  • Echecs de rééquilibrage des tâches

  • Des sorties de conteneurs anormales, telles que des erreurs de mémoire insuffisante (OOM)

Les échecs anormaux de tâches produisent des événements de changement d'état de la STOPPED tâche avec un code EssentialContainerExited ou un code d'TaskFailedToStartarrêt. Vous pouvez filtrer en fonction de ces codes d'arrêt pour examiner l'exécution des conteneurs et les comportements d'arrêt.