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.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Alertas no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Grafana Alerting.
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
-
Navegue até o painel em que se adiciona ou edita uma regra de alerta, escolha o título e depois Editar.
-
Na guia Alerta, escolha Criar alerta. Se já existir um alerta para esse painel, você poderá editar os campos na guia Alerta.
-
Preencha os campos. Para ter mais informações, consulte Campos de regra de alerta.
-
Quando terminar de escrever a regra, escolha Salvar no canto superior direito para salvar a regra de alerta e o dashboard.
-
(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 usar10m, 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 escolherIS 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 | Descrição |
---|---|
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 | Descrição |
---|---|
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, consulteNotificação de alerta.
-
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.