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á.

# Tutorial: Use uma função matemática métrica para suprimir um alarme
<a name="suppress-alarms-tutorial-suppress"></a>

O tutorial a seguir explica como suprimir um CloudWatch alarme usando matemática métrica.

**Exemplo de cenário**

Há uma atividade planejada que acontece entre 1h e 3h UTC na próxima terça-feira. Você deseja criar uma função matemática CloudWatch métrica que substitua os pontos de dados reais durante esse período por 0 (um ponto de dados que fica abaixo do limite definido). 

1. Avalie os critérios que fazem com que o alarme seja acionado. A captura de tela a seguir fornece um exemplo de critérios de alarme:  
![CloudWatch tela mostrando detalhes do alarme.](http://docs.aws.amazon.com/pt_br/IDR/latest/userguide/images/metric-math-assess-alarm-criteria.png)

   O alarme mostrado na captura de tela anterior monitora a `UnHealthyHostCount` métrica de um grupo-alvo do Application Load Balancer. Esse alarme entra no `ALARM` estado em que a `UnHealthyHostCount` métrica é maior ou igual a 3 para 5 dos 5 pontos de dados. O alarme trata os dados perdidos como ruins (violando o limite configurado).

1. Crie a função matemática métrica.

   Neste exemplo, a atividade planejada ocorre entre 1h e 3h UTC na próxima terça-feira. Portanto, crie uma função matemática CloudWatch métrica que substitua os pontos de dados reais durante esse tempo por 0 (um ponto de dados que fica abaixo do limite definido). 

   Observe que o ponto de dados de substituição que você deve configurar difere dependendo da configuração do alarme. Por exemplo, se você tiver um alarme que monitora a taxa de sucesso de HTTP, com um limite menor que 98, substitua seus pontos de dados reais durante a atividade planejada por um valor acima do limite configurado, 100. Veja a seguir um exemplo de função matemática métrica para esse cenário.

   ```
   IF((DAY(m1) == 2 && HOUR(m1) >= 1 && HOUR(m1) < 3), 0, m1)
   ```

   A função matemática métrica anterior contém os seguintes elementos:
   + **DIA (m1) == 2**: Garante que seja terça-feira (segunda-feira = 1, domingo = 7).
   + **HORA (m1) >= 1 && HORA (m1) < 3**: especifica o intervalo de tempo de 1h às 3h UTC.
   + **IF (condition, value\_if\_true, value\_if\_false)**: Se as condições forem verdadeiras, a função substituirá o valor da métrica por 0. Caso contrário, o valor original (m1) será retornado.

   Para obter informações adicionais sobre sintaxe e funções disponíveis, consulte Funções e [sintaxe matemática métricas no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax) do usuário da *Amazon CloudWatch *

1. Faça login no Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Escolha **Alarmes** e, em seguida, localize o alarme ao qual você deseja adicionar a função matemática métrica.

1. Na seção matemática métrica, escolha **Editar**.

1. Escolha **Adicionar matemática**, **Comece com uma expressão vazia**.

1. Insira sua expressão matemática e, em seguida, escolha **Aplicar**.

   A métrica existente que o alarme monitora automaticamente se torna **m1** e sua expressão matemática é **e1**, conforme mostrado no exemplo a seguir:  
![CloudWatch tela mostrando expressões matemáticas métricas.](http://docs.aws.amazon.com/pt_br/IDR/latest/userguide/images/metric-math-expression.png)

1. (Opcional) Edite o rótulo da expressão matemática métrica para ajudar outras pessoas a entender sua função e por que ela foi criada, conforme mostrado no exemplo a seguir:  
![CloudWatch tela mostrando a edição de um rótulo de expressão de correspondência métrica.](http://docs.aws.amazon.com/pt_br/IDR/latest/userguide/images/metric-math-edit-label.png)

1. **Desmarque **m1**, selecione **e1** e, em seguida, escolha Selecionar métrica.** Isso configura o alarme para monitorar diretamente a expressão matemática em vez da métrica subjacente.

1. Escolha **Ir para visualizar e criar**.

1. Confirme se o alarme está configurado conforme o esperado e escolha **Atualizar alarme para salvar a alteração**.

No exemplo anterior, sem a função matemática métrica aplicada, a `UnHealthyHostCount` métrica real teria sido relatada durante a atividade planejada. Isso teria resultado na entrada do CloudWatch alarme no `ALARM` estado e na ativação da Detecção e Resposta a Incidentes, conforme mostrado no exemplo a seguir:

![CloudWatch tela mostrando pontos de dados que levam a um estado de alarme.](http://docs.aws.amazon.com/pt_br/IDR/latest/userguide/images/metric-math-example-alarm-state.png)


Com a função matemática métrica instalada, os pontos de dados reais são substituídos por 0 durante a atividade e o alarme permanece no `OK` estado, suprimindo o engajamento de detecção e resposta a incidentes. 

![CloudWatch tela mostrando pontos de dados sem estado de alarme.](http://docs.aws.amazon.com/pt_br/IDR/latest/userguide/images/metric-math-datapoints-no-alarm.png)