# Alarmes em consultas do CloudWatch Metrics Insights no CloudWatch
<a name="cloudwatch-metrics-insights-alarms"></a>

Você pode criar alarmes nas consultas ao Metrics Insights. Isso ajuda você a ter alarmes que rastreiam vários recursos sem ser necessário atualizá-los posteriormente. A consulta captura os novos recursos e os recursos que sofrem alteações. Por exemplo, é possível criar um alarme que monitore a utilização de CPU da sua frota, e o alarme avaliará automaticamente as novas instâncias que você iniciar após criar o alarme.

Em uma conta de monitoramento configurada para observabilidade entre contas do CloudWatch, os alarmes do Metrics Insights podem observar recursos nas contas de origem e na própria conta de monitoramento. Para obter mais informações sobre como limitar suas consultas de alarme a uma conta específica ou agrupar os resultados por ID da conta, consulte as seções `WHERE` e `GROUP BY` em [Componentes e sintaxe de consulta no CloudWatch Metrics Insights](cloudwatch-metrics-insights-querylanguage.md).

**Usar tags em consultas de alarme**

Você pode criar alarmes em consultas do Metrics Insights que usam tags de recurso da AWS para filtrar e agrupar métricas. Para usar tags com alarmes, em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/), escolha **Configurações**. Na página **Configurações do CloudWatch**, em **Habilitar tags de recurso em telemetria**, escolha **Habilitar**. Alarmes sensíveis a contexto monitoram aplicações, ambientes ou equipes específicos automaticamente à medida que os recursos mudam.

Por exemplo, você pode criar um alarme que monitore a utilização de CPU para todas as instâncias do Amazon EC2 marcadas com uma aplicação específica.

```
SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE tag.Application = 'Orders' AND tag.Environment = 'Prod'
```

Os alarmes baseados em tags se adaptam automaticamente à medida que você adiciona ou remove recursos com as tags correspondentes, o que permite monitoramento dinâmico alinhado com a estrutura operacional.

**Contents**
+ [Criação de um alarme do CloudWatch com o Metrics Insights](cloudwatch-metrics-insights-alarm-create.md)

# Criação de um alarme do CloudWatch com o Metrics Insights
<a name="cloudwatch-metrics-insights-alarm-create"></a>

**Para criar um alarme em uma consulta ao Metrics Insights usando o console**

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 **Metrics** (Métricas), **All metrics** (Todas as métricas).

1. (Opcional) Para executar uma consulta de amostra pré-criada, escolha **Add query** (Adicionar consulta) e selecione a consulta a ser executada. Caso contrário, você pode escolher **Editor** para editar a consulta de exemplo e, em seguida, escolher **Run** (Executar) para executar a consulta modificada. 

1. Para criar sua própria consulta, escolha **Consulta a várias fontes**. É possível usar as visualizações **Criador** e **Editor** e também uma combinação de ambas. Você pode alternar entre as duas visualizações a qualquer momento e ver o trabalho em andamento em ambas. 

   No **Builder** (Criador), você pode procurar e selecionar o namespace da métrica, o nome da métrica, o filtro, o grupo e as opções de ordem. Para cada uma dessas opções, o criador de consultas oferece uma lista de possíveis seleções do seu ambiente para escolher.

   Na visualização de **Editor**, você pode começar a gravar sua consulta. À medida que você digita, o editor oferece sugestões com base nos caracteres digitados até o momento.

   Por exemplo, ao criar a consulta do Metrics Insights para o alarme, use tags para filtrar e agrupar as métricas e ter um monitoramento mais direcionado.
   + Filtrar por tags: use `WHERE tag.keyName = 'value'` para monitorar recursos com tags específicas

     ```
     SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE tag.Environment = 'Prod'
     ```
   + Combinar tags com dimensões: combine filtros de tags com as dimensões de métricas existentes

     ```
     SELECT AVG(Duration) FROM "AWS/Lambda" WHERE tag.Application = 'OrderService' AND FunctionName = 'process%'
     ```
**nota**  
Ao usar tags, os alarmes atenderão às métricas somente se as tags especificadas existirem nos recursos associados durante o período avaliado.

1. Quando você estiver contente com sua consulta escolha **Run** (Executar).

1. Selecione **Criar alarme**.

1. Em **Conditions (Condições)**, especifique o seguinte:

   1. Em **Whenever *metric* is (Sempre que a métrica for)**, especifique se a métrica deve ser maior que, menor que ou igual ao limite. Em **than... (que...)**, especifique o valor limite.

   1. Escolha **Additional configuration (Configuração adicional)**. Em **Datapoints to alarm (Pontos de dados para alarme)**, especifique quantos períodos de avaliação (pontos de dados) devem estar no estado `ALARM` para disparar o alarme. Se os dois valores forem correspondentes, você criará um alarme que passa para o estado `ALARM` se esses períodos consecutivos estiverem violando.

      Para criar um alarme M de N, especifique um número menor para o primeiro valor que especificar para o segundo valor. Para obter mais informações, consulte [Avaliação de alarme](alarm-evaluation.md).

   1. Para o **Missing data treatment (Tratamento de dados ausentes)**, escolha como deseja que o alarme se comporte quando alguns pontos de dados estiverem ausentes. Para obter mais informações, consulte [Configurar como os alarmes do CloudWatch tratam dados ausentes](alarms-and-missing-data.md).

1. Escolha **Próximo**.

1. Em **Notification (Notificação)**, selecione um tópico do SNS para notificar quando o alarme estiver no estado `ALARM`, `OK` ou `INSUFFICIENT_DATA`.

   Para que o alarme envie várias notificações para o mesmo estado de alarme ou para diferentes estados de alarme, escolha **Add notification (Adicionar notificação)**.

   Para que o alarme não envie notificações, escolha **Remove (Remover)**.

1. Para que o alarme execute ações do Auto Scaling, do EC2 ou do Systems Manager, escolha o botão apropriado, o estado do alarme e a ação a ser executada. Os alarmes só poderão executar ações do Systems Manager ao entrarem no estado ALARM. Para obter mais informações sobre ações do Systems Manager, consulte [Configurar o CloudWatch para criar OpsItems a partir de alarmes](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-create-OpsItems-from-CloudWatch-Alarms.html) e [Criação de incidentes](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html).
**nota**  
Para criar um alarme que executa uma ação do SSM Incident Manager, é necessário ter determinadas permissões. Para obter mais informações, consulte [Exemplos de políticas baseadas em identidade para o AWS Systems Manager Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/security_iam_id-based-policy-examples.html).

1. Quando terminar, escolha **Next** (Próximo).

1. Digite um nome e uma descrição para o alarme. O nome deve conter somente caracteres ASCII. 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 **Create alarm (Criar alarme)**.

**Para criar um alarme em uma consulta ao Metrics Insights usando a AWS CLI**

Use o comando `put-metric-alarm` e especifique uma consulta ao Metrics Insights no parâmetro `metrics`. Por exemplo, o comando a seguir define um alarme que entra no estado ALARM (ALARME) se alguma das instâncias ultrapassar 50% de utilização da CPU.

```
aws cloudwatch put-metric-alarm —alarm-name Prod-App-CPU-Alarm —evaluation-periods 1 —comparison-operator GreaterThanThreshold —metrics '[{"Id":"m1","Expression":"SELECT MAX(CPUUtilization) FROM \"AWS/EC2\" WHERE tag.Environment = '\''Prod'\'' AND tag.Application = '\''OrderService'\''", "Period":60}]' —threshold 80
```