Visualizar eventos das pilhas por operação - AWS CloudFormation
Pré-requisitosVisualizar eventos de pilhas por operação (console)Visualizar eventos de pilhas por operação (AWS CLI)Códigos de status da pilha

Visualizar eventos das pilhas por operação

Você pode visualizar os eventos das pilhas agrupados por operação para entender melhor a sequência e o escopo das alterações feitas em sua pilha. O agrupamento baseado em operações ajuda você a acompanhar eventos relacionados em conjunto, facilitando o monitoramento do progresso e a solução de problemas quando eles ocorrerem.

Cada operação de pilha (criar, atualizar, excluir, reverter) recebe um ID de operação exclusivo que agrupa todos os eventos relacionados. Isso permite que você mantenha o foco em operações específicas e identifique rapidamente a causa raiz das falhas.

Pré-requisitos

Para usar a API DescribeEvents, você deve ter as permissões necessárias do IAM para:DescribeEvents.

Visualizar eventos de pilhas por operação (console)

Para visualizar os eventos de pilhas agrupados por operação

  1. Faça login no Console de gerenciamento da AWS e abra o console CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação na parte superior da tela, escolha a Região da AWS na qual você criou a pilha.

  3. Na página Pilhas, selecione o nome da pilha. O CloudFormation exibe a página de detalhes da pilha para a pilha selecionada.

  4. Escolha a guia Eventos para visualizar os eventos de pilha que o CloudFormation gerou para sua pilha.

  5. Os eventos são agrupados automaticamente por ID da operação. Cada operação aparece como uma seção expansível mostrando o seu tipo, status e carimbo de data e hora.

  6. Clique no ID de uma operação para abrir uma visualização detalhada mostrando somente os eventos relacionados a essa operação específica.

  7. Na exibição de detalhes da operação, marque a caixa de seleção Exibir somente falhas para exibir somente eventos com falha na análise da causa raiz.

O CloudFormation atualiza automaticamente os eventos da pilha a cada minuto. O emblema Novos eventos disponíveis aparece quando ocorrem novos eventos de pilha. Escolha o ícone de atualização para carregar esses eventos na lista.

Ao visualizar os eventos da pilha agrupados por operação, você pode entender a sequência de eventos de cada operação e identificar rapidamente qual operação específica causou problemas (se você estiver depurando a pilha).

Enquanto sua operação de pilha está em execução, ela é listada com um status de CREATE_IN_PROGRESS, UPDATE_IN_PROGRESS ou DELETE_IN_PROGRESS. Depois que sua operação for concluída com êxito, seu status mudará para CREATE_COMPLETE, UPDATE_COMPLETE ou DELETE_COMPLETE.

Para obter mais informações, consulte Entender os eventos de criação de pilhas do CloudFormation e Monitorar o progresso da atualização de uma pilha.

Visualizar eventos de pilhas por operação (AWS CLI)

Você pode usar o comando describe-events com filtragem de ID de operação para visualizar eventos de operações específicas.

Obter IDs da última operação

A descrição da pilha disponível por meio da API describe-stacks agora inclui informações de LastOperations mostrando os IDs de operações recentes e seus tipos. Isso permite que você identifique rapidamente quais operações ocorreram e seu status atual sem analisar os logs de eventos.

aws cloudformation describe-stacks --stack-name MyStack

Veja a seguir um exemplo de resposta mostrando que a última operação foi uma reversão após uma falha na operação de atualização.

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

Filtrar eventos por ID de operação

O comando describe-events abaixo descreve os eventos para um ID de operação específico:

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

Para visualizar somente eventos com falha para solução de problemas, use o parâmetro --filter FailedEvents=true:

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

O novo recurso de filtragem de ID de operação permite que você se concentre em operações específicas e seus eventos relacionados. Ela é particularmente útil para:

  • Solução de falhas específicas: isole os eventos de uma operação com falha para entender o que deu errado.

  • Monitoramento de operações de longa duração: acompanhe o progresso de atualizações complexas ou implantações de grandes pilhas.

  • Auditoria de alterações: revise todos os eventos associados a uma operação de atualização específica.

  • Análise da causa raiz: use o filtro de falhas para identificar rapidamente a origem dos problemas de implantação.

Códigos de status da pilha

A tabela abaixo descreve os campos retornados pelo comando describe-events ao usar a operação de filtragem de ID:

Campo Descrição
EventId Identificador de eventos.
OperationId Identificador exclusivo para a operação que gerou esse evento.
StackName Nome da pilha a qual o evento corresponde.
StackId Identificador pilha ao qual o evento corresponde.
LogicalResourceId Identificador do recurso lógico.
PhysicalResourceId Identificador do recurso físico.
ResourceProperties Propriedades do recurso.
ResourceType Tipo de recurso.
Timestamp Hora em que o evento ocorreu.
ResourceStatus O status do recurso (CREATE_COMPLETE, UPDATE_FAILED etc.).
DetailedStatus O status detalhado da pilha. Se CONFIGURATION_COMPLETE estiver presente, a fase de configuração dos recursos da pilha foi concluída e a estabilização dos recursos está em andamento.
ResourceStatusReason Mais informações sobre o status.