Este documento descreve como usar a Linguagem de consulta do Prometheus (PromQL) no Cloud Monitoring. O PromQL oferece uma alternativa 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.
O PromQL pode ser usado para consultar e criar gráficos Dados do Cloud Monitoring provenientes das seguintes fontes:
- serviços do Google Cloud, como o Google Kubernetes Engine ou o Compute Engine, que gravam descritas nas listas do Cloud Monitoring métricas do sistema.
- 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 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 em 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 mais informações sobre como configurar o Grafana e outras ferramentas baseadas na API Prometheus, consulte 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 nomenclatura
O modelo de métrica e as convenções de nomenclatura do Prometheus são diferentes daqueles usados pelo Cloud Monitoring. Usar PromQL para consultar Monitoring os dados de métricas, você precisa converter o Cloud Monitoring em equivalentes compatíveis com PromQL. Para informações sobre o de nomenclatura do projeto, 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 páginas a seguir No console do Google Cloud:
- Metrics Explorer
- Adicionar gráfico ao criar painéis personalizados
Para mais informações sobre como acessar e usar o editor, consulte Usar o editor 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 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 Cloud Monitoring pode funcionar de maneira um pouco diferente do PromQL upstream. Para ver uma lista dessas diferenças, consulte Diferenças de PromQL.