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á.
# Criar alertas
****
Este tópico da documentação discute alertas legados no Grafana. Isso não será mais compatível em versões futuras do Amazon Managed Grafana. Você pode migrar para o Grafana Alerting para usar os recursos de alerta mais recentes. Para obter mais informações, consulte um dos tópicos a seguir.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Alertas no Grafana versão 10](v10-alerts.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Alertas no Grafana versão 9](v9-alerts.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Grafana Alerting](alerts-overview.md).
Ao usar os alertas do Amazon Managed Grafana, você pode anexar regras aos painéis do dashboard. Quando você salva o dashboard, o Amazon Managed Grafana extrai as regras de alerta em um armazenamento de regras de alerta separado e as programa para avaliação.
Na guia **Alerta** do painel de grafo, você pode configurar com que frequência a regra de alerta deve ser avaliada e as condições que devem ser atendidas para que o alerta mude de estado e inicie suas notificações.
Atualmente, somente o painel de grafo é compatível com regras de alerta.
## Adicionar ou editar uma regra de alerta
1. Navegue até o painel em que se adiciona ou edita uma regra de alerta, escolha o título e depois **Editar**.
1. Na guia **Alerta**, escolha **Criar alerta**. Se já existir um alerta para esse painel, você poderá editar os campos na guia **Alerta**.
1. Preencha os campos. Para obter mais informações, consulte [Campos de regra de alerta](#old-alert-rule-fields).
1. Quando terminar de escrever a regra, escolha **Salvar** no canto superior direito para salvar a regra de alerta e o dashboard.
1. (Opcional, mas recomendado) Para garantir que a regra retorne os resultados esperados, escolha **Testar regra**.
## Excluir uma regra de alerta
Para excluir um alerta, role até o final do alerta e escolha **Excluir**.
## Campos de regra de alerta
Esta seção descreve os campos que você preenche para criar um alerta.
### Regra
+ **Nome**: insira um nome descritivo. O nome será exibido na lista **Regras de alerta**.
+ **Avaliar a cada**: especifique com que frequência o programador deve avaliar a regra de alerta. Isso é denominado *intervalo de avaliação*.
+ **Por**: especifique por quanto tempo a consulta deve violar os limites configurados antes que a notificação de alerta seja acionada.
**Atenção**
Não use `For` com a configuração `If no data or all values are null` definida como `No Data`. O desencadeador de `No Data` será acionado instantaneamente e `For` não será levado em consideração. Isso também pode fazer com que uma notificação de OK não seja enviada se o alerta sair de `No Data -> Pending -> OK`.
Se uma regra de alerta tiver `For` configurado e a consulta violar o limite configurado, ela passará primeiro de `OK` para `Pending`. Ao mudar de `OK` para `Pending`, o Amazon Managed Grafana não envia nenhuma notificação. Quando a regra de alerta estiver sendo disparada por mais tempo que a duração de `For`, ela mudará para `Alerting` e enviará notificações de alerta.
Normalmente, recomendamos usar essa configuração porque geralmente é pior receber um falso positivo do que esperar alguns minutos antes do início da notificação de alerta. Ao olhar para a `Alert list` ou os `Alert list panels`, você poderá ver os alertas que estão no estado pendente.
### Condições
Atualmente, o único tipo de condição existente é uma condição de `Query` que permite especificar uma notificação de consulta, um intervalo de tempo e uma função de agregação.
#### Exemplo de condição de consulta
```
avg() OF query(A, 15m, now) IS BELOW 14
```
+ `avg()` controla como os valores de **cada** série devem ser reduzidos a um valor que possa ser comparado com o limite. Escolha a função para alterá-la para outra função de agregação.
+ `query(A, 15m, now)` A notificação define qual consulta deve ser executada na guia **Métricas**. Os próximos dois parâmetros definem o intervalo de tempo: `15m, now` significa 15 minutos atrás até agora. Você também pode usar `10m, now-2m` para definir um intervalo de tempo que será de dez minutos atrás a dois minutos atrás. Isso será útil se você quiser ignorar os últimos dois minutos de dados.
+ `IS BELOW 14` Define o tipo de limite e o valor do limite. Você pode escolher `IS BELOW` para alterar o tipo de limite.
A consulta usada em uma regra de alerta não pode conter nenhuma variável de modelo. Atualmente, oferecemos suporte somente aos operadores `AND` e `OR` entre condições, e elas são executadas em série. Por exemplo, temos três condições na seguinte ordem: *condition:A(evaluates to: TRUE) OR condition:B(evaluates to: FALSE) AND condition:C(evaluates to: TRUE)*, então o resultado será calculado como ([VERDADEIRO OU FALSO] E VERDADEIRO) = VERDADEIRO.
#### Várias séries
Se uma consulta retornar várias séries, a função de agregação e a verificação de limite serão avaliadas para cada série. Atualmente, o Amazon Managed Grafana não rastreia o estado da regra de alerta **por série**. As implicações disso são detalhadas no cenário a seguir.
+ Uma condição de alerta com consulta que retorna duas séries: **servidor1** e **servidor2**.
+ A série **servidor1** faz com que a regra de alerta seja disparada e mude para o estado `Alerting`.
+ As notificações são enviadas com a mensagem: *pico de carga (servidor1)*
+ Em uma avaliação subsequente da mesma regra de alerta, a série **servidor2** também faz com que a regra de alerta seja disparada.
+ Nenhuma nova notificação é enviada porque a regra de alerta já está no estado `Alerting`.
Como você pode ver no cenário anterior, se a regra já estiver no estado `Alerting`, o Grafana não enviará notificações quando outras séries fizerem com que o alerta seja disparado.
**nota**
Você pode configurar lembretes a serem enviados para alertas acionados. Isso enviará notificações adicionais quando um alerta continuar sendo disparado. Se outras séries (como servidor2 no exemplo anterior) também fizerem com que a regra de alerta seja disparada, elas serão incluídas na notificação de lembrete. Dependendo do canal de notificação que você esteja usando, talvez você possa aproveitar esse recurso para identificar séries novas ou existentes que estão causando o disparo de alertas.
### Tratamento de erros e ausência de dados
A tabela a seguir contém condições para controlar como o mecanismo de avaliação de regras lida com consultas que não retornam dados ou apenas valores nulos.
| Opção de ausência de dados | Description |
| --- | --- |
| Nenhum dado | Defina o estado da regra do alerta como NoData. |
| Geração de alertas | Defina o estado da regra do alerta como Alerting. |
| Manter o último estado | Mantenha o estado atual da regra de alerta, independentemente de qual seja. |
| Ok | Compatível, mas geralmente não é útil. |
### Erros de execução ou tempos limite
As opções a seguir indicam ao Amazon Managed Grafana como lidar com erros de execução ou de tempo limite.
| Opção de erro ou tempo limite | Description |
| --- | --- |
| Geração de alertas | Defina o estado da regra do alerta como Alerting. |
| Manter o último estado | Mantenha o estado atual da regra de alerta, independentemente de qual seja. |
Se você tiver um armazenamento de séries temporais não confiável, no qual as consultas às vezes expiram ou falham aleatoriamente, você pode definir essa opção como `Keep Last State` para basicamente ignorá-las.
## Notificações
Na guia **Alerta**, você também pode especificar notificações da regra de alerta e uma mensagem detalhada sobre a regra de alerta. A mensagem pode conter qualquer coisa: informações sobre como você pode resolver o problema, link para o runbook etc.
As notificações reais são configuradas e compartilhadas entre vários alertas. Para obter informações sobre como configurar e definir notificações, consulte[Notificação de alerta](old-alert-notifications.md).
+ **Enviar para**: selecione um canal de notificação de alerta caso tenha um configurado.
+ **Mensagem**: insira uma mensagem de texto a ser enviada no canal de notificação. Alguns notificadores de alerta são compatíveis com a transformação do texto em HTML ou em outros formatos avançados.
+ **Tags**: especifique uma lista de tags (chave/valor) a serem incluídas na notificação. Compatível apenas com alguns notificadores.
## Histórico e anotações do estado do alerta
As alterações do estado do alerta são registradas na tabela interna de anotações no banco de dados do Amazon Managed Grafana. As mudanças de estado são visualizadas como anotações no painel de grafo da regra de alerta. Você também pode acessar o submenu `State history` na guia **Alerta** para visualizar e limpar o histórico do estado.