Neste documento, descrevemos como usar a linguagem de consulta do Prometheus (PromQL) no Cloud Monitoring. O PromQL é 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 das seguintes fontes:
- Serviços do Google Cloud, como o Google Kubernetes Engine ou o Compute Engine, que gravam métricas descritas nas listas de métricas do sistema do Cloud Monitoring.
- Métricas definidas pelo usuário, como métricas com base em registros e métricas definidas pelo usuário do Cloud Monitoring.
- Google Cloud Managed Service para Prometheus, a solução de várias nuvens totalmente gerenciada do Prometheus do Google Cloud. Para mais informações sobre o serviço gerenciado, incluindo suporte do PromQL, consulte Google Cloud Managed Service para Prometheus.
Também é possível usar ferramentas como Grafana para criar gráficos com dados de métricas ingeridos no Cloud Monitoring. As métricas disponíveis incluem métricas do Managed Service para Prometheus e do Cloud Monitoring documentadas 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étricas 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 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, nas seguintes páginas do console do Google Cloud:
- Metrics Explorer
- Adicionar gráfico ao criar painéis personalizados
Para saber mais 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 registro 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.