Afficher les événements de la pile par opération

Vous pouvez consulter les événements de la pile regroupés par opération afin de mieux comprendre la séquence et l'étendue des modifications apportées à votre pile. Le regroupement basé sur les opérations vous permet de suivre ensemble les événements connexes, ce qui facilite le suivi des progrès et la résolution des problèmes lorsqu'ils surviennent.

Chaque opération de pile (création, mise à jour, suppression, annulation) se voit attribuer un identifiant d'opération unique qui regroupe tous les événements connexes. Cela vous permet de vous concentrer sur des opérations spécifiques et d'identifier rapidement la cause première des défaillances.

Prérequis

Pour utiliser DescribeEvents l'API, vous devez disposer des autorisations IAM nécessaires pour :DescribeEvents.

Afficher les événements de la pile par opération (console)

Pour afficher les événements de la pile regroupés par opération

1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cloudformation.

2. Dans la barre de navigation en haut de l'écran, choisissez l'option dans Région AWS laquelle vous avez créé la pile.

3. Sur la page Stacks, sélectionnez le nom de la pile. CloudFormationaffiche les détails de la pile sélectionnée.

4. Choisissez l'onglet Événements pour afficher les événements CloudFormation de pile générés pour votre pile.

5. Les événements sont automatiquement regroupés par ID d'opération. Chaque opération apparaît sous la forme d'une section extensible indiquant le type d'opération, son statut et son horodatage.

6. Cliquez sur un ID d'opération pour ouvrir une vue détaillée affichant uniquement les événements liés à cette opération spécifique.

7. Dans la vue détaillée des opérations, cochez la case Afficher les échecs uniquement pour afficher uniquement les événements ayant échoué à des fins d'analyse des causes premières.

CloudFormation actualise automatiquement les événements de la pile toutes les minutes. Le badge Nouveaux événements disponibles apparaît lorsque de nouveaux événements de pile se produisent. Sélectionnez l’icône d’actualisation pour charger ces événements dans la liste.

En visualisant les événements de la pile regroupés par opération, vous pouvez comprendre la séquence des événements pour chaque opération et identifier rapidement l'opération spécifique à l'origine des problèmes (si vous êtes en train de déboguer votre pile).

Lorsque votre opération de stack est en cours d'exécution, elle est répertoriée avec un statut de CREATE_IN_PROGRESSUPDATE_IN_PROGRESS, ouDELETE_IN_PROGRESS. Une fois votre opération terminée avec succès, son statut passe à CREATE_COMPLETEUPDATE_COMPLETE, ouDELETE_COMPLETE.

Pour plus d’informations, consultez Comprendre les événements de création de pile CloudFormation et Surveiller la progression d’une mise à jour de pile.

Afficher les événements de la pile par opération (AWS CLI)

Vous pouvez utiliser la describe-events commande avec le filtrage des identifiants d'opération pour afficher les événements relatifs à des opérations spécifiques.

Obtenir la dernière opération IDs

La description de la pile disponible via l'API describe-stacks inclut désormais des LastOperations informations indiquant les opérations récentes IDs et leurs types. Cela vous permet d'identifier rapidement les opérations qui ont eu lieu et leur état actuel sans avoir à parcourir les journaux d'événements.

aws cloudformation describe-stacks --stack-name MyStack

Voici un exemple de réponse montrant que la dernière opération était une annulation suite à l'échec d'une opération de mise à jour.

{  
    "Stacks": [  
        {  
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/MyStack/07580010-bb79-11f0-8f6c-0289bb5c804f",  
            "StackName": "MyStack",  
            "Description": "A simple CloudFormation template to create an S3 bucket.",  
            "CreationTime": "2025-11-07T01:28:13.778000+00:00",  
            "LastUpdatedTime": "2025-11-07T01:43:39.838000+00:00",  
            "RollbackConfiguration": {},  
            "StackStatus": "UPDATE_ROLLBACK_COMPLETE",  
            "DisableRollback": false,  
            "NotificationARNs": [],  
            "Tags": [],  
            "EnableTerminationProtection": false,  
            "DriftInformation": {  
                "StackDriftStatus": "NOT_CHECKED"  
            },  
            "LastOperations": [  
                {  
                    "OperationType": "ROLLBACK",  
                    "OperationId": "d0f12313-7bdb-414d-a879-828a99b36f29"  
                },  
                {  
                    "OperationType": "UPDATE_STACK",  
                    "OperationId": "1c211b5a-4538-4dc9-bfed-e07734371e57"  
                }  
            ]  
        }  
    ]  
}

Filtrer les événements par ID d'opération

La describe-events commande suivante décrit les événements relatifs à un ID d'opération spécifique :

aws cloudformation describe-events \
  --operation-id 1c211b5a-4538-4dc9-bfed-e07734371e57

Pour afficher uniquement les événements ayant échoué à des fins de dépannage, utilisez le --filter FailedEvents=true paramètre :

aws cloudformation describe-events \
  --operation-id 1c211b5a-4538-4dc9-bfed-e07734371e57 \
  --filter FailedEvents=true

La nouvelle fonctionnalité de filtrage des identifiants d'opération vous permet de vous concentrer sur des opérations spécifiques et les événements connexes. Cela est particulièrement utile pour :

• Résolution de défaillances spécifiques : isolez les événements liés à un échec d'une opération pour comprendre ce qui s'est mal passé.

• Surveillance des opérations de longue durée : suivez la progression des mises à jour complexes ou des déploiements à grande échelle.

• Audit des modifications : passez en revue tous les événements associés à une opération de mise à jour particulière.

• Analyse des causes premières : utilisez le filtre d'échec pour identifier rapidement la source des problèmes de déploiement.

Codes d'état de la pile

Le tableau suivant décrit les champs renvoyés par la describe-events commande lors de l'utilisation du filtrage par ID d'opération :

Champ	Description
EventId	Identifiant de l'événement.
OperationId	Identifiant unique pour l'opération qui a généré cet événement.
StackName	Nom de la pile à laquelle l'événement correspond.
StackId	Identifiant de la pile à laquelle l'événement correspond.
LogicalResourceId	Identifiant logique de la ressource.
PhysicalResourceId	Identifiant physique de la ressource.
ResourceProperties	Propriétés de la ressource.
ResourceType	Type de ressource.
Timestamp	Moment où l'événement est survenu.
ResourceStatus	État de la ressource (CREATE_COMPLETE,UPDATE_FAILED, etc.).
DetailedStatus	État détaillé de la pile. Si CONFIGURATION_COMPLETE est présent, la phase de configuration des ressources de la pile est terminée et la stabilisation des ressources est en cours.
ResourceStatusReason	Plus d'informations sur cet état.