Políticas de alertas com o PromQL

Esta página explica diferentes métodos de criação de políticas de alertas com uma consulta do PromQL na condição.

As políticas de alertas com uma condição baseada em PromQL oferecem uma alternativa de código aberto a usar consultas na 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 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 você usar alertas no Managed Service para Prometheus, será possível migrar suas regras de alertas do Prometheus para políticas de alertas com um Condição baseada em PromQL. Assim, você pode gerenciar todas as políticas de alerta no Cloud Monitoring.

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

Visão geral

É possível criar políticas de alertas com um gateway das seguintes maneiras:

  • Crie uma política de alertas no console do Google Cloud e defina 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 o AlertPolicy na API Monitoring.

  • Migre suas regras de alertas 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 fazer referência a qualquer métrica no Cloud Monitoring, incluindo métricas do sistema do Google Cloud, métricas personalizadas e com base em registros e métricas do Prometheus. Você deve traduzir os nomes de métricas que não são do Prometheus à sintaxe da métrica do PromQL. Para mais informações, consulte Como mapear métricas do Monitoring para PromQL.

Restrições

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

Se a regra de alerta do Prometheus faz referência a uma métrica personalizada, primeiro é necessário 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, e as métricas de sistemas, agentes ou aplicativos externos. As métricas faturáveis são faturado 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 mais 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 alertas 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 alerta do PromQL para políticas de alerta com uma consulta do 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.