As consultas da linguagem de consulta do Prometheus (PromQL) no Cloud Monitoring permitem criar políticas de alertas com condições complexas, como proporções de métricas, limites dinâmicos com base em outra métrica e métricas combinadas. Essas políticas podem avaliar até dois anos de dados de métricas.
Se você usa o Prometheus em ambientes fora do Google Cloud ou usa alertas no Google Cloud Managed Service para Prometheus, é possível migrar suas regras de alerta do Prometheus para políticas de alertas baseadas em PromQL. A migração das regras permite gerenciar todas as políticas de alertas no Monitoring. Também é possível importar os painéis do Grafana para o Cloud Monitoring. Para informações gerais sobre como usar o PromQL e como as políticas de alertas avaliam os dados, consulte PromQL no Cloud Monitoring e Comportamento das políticas de alertas com base em métricas.
Usar o PromQL em políticas de alertas do Cloud Monitoring
É possível criar políticas de alertas baseadas em PromQL das seguintes maneiras:
Para criar uma política de alertas no console do Google Cloud e definir uma consulta PromQL no editor de código, consulte Criar políticas de alertas baseadas em PromQL (Console).
Para criar uma política de alertas baseada em PromQL usando a CLI gcloud ou o constructo
AlertPolicyna API Monitoring, consulte Criar políticas de alertas baseadas em PromQL (API).Para migrar as regras de alerta e os canais de notificação do Prometheus para o Cloud Monitoring usando a Google Cloud CLI, consulte Migrar regras de alerta e receptores do Prometheus.
Os alertas criados por uma política de alertas baseada em PromQL aparecem no console do Google Cloud com seus outros alertas. É possível interagir com esses alertas no console do Google Cloud .
As condições da política de alertas baseada em PromQL podem referenciar qualquer métrica no Cloud Monitoring, incluindo Google Cloud métricas do sistema, métricas personalizadas e com base em registros e métricas do Prometheus. É necessário traduzir 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.
Consultar dados de métricas de mais de dois anos
Ao contrário de outros tipos de política de alertas que só oferecem suporte à consulta de mais de 25 horas de dados de métricas, é possível usar o PromQL para alertar sobre até 2 anos de dados de métricas. Isso é útil para casos de uso como:
- Detectar anomalias comparando os últimos 5 minutos com o mesmo período de 5 minutos de 1 semana atrás.
- Executar uma política de alertas de consumo lento de sete dias.
- Receber o valor médio do último mês e alertar se a hora mais recente de dados estiver a mais de três desvios padrão dessa média.
- Usar a função
predict_linearna última semana de dados para ver se você vai exceder um limite no dia seguinte.
As políticas de alertas do PromQL que operam nas últimas 25 horas de dados, conforme definido pela soma do período de alinhamento e qualquer mudança de horário causada pelo uso do modificador offset, podem ser avaliadas a cada 30 segundos.
As políticas que operam em dados mais antigos são avaliadas com menos frequência, com o período mínimo
determinado pelo tempo de análise da política de alertas:
| Período de análise da consulta | Intervalo de avaliação mínimo (padrão) |
|---|---|
| Até 25 horas1 | 30 segundos |
| 25 horas a 8 dias | 5 minutos |
| De 8 a 16 dias | 1 hora |
| De 16 a 32 dias | 2 horas |
| De 32 a 93 dias | 6 horas |
| 93 dias a 2 anos | 12 horas |
1 Algumas métricas dos serviços do Google Cloud oferecem suporte apenas a intervalos de avaliação de 30 segundos por até 23 horas e 30 minutos.
Defina as durações de rate para que sejam pelo menos iguais ao intervalo de avaliação,
para que a política de alertas não perca dados. Por exemplo, se
o intervalo de avaliação for de 1 hora, a consulta será semelhante a
rate(metric[1h]).
As condições que operam em mais de 25 horas de dados têm um prazo de consulta de 2 minutos, que corresponde ao prazo no Metrics Explorer. Se a consulta PromQL não expirar no Metrics Explorer, ela não vai expirar no alerta.
As políticas de alertas do PromQL são significativamente mais confiáveis ao operar
com as últimas 25 horas de dados. Para máxima confiabilidade,
verifique se a soma da janela de novo teste, do período de alinhamento e de qualquer mudança de horário
causada pelo uso do modificador offset é de no máximo 25 horas.
As janelas de novo teste são desativadas para consultas de alerta do PromQL que acessam dados com mais de 25 horas.
Só é possível receber alertas sobre as últimas 25 horas de dados de métricas personalizadas (o prefixo custom.googleapis.com) e métricas com base em registros definidas pelo usuário (o prefixo logging.googleapis.com/user/).
Restrições
Não adicione filtros que usam rótulos de metadados do sistema às políticas de alertas baseadas em PromQL.
Uma política de alertas baseada em PromQL pode ter uma janela de reteste de
no máximo 24 horas. Se você usar uma janela de reteste, a soma dela, do período de alinhamento e de qualquer mudança de horário causada pelo uso do modificador offset precisa ser de no máximo 25 horas.
Se a regra de alerta do Prometheus fizer referência a uma métrica, primeiro você precisa ter um descritor de métrica equivalente no Cloud Monitoring antes de criar sua 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.
Se a política de alertas monitorar uma proporção de métricas, defina a duração como pelo menos o dobro do intervalo de avaliação. Durações mais curtas podem resultar em alertas falsos. Para mais informações, consulte Alertas falsos devido a anomalias no cálculo de proporção.