Este documento descreve o uso da linguagem de consulta do Prometheus (PromQL) em 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 multicloud totalmente gerenciada para o Prometheus no 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 Grafana para criar gráficos com dados de métricas ingeridos em Cloud Monitoring: As métricas disponíveis incluem métricas de As métricas do Managed Service para Prometheus e do Cloud Monitoring estão documentadas em as 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 Cloud Monitoring.
Convenções de nomenclatura
O modelo de métricas e as convenções de nomenclatura do Prometheus são diferentes 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 informações sobre como acessar e usar o editor, consulte Como usar o editor de PromQL.
Regras e alertas do Prometheus
Use 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 Cloud Monitoring pode funcionar de maneira um pouco diferente do que o PromQL upstream. Para ver uma lista dessas diferenças, consulte Diferenças de PromQL.