Consultar usando o Cloud Monitoring

Depois de implantar o Google Cloud Managed Service para Prometheus, você pode consultar os dados enviados ao serviço gerenciado e exibir os resultados em gráficos e painéis.

Neste documento, descrevemos os escopos de métricas, que determinam os dados que podem ser consultados, e como usar o Cloud Monitoring para recuperar e usar os dados coletados.

Todas as interfaces de consulta do serviço gerenciado para o Prometheus são configuradas para recuperar dados do Monarch usando a API Cloud Monitoring. Ao consultar o Monarch em vez de consultar dados dos servidores locais do Prometheus, você tem o monitoramento global em escala.

Antes de começar

Se você ainda não implantou o serviço gerenciado, configure a coleção gerenciada ou a coleção autoimplantada. Pule isso se quiser apenas consultar métricas do Cloud Monitoring usando o PromQL.

Escopos de consultas e métricas

Os dados que você pode consultar são determinados pelo escopo de métricas da construção do Cloud Monitoring, independentemente do método usado para consultar os dados.

Um escopo de métricas do Monitoring é uma construção somente leitura que permite consultar dados de métricas pertencentes a vários projetos do Google Cloud. Cada escopo de métricas é hospedado por um projeto do Google Cloud designado, chamado de projeto de escopo.

Por padrão, um projeto é o projeto de escopo para o próprio escopo de métricas, e o escopo das métricas contém as métricas e a configuração desse projeto. Um projeto de escopo pode ter mais de um projeto monitorado no escopo de métricas, e as métricas e configurações de todos os projetos monitorados no escopo de métricas são visíveis para o projeto de escopo. Um projeto monitorado também pode pertencer a mais de um escopo de métricas.

Quando você consulta as métricas em um projeto, e se ele hospeda um escopo de métricas de vários projetos, é possível recuperar dados de vários projetos. Se o escopo das métricas contiver todos os projetos, as consultas e regras serão avaliadas globalmente.

Para mais informações sobre escopos e projetos de escopo, consulte Escopos de métricas. Para informações sobre como configurar um escopo de métricas de vários projetos, consulte Visualizar métricas de vários projetos.

Serviço gerenciado para dados do Prometheus no Cloud Monitoring

O serviço gerenciado para o Prometheus compartilha o back-end de armazenamento de dados, o Monarch, com o Cloud Monitoring. É possível usar todas as ferramentas fornecidas pelo Cloud Monitoring com os dados coletados pelo Serviço gerenciado para o Prometheus. Por exemplo, é possível usar o Metrics Explorer, conforme descrito no console do Google Cloud para o Monitoring e definir alertas com base nessas métricas. de dois minutos. Também é possível importar os painéis do Grafana para o Cloud Monitoring.

Ao trabalhar com dados de métricas, incluindo dados do Serviço gerenciado para o Prometheus, no Cloud Monitoring, é possível usar as ferramentas de consulta fornecidas pelo Cloud Monitoring:

Como fazer consultas usando PromQL no Cloud Monitoring

A maneira mais simples de consultar seus dados do Prometheus é usar a página do Metrics Explorer do Cloud Monitoring no console do Google Cloud. Para verificar se os dados do Prometheus estão sendo coletados corretamente, faça o seguinte:

No painel de navegação do console do Google Cloud, selecione Monitoramento e Metrics Explorer:
Acesse o Metrics explorer
Na barra de ferramentas do painel do criador de consultas, selecione o botão MQL ou PromQL.
Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
Digite a consulta a seguir no Editor e clique em Executar consulta:
```
up
```

Se os dados estiverem sendo ingeridos, você verá um gráfico como este:

Gráfico do Metrics Explorer para a métrica "Ups" do serviço gerenciado para Prometheus.

Para informações sobre como consultar métricas do sistema do Cloud Monitoring usando PromQL, consulte PromQL para métricas do Cloud Monitoring.

Para mais informações sobre como usar o PromQL no Metrics Explorer e no Cloud Monitoring, consulte PromQL no Cloud Monitoring.

Outras opções de consulta no Cloud Monitoring

Para visualizar os dados do Prometheus como uma série temporal do Cloud Monitoring e criar gráficos e painéis, também é possível usar as interfaces orientadas por menu ou MQL. Veja a seguir uma consulta simples no Metrics Explorer:

No painel de navegação do console do Google Cloud, selecione Monitoramento e Metrics Explorer:
Acesse o Metrics explorer
Especifique os dados que aparecerão no gráfico. Além de usar o botão PromQL descrito anteriormente, também é possível usar a interface baseada em menus. Para criar uma consulta, faça o seguinte:
1. No painel do criador de consultas, clique em "Selecionar uma métrica".
2. No campo de pesquisa, digite "up/" para filtrar a lista e selecione Destino do Prometheus, Up e Prometheus/up/GAuge.
3. Clique em "Aplicar".

O gráfico resultante dessa consulta mostra os mesmos dados do gráfico mostrado no exemplo de PromQL.

As consultas criadas com a interface orientada por menu podem ser convertidas em PromQL ao selecionar o botão PromQL. Essa tradução pode não converter corretamente as funções de histograma ou outros operadores incomuns.

O recurso `prometheus_target`

No Cloud Monitoring, os dados de série temporal são gravados em um tipo de recurso monitorado. Para métricas do Prometheus, o tipo de recurso monitorado é prometheus_target. As consultas de monitoramento de métricas do Prometheus que não estão escritas em PromQL precisam especificar esse tipo de recurso.

O recurso prometheus_target tem os seguintes rótulos, que podem ser usados para filtrar e manipular os dados consultados:

project_id: o identificador do projeto do Google Cloud associado a esse recurso.
location: o local físico (região do Google Cloud) em que os dados são armazenados. Esse valor normalmente é a região do cluster do GKE ou da instância do Compute Engine. Se os dados forem coletados de uma AWS ou implantação no local, o valor poderá ser a região do Google Cloud mais próxima.
cluster: o cluster do GKE ou o conceito relacionado pode estar vazio.
namespace: o namespace do GKE ou o conceito relacionado pode estar vazio.
job: o rótulo do job do destino do Prometheus, se conhecido. Pode estar vazio para resultados de avaliação de regras.
instance: o rótulo da instância de destino do Prometheus, se conhecido. Pode estar vazio para os resultados de avaliação de regras.

Os valores desses rótulos são definidos durante a coleta.