Selecione métricas quando usar o explorador de métricas

Este documento descreve como configurar um gráfico temporário que apresenta os dados de séries cronológicas recolhidos pelo seu projeto. O Explorador de métricas só pode apresentar dados de séries cronológicas numéricos.

Selecione os dados a apresentar

Para configurar que séries cronológicas apresentar num gráfico, pode criar uma consulta fazendo seleções nos menus ou pode escrever uma consulta. Quando escreve uma consulta, seleciona a linguagem de consulta e, em seguida, usa um editor de consultas ou uma interface baseada em texto:

• As consultas da linguagem de consulta Prometheus (PromQL) especificam séries cronológicas e como essas séries cronológicas são agrupadas e alinhadas. A interface PromQL suporta um editor com sugestões.

  Geralmente, não é possível converter consultas PromQL em formulários que possam ser usados pelas outras interfaces. As suas consultas não guardadas são rejeitadas quando muda para o separador PromQL ou vice-versa.

• As consultas de filtro de monitorização especificam a série cronológica, mas não incluem declarações de agrupamento ou alinhamento.

  Pode especificar qualquer série cronológica que o Monitoring possa representar graficamente usando um filtro do Monitoring. Por exemplo, para representar graficamente o número de processos em execução numa VM, tem de usar um filtro do Monitoring que especifique uma função.

  Nem sempre é possível converter um filtro de monitorização no formato exigido por outras interfaces. Por conseguinte, a sua consulta pode ser rejeitada se mudar para uma interface diferente.

Normalmente, as consultas especificam um tipo de métrica, um tipo de recurso e filtros:

• Um tipo de métrica identifica as medições a recolher de um recurso. Inclui uma descrição do que está a ser medido e como as medições são interpretadas. Por vezes, um tipo de métrica é denominado métrica. Um exemplo de uma métrica é "Utilização da CPU". Para informações conceptuais, consulte o artigo Tipos de métricas.

• Um tipo de recurso especifica de que recurso os dados das métricas são capturados. O tipo de recurso é, por vezes, denominado tipo de recurso monitorizado ou recurso. Um exemplo de um recurso é uma "instância de máquina virtual (VM) do Compute Engine". Para ver informações conceptuais, consulte o artigo Recursos monitorizados.

As consultas PromQL incluem declarações de agrupamento e alinhamento. No entanto, quando escreve um filtro de monitorização ou usa menus para selecionar a série cronológica a representar num gráfico, configura as definições de agrupamento e alinhamento através de menus.

Crie consultas através de menus

A criação de consultas através de menus é a configuração predefinida. Normalmente, se selecionar uma métrica e um filtro e, em seguida, mudar para uma interface diferente, as suas seleções são preservadas e reformatadas para essa interface. Ou seja, uma consulta criada por menus pode ser convertida numa consulta PromQL.

Pode regressar das outras interfaces à interface baseada em menus selecionando tune Criador. No entanto, a sua consulta é rejeitada. Ou seja, não é possível converter uma consulta PromQL num formulário equivalente orientado por menus.

Para criar a consulta através de menus, faça o seguinte:

1. Na Google Cloud consola, aceda à página leaderboard Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

3. Na barra de ferramentas do painel de consulta, faça o seguinte:

   1. No elemento Métrica, expanda o menu Selecionar uma métrica.

      O menu Selecionar uma métrica contém funcionalidades que ajudam a encontrar os tipos de métricas disponíveis:

      • Para encontrar um tipo de métrica específico, use a filter_list barra de filtros. Por exemplo, se introduzir util, restringe o menu para mostrar entradas que incluam util. As entradas são apresentadas quando passam num teste "contém" que não distingue maiúsculas de minúsculas.

      • Para mostrar todos os tipos de métricas, mesmo os que não têm dados, clique em done Ativo. Por predefinição, os menus apenas mostram tipos de métricas com dados.

   2. Faça uma seleção no menu Recursos, no menu Categorias de métricas e no menu Métricas e, de seguida, clique em Aplicar.

      Por exemplo, para criar um gráfico da utilização da CPU de uma máquina virtual do Compute Engine, pode selecionar Instância de VM, Instância, Utilização da CPU e, de seguida, clicar em Aplicar.

      O menu Recursos apresenta o recurso a partir do qual os dados são recolhidos. Quando uma métrica não é escrita em função de um recurso, selecione Não especificado.

   Depois de selecionar o tipo de recurso e a métrica, o gráfico mostra todas as séries de tempos disponíveis para esse par:

   

   O gráfico anterior contém mais dados do que os que podem ser apresentados. Os gráficos estão limitados a 50 linhas apresentáveis. O gráfico apresenta um aviso de que existem demasiados dados para apresentar. Para reduzir a quantidade de dados, na barra de ferramentas de consulta, use o elemento Ordenar e limitar. Para mais informações, consulte o artigo Mostrar valores atípicos.

   Também pode usar as opções de filtragem e agregação para reduzir a quantidade de dados representados em gráficos. Estas técnicas tornam os gráficos mais úteis para diagnósticos e análises, e aumentam o desempenho e a capacidade de resposta da própria interface do utilizador.

4. Opcional: adicione filtros para restringir as séries cronológicas apresentadas. A secção seguinte descreve as opções de filtragem.

5. Opcional: configure a forma como as séries cronológicas são agrupadas e alinhadas. Para mais informações, consulte o artigo Escolha como apresentar os dados representados em gráficos.

Filtre os dados representados em gráficos

Os filtros garantem que apenas são representados graficamente os intervalos temporais que cumprem um determinado conjunto de critérios. Quando aplica filtros, pode reduzir o número de linhas no gráfico, o que pode melhorar o desempenho do gráfico. Outra forma de melhorar a capacidade de resposta de um gráfico é configurar as opções de agregação e ordenar e limitar o número de séries cronológicas apresentadas. Para mais informações, consulte o artigo Mostrar valores atípicos.

Um filtro é composto por uma etiqueta, um comparador e um valor. Por exemplo, para fazer corresponder todos os intervalos temporais cuja etiqueta zone comece por "us-central1", pode usar o filtro zone=~"us-central1.*", que usa uma expressão regular para fazer a comparação. Existem quatro operadores de comparação:

• é igual a =
• diferente de, !=
• correspondência de expressão regular, =~
• A expressão regular não corresponde, !=~

Quando filtra pelo ID do projeto ou pelo contentor de recursos, tem de usar o operador igual a, (=). Quando filtra por outras etiquetas, pode usar qualquer comparador suportado. Normalmente, pode filtrar métricas e etiquetas de recursos, bem como por grupo de recursos.

Quando fornece vários critérios de filtragem, o gráfico correspondente mostra apenas as séries cronológicas que cumprem todos os critérios, um AND lógico.

Para adicionar um filtro quando usar a interface orientada por menus da Google Cloud consola, faça o seguinte:

1. No elemento Filtro, clique em Adicionar filtro e faça uma seleção no menu.

2. Para alterar a comparação, selecione um valor no menu Comparador.

3. No campo Valor, introduza ou selecione um valor:

   • Para uma comparação direta, = ou !=, selecione o valor no menu ou introduza um valor e clique em OK. Pode introduzir valores, como us-central1-a, ou criar uma string de filtro que comece com starts_with ou ends_with. Por exemplo, para apresentar dados de qualquer zona us-central1, pode introduzir a string de filtro starts_with("us-central1"). Consulte o artigo Monitorizar filtros para mais informações sobre strings de filtros.

     Uma vez que as entradas de menu são derivadas das séries cronológicas recebidas, quando um recurso monitorizado não está a gerar dados para a métrica selecionada, tem de introduzir um valor para a etiqueta.

   • Para uma comparação de expressões regulares, =~ ou !=~, introduza uma expressão regular RE2 no campo Valor e clique em OK. Por exemplo, a expressão regular us-central1-.* corresponde a todas as zonas us-central1.

     Para corresponder a qualquer zona dos EUA que termine com "a", pode usar a expressão regular ^us.*.a$.

     Não pode usar expressões regulares para filtrar a etiqueta do recurso project_id.

     Por exemplo, para ver apenas a série cronológica de uma das zonas us-central1, aplique um filtro zone=~"us-central1.*".

Quando adiciona vários filtros, aplicam-se os seguintes pontos:

• Pode usar a mesma etiqueta várias vezes, o que lhe permite especificar um filtro para um intervalo de valores.

• Todos os critérios de filtro têm de ser cumpridos. Estes constituem um AND lógico.

Para editar o valor ou o comparador de um filtro, no elemento de filtro, clique em arrow_drop_down Menu, faça as alterações e, de seguida, clique em OK.

Para eliminar um filtro, clique em cancel Cancelar.

Escreva consultas PromQL

Para introduzir uma consulta PromQL, faça o seguinte:

1. Na Google Cloud consola, aceda à página leaderboard Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
3. Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é code MQL ou code PromQL.
4. 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.
5. Opcional: desative o botão Execução automática.

6. Introduza a consulta no editor de consultas. Por exemplo, para criar um gráfico da utilização média da CPU das instâncias de VM no seu Google Cloud projeto, use a seguinte consulta:

   avg(compute_googleapis_com:instance_cpu_utilization)
   

   Para mais informações sobre a utilização do PromQL, consulte o artigo PromQL no Cloud Monitoring.

7. Clique em Executar consulta.

   Quando a opção Executar automaticamente está ativada, o botão Executar consulta não é apresentado.

Escreva consultas de filtros de monitorização

Quando quiser fazer qualquer uma das seguintes ações, tem de usar o modo de filtro direto, que lhe permite introduzir um filtro de monitorização:

• Apresentar um objetivo ao nível do serviço (SLO).
• Apresentar a contagem de processos em execução em máquinas virtuais (VMs).
• Apresentar uma métrica personalizada para a qual ainda não tem dados.
• Filtrar um intervalo temporal com base numa etiqueta para a qual ainda não tem dados.

Um filtro de monitorização, ou, de forma equivalente, um filtro de métricas, é uma expressão que a monitorização usa para identificar as séries cronológicas a representar em gráficos. Por exemplo, a expressão seguinte resulta num gráfico que apresenta uma contagem de processos cujo nome inclui nginx:

select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"

Também pode usar filtros de monitorização para identificar séries cronológicas pelo respetivo recurso e tipo de métrica. A expressão seguinte resulta num gráfico que apresenta a contagem de entradas de registo para todas as instâncias de máquinas virtuais na zona us-east1-b: Google Cloud

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"

Para introduzir um filtro de monitorização, faça o seguinte:

1. Na Google Cloud consola, aceda à página leaderboard Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.

3. Clique em help_outline Ajuda no elemento Métrica e, de seguida, selecione Modo de filtro direto.

   Os elementos Métrica e Filtro são eliminados e é criado um elemento Filtros que lhe permite introduzir texto.

   Se selecionou um tipo de recurso, uma métrica ou filtros antes de mudar para o modo Modo de filtro direto, essas definições são apresentadas no elemento Filtros.

4. Na área de texto do elemento Filtros, introduza uma expressão de filtro de monitorização. Para informações de sintaxe, consulte os seguintes documentos:

   • Monitorizar filtros
   • Filtros de estado de funcionamento do processo
   • Obter dados de SLO

   Quando usa o modo de filtro direto e não estão disponíveis dados que satisfaçam o filtro, é apresentado um erro. As mensagens de erro comuns incluem Chart definition invalid e No data is available for the selected timeframe.

5. Opcional: configure a forma como as séries cronológicas são agrupadas e alinhadas. Para mais informações, consulte o artigo Escolha como apresentar os dados representados em gráficos.

Para voltar à interface baseada em menus, clique em tune Sair do modo de filtro direto.

Escolha como apresentar os dados representados em gráficos

Esta secção aborda como apresentar os dados selecionados definindo os campos de agregação. A agregação consiste no alinhamento de pontos de dados num intervalo temporal e na combinação de diferentes intervalos temporais. Para uma explicação detalhada da agregação, consulte o artigo Filtragem e agregação: manipular séries cronológicas.

• Para obter informações sobre as opções de visualização, consulte o artigo Defina as opções de apresentação de gráficos.
• Para mais informações sobre a interação com o próprio gráfico, consulte o artigo Explore os dados representados em gráficos.

O conteúdo desta secção não se aplica quando selecionou os dados para criar gráficos através do PromQL.

Combine intervalos temporais

Pode reduzir a quantidade de dados devolvidos para uma métrica combinando diferentes séries cronológicas. Para combinar várias séries cronológicas, normalmente, especifica uma ou mais etiquetas e uma função. As séries cronológicas que têm o mesmo valor para todas as etiquetas especificadas são agrupadas e, em seguida, a função especificada combina essas séries cronológicas numa nova série cronológica.

As definições no elemento Agregação podem alterar o número de séries cronológicas apresentadas no gráfico. As predefinições deste elemento são determinadas pelo tipo de métrica que selecionou. Para modificar a apresentação, faça qualquer uma das seguintes ações:

• Para apresentar todas as séries cronológicas, no elemento Agregação, certifique-se de que o primeiro menu está definido como Não agregado e o segundo menu está definido como Nenhum.

• Para combinar séries cronológicas, no elemento Agregação, faça o seguinte:

  1. Expanda o primeiro menu e selecione uma função.

     O gráfico é atualizado e apresenta um único intervalo temporal. Por exemplo, se selecionar Média, a série cronológica apresentada é a média de todas as séries cronológicas.

     O menu de funções suporta funções algébricas comuns, como média, mínimo, máximo e soma. A opção Série cronológica de contagem contabiliza o número de séries cronológicas que correspondem às definições de métricas e filtros. As opções de percentil, como o percentil 99, são valores estatísticos derivados das séries cronológicas que correspondem às definições de métricas e filtros.

  2. Para combinar séries cronológicas com os mesmos valores de etiquetas, expanda o segundo menu e, de seguida, selecione uma ou mais etiquetas.

     O gráfico é atualizado e mostra uma série cronológica para cada combinação única de valores de etiquetas. Por exemplo, para apresentar em séries cronológicas por zona, defina o segundo menu como zona.

• Para configurar o espaçamento entre pontos de dados, clique em add Adicionar elemento de consulta, selecione Intervalo mínimo e, de seguida, introduza um valor.

Por exemplo, se definir a função como Soma e selecionar a etiqueta user_labels.version, existe uma série cronológica para cada valor da etiqueta user_labels.version. Os pontos de dados em cada série cronológica são calculados a partir da soma de todos os valores para séries cronológicas individuais para uma versão específica:

Quando seleciona várias etiquetas, as séries cronológicas que têm os mesmos valores para as etiquetas selecionadas são combinadas. O gráfico resultante apresenta uma série cronológica para cada combinação de valores de etiqueta. A ordem pela qual especifica as etiquetas não é importante. A captura de ecrã seguinte mostra um gráfico onde os intervalos temporais são combinados pelas etiquetas user_labels.version e system_labels.machine_image:

Conforme mostrado, o gráfico apresenta uma série cronológica para cada par de valores de etiquetas. O facto de obter uma série cronológica para cada combinação de etiquetas significa que esta técnica pode criar mais dados do que os que pode usar de forma útil num único gráfico.

Mostrar todos os intervalos temporais

Para mostrar todas as séries cronológicas, no elemento Agregação, defina o primeiro menu como Não agregado e o segundo menu como Nenhum.

Alinhe intervalos temporais

O alinhamento é o processo de conversão dos dados de séries cronológicas recebidos pela monitorização numa nova série cronológica com pontos de dados a intervalos fixos. O processo de alinhamento consiste em recolher todos os pontos de dados recebidos num período fixo, aplicar uma função para combinar esses pontos de dados e atribuir uma data/hora ao resultado. Essa função pode calcular a média de todas as amostras ou extrair o máximo de todas as amostras.

Defina o intervalo de alinhamento

Para especificar o período fixo durante o qual os pontos devem ser combinados, clique em add Adicionar elemento de consulta no painel de consulta, selecione Intervalo mínimo e, de seguida, conclua a caixa de diálogo.

Por exemplo, considere uma métrica com um período de amostragem de um minuto. Se um gráfico estiver configurado para apresentar 1 hora de dados, o gráfico pode apresentar todos os 60 pontos de dados. Se o campo Intervalo mínimo estiver definido como 10 minutes, o gráfico apresenta 6 pontos de dados. No entanto, se configurar o gráfico para apresentar uma semana de dados, existem demasiados pontos para apresentar no gráfico, pelo que o intervalo ao longo do qual os pontos são combinados é modificado automaticamente. Neste exemplo, o intervalo modificado é de uma hora.

A captura de ecrã seguinte ilustra a utilização da CPU das instâncias de VM do Compute Engine num determinado Google Cloud projeto. Nesta imagem, o campo Intervalo mínimo está definido como 1 minute:

Para comparação, a captura de ecrã seguinte ilustra o efeito da alteração do intervalo de 1 minute para 5 minutes:

Ao aumentar o período, o gráfico resultante tem menos pontos, diminuindo de 60 pontos por série cronológica para 10 pontos por série cronológica. Ao aumentar o campo Intervalo mín., são combinados mais pontos, o que tem um efeito de suavização nos dados representados.

Defina a função de alinhamento

Quando seleciona a função de agregação, o Cloud Monitoring seleciona automaticamente a função de alinhamento. O Cloud Monitoring determina a função de alinhamento ideal com base no tipo de métrica selecionado e na sua escolha para a função de agregação. No entanto, pode especificar uma função de alinhamento e substituir a escolha feita pelo Cloud Monitoring.

Para especificar a função de alinhamento, faça o seguinte:

1. No elemento Agregação, expanda o primeiro menu e selecione Configurar alinhador. São adicionados a função de alinhamento e os elementos de agrupamento.
2. Expanda o elemento Função de alinhamento e faça uma seleção.

Embora a maioria das funções de alinhamento suportadas execute funções matemáticas comuns, algumas executam ações mais complicadas:

• next older: para reter apenas a amostra mais recente num período de alinhamento, selecione next older. Esta função é usada frequentemente com verificações de tempo de atividade e é uma boa escolha quando só se preocupa com o valor mais recente.

  Esta função só é válida para métricas de indicador.

• percentil: para apresentar uma métrica de distribuição num tipo de gráfico de linhas, gráfico de áreas empilhadas ou gráfico de barras empilhadas, tem de selecionar o percentil na distribuição a apresentar. Uma forma de especificar este percentil é selecionar uma função de percentil. Pode selecionar os percentis 5.º, 50.º, 95.º e 99.º. O ponto de dados alinhado é determinado através do cálculo do percentil especificado com todos os pontos de dados no período de alinhamento.

  Esta função só é válida para métricas de calibre e delta quando têm um tipo de dados de distribuição.

• delta: para converter uma métrica cumulativa ou uma métrica delta numa métrica delta com uma amostra por período de alinhamento, use esta função. A interpolação de dados pode ocorrer quando usa esta função. Para ver um exemplo, consulte o artigo Tipos, géneros e conversões.

  Esta função só é válida para métricas cumulativas e delta.

• rate: para converter uma métrica cumulativa ou delta numa métrica de indicador, use esta função. Se escolher esta função, pode considerar que a série cronológica é transformada como se fosse com uma função delta e, em seguida, dividida pelo período de alinhamento. Por exemplo, se a unidade da série cronológica original for MiB e a unidade do período de alinhamento for segundo, o gráfico tem uma unidade de MiB por segundo. Para mais informações, consulte o artigo Tipos, tipos e conversões.

  Esta função só é válida para métricas cumulativas e delta.

Para mais informações sobre as funções de alinhamento disponíveis, consulte Aligner na referência da API.

Agrupamento e alinhamento secundários

Quando tem várias séries cronológicas que já representam agregações, pode reduzir todas as séries cronológicas no gráfico a uma única série cronológica escolhendo um agregador secundário. Por exemplo, se agrupar os dados por zona, o gráfico mostra um intervalo temporal para cada zona. Para criar um gráfico com uma única série cronológica, use os campos de agregação secundária.

Para alguns tipos de métricas, tem a opção de transformar os dados. Se esta opção estiver disponível e se definir o campo Transform para um valor diferente de None, todos os outros campos são as definições de agregação secundárias.

Quando os campos de agregação secundários são configuráveis, para aceder a esses campos, faça o seguinte:

1. Clique em add Adicionar elemento de consulta e, de seguida, selecione Agregação secundária.
2. Configure o elemento Agregação secundária.

A captura de ecrã seguinte mostra várias séries cronológicas resultantes da agrupamento de um conjunto de dados filtrado. A utilização do agrupamento requer agregação; cada grupo de linhas é agregado numa só. A captura de ecrã seguinte mostra séries cronológicas agrupadas por zona:

A captura de ecrã seguinte mostra o resultado da utilização da agregação secundária para encontrar o valor médio na série cronológica agrupada:

Configure o nome de uma coluna de legenda

O campo Alias da legenda permite-lhe personalizar uma descrição para a série cronológica no seu gráfico. Estas descrições aparecem na sugestão para o gráfico e na legenda do gráfico na coluna Nome. Por predefinição, as descrições na legenda são criadas para si a partir dos valores de diferentes etiquetas na sua série cronológica. Uma vez que o sistema seleciona as etiquetas, os resultados podem não ser úteis para si. Para criar um modelo para descrições, use este campo.

Pode introduzir texto simples e modelos no campo Alias da legenda. Quando adiciona um modelo, adiciona uma expressão que é avaliada quando a legenda é apresentada.

Para adicionar um modelo de legenda a um gráfico, faça o seguinte:

1. No painel Apresentação, expanda expand_more Alias da legenda.
2. Clique em add Mostrar sugestões de variáveis de modelo e selecione uma entrada no menu. Por exemplo, se selecionar zone, o modelo ${resource.labels.zone} é adicionado.

Por exemplo, a captura de ecrã seguinte mostra um modelo de legenda que contém texto simples e a expressão ${resource.labels.zone}:

Na legenda do gráfico, os valores gerados a partir do modelo aparecem numa coluna com o cabeçalho Nome e na sugestão:

Pode configurar o modelo de legenda para incluir várias strings de texto e modelos. No entanto, o espaço de apresentação disponível na sugestão é limitado.

O que se segue?

• Explore os dados representados em gráficos
• Vista geral das métricas definidas pelo utilizador
• Configure o modelo de legenda
• Defina as opções de visualização do gráfico