# Criar um alarme do Cloudwatch com base em uma expressão matemática de métrica
<a name="Create-alarm-on-metric-math-expression"></a>

Os alarmes de métricas são projetados para avaliar séries temporais que você define de uma única métrica ou de uma expressão matemática de métrica, que combina ou transforma uma ou mais métricas em uma série temporal que fornece insights mais alinhados às suas necessidades exclusivas. Para criar um alarme com base em uma expressão matemática métrica, escolha uma ou mais métricas do CloudWatch a serem usadas na expressão. Depois, especifique a expressão, o limite e os períodos de avaliação.

Não é possível criar um alarme com base na expressão **SEARCH**. Somente alarmes baseados em consultas SQL do Metrics Insights podem operar em várias séries temporais.

**Para criar um alarme com base em uma expressão matemática de métrica**

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) e depois escolha **All alarms** (Todos os alarmes).

1. Selecione **Criar alarme**.

1. Escolha **Select Metric** (Selecionar métrica) e, em seguida, execute uma das seguintes ações:
   + Selecione um namespace na lista suspensa **Namespaces da AWS** ou **Namespaces personalizados**. Depois de selecionar um namespace, continue escolhendo opções até que uma lista de métricas apareça, na qual você deve marcar a caixa de seleção ao lado da métrica correta.
   + Use a caixa de pesquisa para encontrar uma métrica, uma dimensão ou um ID de recurso. Depois de inserir a métrica, a dimensão ou o ID do recurso, continue escolhendo opções até que uma lista de métricas apareça, na qual você deve marcar a caixa de seleção ao lado da métrica correta.

1. (Opcional) Se quiser adicionar outra métrica a uma expressão matemática de métrica, você poderá usar a caixa de pesquisa para encontrar uma métrica específica. Você pode adicionar até dez métricas a uma expressão matemática de métrica.

1. Selecione a guia **Graphed metrics** (Representar métricas em gráficos). Para cada uma das métricas que você adicionou anteriormente, execute as seguintes ações:

   1. Na coluna **Statistics** (Estatística), selecione o menu suspenso. No menu suspenso, escolha uma das estatísticas ou percentis predefinidos. Use a caixa de pesquisa no menu suspenso para especificar um percentil personalizado.

   1. Na coluna **Period** (Período), selecione o menu suspenso. No menu suspenso, escolha um dos períodos de avaliação predefinidos.

      Ao criar o alarme, você pode especificar se a legenda do eixo Y é exibida no lado esquerdo ou no lado direito do gráfico.
**nota**  
Quando o CloudWatch avalia alarmes, os períodos são agregados em pontos de dados únicos.

1. Escolha o menu suspenso **Add math** (Adicionar matemática) e, em seguida, selecione **Start with an empty expression** (Começar com uma expressão vazia) da lista de expressões matemáticas de métrica predefinidas.

   Depois de escolher **Start with an empty expression** (Começar com uma expressão vazia), uma caixa de expressão matemática aparecerá para que você possa aplicar ou editar expressões matemáticas.

1. Na caixa de expressão matemática, insira sua expressão matemática e, em seguida, escolha **Apply** (Aplicar).

   Depois de escolher **Apply** (Aplicar), uma coluna de **ID** aparece ao lado da coluna **Label** (Rotular).

   Para usar uma métrica ou o resultado de outra expressão matemática de métricas como parte da fórmula de sua expressão matemática atual, use o valor que é mostrado na coluna **ID**. Para alterar o valor de **ID**, selecione o ícone de caneta e papel ao lado do valor atual. O novo valor deve começar com uma letra minúscula e pode incluir números, letras e o símbolo de sublinhado. Alterar o valor do **ID** para um nome mais significativo também pode tornar o gráfico do alarme mais fácil de entender.

   Para obter informações sobre as funções disponíveis para matemática de métrica, consulte [Sintaxe de funções da matemática métricas](using-metric-math.md#metric-math-syntax).

1. (Opcional) Adicione mais expressões matemáticas usando as métricas e os resultados de outras expressões matemáticas nas fórmulas das novas expressões matemáticas.

1. Quando você tiver a expressão a ser usada no alarme, desmarque as caixas de seleção à esquerda de todas as outras expressões e métricas na página. Somente a caixa de seleção ao lado da expressão a ser usada no alarme deve estar marcada. A expressão escolhida para o alarme deve produzir uma única série temporal e só mostrar uma linha no gráfico. Depois, escolha **Select metric (Selecionar métrica)**.

   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 expressão matemática que você selecionou.

1. Em **Whenever *expression* is (Sempre que a expressão for)**, especifique se a expressão deverá 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, Amazon EC2, Lambda ou Systems Manager, escolha o botão apropriado e depois o estado do alarme e a ação a ser executada. Se você escolher uma função do Lambda como uma ação de alarme, especifique o nome da função ou o ARN e, opcionalmente, você poderá escolher uma versão específica da função.

   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. Escolha **Próximo**.

   O nome deve conter somente caracteres UTF-8, e não poderá conter caracteres de controle ASCII. A descrição pode incluir a formatação de markdown, que é exibida somente na guia **Detalhes** do alarme no console do CloudWatch. O markdown pode ser útil para adicionar links para runbooks ou outros recursos internos.

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)**.

Também é possível adicionar alarmes a um painel. Para obter mais informações, consulte [Adição de um alarme a um painel do CloudWatch](add_alarm_dashboard.md).