Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Configurando PrometheusRules

Um PrometheusRule define um grupo de regras de alerta e/ou gravação do Prometheus.

Esta seção assume familiaridade com o funcionamento conjunto dos componentes de monitoramento. Para mais informações, consulte esta seção.

Criando PrometheusRules na interface do Rancher

Pré-requisitos:

O aplicativo de monitoramento precisa ser instalado.

Para criar grupos de regras na interface do Rancher,

  1. Vá para o cluster onde você deseja criar grupos de regras. Clique em Monitoramento  Avançado e clique em Regras do Prometheus.

  2. Clique em Criar.

  3. Insira um Nome do Grupo.

  4. Configure as regras. Na interface do Rancher, esperamos que um grupo de regras contenha apenas regras de alerta ou regras de gravação, mas não ambas. Para ajuda ao preencher os formulários, consulte as opções de configuração abaixo.

  5. Clique em Criar.

Resultado: Os alertas podem ser configurados para enviar notificações para o(s) receptor(es).

Sobre o Recurso Personalizado PrometheusRule

Quando você define uma Rule (que é declarada dentro de um RuleGroup em um recurso PrometheusRule), o spec da própria Rule contém rótulos que são usados pelo Alertmanager para determinar qual Route deve receber este Alert. Por exemplo, um Alert com o rótulo team: front-end será enviado para todas as Routes que correspondem a esse rótulo.

Os arquivos de regra do Prometheus são mantidos em recursos personalizados PrometheusRule. Um PrometheusRule permite que você defina um ou mais RuleGroups. Cada RuleGroup consiste em um conjunto de objetos Rule que podem representar uma regra de alerta ou uma regra de gravação com os seguintes campos:

  • O nome do novo alerta ou registro

  • Uma expressão PromQL para o novo alerta ou registro

  • Rótulos que devem ser anexados ao alerta ou registro que o identificam (por exemplo, nome do cluster ou severidade)

  • Anotações que codificam quaisquer informações adicionais importantes que precisam ser exibidas na notificação de um alerta (por exemplo, resumo, descrição, mensagem, URL do runbook, etc.). Este campo não é obrigatório para regras de gravação.

Para mais informações sobre quais campos podem ser especificados, consulte o spec do Operador Prometheus.

Use o campo de seletor de rótulos ruleSelector no objeto Prometheus para definir os arquivos de regra que você deseja que sejam montados no Prometheus.

Para exemplos, consulte a documentação do Prometheus sobre regras de gravação e regras de alerta.

Configuração

Grupo de Regras

Campo Descrição

Nome do Grupo

O nome do grupo. Deve ser único dentro de um Arquivo de regras.

Sobrescrever Intervalo do Grupo

Duração em segundos para a frequência com que as regras no grupo são avaliadas.

Regras de Alerta

As regras de alerta permitem que você defina condições de alerta com base em expressões do PromQL (Linguagem de Consulta do Prometheus) e envie notificações sobre alertas disparados para um serviço externo.

Campo Descrição

Nome do Alerta

O nome do alerta. Deve ser um valor de rótulo válido.

Tempo de espera para disparo

Duração em segundos. Os alertas são considerados disparados uma vez que tenham sido retornados por esse tempo. Alertas que ainda não dispararam por tempo suficiente são considerados pendentes.

Expressão PromQL

A expressão PromQL a ser avaliada. O Prometheus avaliará o valor atual desta expressão PromQL em cada ciclo de avaliação e todas as séries temporais resultantes se tornarão alertas pendentes/disparados. Para mais informações, consulte a documentação do Prometheus ou nossos exemplos de expressões PromQL.

Rótulos

Rótulos a adicionar ou sobrescrever para cada alerta.

Gravidade

Quando habilitados, rótulos são anexados ao alerta ou registro que o identificam pelo nível de severidade.

Valor do Rótulo de Severidade

Crítico, aviso ou nenhum

Anotações

Anotações são um conjunto de rótulos informativos que podem ser usados para armazenar informações adicionais mais longas, como descrições de alertas ou links de runbook. Um runbook é um conjunto de documentação sobre como lidar com alertas. Os valores de anotação podem ser templateados.

Regras de Gravação

As regras de gravação permitem que você pré-calcule expressões PromQL (Linguagem de Consulta Prometheus) frequentemente necessárias ou computacionalmente caras e salve seu resultado como um novo conjunto de séries temporais.

Campo Descrição

Nome da Série Temporal

O nome da série temporal para a qual será direcionada. Deve ser um nome de métrica válido.

Expressão PromQL

A expressão PromQL a ser avaliada. O Prometheus avaliará o valor atual desta expressão PromQL em cada ciclo de avaliação e o resultado será gravado como um novo conjunto de séries temporais com o nome da métrica conforme dado por 'record'. Para mais informações sobre expressões, consulte a documentação do Prometheus ou nossos exemplos de expressões PromQL.

Rótulos

Rótulos a serem adicionados ou sobrescritos antes de armazenar o resultado.