Políticas de alertas baseadas em PromQL

Esta página explica diferentes métodos de criação de políticas de alertas com base em PromQL. É 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ê usa alertas no Managed Service para Prometheus, é possível migrar suas regras de alerta do Prometheus para políticas de alerta baseadas em PromQL. Dessa forma, é possível gerenciar todas as políticas de alerta 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 baseadas em PromQL 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 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 baseada em PromQL aparecem no console do Google Cloud com seus outros incidentes. É possível interagir com esses incidentes no console do Google Cloud .

As condições da sua política de alertas baseada em PromQL podem fazer referência a qualquer métrica no Cloud Monitoring, incluindo métricas do sistema Google Cloud , personalizadas e com base em registros, além de métricas do Prometheus. É necessário converter os nomes de 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 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 referenciar uma métrica, você precisará ter um descritor de métrica equivalente no Cloud Monitoring antes de criar a política de alertas baseada em PromQL. No entanto, é possível substituir essa validação configurando a política de alertas baseada em PromQL com a API Cloud Monitoring. Para mais informações, consulte Desativar a verificação de existência de métricas.

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 não são. As métricas faturáveis são faturadas 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 PromQL na condição, consulte Criar políticas de alertas baseadas 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 baseadas em PromQL (API).

Para informações sobre como migrar regras de alerta do PromQL para políticas de alerta baseadas em PromQL no Monitoring, 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.