Managed Service for Prometheus:Criar um modelo de regra de alerta do Prometheus

Informações básicas

Se você possui várias instâncias do Prometheus em múltiplas regiões, criar regras de alerta individualmente para cada instância exige muito trabalho e dificulta o gerenciamento sincronizado. Para resolver esse problema, o Managed Service for Prometheus oferece o recurso de modelo de regra de alerta. Esse recurso permite criar rapidamente regras de alerta para diversas instâncias do Prometheus e gerenciá-las de forma unificada, reduzindo o custo operacional de manutenção das regras em várias instâncias.

Criar modelo de regra de alerta do Prometheus

1. Faça login no console do ARMS.

2. No painel de navegação à esquerda, escolha Managed Service for Prometheus > Prometheus Alert Rule Template.

3. Faça login no console do Managed Service for Prometheus.

4. No painel de navegação à esquerda, clique em Alert Rule Template.

5. No canto superior direito da página, clique em Create Prometheus Alert Rule Template.

6. Na página Create Prometheus Alert Rule, configure os seguintes parâmetros.

   Crie um modelo de regra de alerta do Prometheus usando um limiar estático ou um PromQL personalizado.

   • O tipo de verificação por limiar estático oferece métricas de alerta predefinidas. Selecione uma métrica predefinida para criar uma regra de alerta rapidamente.

   • Para monitorar métricas não predefinidas, utilize o tipo de verificação por PromQL personalizado na criação da regra de alerta.

   Tabela 1. Tipos de verificação por limiar estático

   Parâmetro	Descrição	Exemplo
   Alert rule template name	Nome do modelo de regra de alerta.	Cluster de produção - Alerta de utilização de cpu do contêiner
   Alert rule template description	Opcional. Descreva o modelo, incluindo sua finalidade, cenários aplicáveis ou outras observações.	Nenhum
   Check type	Selecione Static Threshold.	Static Threshold
   Alert group	Selecione um grupo de alertas.	Kubernetes Workloads
   Alert metric	Escolha a métrica para configurar o alerta. Cada grupo de alertas possui métricas diferentes.	Utilização de cpu do contêiner
   Alert condition	Defina as condições para acionar um evento de alerta com base no conteúdo predefinido da métrica de alerta.	A condição de alerta é atendida quando a utilização de cpu do contêiner é greater than 80%.
   Filter condition	Defina o escopo da regra de alerta com base na métrica. O sistema aciona um evento de alerta para qualquer recurso que atenda tanto às condições de filtro quanto à condição de alerta. As condições de filtro disponíveis são: Traverse: A regra de alerta aplica-se a todos os recursos na instância atual do Prometheus. Por padrão, a condição de filtro é definida como Traverse. Equal To: Após selecionar esta condição, insira um nome de recurso específico. A regra de alerta se aplicará apenas a esse recurso. Não é possível inserir vários recursos. Is not equal: Ao escolher esta condição, insira um nome de recurso específico. A regra de alerta se aplicará a todos os recursos, exceto ao especificado. Não é possível inserir vários recursos. Match Regular Expression: Selecione esta condição e insira uma expressão regular para corresponder aos nomes dos recursos. A regra de alerta se aplicará a todos os recursos correspondentes à expressão. Do Not Match Regular Expression: Escolha esta condição e insira uma expressão regular para corresponder aos nomes dos recursos. A regra de alerta filtrará todos os recursos correspondentes à expressão.	IP da instância: Traverse
   Duration	Acionar um evento de alerta assim que a condição for atendida: o sistema aciona o alerta se qualquer ponto de dados atingir o limiar. Acionar um evento de alerta somente quando a condição persistir por N minutos: o sistema aciona o alerta apenas se o limiar for atingido por N minutos ou mais.	1
   Alert severity	Gravidade do alerta. A gravidade padrão é Default. Os níveis de gravidade, do menor para o maior, são Default, P4, P3, P2 e P1.	Default
   Alert content	Informações de alerta recebidas pelos usuários. Use a sintaxe de modelo do Go para personalizar variáveis de parâmetros de alerta no conteúdo.	Namespace: {{$labels.namespace}} / Pod: {{$labels.pod_name}} / Container: {{$labels.container}} CPU utilization {{$labels.metrics_params_opt_label_value}} {{$labels.metrics_params_value}}%, current value {{ printf "%.2f" $value }}%
   Advanced Settings
   Labels	Defina rótulos de alerta. Os rótulos podem servir como opções para correspondência de regras nas políticas de notificação.	Nenhum
   Annotations	Configure anotações para o alerta.	Nenhum

   Tabela 2. Tipos de verificação por PromQL personalizado

   Parâmetro	Descrição	Exemplo
   Alert rule template name	Nome do modelo de regra de alerta.	Utilização de cpu do Pod superior a 80%
   Alert rule template description	Opcional. Descreva o modelo, incluindo sua finalidade, cenários aplicáveis ou outras observações.	Nenhum
   Check type	Defina como Custom PromQL.	Custom PromQL
   Custom PromQL statement	Use uma instrução PromQL para definir a expressão da regra de alerta.	max(container_fs_usage_bytes{pod!="", namespace!="arms-prom",namespace!="monitoring"}) by (pod_name, namespace, device)/max(container_fs_limit_bytes{pod!=""}) by (pod_name,namespace, device) * 100 > 90
   Duration	Acionar um evento de alerta assim que a condição for atendida: o sistema aciona o alerta se qualquer ponto de dados atingir o limiar. Acionar um evento de alerta somente quando a condição persistir por N minutos: o sistema aciona o alerta apenas se o limiar for atingido por N minutos ou mais.	1
   Alert severity	Gravidade do alerta. A gravidade padrão é Default. Os níveis de gravidade, do menor para o maior, são Default, P4, P3, P2 e P1.	Default
   Alert content	Informações de alerta recebidas pelos usuários. Use a sintaxe de modelo do Go para personalizar variáveis de parâmetros de alerta no conteúdo.	Namespace: {{$labels.namespace}}/Pod: {{$labels.pod_name}}/Disk device: {{$labels.device}} utilization exceeds 90%, current value {{ printf "%.2f" $value }}%
   Advanced Settings
   Labels	Defina rótulos de alerta. Os rótulos podem servir como opções para correspondência de regras nas políticas de notificação.	Nenhum
   Annotations	Configure anotações para o alerta.	Nenhum

Aplicar modelo

Após criar um modelo de alerta do Prometheus, aplique-o para criar regras de alerta em uma instância do Prometheus. Também é possível usar o modelo para atualizar regras de alerta existentes nessa instância.

1. Na página Prometheus Alert Rule Template, clique em Apply Template referente ao modelo desejado.

2. Na página Apply Template, na aba Prometheus Instance Selection Mode, selecione uma instância do Prometheus e clique em OK.

   Nota

   Filtre as instâncias do Prometheus associadas a este modelo de alerta pelo nome da instância, região e tipo da instância do Prometheus.

3. Na caixa de diálogo exibida, escolha se deseja atualizar as regras de alerta existentes e clique em OK.

   O ARMS utiliza o modelo de regra de alerta atual para criar regras nas instâncias do Prometheus selecionadas.

   • Caso não selecione Update Existing Alert Rules: Se a instância do Prometheus selecionada já possuir regras de alerta criadas a partir do modelo atual, o sistema exibirá a mensagem Alert Rules Have Already Been Created By Using This Template And Will Not Be Updated. As regras de alerta existentes não serão atualizadas.

   • Update Existing Alert Rules: Se a instância do Prometheus selecionada já contiver regras de alerta criadas a partir do modelo atual, o sistema atualizará as regras de alerta do Prometheus para corresponder ao conteúdo mais recente do modelo.

     Importante

     Se uma regra de alerta foi modificada individualmente, mas seu mapeamento com o modelo foi mantido, as modificações individuais serão substituídas e perdidas.

Excluir o modelo

Quando um modelo de alerta do Prometheus não for mais necessário, exclua-o. Durante a exclusão, especifique se deseja manter as regras de alerta criadas a partir dele.

1. Na página Prometheus Alert Rule Template, clique em Delete à direita do modelo de regra de alerta desejado.

2. Na caixa de diálogo exibida, escolha se também deseja excluir as regras de alerta criadas a partir do modelo e clique em Confirm.

   • Ao selecionar Delete Alert Rules Created from Template: O sistema exclui as regras de alerta do Prometheus associadas ao modelo. Se uma regra de alerta do Prometheus criada a partir do modelo tiver sido editada manualmente e você tiver selecionado Do Not Retain The Mapping Between The Template And The Rule ao salvá-la, essa regra não será excluída.

   • Caso não selecione Delete Alert Rules Created from Template, o sistema mantém as regras de alerta do Prometheus criadas a partir do modelo.

Visualizar regras de alerta criadas a partir de um modelo

Visualize e gerencie em lote as regras de alerta criadas a partir de um modelo.

1. Na página Prometheus Alert Rule Template, clique em View Rules Created From Template à direita do modelo de regra de alerta desejado.

2. Gerencie as regras de alerta em lote na página Alert Rules Created from Template.

   • Para ativar alertas em lote: Selecione as regras de alerta desejadas e clique em Enable Alert Rules.

   • Para desativar alertas em lote: Selecione as regras de alerta desejadas e clique em Disable Alert Rules.

   • Para excluir alertas em lote: Selecione as regras de alerta desejadas e clique em Delete Alert Rules.

Observações

Ao editar e salvar uma regra de alerta do Prometheus criada a partir de um modelo de regra de alerta do Prometheus, escolha se deseja manter o mapeamento entre o modelo e a regra.

• Retain the mapping between this alert rule and the alert rule template: Se mantiver esse mapeamento, suas edições atuais poderão ser substituídas caso aplique o modelo de regra de alerta correspondente à instância do Prometheus desta regra e selecione a opção de atualização forçada.

• Remove the mapping between this alert rule and the alert rule template: Após desativar o mapeamento, esta regra de alerta será tratada como independente. Recomendamos alterar o nome da regra de alerta. Caso contrário, se aplicar novamente o modelo de regra de alerta correspondente à instância do Prometheus, a criação falhará devido à duplicidade no nome da regra de alerta.