Monitorar o progresso da pilha - AWS CloudFormation

Monitorar o progresso da pilha

Esta seção descreve como monitorar uma implantação de pilha que está em andamento. O CloudFormation fornece uma lista detalhada e cronológica dos eventos de implantação, mostrando o progresso e quaisquer problemas encontrados durante a implantação.

Visualizar eventos da pilha (console)

Para visualizar os eventos da pilha
  1. Abra o console do AWS 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 Stacks (Pilhas) do console do CloudFormation, 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.

O CloudFormation atualiza automaticamente os eventos da pilha a cada minuto. Além disso, o CloudFormation exibe o emblema Novos eventos disponíveis quando ocorrem novos eventos de pilha. Escolha o ícone de atualização para carregar esses eventos na lista. Ao visualizar eventos de criação da pilha, você pode entender a sequência de eventos que levam à criação da sua pilha (ou falha, se você está depurando a pilha).

Durante a criação da pilha, ela estará listada na página Pilhas com um status de CREATE_IN_PROGRESS. Após a pilha ter sido criada com êxito, seu status muda para CREATE_COMPLETE.

Para ter 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 da pilha (AWS CLI)

Como alternativa, você pode usar o comando describe-stack-events enquanto a pilha está sendo criada para visualizar os eventos à medida que eles são relatados.

O comando describe-stack-events a seguir descreve os eventos da pilha myteststack.

aws cloudformation describe-stack-events --stack-name myteststack

O seguinte é um exemplo de resposta.

{ "StackEvents": [ { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "af67ef60-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:30.070Z", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_COMPLETE-1377219748025", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:28.025Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219746688", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:26.688Z", "ResourceStatusReason": "Resource creation Initiated", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219743862", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:23.862Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": null, "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "a69469e0-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:15.422Z", "ResourceStatusReason": "User Initiated", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" } ] }

Os eventos mais recentes são relatados primeiro. A tabela a seguir descreve os campos retornados pelo comando describe-stack-events:

Campo Descrição
EventId

Identificador de eventos.

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, que pode ser um dos seguintes códigos de status: CREATE_COMPLETE | CREATE_FAILED | CREATE_IN_PROGRESS | DELETE_COMPLETE | DELETE_FAILED | DELETE_IN_PROGRESS | DELETE_SKIPPED | IMPORT_COMPLETE | IMPORT_IN_PROGRESS | IMPORT_ROLLBACK_COMPLETE | IMPORT_ROLLBACK_FAILED | IMPORT_ROLLBACK_IN_PROGRESS | REVIEW_IN_PROGRESS | ROLLBACK_COMPLETE | ROLLBACK_FAILED | ROLLBACK_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_FAILED | UPDATE_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_IN_PROGRESS

O status DELETE_SKIPPED se aplica aos recursos com um atributo de manutenção de política de exclusão.

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.

Códigos de status da pilha

A tabela a seguir descreve os códigos de status da pilha:

Status da pilha e status detalhado opcional Descrição

CREATE_COMPLETE

Criação bem-sucedida de uma ou mais pilhas.

CREATE_IN_PROGRESS

Criação contínua de uma ou mais pilhas.

CREATE_FAILED

Criação malsucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas. As possíveis razões para uma falha na criação incluem permissões insuficientes para trabalhar com todos os recursos na pilha, valores de parâmetro rejeitados por um produto da AWS ou um tempo limite durante a criação de recursos.

DELETE_COMPLETE

Exclusão bem-sucedida de uma ou mais pilhas. As pilhas excluídas serão retidas e poderão ser visualizadas por 90 dias.

DELETE_FAILED

Exclusão malsucedida de uma ou mais pilhas. Como a exclusão falhou, alguns recursos ainda poderão estar em execução. No entanto, não é possível trabalhar com a pilha, tampouco atualizá-la. Exclua a pilha novamente ou visualize os eventos de pilha para ver as mensagens de erro associadas.

DELETE_IN_PROGRESS

Remoção contínua de uma ou mais pilhas.

REVIEW_IN_PROGRESS

Criação contínua de uma ou mais pilhas com um StackId esperado, mas sem modelos ou recursos.
Importante

Uma pilha com este código de status conta contra o número máximo possível de pilhas.

ROLLBACK_COMPLETE

Remoção bem-sucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. A pilha retorna ao estado operacional anterior. Quaisquer recursos criados durante a ação de criação da pilha serão excluídos.

Esse status ocorre somente após uma falha de criação de uma pilha. Ele significa que todas as operações da pilha parcialmente criada foram adequadamente limpas. Ao entrar nesse estado, a única operação possível é a exclusão.

ROLLBACK_FAILED

Remoção malsucedida de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha. Exclua a pilha ou visualize os eventos de pilha para ver as mensagens de erro associadas.

ROLLBACK_IN_PROGRESS

Remoção contínua de uma ou mais pilhas após uma falha na criação de uma pilha ou após um cancelamento explícito da criação de uma pilha.

UPDATE_COMPLETE

Atualização bem-sucedida de uma ou mais pilhas.

UPDATE_COMPLETE_CLEANUP_IN_PROGRESS

Remoção contínua de recursos antigos para uma ou mais pilhas após uma atualização bem-sucedida da pilha. Para atualizações de pilha que exigem a substituição de recursos, o CloudFormation cria os novos recursos primeiro e, em seguida, exclui os recursos antigos para ajudar a reduzir as interrupções com a pilha. Nesse estado, a pilha foi atualizado e é utilizável, mas o CloudFormation ainda está excluindo os recursos antigos.

UPDATE_FAILED

Atualização bem-sucedida de uma ou mais pilhas. Visualize os eventos da pilha para ver as mensagens de erro associadas.

UPDATE_IN_PROGRESS

Atualização contínua de uma ou mais pilhas.

UPDATE_ROLLBACK_COMPLETE

Retorno bem-sucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha.

UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS

Remoção contínua de recursos novos para uma ou mais pilhas após uma atualização falha da pilha. Nesse estado, a pilha foi revertida para seu estado de trabalho anterior e é utilizável, mas o CloudFormation ainda está excluindo os recursos novos criados durante a atualização da pilha.

UPDATE_ROLLBACK_FAILED

Retorno malsucedido de uma ou mais pilhas para um estado de trabalho anterior após uma falha na atualização da pilha. Quando estiver neste estado, você pode excluir a pilha ou continuar a reversão. Talvez você precise corrigir erros para que a pilha possa retornar a um estado operacional. Se preferir, entre em contato com o AWS Support para restaurar a pilha para um estado utilizável.

UPDATE_ROLLBACK_IN_PROGRESS

Retorno contínuo de uma ou mais pilhas para o estado de trabalho anterior após falha na atualização da pilha.

IMPORT_IN_PROGRESS

A operação de importação está em andamento.

IMPORT_COMPLETE

A operação de importação foi concluída com êxito para todos os recursos da pilha que oferecem suporte a resource import.

IMPORT_ROLLBACK_IN_PROGRESS

A importação será revertida para a configuração do modelo anterior.

IMPORT_ROLLBACK_FAILED

Houve uma falha na operação de reversão de importação para pelo menos um recurso na pilha. Os resultados serão disponibilizados para os recursos importados com êxito pelo CloudFormation.

IMPORT_ROLLBACK_COMPLETE

A importação foi revertida com êxito para a configuração de modelo anterior.