Políticas de alertas com o PromQL

Esta página explica os diferentes métodos de criação de políticas de alertas com um consulta 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. Dessa forma, é possível gerenciar todos os alertas 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:

  • Criar uma política de alertas no console do Google Cloud e definir um PromQL no editor de código.

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

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

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 o Cloud Monitoring, incluindo métricas de sistema do Google Cloud, personalizadas e com base em registros e do Prometheus. Você deve traduz 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 alertas com uma condição baseada em PromQL pode ter uma janela de novo teste no máximo 24 horas e um período de alinhamento de no máximo 24 horas. A soma a janela de novo teste e o período de alinhamento precisam 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 documentos a seguir:

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 usando diretamente a API Cloud Monitoring, consulte Criar políticas de alertas com uma condição baseada em PromQL (API).

Para informações sobre como migrar alertas do PromQL regras a políticas de alertas com uma consulta PromQL, consulte Migre 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.