Visualización de eventos de la pila por operación - AWS CloudFormation

Visualización de eventos de la pila por operación

Puede ver los eventos de la pila agrupados por operación para comprender mejor la secuencia y el alcance de los cambios realizados en la pila. La agrupación basada en operaciones le ayuda a realizar un seguimiento conjunto de los eventos relacionados, lo que facilita el seguimiento del progreso y la resolución de problemas cuando se producen.

A cada operación de la pila (creación, actualización, eliminación o reversión) se le asigna un ID de operación único que agrupa todos los eventos relacionados. Esto le permite centrarse en operaciones específicas e identificar rápidamente la causa raíz de los errores.

Requisitos previos

Para usar la API DescribeEvents, debe tener los permisos de IAM necesarios para: DescribeEvents.

Visualización de eventos de la pila por operación (consola)

Visualización de eventos de la pila agrupados por operación
  1. Inicie sesión en la Consola de administración de AWS y abra la consola de CloudFormation en https://console.aws.amazon.com/cloudformation.

  2. En la barra de navegación de la parte superior de la pantalla, elija la Región de AWS en la que creó la pila.

  3. En la página Pilas, seleccione el nombre de la pila. CloudFormation muestra la información de la pila que haya seleccionado.

  4. Seleccione la pestaña Eventos para ver los eventos de la pila que CloudFormation generó para la pila.

  5. Los eventos se agrupan automáticamente por ID de operación. Cada operación aparece como una sección ampliable que muestra el tipo, el estado y la marca temporal de la operación.

  6. Haga clic en el ID de operación para abrir una vista detallada que muestre solo los eventos relacionados con esa operación específica.

  7. En la vista de detalles de la operación, seleccione la casilla Mostrar solo errores para mostrar solo los eventos con errores en el análisis de la causa raíz.

CloudFormation actualiza automáticamente los eventos de la pila cada minuto. La insignia Nuevos eventos disponibles aparece cuando se producen nuevos eventos de la pila. Seleccione el icono de actualización para cargar estos eventos en la lista.

Al visualizar eventos de la pila agrupados por operación, puede comprender la secuencia de eventos de cada operación e identificar rápidamente qué operación específica causó problemas (si está depurando la pila).

Mientras la operación de la pila está en ejecución, aparece con el estado CREATE_IN_PROGRESS, UPDATE_IN_PROGRESS o DELETE_IN_PROGRESS. Una vez que la operación se haya completado correctamente, su estado cambiará a CREATE_COMPLETE, UPDATE_COMPLETE o DELETE_COMPLETE.

Para obtener más información, consulte Comprensión de los eventos de creación de la pila de CloudFormation y Monitorización del progreso de una actualización de pila.

Visualización de eventos de la pila por operación (AWS CLI)

Puede usar el comando describe-events con el filtrado de ID de operación para ver los eventos de operaciones específicas.

Obtención de los ID de la última operación

La descripción de la pila, disponible a través de la API describe-stacks, ya incluye información de LastOperations que muestra los ID de operaciones recientes y sus tipos. Esto le permite identificar rápidamente qué operaciones se han realizado y su estado actual sin tener que analizar los registros de eventos.

aws cloudformation describe-stacks --stack-name MyStack

El siguiente es un ejemplo de respuesta que muestra que la última operación fue una reversión tras una operación de actualización fallida.

{ "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" } ] } ] }

Filtrado de eventos por ID de operación

El siguiente comando describe-events describe los eventos de un ID de operación específico:

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

Para ver solo los eventos fallidos para la solución de problemas, utilice el parámetro --filter FailedEvents=true:

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

La nueva función de filtrado por ID de operación le permite centrarse en operaciones específicas y sus eventos relacionados. Resulta especialmente útil para lo siguiente:

  • Solución de problemas específicos: aísle los eventos de una operación fallida para comprender qué es lo que ha fallado.

  • Supervisión de las operaciones de larga duración: realice un seguimiento del progreso de las actualizaciones complejas o de las implementaciones de pilas de gran tamaño.

  • Auditoría de cambios: revise todos los eventos asociados a una operación de actualización concreta.

  • Análisis de la causa raíz: utilice el filtro de errores para identificar rápidamente el origen de los problemas de implementación.

Códigos de estado de pilas

En la siguiente tabla se describen los campos devueltos por el comando describe-events al utilizar el filtrado por ID de operación:

Campo Descripción
EventId Identificador de eventos.
OperationId Identificador único de la operación que generó este evento.
StackName Nombre de la pila a la que corresponde el evento.
StackId Identificador de la pila a la que corresponde el evento.
LogicalResourceId Identificador lógico del recurso.
PhysicalResourceId Identificador físico del recurso.
ResourceProperties Propiedades del recurso.
ResourceType Tipo del recurso.
Timestamp Hora en la que se produjo el evento.
ResourceStatus El estado del recurso (CREATE_COMPLETE, UPDATE_FAILED, etc.).
DetailedStatus Estado detallado de la pila. Si CONFIGURATION_COMPLETE está presente, la fase de configuración de los recursos de la pila se ha completado y la estabilización de los recursos está en curso.
ResourceStatusReason Más información sobre el estado.