Esta página descreve como criar políticas de alertas baseadas em PromQL no Cloud Monitoring. É possível usar consultas PromQL para criar condições complexas com recursos como proporções, limites dinâmicos com base em uma métrica diferente e métricas combinadas. Também é possível configurar políticas de alertas baseadas em PromQL para operar com mais de dois anos de dados.
Se você usa o Prometheus em ambientes fora do Google Cloudou se usa alertas no Serviço gerenciado para Prometheus, migre as regras de alertas do Prometheus para políticas de alertas baseadas 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 o Cloud Monitoring.
- Para informações gerais sobre como usar o PromQL no Monitoring, consulte PromQL no Cloud Monitoring.
- Para informações gerais sobre políticas de alertas, consulte Comportamento das políticas de alertas com base em métricas.
Usar o PromQL nas 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 Google Cloud e definir uma consulta do 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 a construção
AlertPolicyna API Monitoring, consulte Criar políticas de alertas baseadas em PromQL (API).Para migrar suas regras de alerta e 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 incidentes criados por uma política de alertas baseada em PromQL aparecem no console 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 , métricas personalizadas e com base em registros e métricas do Prometheus. É necessário traduzir os nomes das métricas não Prometheus para a sintaxe de métricas do PromQL. Para mais informações, consulte Como mapear métricas do Monitoring para PromQL.
Consultar mais de dois anos de dados de métricas
Ao contrário de outros tipos de política de alertas que só permitem consultar mais de 25 horas de dados de métricas, você pode usar o PromQL para gerar alertas com até dois anos de dados de métricas. Isso é compatível com casos de uso como:
- Detectar anomalias comparando os últimos cinco minutos com o mesmo período de cinco minutos de uma semana atrás.
- Executando uma política de alertas de gravação lenta de sete dias.
- Receber o valor médio do último mês e um alerta se a hora mais recente de dados estiver mais de três desvios padrão dessa média.
- Usando a função
predict_linearna última semana de dados para saber se você vai exceder um limite no dia seguinte.
As políticas de alertas do PromQL que operam nos dados das últimas 25 horas, 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 com dados mais antigos são avaliadas com menos frequência. O período mínimo é determinado pela antiguidade da política de alertas:
| Período de retorno da consulta | Intervalo mínimo (padrão) de avaliação |
|---|---|
| Até 25 horas1 | 30 segundos |
| 25 horas a 8 dias | 5 minutos |
| 8 a 16 dias | 1 hora |
| 16 a 32 dias | 2 horas |
| De 32 a 93 dias | 6 horas |
| De 93 dias a 2 anos | 12 horas |
1 Algumas métricas dos serviços do Google Cloud só aceitam intervalos de avaliação de 30 segundos por até 23 horas e 30 minutos.
Defina durações de rate pelo menos iguais ao intervalo de avaliação para que a política de alertas não perca nenhum dado. Por exemplo, se o intervalo de avaliação for de uma hora, a consulta será semelhante a rate(metric[1h]).
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 em PromQL não atingir o tempo limite no Metrics Explorer, ela também não vai atingir no alerta.
As políticas de alertas do PromQL são muito mais confiáveis quando operam com os dados das últimas 25 horas. 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 novas tentativas são desativadas para consultas de alerta do PromQL que acessam dados com mais de 25 horas.
Só é possível gerar alertas com base nas 25 horas mais recentes de dados para métricas personalizadas (prefixo custom.googleapis.com) e métricas com base em registros definidas pelo usuário (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 um período de reteste, a soma desse período, 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 alertas do Prometheus fizer referência a uma métrica, primeiro 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 sua política de alertas baseada em PromQL com a API Cloud Monitoring. Para mais informações, consulte Desativar a verificação da 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 incidentes falsos. Para mais informações, consulte Alertas falsos devido a anomalias no cálculo da proporção.
Preços
Para saber mais sobre os preços do Cloud Monitoring, consulte a página Preços do Google Cloud Observability.