Como selecionar métricas usando o Metrics Explorer

Nesta página, descrevemos como escolher os dados a serem exibidos e também como exibir esses dados ao usar o Metrics Explorer. Para informações sobre como configurar o estilo de um gráfico, consulte Como definir opções de visualização.

Como selecionar os dados a serem exibidos

Para especificar as métricas a serem exibidas ao usar o Metrics Explorer, clique na guia Métrica na página de definição de gráfico. A captura de tela abaixo mostra a guia do seletor de métricas:

Exibir a guia de seleção de métricas.

Para preencher o campo Encontrar tipo e métrica do recurso, especifique pelo menos um par de valores:

  • Um tipo de métrica que identifica as medições que podem ser coletadas de um recurso monitorado. Ele inclui uma descrição do que está sendo medido e como as medições são interpretadas. Às vezes, o tipo de métrica é chamado de métrica. Para informações conceituais, consulte Tipos de métricas.

  • Um recurso monitorado especifica de qual recurso os dados da métrica são capturados. O recurso monitorado é, às vezes, chamado de tipo de recurso monitorado ou de recurso. Para informações conceituais, consulte Recursos monitorados.

O Monitoring tem muitos tipos de métricas e recursos monitorados predefinidos disponíveis, e também é possível criar métricas personalizadas:

O campo de especificação de métricas

Para selecionar uma métrica, use o campo Find resource type and metric para escolher um tipo de recurso e um tipo de métrica. É possível especificá-los em qualquer ordem. Para começar, clique no campo. Isso trará uma ou duas listas, com base em qualquer seleção anterior. As listas são indicadas por cabeçalhos, Tipos de recursos e Métricas, como mostra a captura de tela a seguir:

Listas de pesquisa para selecionar métricas e recursos.

Há duas maneiras de selecionar uma entrada:

  • ao selecionar entradas das listas;

  • ao inserir um filtro de métrica. Para inserir um filtro de métrica, faça o seguinte:

    1. Ao lado de Encontrar métrica e tipo de recurso, clique em Ajuda
    2. Clique em Modo de filtro direto no painel de ajuda.

      Quando o Modo de filtro direto está ativado, a opção Encontrar métrica e tipo de recurso é substituída por uma caixa de texto editável chamada Tipo de recurso, métrica e filtro:

      O

      Se você escolheu um tipo de recurso, uma métrica ou um filtro antes de selecionar Modo de filtro direto, essas configurações serão usadas para preencher a caixa de texto Tipo de recurso, métrica e filtro.

    3. Insira um filtro de métrica na caixa de texto Tipo de recurso, métrica e filtro. O filtro precisa incluir um tipo de métrica e um de recurso. Também é possível incluir filtros de rótulo. Para saber mais sobre a gramática de filtros, consulte Filtros do Monitoring.

      Por exemplo, para exibir as entradas de registro de todas as instâncias de VM do Google Cloud na zona us-east1-b, insira:

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

      Se você usou o modo de filtro direto para configurar gráficos ou políticas de alertas e nenhum dado estiver disponível, uma mensagem de erro aparecerá no gráfico. A mensagem de erro exata depende do filtro inserido. Por exemplo, uma mensagem comum é Chart definition invalid. Você também pode ver a mensagem No data is available for the selected time frame.

Passar o cursor do mouse sobre um item em uma das listas carrega uma dica que exibe as informações no descritor do item. Para mais informações sobre descritores de tipos de métricas ou recursos monitorados, consulte a lista de métricas ou a de recursos monitorados.

Quando pelo menos um tipo de recurso e um par de métricas são selecionados, o gráfico mostra todas as séries temporais disponíveis. Itens adicionais aparecem abaixo da métrica especificada na guia Métrica. A captura de tela abaixo mostra a guia Métrica depois que uma métrica é especificada:

Exibição de opções de seleção extras.

Com base na métrica e no recurso selecionados, sem outra configuração, a captura de tela abaixo mostra o gráfico resultante:

Exibir um gráfico com uma métrica selecionada.

Esse gráfico contém mais dados do que a quantidade máxima permitida. Os gráficos estão limitados a 300 linhas para exibição. Nesse caso, ele mostrará um aviso de que há excesso de dados a serem exibidos e recomendará o uso do modo outlier. Esse modo é uma das opções da guia View options e reduz bastante o volume de dados a ser exibido.

No entanto, você também pode usar as outras opções de configuração de métricas para aumentar o gerenciamento do conjunto de dados. Essas 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 de usuário.

Como filtrar os dados

É possível reduzir o volume de dados retornados de uma métrica ao especificar critérios de filtro. Assim, somente séries temporais que atendam a algum conjunto de critérios serão usadas. Se você aplicar filtros, haverá menos linhas no gráfico, e isso pode melhorar o desempenho dele.

Você pode fornecer vários critérios de filtragem. O gráfico correspondente mostra apenas as séries temporais que atendem a todos os critérios, um AND lógico.

No Console do Google Cloud, para adicionar um filtro, clique no campo Filtrar. Isso abre um painel que contém listas de critérios que podem ser usados para a filtragem. Por exemplo, é possível filtrar por grupo de recursos, por nome, por rótulo de recurso, por zona e por rótulo de métrica.

A captura de tela abaixo mostra os rótulos de filtro conhecidos de um projeto:

Listas de rótulos de filtro preenchidos previamente

É possível selecionar das listas ou digitar para encontrar as correspondências. Além disso, você pode criar filtros para dados que ainda não apareceram. Esses critérios de filtro não aparecerão na lista de seleção, mas é possível especificar manualmente os filtros que você sabe que serão válidos no futuro.

Depois de escolher um rótulo para filtrar, especifique o restante do filtro: um valor ou intervalo de valores e uma comparação.

Por exemplo, veja na captura de tela a seguir um filtro no rótulo de recurso zone. O campo Filtro é compatível com um par de operadores de comparação para igualdade, = e =~, e um para desigualdade, != e !=~. O segundo item em cada par recebe uma expressão regular como um valor. O padrão é o operador de igualdade simples, =.

Comparadores de filtro

Abaixo da lista de operadores de comparação, há uma lista dos valores disponíveis. A captura de tela a seguir mostra os nomes das zonas no projeto:

Alguns valores de filtro preenchidos previamente

Para o campo Valor, é possível selecionar um dos itens na lista suspensa ou inserir uma expressão que corresponda a vários itens:

  • Se você usar uma comparação direta, = ou !=, crie uma string de filtro como starts_with. Por exemplo, a string de filtro starts_with("us-central") corresponde a qualquer zona us-central:

    Como usar uma string de filtro

    Consulte Como monitorar filtros para saber mais sobre strings de filtros.

  • Se você selecionar =~ ou !=~, poderá usar uma expressão regular RE2 no valor. Por exemplo, a expressão regular us-central1-.* corresponde a qualquer zona us-central1:

    Como filtrar com regexps

    A expressão regular ^us.*.a$ corresponde a qualquer zona dos EUA que termine com “a”:

    Como filtrar com mais regexps

É possível especificar vários critérios de filtro e usar o mesmo rótulo várias vezes. Isso permite que você especifique um filtro para um intervalo de valores. Para adicionar mais filtros, clique na opção Adicionar um filtro próxima à parte inferior do campo de filtro. Atualmente, todos os critérios de filtro precisam ser atendidos. Eles constituem um AND lógico. Por exemplo, use as strings de filtro starts_with e ends_with para mostrar apenas as zonas “a” nos EUA:

Como usar vários filtros

Com um filtro zone="starts_with("asia-east1")" ou zone=~"asia-east1.*" ativado, somente a série temporal com dados de uma das zonas asia-east1 é exibida:

Como exibir uma série temporal filtrada.

Como escolher a exibição dos dados

Veja na seção como exibir os dados selecionados configurando os campos de agregação. A agregação consiste no alinhamento de pontos de dados e na combinação de diferentes séries temporais. Para uma explicação detalhada sobre agregação, consulte Filtragem e agregação: como manipular séries temporais.

Agrupamento

É possível reduzir a quantidade de dados retornados para uma métrica combinando diferentes séries temporais. Para combinar várias séries temporais, você geralmente especifica um agrupamento e uma função. O agrupamento é feito com base nos rótulos. A função, chamada de Agregador no Console do Google Cloud, é usada para combinar as séries temporais do grupo em uma única série temporal. Os agregadores típicos incluem os valores de desvio médio, máximo, mínimo e padrão e também percentis variados.

Para adicionar um agrupamento, clique em Adicionar um rótulo na caixa de texto Agrupar por e, em seguida, faça uma seleção no menu. O menu é criado dinamicamente e exibe os rótulos disponíveis. Esses são os mesmos rótulos que podem ser usados para filtragem. Quando você adiciona a primeira opção de agrupamento, acontece o seguinte:

  • Um agregador é selecionado. A função selecionada é determinada pelo tipo de dado que está sendo exibido. No entanto, essa função pode ser alterada.
  • O agregador combina todas as séries temporais que têm o mesmo valor de rótulo em uma única série temporal.
  • O gráfico exibe uma série temporal para cada valor do rótulo "agrupar por".

A captura de tela a seguir mostra um agrupamento por user_labels.version com o Agregador definido como o valor padrão de sum:

Exemplo de configuração de agrupamento.

Essa seleção resulta em uma série temporal para cada valor de user_labels.version. Os pontos de dados em cada série temporal são calculados a partir da soma de todos os valores de séries temporais individuais para uma versão específica:

Exibição de séries temporais agrupadas por user_labels.version

Agrupe por vários rótulos. Quando você tem várias opções de agrupamento, as séries temporais são agrupadas pela combinação de valores dos rótulos e o agregador é aplicado a cada grupo. O gráfico resultante exibe uma série temporal para cada combinação de valores dos rótulos. A ordem de especificação dos rótulos não importa.

Por exemplo, a captura de tela a seguir ilustra o agrupamento por user_labels.version e system_labels.machine_image:

Como exibir séries temporais agrupadas por versão e imagem da máquina.

Conforme ilustrado, se agrupar por rótulos, você terá uma série temporal para cada par de valores. O fato de você ter uma série temporal para cada combinação de rótulos significa que essa técnica pode facilmente criar mais dados do que é possível colocar em um único gráfico.

Se você não especificar uma opção de agrupamento e especificar um agregador, o agregador será aplicado a todas as séries temporais selecionadas e resultará em uma única série temporal. Esse comportamento é ilustrado na captura de tela a seguir:

Exibição das séries temporais agregadas por soma, mas sem agrupamento

Quando você especifica o agrupamento ou se seleciona um agregador, a série temporal resultante contém apenas os rótulos obrigatórios, como o identificador do projeto e os rótulos especificados pelo agrupamento.

Como remover condições de agrupamento

Para remover uma condição de "Group By", siga estas etapas:

  1. Exclua os rótulos de "Group By".
  2. Defina o agregador como none.

Alinhamento

O alinhamento é o processo de conversão de dados de séries temporais recebidos pelo Monitoring em uma nova série temporal que tem pontos de dados em intervalos fixos. O processo de alinhamento consiste em coletar todos os pontos de dados recebidos em um período fixo, aplicar uma função para combinar esses pontos de dados e atribuir um carimbo de data/hora ao resultado. Essa função de combinação pode calcular a média de todas as amostras ou extrair o máximo de todas as amostras.

Ao criar um gráfico usando o Console do Google Cloud, depois de selecionar a métrica e o tipo de recurso, são exibidos vários campos adicionais e um botão intitulado Mostrar opções avançadas:

Exibição do campo Período.

Período: o valor desse campo é o intervalo mínimo de tempo a ser usado no alinhamento dos dados de séries temporais. Por exemplo, se o gráfico estiver configurado para exibir 1 hora de dados e o Período estiver definido como 10 minutes, o gráfico conterá 6 pontos de dados. No entanto, se você configurar o gráfico para exibir 1 semana de dados, o período será automaticamente configurado como 1 hora. A configuração padrão desse campo é um minuto.

Para visualizar as opções de agregação restantes, clique em Mostrar opções avançadas:

Exibição das opções avançadas.

Alinhador: o campo Alinhador especifica a função usada para combinar todos os pontos de dados em um período de alinhamento. Para mais informações sobre os alinhadores disponíveis, consulte Aligner na referência da API.

A captura de tela a seguir ilustra a utilização da CPU das instâncias de VM do Compute Engine em um projeto específico do Google Cloud. Nesta imagem, os campos de alinhamento estão nos valores padrão: o Alinhador é definido como mean e o Período é definido como 1 minute:

Utilização da CPU de instâncias de VM usando configurações de alinhamento padrão.

Para fins de comparação, a captura de tela a seguir ilustra o efeito da alteração do período de 1 minute para 5 minutes:

Utilização da CPU de instâncias de VM usando o padrão com um período de alinhamento de 5 minutos

Ao aumentar o período, o gráfico resultante tem menos pontos de dados, e o número e a altura dos picos foram reduzidos.

Agregação secundária

Quando você tem várias séries temporais que já representam agregações, como os exemplos que ilustram a opção Group By, é possível agregá-los escolhendo um Secondary Aggregator:

Campo para agregação secundária

A agregação secundária reduz todas as séries temporais no gráfico a uma única série temporal.

Veja na captura de tela a seguir várias séries temporais resultantes do agrupamento de um conjunto filtrado de dados. O uso do agrupamento requer agregação: cada grupo de linhas é agregado em uma. Veja na captura de tela a seguir séries temporais agrupadas por zona:

Como exibir uma série temporal filtrada que é agrupada por zona.

Veja na captura de tela a seguir o resultado do uso da agregação secundária para encontrar o valor médio na série temporal agrupada:

Como exibir uma agregação secundária aplicada ao exemplo anterior.

A seguir