Este documento descreve 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) para criar gráficos e painéis.
O PromQL pode ser usado para consultar e criar gráficos usando dados do Cloud Monitoring destas 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 saber mais sobre esse serviço gerenciado, incluindo suporte para PromQL, consulte Google Cloud Managed Service para Prometheus.
Também é possível usar ferramentas como o 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 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 serviço gerenciado para Prometheus sobre o Grafana.
Também é possível importar os painéis do Grafana para o Cloud Monitoring.
Convenções de nomenclatura
O modelo de métrica e as convenções de nomenclatura do Prometheus são diferentes daqueles usados 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 Code nas páginas a seguir 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 de PromQL.
Regras e alertas do Prometheus
É possível usar o PromQL para criar regras de gravação e alerta 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 alerta de regras gerenciadas ou Avaliação e alerta 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. Estes recursos podem ajudar você a começar:
Diferenças de PromQL
O PromQL para Cloud Monitoring pode funcionar de maneira um pouco diferente do PromQL upstream. Para ver uma lista dessas diferenças, consulte Diferenças de PromQL.