As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitoramento de implantações com ferramentas da Amazon CloudWatch
Você pode monitorar CodeDeploy implantações usando as seguintes CloudWatch ferramentas: Amazon CloudWatch Events, CloudWatch alarmes e Amazon CloudWatch Logs.
A análise dos registros criados pelo CodeDeploy agente e pelas implantações pode ajudá-lo a solucionar as causas das falhas de implantação. Como alternativa à análise de CodeDeploy registros em uma instância por vez, você pode usar o CloudWatch Logs para monitorar todos os registros em um local central.
Para obter informações sobre o uso de CloudWatch alarmes e CloudWatch eventos para monitorar suas CodeDeploy implantações, consulte os tópicos a seguir.
**Topics**
+ [Monitorando implantações com CloudWatch alarmes em CodeDeploy](monitoring-create-alarms.md)
+ [Monitoramento de implantações com Amazon Events CloudWatch](monitoring-cloudwatch-events.md)
# Monitorando implantações com CloudWatch alarmes em CodeDeploy
Você pode criar um CloudWatch alarme para uma instância ou grupo do Amazon EC2 Auto Scaling que você está usando CodeDeploy em suas operações. Um alarme monitora uma única métrica durante um período que você especifica e executa uma ou mais ações com base no valor da métrica em relação a um determinado limite em vários períodos. CloudWatch os alarmes invocam ações quando seu estado muda (por exemplo, de `OK` para`ALARM`).
Usando a funcionalidade de CloudWatch alarme nativa, você pode especificar qualquer uma das ações suportadas CloudWatch quando uma instância que você está usando em uma implantação falha, como enviar uma notificação do Amazon SNS ou interromper, encerrar, reinicializar ou recuperar uma instância. Para suas CodeDeploy operações, você pode configurar um grupo de implantação para interromper uma implantação sempre que qualquer CloudWatch alarme associado ao grupo de implantação for ativado.
Você pode associar até dez CloudWatch alarmes a um grupo de CodeDeploy implantação. Se qualquer um dos alarmes especificados for ativado, a implantação será interrompida, e o status será atualizado para Stopped. Para usar essa opção, você deve conceder CloudWatch permissões à sua função CodeDeploy de serviço.
Para obter informações sobre a configuração de CloudWatch alarmes no CloudWatch console, consulte [Criação de CloudWatch alarmes da Amazon no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/AlarmThatSendsEmail.html) *do usuário da Amazon*.
Para obter informações sobre como associar um CloudWatch alarme a um grupo de implantação em CodeDeploy, consulte [Crie um grupo de implantação com CodeDeploy](deployment-groups-create.md) e. [Altere as configurações do grupo de implantação com CodeDeploy](deployment-groups-edit.md)
**Topics**
+ [Conceder CloudWatch permissões para uma função CodeDeploy de serviço](monitoring-create-alarms-grant-permissions.md)
# Conceder CloudWatch permissões para uma função CodeDeploy de serviço
Antes de usar o monitoramento de CloudWatch alarmes com suas implantações, a função de serviço que você usa em suas CodeDeploy operações deve ter permissão para acessar os CloudWatch recursos.
**Para conceder CloudWatch permissões a uma função de serviço**
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No console do IAM, selecione **Perfis** no painel de navegação.
1. Escolha o nome da função de serviço que você usa em suas AWS CodeDeploy operações.
1. Na guia **Permissões**, na área de **Políticas em linha**, selecione **Criar política da função**.
–ou–
Se o botão **Criar política da função** não estiver disponível, expanda a área de **Políticas em linha** e depois **clique aqui**.
1. Na página **Definir permissões**, selecione **Política personalizada** e, então, **Selecionar**.
1. Na página **Revisar política**, no campo **Nome da política**, digite um nome para identificar essa política, tal como `CWAlarms`.
1. Cole o seguinte no campo **Documento da política:**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "cloudwatch:DescribeAlarms",
"Resource": "*"
}
]
}
```
------
1. Selecione **Aplicar política**.
# Monitoramento de implantações com Amazon Events CloudWatch
Você pode usar o Amazon CloudWatch Events para detectar e reagir às mudanças no estado de uma instância ou de uma implantação (um “evento”) em suas CodeDeploy operações. Em seguida, com base nas regras criadas por você, CloudWatch os Eventos invocarão uma ou mais ações de destino quando uma implantação ou instância entrar no estado especificado em uma regra. Dependendo do tipo de alteração de estado, convém enviar notificações, capturar informações de estado, tomar medidas corretivas, iniciar eventos ou realizar outras ações. Você pode selecionar os seguintes tipos de alvos ao usar CloudWatch Eventos como parte de suas CodeDeploy operações:
+ AWS Lambda funções
+ Streams do Kinesis
+ Filas do Amazon SQS
+ Destinos integrados (`EC2 CreateSnapshot API call`, `EC2 RebootInstances API call`, `EC2 StopInstances API call` e `EC2 TerminateInstances API call`)
+ Tópicos do Amazon SNS
A seguir, alguns casos de uso:
+ Use uma função do Lambda para transmitir uma notificação a um canal Slack sempre que uma implantação falhar.
+ Envie dados sobre implantações ou instâncias a um stream do Kinesis para oferecer suporte ao monitoramento abrangente do status em tempo real.
+ Use ações de CloudWatch alarme para parar, encerrar, reinicializar ou recuperar automaticamente EC2 instâncias da Amazon quando ocorrer uma implantação ou evento de instância que você especificar.
O restante deste tópico descreve o procedimento básico para criar uma regra de CloudWatch eventos para CodeDeploy. No entanto, antes de criar regras de eventos para uso em suas CodeDeploy operações, você deve fazer o seguinte:
+ Conclua os pré-requisitos CloudWatch dos eventos. Para obter informações, consulte [Pré-requisitos de CloudWatch eventos da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_Prerequisites.html).
+ Familiarize-se com eventos, regras e metas em CloudWatch Eventos. Para obter mais informações, consulte [O que é Amazon CloudWatch Events?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html) e [novos CloudWatch eventos — acompanhe e responda às mudanças em seus AWS recursos](https://aws.amazon.com/blogs/aws/new-cloudwatch-events-track-and-respond-to-changes-to-your-aws-resources/).
+ Criar um ou mais destinos que você usará nas suas regras de evento.
**Para criar uma regra de CloudWatch eventos para CodeDeploy:**
1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. No painel de navegação, escolha **Eventos**.
1. Escolha **Create rule (Criar regra)** e, em **Event selector (Seletor de eventos)**, escolha **AWS CodeDeploy**.
1. Especifique um tipo de detalhe:
+ Para criar uma regra que se aplique a todas as alterações de estado das instâncias e das implantações, escolha **Any detail type** e vá para a etapa 6.
+ Para criar uma regra que se aplique somente às instâncias, escolha **Tipo de detalhe específico** e, em seguida, escolha **Notificação de alteração do estado da CodeDeploy instância**.
+ Para criar uma regra que se aplique somente às implantações, escolha **Tipo de detalhe específico** e, em seguida, escolha Notificação de **alteração do estado da CodeDeploy implantação**.
1. Especifique as alterações de estado às quais a regra se aplica:
+ Para criar uma regra que se aplique a todas as alterações de estado, escolha **Any state**.
+ Para criar uma regra que se aplique apenas a algumas alterações de estado, escolha **Specific state(s)** e escolha um ou mais valores de status na lista. A tabela a seguir lista os valores de status que você pode escolher:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/monitoring-cloudwatch-events.html)
1. Especifique a quais CodeDeploy aplicativos a regra se aplica:
+ Para criar uma regra que se aplique a todos os aplicativos, escolha **Any application** e vá para a etapa 8.
+ Para criar uma regra que se aplique a apenas um aplicativo, escolha **Specific application** e escolha o nome do aplicativo na lista.
1. Especifique a quais grupos de implantação a regra se aplica:
+ Para criar uma regra que se aplique a todos os grupos de implantação associados ao aplicativo selecionado, escolha **Any deployment group**.
+ Para criar uma regra que se aplique a apenas um dos grupos de implantação associados ao aplicativo selecionado, escolha **Specific deployment group(s)** e escolha o nome do grupo de implantação na lista.
1. Analise a configuração da regra para garantir que ela atenda aos requisitos de monitoramento de evento.
1. Na área **Targets**, escolha **Add target\$1**.
1. Na lista **Select target type (Selecionar tipo de destino)**, escolha o tipo de destino preparado para usar com essa regra e configure as opções adicionais necessárias a esse tipo.
1. Escolha **Configure details (Configurar detalhes)**.
1. Na página **Configure rule details**, digite um nome e uma descrição para a regra e, em seguida, escolha a caixa **State** para habilitar a regra agora.
1. Se você estiver satisfeito com a regra, escolha **Create rule**.