Como selecionar métricas usando o Metrics Explorer

O Metrics Explorer é uma ferramenta de gráficos independente que permite criar gráficos para qualquer métrica (numérica) coletada pelo projeto. Nesta página, descrevemos como configurar o Metrics Explorer usando a guia Configuração. Se você usa a linguagem de consulta de monitoramento (MQL, na sigla em inglês), os conceitos desta página são aplicados. No entanto, você precisa usar a sintaxe definida na Introdução à linguagem de consulta de monitoramento (MQL, na sigla em inglês).

Para informações sobre como configurar o estilo de um gráfico, consulte Como configurar opções de exibição.

Selecionar os dados a serem exibidos

Para especificar as métricas a serem exibidas ao usar o Metrics Explorer, especifique os valores de uma métrica e um tipo de recurso:

  • O campo metric identifica as medidas a serem coletadas de um recurso monitorado. Ele inclui uma descrição do que está sendo medido e como as medições são interpretadas. Métrica é uma forma abreviada de tipo de métrica. Para informações conceituais, consulte Tipos de métricas.

  • O campo type type especifica de qual recurso os dados de métricas são capturados. ostipo de recurso às vezes é chamado detipo de recurso monitorado ou orecurso de dados. 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

Os campos Tipo de recurso e Métrica determinam a métrica no gráfico. Esses campos podem ser preenchidos em qualquer ordem, e ambos permitem inserir valores ou selecionar entradas no menu:

  • Para reduzir o número de opções exibidas em um menu, insira um valor na barra de filtro. Por exemplo, se você inserir cpu, o menu só listará as entradas que incluem cpu. Um teste indiferente a maiúsculas é usado para determinar se uma entrada está listada.

  • Para mais informações sobre uma entrada, coloque o ponteiro na entrada para ativar a dica.

  • Para inserir um filtro de monitoramento, consulte Modo de filtro direto.

Depois que o tipo de recurso e a métrica são selecionados, o gráfico mostra todas as séries temporais disponíveis para esse par. A captura de tela a seguir mostra um gráfico após a seleção do tipo de recurso e da métrica.

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

Este gráfico contém mais dados que podem ser exibidos, limitados a 300 linhas. O gráfico fornece um aviso de que há muitos dados para exibir e sugere usar o modo outlier, o que reduz significativamente a quantidade de dados a serem exibidos. Para acessar os controles do modo outlier, clique em Configurações. Para mais informações, consulte Como definir opções de visualização.

Também é possível usar as opções de filtragem e agregação para reduzir a quantidade de dados em gráficos. 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.

Modo de filtro direto

O modo de filtro direto permite inserir uma expressão que o Monitoring usa para identificar a série temporal a ser monitorada. As expressões inseridas no modo de filtro direto às vezes são chamadas de filtros de métricas ou filtros de monitoramento. Veja a seguir uma expressão que faz com que o Monitoring exiba as entradas de registro para todas as instâncias de máquina virtual do Google Cloud na zona us-east1-b:

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

Esse modo é útil quando você quer identificar a sintaxe adequada para uma chamada de API ou verificar se um filtro do Monitoring está formatado corretamente. Ele também é útil quando você quer criar um gráfico dos dados que o recurso e o modelo de métrica não representam. Por exemplo, a expressão a seguir resulta em um gráfico que exibe uma contagem de processos cujo nome inclui nginx:

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

Para informações de sintaxe, consulte Filtros de integridade do processo e Como recuperar dados do SLO (em inglês). Para informações gerais, consulte Filtros de Monitoring.

Para inserir um filtro do Monitoring, faça o seguinte:

  1. Expanda o menu Tipo de recurso e selecione Modo de filtro direto.
  2. Insira uma expressão de filtro do Monitoring na caixa de texto.

    A caixa de texto é preenchida com o tipo de recurso, a métrica e a configuração de filtro que você fez antes de alterar para o Modo de filtro direto.

    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 timeframe.

Para retornar à interface orientada a menus, clique em Modo padrão.

Filtrar dados gráficos

É possível reduzir a quantidade de dados a serem representados. Para isso, especifique os critérios de filtro, aplique a agregação ou use o modo de valores atípicos. Os filtros garantem que somente séries temporais que atendam a algum conjunto de critérios sejam usadas. Se você aplicar filtros, haverá menos linhas no gráfico e isso poderá melhorar o desempenho dele.

Se você fornecer vários critérios de filtragem, o gráfico correspondente mostrará apenas as séries temporais que atendem a todos os critérios, um AND lógico. Normalmente, é possível filtrar por grupo de recursos, por nome, por rótulo de recurso, por zona e por rótulo de métrica.

Para adicionar um filtro ao usar a guia MQL, use o Editor de consultas para especificar o filtro.

Para adicionar um filtro quando você usar a guia Configuração, clique em Adicionar filtro e especifique o rótulo do filtro, a comparação e o valor ou intervalo. :

  1. Clique em Rótulo e selecione uma entrada no menu.

    Para encontrar um rótulo específico, use a barra de rolagem ou insira o texto na área de texto Filtrar . Quando você inserir texto, o menu listará apenas as entradas que contêm o texto inserido.

    A captura de tela a seguir mostra os rótulos de filtro conhecidos de uma métrica específica:

    Exemplo de uma lista de rótulos de filtro.

  2. Clique em Comparação e selecione uma entrada no menu. Você pode escolher entre quatro operadores: igual, =, não igual, !=, expressão regular corresponde, =~, e expressão regular não corresponde, !=~:

    Lista de comparadores de filtros.

  3. Clique em Valor e siga um destes procedimentos:

    • Se você selecionou uma comparação direta, = ou !=, selecione o menu ou insira um valor e clique em Concluído. Os valores inseridos podem ser simples, como us-central1-a, ou você pode criar uma string de filtro que comece com starts_with ou ends_with. Por exemplo, para exibir dados de qualquer zona us-central1, insira a string de filtro starts_with("us-central1"). Consulte Filtros de monitoramento para mais informações sobre strings de filtro.

      Como as entradas de menu são derivadas da série temporal recebida, se um recurso monitorado não estiver gerando dados para a métrica selecionada, insira um valor para o rótulo.

      A captura de tela a seguir mostra o menu de valor que é exibido para um projeto específico quando o rótulo de recurso zone é selecionado:

      Exemplo de uma lista de rótulos de filtro.

    • Se você selecionou uma comparação de expressão regular, =~ ou !=~, insira uma expressão regular RE2 no campo Valor e clique em Concluído. 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", use a expressão regular ^us.*.a$.

      Não é possível usar expressões regulares para filtrar o rótulo de recurso project_id.

      Por exemplo, se você quiser visualizar somente a série temporal em uma das zonas us-central1, aplique um filtro zone="starts_with("us-central1")" ou zone=~"us-central1.*":

      Como exibir uma série temporal filtrada.

(em inglês)

É possível especificar vários critérios de filtro e usar o mesmo rótulo várias vezes. Esses recursos permitem especificar um filtro para um intervalo de valores. Todos os critérios de filtro precisam ser atendidos. eles constituem um AND lógico. Por exemplo, a seguinte configuração pode ser usada nas strings de filtro starts_with e ends_with para mostrar apenas as zonas "a” nos EUA:

Exemplo usando vários filtros.

Escolha como exibir os dados gráficos

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 em uma série temporal 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.

Série temporal do grupo

É 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 por valores de rótulo. A função define como todos os dados de série temporal em um grupo são combinados em uma nova série temporal.

Para adicionar um agrupamento, clique no texto da caixa de texto Agrupar por e faça uma seleção no menu. O menu é construído dinamicamente com base nos dados de série temporal do recurso e da métrica selecionada. Agrupar e filtrar usam o mesmo conjunto de rótulos.

Quando você adiciona o primeiro rótulo, ocorre o seguinte:

  • Um agregador é selecionado. O tipo de dados que está sendo exibido determina o agregador padrão; No entanto, é possível alterar essa função.
  • O agregador determina como as séries temporais que têm o mesmo valor do rótulo são combinadas em uma única série temporal.
  • O gráfico exibe uma série temporal para cada valor do rótulo listado na caixa de texto Agrupar por.

Se você agrupar por vários rótulos, o agregador combinará as séries temporais que têm o mesmo valor para os rótulos especificados.

Se você não especificar uma opção de agrupamento e especificar um agregador, essa função será aplicada a todas as séries temporais selecionadas e resultará em uma única série temporal.

Por exemplo, se o campo Agrupar por estiver definido como user_labels.version e o agregador estiver definido como sum, haverá uma série temporal para cada valor: etiqueta 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, o agregador é aplicado ao conjunto de séries temporais que têm os mesmos valores dos rótulos selecionados.

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.

Quando você especifica o agrupamento ou seleciona um agregador, a série temporal representada em gráfico contém apenas os rótulos necessários, como o identificador do projeto e os especificados pelo agrupamento.

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.

Alinhar série temporal

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 pode calcular a média de todas as amostras ou extrair o máximo de todas as amostras.

O período de alinhamento especifica o intervalo mínimo a ser usado ao alinhar os dados da série temporal. Quando há muitos pontos de dados para traçar no período de exibição selecionado, o período de alinhamento é aumentado automaticamente para que cada ponto de dados seja representado. A configuração padrão desse campo é um minuto.

Por exemplo, considere uma métrica com um período de amostragem de um minuto. Se um gráfico for configurado para exibir uma hora de dados, ele poderá exibir todos os 60 pontos de dados. Se o período de alinhamento estiver definido como 10 minutes, o gráfico exibirá seis pontos de dados. No entanto, se você configurar o gráfico para exibir uma semana de dados, haverá muitos pontos para exibir no gráfico, então o período será modificado automaticamente. Nesse exemplo, o período de alinhamento modificado é de uma hora.

O campo Alinhador especifica a função usada para combinar todos os pontos de dados em um período de alinhamento. A maioria dos alinhadores realiza funções matemáticas comuns. Por exemplo, se você selecionar mín., o ponto de dados alinhado será o mínimo de todos os pontos de dados no período de alinhamento. Alguns alinhadores executam ações mais complicadas:

  • Próximo período: para manter apenas a amostra mais recente em um período de alinhamento, use o alinhador mais antigo. Esse alinhador costuma ser usado com verificações de tempo de atividade e é uma boa escolha quando você se preocupa apenas com o valor mais recente.

    Esse alinhador é válido somente para métricas de medidor.

  • percentile: para exibir uma métrica de distribuição em um tipo de gráfico de linha, gráfico de área empilhadas ou gráfico de barras empilhadas, você precisa selecionar qual percentil na distribuição será exibida. Uma maneira de especificar esse percentil é selecionar um alinhador de percentil. É possível selecionar os 5º, 50º, 95º e 99º percentis. O ponto de dados alinhado é determinado pelo cálculo do percentil especificado usando todos os pontos de dados no período de alinhamento.

    Esse alinhador é válido apenas para as métricas de medidor e delta quando elas têm um tipo de dados de distribuição.

  • delta: para converter uma métrica cumulativa ou uma métrica delta em uma métrica delta com uma amostra por período de alinhamento, use esse alinhador. Esse alinhador pode resultar em interpolação de dados. Para ver um exemplo, consulte Tipos, tipos e conversões.

    Esse alinhador é válido somente para métricas cumulativas e delta.

  • rate: para converter uma métrica cumulativa ou delta em uma métrica de medidor, use esse alinhador. Se você escolher esse alinhador, poderá pensar na série temporal que está sendo transformada como se fosse com um alinhador delta e, em seguida, dividida pelo período de alinhamento. Por exemplo, se a unidade da série temporal original for MiB e a unidade do período de alinhamento for segundo, o gráfico terá uma unidade de MiB/segundo. Para mais informações, consulte Tipos, tipos e conversões.

    Esse alinhador é válido somente para métricas cumulativas e delta.

Para mais informações sobre os alinhadores disponíveis, consulte Aligner na referência da API.

Para visualizar ou modificar a função de alinhamento, clique em Mostrar opções avançadas.

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: a função de alinhamento está definida como mean e o período de alinhamento é 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, diminuindo de 60 pontos por série temporal para 10 pontos por série temporal. Cada ponto no gráfico é calculado calculando a média dos pontos da série temporal em um período de alinhamento. Ao aumentar o período de alinhamento, mais pontos são calculados em média, o que causa um efeito de suavização nos dados representados.

Agregação secundária

Quando você tem várias séries temporais que já representam agregações, é possível reduzir todas as séries temporais no gráfico para uma única série temporal escolhendo um Agregador secundário. Por exemplo, se você agrupar os dados por zona, o gráfico mostrará uma série temporal para cada zona. Para criar um gráfico com uma única série temporal, use os campos de agregação secundários.

Para visualizar ou modificar as configurações de agregação secundárias, clique em Mostrar opções avançadas.

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.

Modelo de legenda

O campo Modelo de legenda permite personalizar uma descrição para a série temporal no seu gráfico. Essas descrições aparecem no cartão de informações e na legenda do gráfico na coluna Nome. Por padrão, as descrições na legenda são criadas para você a partir dos valores de diferentes rótulos na série temporal. Como o sistema seleciona os rótulos, os resultados podem não ser úteis para você. Você pode usar este campo para criar um modelo para as descrições.

Para acessar o modelo de legenda de um gráfico, no Console do Cloud, selecione a guia Avançado no painel de configuração do gráfico. O modelo de legenda está listado no cabeçalho Outras opções.

É possível inserir texto simples e modelos no campo Modelo de legenda. Ao adicionar um modelo, você adiciona uma expressão que é avaliada quando a legenda é exibida.

Para adicionar um modelo, siga estas instruções:

  • Clique em Inserir um modelo.
  • Selecione uma entrada no menu. Depois de selecionar uma entrada, um modelo será adicionado automaticamente. Por exemplo, se você selecionar response_code, o modelo ${resource.labels.zone} será adicionado.

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

Um modelo para uma descrição simples

Na legenda do gráfico, os valores gerados a partir do modelo aparecem em uma coluna com o cabeçalho Nome e no cartão de informações:

Descrições geradas a partir de um modelo

É possível configurar o modelo de legenda para incluir várias strings e modelos de texto. No entanto, o espaço de exibição disponível no cartão de informações é limitado.

A seguir