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á.
Criação de regras de alerta gerenciadas por Grafana, Mimir ou Loki
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.
Para espaços de trabalho do Grafana que suportam a versão 10.x do Grafana, consulte. Trabalhando na versão 10 do Grafana
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana
Usando o Grafana, você pode criar regras de alerta para uma instância externa do Grafana Mimir ou Loki.
nota
O Grafana Mimir pode se conectar ao Amazon Managed Service for Prometheus e às fontes de dados do Prometheus.
Pré-requisitos
-
Verifique se você tem permissões de gravação na fonte de dados do Prometheus. Caso contrário, você não poderá criar ou atualizar as regras de alerta gerenciadas do Cortex.
-
Para fontes de dados Grafana Mimir e Loki, ative a API da régua configurando seus respectivos serviços.
-
Loki — O tipo de armazenamento de
local
regras, padrão para a fonte de dados Loki, suporta somente a visualização de regras. Para editar regras, configure um dos outros tipos de armazenamento. -
Grafana Mimir — Use o
/api/prom
prefixo legado, não./prometheus
A fonte de dados do Prometheus é compatível com o Grafana Mimir e o Prometheus, e o Grafana espera que a API Query e a API Ruler estejam na mesma URL. Você não pode fornecer uma URL separada para a API Ruler.
-
nota
Se você não quiser gerenciar as regras de alerta para uma fonte de dados específica do Loki ou do Prometheus, acesse as configurações e desmarque a caixa de seleção Gerenciar alertas por meio da interface de usuário de alertas.
Para adicionar uma regra de alerta gerenciada por Grafana, Mimir ou Loki
-
No console do Grafana, no menu Grafana, escolha o ícone de Alerta (sino) para abrir a página de Alerta listando os alertas existentes.
-
Escolha Criar regra de alerta.
-
Na Etapa 1, escolha o tipo de regra e os detalhes, da seguinte forma:
-
Escolha o alerta Mimir ou Loki.
-
Em Nome da regra, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o
alertname
rótulo de cada instância de alerta criada a partir dessa regra. -
No menu suspenso Selecionar fonte de dados, selecione uma fonte de dados Prometheus ou Loki.
-
No menu suspenso Namespace, selecione um namespace de regra existente. Caso contrário, escolha Adicionar novo e insira um nome para criar um. Os namespaces podem conter um ou mais grupos de regras e ter apenas uma finalidade organizacional. Para ter mais informações, consulte Grupos de regras e namespaces do Cortex ou Loki.
-
No menu suspenso Grupo, selecione um grupo existente dentro do namespace selecionado. Caso contrário, escolha Adicionar novo e insira um nome para criar um. As regras recém-criadas são anexadas ao final do grupo. As regras dentro de um grupo são executadas sequencialmente em intervalos regulares, com o mesmo tempo de avaliação.
-
-
Na Etapa 2, adicione a consulta a ser avaliada.
O valor pode ser uma expressão PromQL ou LogQL. A regra iniciará um alerta se o resultado da avaliação tiver pelo menos uma série com um valor maior que 0. Um alerta é criado para cada série.
-
Na Etapa 3, especifique o intervalo de avaliação do alerta.
Na caixa de texto Para da condição, especifique por quanto tempo a condição deve ser verdadeira antes que o alerta seja iniciado. Se você especificar
5m
, as condições devem ser verdadeiras por cinco minutos antes do alerta ser iniciado.nota
Depois que uma condição é atendida, o alerta entra em
Pending
estado. Se a condição permanecer ativa pelo período especificado, o alerta será transferido para oFiring
estado. Se não for mais cumprido, ele reverte para oNormal
estado. -
Na Etapa 4, adicione outros metadados associados à regra.
-
Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes emRótulos e anotações.
-
Adicione o URL, o painel, o painel e os IDs de alerta do Runbook.
-
Adicione etiquetas personalizadas.
-
-
Escolha Visualizar alertas para avaliar a regra e ver quais alertas ela produziria. Ele exibe uma lista de alertas com o estado e o valor de cada um.
-
Escolha Salvar para salvar a regra ou Salvar e sair para salvar a regra e voltar para a página de alertas.
Depois de criar sua regra, você pode criar uma notificação para sua regra. Para obter mais informações sobre notificações, consulte Gerencie suas notificações de alerta.