Événements Amazon ECS

Amazon ECS suit l'état de chacune de vos tâches et de chacun de vos services. Si l'état d'une tâche ou d'un service change, un événement est généré et envoyé à Amazon EventBridge. Ces événements sont considérés comme des événements de changement d'état de tâche et des événements d'action de service. Ces événements et leurs causes possibles sont détaillés dans les sections suivantes.

Amazon ECS a généré et envoyé les types d'événements suivants à EventBridge : événements de changement d'état d'instance de conteneur, événements de changement d'état de tâche, événements de changement d'état de service et événements de changement d'état de déploiement de services.

• Modification de l'état de l'instance de conteneur

• Modification de l'état de la tâche

• Deployment state change (Changement d'état du déploiement)

• Action de service

Note

Amazon ECS peut ajouter d'autres types d'événements, de sources et de détails par la suite. Si vous désérialisez des données JSON d'événements dans du code, assurez-vous que votre application est prête à gérer les propriétés inconnues afin d'éviter les problèmes si et quand ces propriétés supplémentaires sont ajoutées.

Dans certains cas, plusieurs événements sont générés pour la même activité. Par exemple, lorsqu'une tâche est démarrée sur une instance de conteneur, un événement de modification de l'état de tâche est généré pour la nouvelle tâche. Un événement de changement d'état d'instance de conteneur est généré pour prendre en compte le changement dans les ressources disponibles, comme le processeur, la mémoire et les ports disponibles, dans l'instance de conteneur. De même, si une instance de conteneur est mise hors service, des événements sont générés pour l'instance de conteneur, l'état de connexion de l'agent de conteneur et chaque tâche en cours d'exécution sur l'instance de conteneur.

Les événements de changement d'état de conteneur et de changement d'état de tâche contiennent deux champs version : un dans le corps principal de l'événement et l'autre dans l'objet detail de l'événement. Les différences entre ces deux champs sont décrites ci-dessous :

• Le champ version du corps de l'événement est défini sur 0 pour tous les événements. Pour plus d'informations sur EventBridge les paramètres, consultez la section Événements et modèles d'événements dans le guide de EventBridge l'utilisateur Amazon.

• Le champ version dans l'objet detail de l'événement décrit la version de la ressource associée. Chaque fois qu'une ressource change d'état, cette version est incrémentée. Comme les événements peuvent être envoyés plusieurs fois, ce champ vous permet d'identifier les événements en double. Les événements en double présentent la même version dans l'objet detail. Si vous répliquez votre instance de conteneur Amazon ECS et l'état de votre tâche avec EventBridge, vous pouvez comparer la version d'une ressource signalée par les API Amazon ECS avec la version indiquée EventBridge pour la ressource (à l'intérieur de l'detailobjet) afin de vérifier que la version de votre flux d'événements est à jour.

Les événements d'action de service contiennent uniquement le champ version dans le corps principal.

Pour plus d'informations sur la manière d'intégrer Amazon ECS EventBridge, consultez Intégrer Amazon EventBridge et Amazon ECS.