Configurar regras de alerta gerenciadas da fonte de dados

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 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

Crie regras de alerta para uma instância externa do Grafana Mimir ou Loki que tenha a régua API ativada; elas são chamadas de regras de alerta gerenciadas pela fonte de dados.

nota

As regras de alerta para uma instância externa do Grafana Mimir ou Loki podem ser editadas ou excluídas por usuários com funções de editor ou administrador.

Se você excluir um recurso de alerta criado na interface do usuário, não poderá mais recuperá-lo. Para fazer um backup de sua configuração e poder restaurar recursos de alerta excluídos, crie seus recursos de alerta usando o Terraform ou o Alerting. API

Pré-requisitos

• Verifique se você tem permissão de gravação na fonte de dados Prometheus ou Loki. Caso contrário, você não poderá criar ou atualizar as regras de alerta gerenciado do Grafana Mimir.

• Para fontes de dados Grafana Mimir e Loki, habilite o Ruler API 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 de regras.

  • Grafana Mimir - use o prefixo. /prometheus A fonte de dados do Prometheus é compatível com o Grafana Mimir e o Prometheus, e o Grafana espera que tanto o Query quanto o Ruler estejam sob o mesmo comando. API API URL Você não pode fornecer um documento separado URL para o Governante. API

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

Nos procedimentos a seguir, orientaremos você no processo de criação das regras de alerta gerenciadas da fonte de dados.

Para criar uma regra de alerta gerenciada pela fonte de dados, use o fluxo de criação de alertas no espaço de trabalho e siga estas etapas para ajudá-lo.

Para definir o nome da regra de alerta

1. Escolha Alertas -> Regras de alerta -> + Nova regra de alerta.

2. Insira um nome para identificar sua regra de alerta.

   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.

Defina uma consulta para obter os dados que você deseja medir e uma condição que precisa ser atendida antes que uma regra de alerta seja acionada.

Para definir a consulta e a condição

1. Todas as regras de alerta são gerenciadas pela Grafana por padrão. Para mudar para uma regra de alerta gerenciada por fonte de dados, escolha Alternar para regra de alerta gerenciada por fonte de dados.

2. Selecione uma fonte de dados na lista suspensa.

   Você também pode escolher Abrir seletor de fonte de dados avançado para ver mais opções, incluindo adicionar uma fonte de dados (somente administradores).

3. Insira uma consulta PromQL ou LogQL.

4. Escolha Visualizar alertas.

Use a avaliação da regra de alerta para determinar com que frequência uma regra de alerta deve ser avaliada e com que rapidez ela deve mudar seu estado.

Para definir o comportamento de avaliação de alertas

1. Selecione um namespace ou escolha + Novo namespace.

2. Selecione um grupo de avaliação ou escolha + Novo grupo de avaliação.

   Se você estiver criando um novo grupo de avaliação, especifique o intervalo para o grupo.

   Todas as regras do mesmo grupo são avaliadas sequencialmente no mesmo intervalo de tempo.

3. Insira um período pendente.

   O período pendente é o período em que uma regra de alerta pode violar a condição até ser acionada.

   Quando uma condição é atendida, o alerta entra no Pending estado. Se a condição permanecer ativa pelo período especificado, o alerta será transferido para o Firing estado, caso contrário, ele será revertido para o Normal estado.

Adicione rótulos às suas regras de alerta para definir qual política de notificação deve lidar com suas instâncias de alerta de disparo.

Todas as regras e instâncias de alerta, independentemente de seus rótulos, correspondem à política de notificação padrão. Se não houver políticas aninhadas ou nenhuma política aninhada corresponder aos rótulos na regra de alerta ou na instância de alerta, a política de notificação padrão será a política correspondente.

Configurar notificações do

• Adicione marcadores se quiser alterar a forma como suas notificações são roteadas.

  Adicione rótulos personalizados selecionando pares de valores-chave existentes no menu suspenso ou adicione novos rótulos inserindo a nova chave ou valor.

Adicione anotações para fornecer mais contexto sobre o alerta em suas notificações de alerta.

As anotações adicionam metadados para fornecer mais informações sobre o alerta em suas notificações de alerta. Por exemplo, adicione uma Summary anotação para informar qual valor causou o disparo do alerta ou em qual servidor ele aconteceu.

Para adicionar anotações

1. [Opcional] Adicione um resumo.

   Breve resumo do que aconteceu e por quê.

2. [Opcional] Adicione uma descrição.

   Descrição do que a regra de alerta faz.

3. [Opcional] Adicione um RunbookURL.

   Página da web onde você guarda seu caderno de notas para o alerta

4. [Opcional] Adicionar uma anotação personalizada

5. [Opcional] Adicione um link para painel e painel.

   Vincula alertas a painéis em um painel.

6. Selecione a apção Salvar regra.