# Monitorar o progresso da atualização de uma pilha
<a name="using-cfn-updating-stacks-monitor-stack"></a>

Monitore o progresso da atualização de uma pilha visualizando os eventos da pilha. A guia **Eventos** do console exibe cada etapa principal da criação e atualização da pilha classificada pelo tempo de cada evento, com os eventos mais recentes na parte superior. Para obter mais informações, consulte [Monitorar o progresso da pilha](monitor-stack-progress.md).

**Topics**
+ [Eventos gerados durante uma atualização de pilha bem-sucedida](#using-cfn-updating-stacks-monitor-stack-update-events)
+ [Eventos gerados quando uma atualização de recurso falha](#using-cfn-updating-stacks-monitor-stack-update-failure)

## Eventos gerados durante uma atualização de pilha bem-sucedida
<a name="using-cfn-updating-stacks-monitor-stack-update-events"></a>

O início do processo de atualização da pilha é marcado com um evento `UPDATE_IN_PROGRESS` para a pilha:

```
2011-09-30 09:35 PDT AWS::CloudFormation::Stack {{MyStack}} UPDATE_IN_PROGRESS 
```

Em seguida estão os eventos que marcam o início e a conclusão da atualização de cada recurso que foi alterado no modelo de atualização. Por exemplo, a atualização de um recurso de [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html) chamado `MyDB` resultaria nas seguintes entradas:

```
2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE
2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS
```

O evento `UPDATE_IN_PROGRESS` é registrado em log quando o CloudFormation relata que começou a atualizar o recurso. O evento `UPDATE_COMPLETE` é registrado em log quando o recurso é criado com êxito.

Quando o CloudFormation tiver atualizado com êxito a pilha, você verá o seguinte evento:

```
2011-09-30 09:35 PDT AWS::CloudFormation::Stack {{MyStack}} UPDATE_COMPLETE 
```

**Importante**  
Durante as operações de atualização de pilha, se o CloudFormation precisar substituir um recurso existente, primeiramente ele criará um novo recurso e, em seguida, excluirá o antigo. No entanto, pode haver casos em que o CloudFormation não pode excluir o recurso antigo (por exemplo, se o usuário não tiver permissões para excluir um recurso de um determinado tipo).  
O CloudFormation faz três tentativas de excluir o recurso antigo. Se o CloudFormation não puder excluir o recurso antigo, ele removerá o recurso antigo da pilha e continuará a atualizá-la. Quando a atualização da pilha estiver concluída, o CloudFormation emitirá um evento de pilha `UPDATE_COMPLETE`, mas incluirá um `StatusReason` que declarará que não foi possível excluir um ou mais recursos. O CloudFormation também emite um evento `DELETE_FAILED` para o recurso específico, com um `StatusReason` correspondente fornecendo mais detalhes sobre o motivo pelo qual o CloudFormation não conseguiu excluir o recurso.  
O recurso antigo ainda existe e continuará a gerar cobranças, mas deixará de ser acessível por meio do CloudFormation. Para excluir o recurso antigo, acesse o recurso antigo diretamente usando o console ou a API do serviço em questão.  
Isso também se aplica aos recursos que você removeu do modelo de pilha e, portanto, eles serão excluídos da pilha durante a atualização da pilha.

## Eventos gerados quando uma atualização de recurso falha
<a name="using-cfn-updating-stacks-monitor-stack-update-failure"></a>

Se a atualização de um recurso falhar, o CloudFormation relatará um evento `UPDATE_FAILED` que incluirá um motivo para a falha. Por exemplo, se o modelo de atualização tiver especificado uma alteração de propriedade não aceita pelo recurso, como a redução do tamanho de `AllocatedStorage` para um recurso de [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-rds-dbinstance.html), você verá eventos como estes:

```
2011-09-30 09:36 PDT AWS::RDS::DBInstance MyDB UPDATE_FAILED Size cannot be less than current size; requested: 5; current: 10
2011-09-30 09:35 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS
```

Se um recurso de atualização falhar, o CloudFormation reverterá quaisquer recursos que tiverem sido atualizados para as configurações anteriores à atualização. Aqui está um exemplo de eventos que seriam vistos durante uma reversão de atualização:

```
2011-09-30 09:38 PDT AWS::CloudFormation::Stack {{MyStack}} UPDATE_ROLLBACK_COMPLETE
2011-09-30 09:38 PDT AWS::RDS::DBInstance MyDB UPDATE_COMPLETE
2011-09-30 09:37 PDT AWS::RDS::DBInstance MyDB UPDATE_IN_PROGRESS
2011-09-30 09:37 PDT AWS::CloudFormation::Stack {{MyStack}} UPDATE_ROLLBACK_IN_PROGRESS The following resource(s) failed to update: [MyDB]
```