Políticas de alertas com o PromQL

Nesta página, explicamos diferentes métodos de criação de políticas de alertas com uma consulta PromQL na condição.

As políticas de alertas com uma condição baseada em PromQL oferecem uma alternativa de código aberto ao uso de consultas da linguagem de consulta do Monitoring (MQL, na sigla em inglês) para configurar as condições da política de alertas. É possível usar consultas do PromQL para criar condições complexas com recursos como proporções, limites dinâmicos e métricas combinadas.

Se você usar o Prometheus em ambientes fora do Google Cloud ou se usar alertas no Managed Service para Prometheus, será possível migrar suas regras de alertas do Prometheus para políticas de alertas com uma condição baseada em PromQL. Assim, é possível gerenciar todas as políticas de alertas no Cloud Monitoring.

Também é possível importar painéis do Grafana para o Cloud Monitoring.

Visão geral

É possível criar políticas de alertas com uma condição baseada em PromQL das seguintes maneiras:

  • Crie uma política de alertas no console do Google Cloud e defina uma consulta do PromQL no editor de código.

  • Crie uma política de alertas com uma condição baseada em PromQL usando a CLI gcloud ou a construção AlertPolicy na API Monitoring.

  • Migre suas regras de alerta e canais de notificação do Prometheus para o Cloud Monitoring usando a Google Cloud CLI.

Os incidentes criados por uma política de alertas com uma condição baseada em PromQL aparecem no console do Google Cloud com os outros incidentes. É possível interagir com esses incidentes no console do Google Cloud.

As condições da política de alertas do PromQL podem se referir a qualquer métrica no Cloud Monitoring, incluindo métricas do sistema do Google Cloud, personalizadas e com base em registros e métricas do Prometheus. Você precisa converter os nomes das métricas que não são do Prometheus na sintaxe de métricas do PromQL. Para mais informações, consulte Como mapear métricas de monitoramento para PromQL.

Restrições

Uma política de alertas com uma condição baseada em PromQL pode ter uma janela de novo teste de no máximo 24 horas e um período de alinhamento de no máximo 24 horas. A soma da janela de novo teste e do período de alinhamento precisa ser de no máximo 25 horas.

Se a regra de alerta do Prometheus referenciar uma métrica personalizada, primeiro você precisa ter um descritor de métrica personalizada equivalente no Cloud Monitoring.

Preços

Em geral, as métricas do sistema do Cloud Monitoring são gratuitas, assim como as métricas de sistemas, agentes ou aplicativos externos. As métricas faturáveis são cobradas pelo número de bytes ou de amostras ingeridas.

Para mais informações sobre os preços do Cloud Monitoring, consulte os documentos a seguir:

A seguir

Para informações sobre como usar o console do Google Cloud para criar políticas de alertas com uma consulta PromQL na condição, consulte Criar políticas de alerta com uma condição baseada em PromQL (Console).

Para informações sobre como criar políticas de alertas com o PromQL diretamente usando a API Cloud Monitoring, consulte Criar políticas de alertas com uma condição baseada em PromQL (API).

Para informações sobre como migrar regras de alertas do PromQL para políticas de alertas com uma consulta do PromQL, consulte Migrar regras e receptores de alertas do Prometheus.

Para informações sobre como importar painéis do Grafana, consulte Importar painéis do Grafana para o Cloud Monitoring.