PromQL no Cloud Monitoring

Neste documento, descrevemos o uso da linguagem de consulta do Prometheus (PromQL) no Cloud Monitoring. O PromQL oferece uma alternativa às interfaces de menu do Metrics Explorer e da linguagem de consulta do Monitoring (MQL, na sigla em inglês) para criar gráficos e painéis.

É possível usar o PromQL para consultar e criar gráficos de dados do Cloud Monitoring destes recursos:

Também é possível usar ferramentas como Grafana para criar gráficos com dados de métricas ingeridos pelo Cloud Monitoring. As métricas disponíveis incluem as do Managed Service para Prometheus e do Cloud Monitoring que constam nas listas de métricas. Para informações sobre como configurar o Grafana e outras ferramentas com base na API Prometheus, consulte a documentação do Managed Service para Prometheus sobre o Grafana.

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

Convenções de nomeação

As convenções de nomenclatura e modelo de métrica do Prometheus são diferentes das usadas pelo Cloud Monitoring. Para usar o PromQL para consultar dados de métricas do Monitoring, é necessário converter os nomes do Cloud Monitoring em equivalentes compatíveis com o PromQL. Para mais informações sobre as convenções de nomenclatura, consulte Como mapear métricas do Cloud Monitoring para PromQL.

Como acessar o PromQL no Cloud Monitoring

É possível usar o PromQL na guia Código das seguintes páginas no console do Google Cloud:

  • Metrics Explorer
  • Adicionar gráfico ao criar painéis personalizados

Para informações sobre como acessar e usar o editor, consulte Como usar o editor PromQL.

Regras e alertas do Prometheus

É possível usar o PromQL para criar regras de gravação e alertas em qualquer métrica no Cloud Monitoring usando alertas no estilo do Prometheus no Managed Service para Prometheus. Para mais informações, consulte Avaliação e alertas de regras gerenciadas ou Avaliação e alertas de regras autoimplantadas.

Aprendizado sobre promQL

Para aprender os conceitos básicos do uso do PromQL, recomendamos consultar a documentação de código aberto. Os recursos a seguir podem ajudar você a começar:

Diferenças de PromQL

O PromQL para o Cloud Monitoring pode funcionar de maneira um pouco diferente do PromQL upstream. Para ver uma lista dessas diferenças, consulte Diferenças de PromQL.