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 regras de alerta gerenciadas do Grafana Mimir ou Loki
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
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 Prometheus.
Pré-requisitos
-
Verifique se você tem permissões de escrita na fonte de dados Prometheus. Do contrário, você não poderá criar ou atualizar as regras de alerta gerenciadas do Cortex.
-
Para as fontes de dados Grafana Mimir e Loki, habilite a API Ruler configurando seus respectivos serviços.
-
Loki: o tipo de armazenamento
local
de regras, padrão para a fonte de dados Loki, é compatível apenas com a visualização de regras. Para editar regras, configure um dos outros tipos de armazenamento. -
Grafana Mimir: use o prefixo
/api/prom
legado, não o/prometheus
. A fonte de dados Prometheus é compatível com o Grafana Mimir e o Prometheus, e o Grafana espera que a API Query e a API Ruler estejam no mesmo URL. Você não pode fornecer um URL separado para a API Ruler.
-
nota
Se você não quiser gerenciar as regras de alerta para uma fonte de dados Loki ou Prometheus específica, 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 do Grafana Mimir ou Loki
-
No console do Grafana, no menu Grafana, escolha o ícone de Alertas (sino) para abrir a página Alertas listando os existentes.
-
Escolha Criar regra de alerta.
-
Na Etapa 1, escolha o tipo de regra e os detalhes, da seguinte forma:
-
Escolha Alerta Mimir ou Loki.
-
Em Nome da regra, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o rótulo
alertname
de cada instância de alerta criada 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. Do 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 obter mais informações, consulte Namespaces e grupos de regras do Cortex ou Loki.
-
No menu suspenso Grupo, selecione um grupo existente no namespace selecionado. Do 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 em 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 Por da condição, especifique por quanto tempo a condição deve ser true antes que o alerta seja iniciado. Se você especificar
5m
, as condições deverão ser true por cinco minutos antes que o alerta seja iniciado.nota
Depois que uma condição é atendida, o alerta entra no estado
Pending
. Se a condição permanecer ativa pelo período especificado, o alerta mudará para o estadoFiring
. Se não for mais satisfeito, ele reverterá para o estadoNormal
. -
Na Etapa 4, adicione outros metadados associados à regra.
-
Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes em Rótulos e anotações.
-
Adicione URL, painel, painel e alerta IDs do Runbook.
-
Adicione rótulos personalizados.
-
-
Escolha Pré-visualizar alertas para avaliar a regra e ver quais alertas ela vai produzir. Essa opção vai exibir 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 Alertas.
Depois de criar sua regra, você pode criar uma notificação para a regra. Para obter mais informações sobre notificações, consulte Gerenciar as notificações de alerta.