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á.
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
Crie regras de alerta para uma instância externa do Grafana Mimir ou Loki que tenha a API Ruler habilitada. 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 perfis de editor ou administrador.
Caso exclua um recurso de alerta criado na interface de usuário, você não poderá mais recuperá-lo. Para fazer um backup de sua configuração e poder restaurar recursos de alerta excluídos, crie os recursos de alerta usando o Terraform ou a API de alertas.
Pré-requisitos
-
Verifique se você tem permissão de gravação na fonte de dados Prometheus ou Loki. Do contrário, você não poderá criar ou atualizar as regras de alertas gerenciados pelo Grafana Mimir.
-
Para as fontes de dados Grafana Mimir e Loki, habilite a API Ruler configurando seus respectivos serviços.
-
Loki: o tipo de armazenamento
localde 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 de regras. -
Grafana Mimir: use o prefixo
/prometheus. A fonte de dados Prometheus é compatível com o Grafana Mimir e o Prometheus, e o Grafana espera que a API Querye 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 específica 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.
Nos procedimentos a seguir, orientaremos você no processo de criação das regras de alerta gerenciadas pela 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 ajudar.
Para definir o nome da regra de alerta
-
Escolha Alertas -> Regras de alerta -> + Nova regra de alerta.
-
Insira um nome para identificar a regra do alerta.
Este nome é exibido na lista de regras de alerta. Também é o rótulo
alertnamede cada instância de alerta criada dessa regra.
Defina uma consulta para obter os dados que você deseja avaliar e uma condição que precisa ser atendida antes que uma regra de alerta seja disparada.
Para definir a consulta e a condição
-
Todas as regras de alerta são gerenciadas pelo Grafana por padrão. Para mudar para uma regra de alerta gerenciada pela fonte de dados, escolha Alternar para regra de alerta gerenciada pela fonte de dados.
-
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).
-
Insira uma consulta PromQL ou LogQL.
-
Escolha Pré-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
-
Selecione um namespace ou escolha + Novo namespace.
-
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.
-
Insira um período de pendência.
O período de pendência é o período em que uma regra de alerta pode violar a condição até ser disparada.
Quando 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, do contrário, retornará para o estadoNormal.
Adicione rótulos às regras de alerta para definir qual política de notificação deve lidar com as instâncias de alertas disparados.
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 rótulos se quiser alterar a forma como as notificações são roteadas.
Adicione rótulos personalizados selecionando pares de chave/valor 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 nas notificações de alerta.
As anotações adicionam metadados para fornecer mais informações sobre o alerta nas notificações de alerta. Por exemplo, adicione uma anotação de Summary para informar qual valor causou o disparo do alerta ou em qual servidor ele aconteceu.
Para adicionar anotações
-
[Opcional] Adicione um resumo.
Breve resumo do que aconteceu e o porquê.
-
(Opcional) Adicione uma descrição.
Descrição do que a regra de alerta faz.
-
[Opcional] Adicione um URL do runbook.
Página da Web em que você guarda o runbook para o alerta
-
[Opcional] Adicionar uma anotação personalizada
-
[Opcional] Adicione um link para o painel e o dashboard.
Vincula alertas a painéis em um dashboard.
-
Selecione a apção Salvar regra.
