Depois de implementar o serviço gerido do Google Cloud para o Prometheus, pode consultar os dados enviados para o serviço gerido e apresentar os resultados em gráficos e painéis de controlo.
Este documento descreve os âmbitos das métricas, que determinam os dados que pode consultar, e como usar o Cloud Monitoring para obter e usar os dados que recolheu.
Todas as interfaces de consulta do serviço gerido para Prometheus estão configuradas para obter dados do Monarch através da Cloud Monitoring API. Ao consultar o Monarch em vez de consultar dados de servidores Prometheus locais, recebe monitorização global em grande escala.
Antes de começar
Se ainda não implementou o serviço gerido, configure a recolha gerida ou a recolha autodeployada. Pode ignorar este passo se só tiver interesse em consultar métricas do Cloud Monitoring através do PromQL.
Âmbitos das consultas e métricas
Os dados que pode consultar são determinados pela construção do Cloud Monitoring âmbito das métricas, independentemente do método que usa para consultar os dados.
Um âmbito de métricas de monitorização é uma construção apenas de tempo de leitura que lhe permite consultar dados de métricas pertencentes a vários Google Cloud projetos. Cada âmbito de métricas é alojado por um Google Cloud projeto designado, denominado projeto de âmbito.
Por predefinição, um projeto é o projeto de âmbito para o seu próprio âmbito de métricas e o âmbito de métricas contém as métricas e a configuração desse projeto. Um projeto de âmbito pode ter mais do que um projeto monitorizado no respetivo âmbito de métricas, e as métricas e as configurações de todos os projetos monitorizados no âmbito de métricas são visíveis para o projeto de âmbito. Um projeto monitorizado também pode pertencer a mais do que um âmbito de métricas.
Quando consulta as métricas num projeto de âmbito, e se esse projeto de âmbito alojar um âmbito de métricas de vários projetos, pode obter dados de vários projetos. Se o âmbito das métricas contiver todos os seus projetos, as consultas e as regras são avaliadas globalmente.
Para mais informações sobre o âmbito dos projetos e o âmbito das métricas, consulte o artigo Âmbito das métricas. Para obter informações sobre a configuração do âmbito das métricas de vários projetos, consulte o artigo Veja métricas de vários projetos.
Serviço gerido para dados do Prometheus no Cloud Monitoring
O Managed Service for Prometheus partilha o back-end de armazenamento de dados, o Monarch, com o Cloud Monitoring. Pode usar todas as ferramentas fornecidas pelo Cloud Monitoring com os dados recolhidos pelo Managed Service for Prometheus. Por exemplo, pode usar o Explorador de métricas, conforme descrito na Google Cloud consola para monitorização, e pode definir alertas com base nestas métricas. Também pode importar os seus painéis de controlo do Grafana para o Cloud Monitoring.
Quando trabalha com dados de métricas, incluindo dados do Managed Service for Prometheus, no Cloud Monitoring, pode usar as ferramentas de consulta fornecidas pelo Cloud Monitoring:
Consultar com PromQL no Cloud Monitoring
A forma mais simples de consultar os seus dados do Prometheus é usar a página do Metrics Explorer do Cloud Monitoring na Google Cloud consola. Para verificar se os seus dados do Prometheus estão a ser recolhidos corretamente, faça o seguinte:
-
Na Google Cloud consola, aceda à página leaderboard Explorador de métricas:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é code MQL ou code PromQL.
Verifique se a opção PromQL está selecionada no botão Idioma. O botão para alternar o idioma encontra-se na mesma barra de ferramentas que lhe permite formatar a consulta.
Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
up
Se os dados estiverem a ser carregados, é apresentado um gráfico semelhante ao seguinte:
Para obter informações sobre como consultar métricas do sistema do Cloud Monitoring através do PromQL, consulte o artigo PromQL para métricas do Cloud Monitoring.
Para mais informações sobre a utilização do PromQL no Explorador de métricas e nos gráficos do Cloud Monitoring, consulte o artigo PromQL no Cloud Monitoring.
Outras opções de consulta no Cloud Monitoring
Para ver os seus dados do Prometheus como intervalos temporais do Cloud Monitoring e criar gráficos e painéis de controlo, também pode usar as interfaces orientadas por menus ou o MQL. O exemplo seguinte mostra uma consulta simples no explorador de métricas:
-
Na Google Cloud consola, aceda à página leaderboard Explorador de métricas:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Especifique os dados a apresentar no gráfico. Além de usar o botão PromQL descrito anteriormente, também pode usar a interface orientada por menus. Para criar uma consulta, faça o seguinte:
No painel do criador de consultas, clique em "Selecionar uma métrica".
No campo de pesquisa, escreva "up/" para filtrar a lista e, de seguida, selecione Prometheus Target, Up e Prometheus/up/gauge.
Clique em "Aplicar".
O gráfico resultante desta consulta mostra os mesmos dados que o gráfico apresentado no exemplo de PromQL.
As consultas criadas através da interface orientada por menus podem ser convertidas em PromQL selecionando o botão PromQL. Esta tradução pode não converter corretamente funções de histograma ou outros operadores pouco comuns.
O recurso prometheus_target
No Cloud Monitoring, os dados de intervalos temporais são escritos em função de um tipo de recurso monitorizado. Para métricas do Prometheus, o tipo de recurso monitorizado é
prometheus_target. As consultas de monitorização de
métricas do Prometheus que não estão escritas em PromQL
têm de especificar este tipo de recurso.
O recurso prometheus_target tem as seguintes etiquetas, que pode usar para filtrar e manipular os dados consultados:
project_id: o identificador do projeto Google Cloud associado a este recurso.location: a localização física (Google Cloud região) onde os dados são armazenados. Normalmente, este valor é a região do seu cluster do GKE ou instância do Compute Engine. Se os dados forem recolhidos a partir de uma implementação local ou da AWS, o valor pode ser a região Google Cloud mais próxima.cluster: O cluster do GKE ou o conceito relacionado; pode estar vazio.namespace: O espaço de nomes do GKE ou o conceito relacionado; pode estar vazio.job: a etiqueta de tarefa do destino do Prometheus, se for conhecida; pode estar vazia para resultados de avaliação de regras.instance: a etiqueta de instância do destino do Prometheus, se for conhecida; pode estar vazia para resultados de avaliação de regras.
Os valores destas etiquetas são definidos durante a recolha.
O que se segue?
- Configure alertas do PromQL através do Cloud Monitoring.
- Importe painéis de controlo do Grafana para o Cloud Monitoring.