Políticas de alertas com PromQL

Nesta página, explicamos os 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ê usa o Prometheus em ambientes fora do Google Cloud ou se usa alertas no Managed Service para Prometheus, é possível migrar suas regras de alerta do Prometheus para políticas de alerta com uma condição baseada no PromQL. Dessa forma, é 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:

  • Criar uma política de alertas no console do Google Cloud e definir uma consulta 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 as regras de alerta e os 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 referenciar qualquer métrica no Cloud Monitoring, incluindo métricas do sistema do Google Cloud, métricas personalizadas e baseadas em registros e métricas do Prometheus. É necessário converter os nomes das métricas que não são do Prometheus para a sintaxe de métricas do PromQL. Para mais informações, consulte Como mapear métricas do Monitoring para PromQL.

Restrições

Uma política de alertas com uma condição baseada em PromQL pode ter uma duração de no máximo 24 horas e uma janela de lookback de no máximo 24 horas. A soma da duração e da janela de lookback precisa ser de no máximo 25 horas.

Se a regra de alerta do Prometheus se referir a uma métrica personalizada, será necessário primeiro ter um descritor de métrica personalizada equivalente no Cloud Monitoring.

Preços

Em geral, as métricas de sistema do Cloud Monitoring são gratuitas, já as métricas de sistemas, agentes ou aplicativos externos não. 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 seguintes documentos:

A seguir

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

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

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

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