

# Gerenciar alarmes
<a name="Manage-CloudWatch-Alarm"></a>

**Topics**
+ [Como editar ou excluir um alarme do CloudWatch](Edit-CloudWatch-Alarm.md)
+ [Ocultar alarmes do Auto Scaling](hide-autoscaling-alarms.md)
+ [Alarmes e marcação](CloudWatch_alarms_and_tagging.md)
+ [Visualização e gerenciamento de alarmes silenciados](viewing-managing-muted-alarms.md)

# Como editar ou excluir um alarme do CloudWatch
<a name="Edit-CloudWatch-Alarm"></a>

É possível editar ou excluir um alarme existente.

Não é possível alterar o nome de um alarme existente. Copie o alarme e dê ao novo alarme um nome diferente. Para copiar um alarme, marque a caixa de seleção ao lado do nome do alarme na lista de alarmes e escolha **Action (Ação)**, **Copy (Copiar)**.

**Para editar um alarme**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Alarms** (Alarmes), **All alarms** (Todos os alarmes).

1. Escolha o nome do alarme.

1. Para adicionar ou remover tags, escolha a guia **Tags** e, em seguida, escolha **Gerenciar tags**.

1. Para editar outras partes do alarme, escolha **Ações**, **Editar**.

   A página **Specify metric and conditions (Especificar métrica e condições)** será exibida, mostrando um gráfico e outras informações sobre a métrica e a estatística que você selecionou.

1. Para alterar a métrica, escolha **Edit (Editar)**, escolha a guia **All metrics (Todas as métricas)** e execute uma das seguintes ações:
   + Escolha o namespace do serviço que contém a métrica desejada. Continue escolhendo as opções à medida que elas são exibidas para restringir as escolhas. Quando uma lista de métricas for exibida, marque a caixa de seleção ao lado da métrica que você deseja.
   + Na caixa de pesquisa, digite o nome de uma métrica, uma dimensão ou um ID de recurso e pressione Enter. Escolha um dos resultados e continue até uma lista de métricas ser exibida. Marque a caixa de seleção ao lado da métrica que você deseja. 

   Escolha **Selecionar métrica**.

1. Para alterar outros aspectos do alarme, escolha as opções apropriadas. Para alterar o número de pontos de dados que devem estar violando para o alarme entrar no estado `ALARM` ou para alterar a maneira como os dados ausentes são tratados, escolha **Additional configuration (Configuração adicional)**.

1. Escolha **Próximo**.

1. Em **Notification (Notificação)**, **Auto Scaling action (Ação do Auto Scaling)** e **EC2 action (Ação do EC2)**, é possível editar as ações executadas quando o alarme é acionado. Escolha **Próximo**.

1. Opcionalmente, altere a descrição do alarme.

   Não é possível alterar o nome de um alarme existente. Copie o alarme e dê ao novo alarme um nome diferente. Para copiar um alarme, marque a caixa de seleção ao lado do nome do alarme na lista de alarmes e escolha **Action (Ação)**, **Copy (Copiar)**.

1. Escolha **Próximo**.

1. Em **Preview and create (Visualizar e criar)**, confirme se as informações e condições são o que você deseja e escolha **Update alarm (Atualizar alarme)**.

**Para atualizar uma lista de notificações por e-mail que foi criada usando o console do Amazon SNS**

1. Abra o console do Amazon SNS em [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. No painel de navegação, escolha **Topics (Tópicos)** e selecione o ARN para a sua lista de notificações (tópico).

1. Execute um destes procedimentos:
   + Para adicionar um endereço de e-mail, escolha **Create subscription (Criar inscrição)**. Em **Protocolo**, escolha **E-mail**. Em **Endpoint**, insira o endereço de e-mail do novo destinatário. Selecione **Criar assinatura**.
   + Para remover um endereço de e-mail, escolha **ID da inscrição**. Escolha **Outras ações de inscrição**, **Excluir inscrições**.

1. Selecione **Publicar em um tópico**.

**Para excluir um alarme**

1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Alarmes**.

1. Marque a caixa de seleção à esquerda do nome do alarme e escolha **Ações**, **Excluir**.

1. Escolha **Excluir**.

# Ocultar alarmes do Auto Scaling
<a name="hide-autoscaling-alarms"></a>

Ao visualizar seus alertas no Console de gerenciamento da AWS, você pode ocultar os alarmes relacionados ao Amazon EC2 Auto Scaling e ao Application Auto Scaling. Esse recurso está disponível somente no Console de gerenciamento da AWS.

**Para ocultar temporariamente os alarmes do Auto Scaling**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Alarms** (Alarmes), **All alarms** (Todos os Alarmes), e selecione **Hide Auto Scaling alarms** (Ocultar todos os alarmes de AutoScaling).

# Alarmes e marcação
<a name="CloudWatch_alarms_and_tagging"></a>

As *etiquetas* são pares de valores-chave que podem ajudar você a organizar e categorizar os recursos. Você também pode usá-las para definir o escopo de permissões de usuários, concedendo a um usuário permissão para acessar ou alterar apenas recursos com determinados valores de etiqueta. Para obter informações mais gerais sobre a marcação de recursos, consulte [Tagging your AWS resources](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).

A lista apresentada a seguir explica alguns detalhes sobre como a marcação funciona com os alarmes do CloudWatch.
+ Para que seja possível definir ou atualizar as etiquetas para um recurso do CloudWatch, é necessário estar conectado a uma conta que tenha a permissão `cloudwatch:TagResource`. Por exemplo, para criar um alarme e definir as etiquetas para ele, é necessário ter a permissão `cloudwatch:TagResource`, além da permissão `the cloudwatch:PutMetricAlarm `. Recomendamos que você se certifique de que qualquer pessoa em sua organização que criará ou atualizará os recursos do CloudWatch tenha a permissão `cloudwatch:TagResource`.
+ As etiquetas podem ser usadas para obter um controle de autorização baseado em etiquetas. Por exemplo, as permissões de perfil ou de usuário do IAM podem incluir condições para limitar as chamadas do CloudWatch para recursos específicos com base nas etiquetas. No entanto, considere o seguinte:
  + As etiquetas com nomes que começam com `aws:` não podem ser usadas para obter um controle de autorização baseado em etiquetas.
  + Os alarmes compostos não oferecem suporte para o controle de autorização baseado em etiquetas.

# Visualização e gerenciamento de alarmes silenciados
<a name="viewing-managing-muted-alarms"></a>

 **Visualização de alarmes silenciados:** é possível identificar facilmente quais alarmes estão silenciados no momento por meio do console do CloudWatch. Tanto na exibição da lista de alarmes quanto nas páginas de detalhes dos alarmes individuais, um ícone de silenciamento é exibido ao lado dos alarmes cujas ações estão sendo silenciadas pelas regras ativas de silenciamento. Esse indicador visual ajuda você a entender rapidamente quais ações de alarmes estão sendo silenciadas no momento até que a janela de silenciamento expire. 

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/alarm_mute_rules_icon.png)


 **Cronograma de alarmes:** o console de alarmes do CloudWatch fornece uma visão abrangente do cronograma que mostra quando suas ações de alarme foram silenciadas. Esse cronograma exibe os períodos de silêncio junto com as mudanças no estado do alarme, oferecendo uma visão histórica completa do comportamento do alarme e da atividade de silenciamento. É possível usar esse cronograma para analisar a eficácia de suas regras de silenciamento e entender como elas se correlacionam com suas atividades operacionais. 

![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/alarm-mutes-timelineview.png)


 **Verificação programática do status de silenciamento do alarme:** para determinar programaticamente se um alarme está silenciado no momento, é possível usar a API [ListAlarmMuteRules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListAlarmMuteRules.html) com o nome do alarme como critério de filtro. Essa API retorna todas as regras ativas de silenciamento que estejam afetando o alarme especificado, permitindo que você integre verificações de status de silenciamento em seus fluxos de trabalho de automação, painéis de monitoramento ou ferramentas operacionais. 

 Por exemplo: para verificar se um alarme chamado “HighCpuAlarm” está silenciado no momento, chame a API [ListAlarmMuteRules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListAlarmMuteRules.html) com o parâmetro de filtro definido como o nome do alarme. A resposta incluirá todas as regras de silenciamento direcionadas a esse alarme, junto com seu status atual (PROGRAMADO, ATIVO ou EXPIRADO). 

 **Histórico de alarmes:** sempre que as ações de alarme são silenciadas devido a uma regra ativa de silenciamento, o CloudWatch grava uma entrada de histórico no log de histórico do alarme. Isso fornece uma trilha de auditoria completa de quando seus alarmes foram silenciados, ajudando você a entender o cronograma dos eventos de silenciamento e a correlacioná-los com as atividades operacionais. É possível visualizar esse histórico por meio do console do CloudWatch ou recuperá-lo programaticamente usando a API [DescribeAlarmHistory](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html). 

**nota**  
 Quando várias regras de silenciamento de alarme estão ativas simultaneamente, o nome da regra de silenciamento criada mais recentemente é gravado no histórico de alarmes junto com o número total de outras regras de silenciamento ativas. 
 A linha do tempo exibe períodos de silenciamento somente quando um estado de alarme muda durante uma janela ativa de silenciamento e as ações são impedidas de serem executadas. 

**dica**  
 É possível gerenciar as regras de silenciamento de alarmes de forma programática usando a API do CloudWatch. Para obter mais informações, consulte [PutAlarmMuteRule](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutAlarmMuteRule.html), [GetAlarmMuteRule](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetAlarmMuteRule.html), [ListAlarmMuteRules](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_ListAlarmMuteRules.html) e [DeleteAlarmMuteRule](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DeleteAlarmMuteRule.html). 