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 événements générés par Amazon ECS, tels que les actions de service et les modifications de l'état des tâches, dans Amazon Logs par le biais d'Amazon CloudWatch Logs. 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 une période de rétention de votre choix, allant au-delà des limites natives des 100 derniers événements non filtrés ou tâches arrêtées 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 des requêtes et des filtres couramment utilisés sans que vous ayez à apprendre les langages de requête 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
Arrêts de conteneurs et autres événements de terminaison, que vous pouvez utiliser pour le dépannage ou pour surveiller le 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 échoués, déclenchés par les paramètres du disjoncteur et de l'annulation, 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 connecté et déconnecté.
## 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 définir une période de conservation pour le groupe de journaux comprise entre 1 jour et 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 suivre en direct.
+ 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 liés à l'ingestion des EventBridge données, au stockage d'Amazon CloudWatch Logs et à l'exécution des requêtes.
Pour plus d'informations sur la EventBridge tarification, consultez la section [EventBridge tarification](https://aws.amazon.com/eventbridge/pricing/).
Pour plus d'informations sur la CloudWatch tarification, consultez la section [CloudWatch tarification](https://aws.amazon.com/cloudwatch/pricing/).
## Dépannage basé sur les événements
Utilisez les événements générés par Amazon ECS pour répondre aux questions de dépannage courantes.
### Analyse des échecs de tâches
Vous pouvez consulter les événements de modification de l'état des `STOPPED` tâches, les codes d'arrêt et les codes de sortie des conteneurs afin de déterminer pourquoi une tâche n'a pas pu être lancée ou a échoué pendant son exécution.
Vous pouvez consulter les événements liés aux actions 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 placée en raison de contraintes de ressources.
### Scénarios d'échec de tâches courants
Les échecs de tâches anormaux les plus courants sont liés aux problèmes suivants :
+ Défaillances du déploiement du service CI/CD
+ Défaillances du dimensionnement automatique
+ Défaillances du rééquilibrage des tâches
+ Sorties anormales du conteneur, telles que des erreurs out-of-memory (OOM)
Les échecs de tâches anormaux produisent des événements de modification de l'état des `STOPPED` tâches avec un code `EssentialContainerExited` ou un code d'`TaskFailedToStart`arrêt. Vous pouvez filtrer en fonction de ces codes d'arrêt pour examiner les comportements d'exécution et d'arrêt des conteneurs.
# Activer la capture d'événements pour un cluster Amazon ECS existant
Vous pouvez activer la capture d'événements sur un cluster Amazon ECS existant pour stocker les événements générés par Amazon ECS dans Amazon CloudWatch Logs via. EventBridge Cette fonctionnalité vous permet de surveiller et de résoudre les échecs de tâches, les déploiements de services et les autres activités du cluster.
Après avoir activé la capture d'événements, Amazon ECS crée les ressources suivantes :
+ Un groupe de CloudWatch journaux Amazon Logs nommé `/aws/events/ecs/containerinsights/${clusterName}/performance`
+ EventBridge Règle qui capture tous les événements depuis la `aws.ecs` source
Un onglet **Historique** s'affiche dans la vue du cluster, vous permettant d'interroger les événements du cycle de vie des tâches et les actions de service. La capture des événements commence immédiatement et stocke tous les événements générés par Amazon ECS conformément à la période de conservation que vous avez spécifiée.
## Conditions préalables
+ Un cluster Amazon ECS existant
+ Autorisations IAM appropriées pour modifier les paramètres du cluster et créer des ressources Amazon CloudWatch Logs
## Activer la capture d'événements à l'aide de la console
1. Ouvrez la console à la [https://console.aws.amazon.com/ecs/version 2](https://console.aws.amazon.com/ecs/v2).
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Sélectionnez le cluster dans lequel vous souhaitez activer la capture d'événements.
La page des détails du cluster s’ouvre.
1. Choisissez **Configuration**.
1. Dans la section **des événements ECS**, choisissez **Activer la capture des événements**.
La boîte de dialogue **Activer la capture d'événements** s'affiche.
1. Pour l'**événement Expire**, choisissez la période de rétention pour le groupe de CloudWatch journaux Amazon Logs. La valeur par défaut est de 7 jours.
1. Choisissez **Activer**.
# Affichage des événements de modification de l'état du service et des tâches Amazon ECS
La console Amazon ECS fournit une fonctionnalité de capture d'événements qui stocke les événements générés par Amazon ECS, tels que les actions de service et les modifications de l'état des tâches, dans Amazon Logs par le biais d'Amazon CloudWatch Logs. EventBridge Cette fonctionnalité inclut une interface de requête dotée de fonctionnalités de filtrage pour améliorer la surveillance et le dépannage.
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.
Vous pouvez utiliser l'un des critères suivants pour filtrer les événements :
+ ID de déploiement (disponible uniquement sur la page détaillée du service)
+ L’heure de début
+ L’heure de fin
+ Nom du service (applicable uniquement sur la page détaillée du cluster, sur la page de détail du service, ce sera le service actuel par défaut)
+ ID de tâche
+ Dernier état de la tâche
+ Famille de définitions de tâches
+ Révision de la définition des tâches
## Affichage des événements au niveau du cluster
1. Ouvrez la console à la [https://console.aws.amazon.com/ecs/version 2](https://console.aws.amazon.com/ecs/v2).
1. Choisissez **Clusters**.
La page de liste des clusters s'affiche.
1. Choisissez le cluster .
La page des détails du cluster s’ouvre.
1. Sous **Historique**, déterminez les événements à consulter.
1. Pour afficher les événements d'action de service, choisissez **Événements d'action de service**.
1. Pour afficher les événements de changement d'état de **tâche, choisissez Événements de changement d'état** de tâche.
1. (Facultatif) Dans **Critères de requête**, entrez les filtres pour les événements que vous souhaitez afficher.
1. Choisissez **Exécuter la requête**.
Les événements s'affichent sous forme de liste.
1. Pour consulter tous les détails de l'événement, sélectionnez-le.
## Visualisation au niveau du service
1. Ouvrez la console à la [https://console.aws.amazon.com/ecs/version 2](https://console.aws.amazon.com/ecs/v2).
1. Sur la page **Clusters**, choisissez le cluster.
1. Sur la page des détails du cluster, dans la section **Services**, choisissez le service.
La page des détails du service s’affiche.
1. Sous **Historique**, déterminez les événements à consulter.
1. Pour afficher les événements d'action de service, choisissez **Événements d'action de service**.
1. Pour afficher les événements de changement d'état de **tâche, choisissez Événements de changement d'état** de tâche.
1. (Facultatif) Dans **Critères de requête**, entrez les filtres pour les événements que vous souhaitez afficher.
1. Choisissez **Exécuter la requête**.
Les événements s'affichent sous forme de liste.
1. Pour consulter tous les détails de l'événement, sélectionnez-le.