Como selecionar dados para o gráfico

Nesta página, você verá como especificar quais dados são exibidos em um gráfico. Para informações sobre como configurar o estilo de um gráfico, consulte Como definir opções de visualização.

Selecionar os dados a serem exibidos

Para preencher o gráfico, especifique pelo menos um par de valores:

  • 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

Quando você arrasta um widget da Biblioteca de widgets para a área do gráfico, um gráfico é exibido com um tipo de recurso e uma métrica pré-selecionados:

Exemplo de um gráfico de linha criado recentemente

Há várias maneiras de especificar os dados do gráfico:

  • Para configurar rapidamente um gráfico, use o modo Básico. Essa opção tem opções de configuração mínimas. Uma configuração básica sempre pode ser representada nos outros modos. Veja mais detalhes em Como usar o modo Básico ou Avançado.

  • Para acessar todos os campos de configuração do gráfico, use o modo Avançado. Ele fornece acesso à maioria dos campos de agregação. Veja mais detalhes em Como usar o modo Básico ou Avançado.

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

  • Para configurar um gráfico usando uma linguagem de consulta, use o modo MQL. Com esse modo, você tem acesso ao editor de consultas. Se você usar o MQL, essa configuração não poderá ser representada pelos outros modos. Para informações sobre o MQL, consulte Introdução ao MQL.

Usar o modo Básico ou Avançado

O menu Tipo de recurso lista todos os recursos monitorados para dados de métricas. O menu Métrica é determinado pela seleção do Tipo de recurso.

  • Para encontrar uma entrada específica em um menu, use a barra de rolagem ou insira o texto na área Filtro do menu. Quando você insere texto, as entradas do menu são limitadas àquelas que incluem o texto inserido.

    Veja na captura de tela a seguir o menu expandido do campo Métrica. A barra de filtro contém o texto lat. Portanto, esse menu lista apenas entradas que incluem essa string:

    Exibição da barra de filtros de métricas.

    Na captura de tela anterior, a métrica Late Boot Validation é destacada. Quando o ponteiro é posicionado sobre uma entrada, um painel é aberto e exibe informações detalhadas sobre essa métrica. Conforme ilustrado, esse painel lista, entre outras coisas, o tipo de métrica, o tipo de valor e o campo de descrição.

Se você quiser acessar um tipo de recurso ou métrica que ainda não tem dados, altere o comportamento padrão:

  • Para selecionar qualquer tipo de recurso, expanda o menu Tipo de recurso e desmarque a opção Mostrar apenas ativo.

  • Para visualizar todas as métricas do tipo de recurso selecionado, mesmo aquelas que não têm dados, expanda o menu Métrica e desmarque a opção Exibir apenas como ativas.

  • Para selecionar qualquer métrica, clique em Fechar no menu Tipo de recurso e localize a entrada de interesse. de dados. Ao clicar em "Fechar", o menu Métrica inclui todas as métricas.

  • Para visualizar ou editar o tipo de recurso, a métrica e as configurações de filtro usadas pela API Cloud Monitoring, no menu Tipo de recurso, clique em Modo de filtro direto }

Como usar o modo de filtro direto

Use o modo de filtro direto quando tiver interesse em gerar gráficos com qualquer um dos seguintes itens:

  • Um objetivo de nível de serviço (SLO).
  • A contagem de processos em execução em máquinas virtuais (VMs).
  • Uma métrica personalizada para a qual você ainda não tem dados.

Ao usar o modo de filtro direto, insira um filtro do Monitoring que especifique a série temporal a ser representada no gráfico. O filtro "Monitoramento" a seguir resulta no gráfico que exibe as entradas de registro de 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"

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

  1. Selecione o modo Básico ou Avançado.
  2. No menu Tipo de recurso, clique em Modo de filtro direto.

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.

Se você selecionar o modo MQL, use o Editor de consultas para especificar o filtro.

Para adicionar um filtro ao selecionar o modo Básico ou Avançado, clique em Adicionar filtro e especifique o rótulo do filtro. a comparação e o valor ou intervalo de valores:

  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.

É 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

Após a seleção dos dados de séries temporais, o próximo passo é determinar como esses dados são exibidos. Por exemplo, você quer exibir cada série temporal ou quer combinar essas séries?

Para especificar como os dados são exibidos, configure as opções de agregação. A agregação consiste no alinhamento de dados de séries temporais e na combinação de diferentes séries desse tipo. A combinação de séries temporais é opcional.

Para uma explicação detalhada sobre agregação, consulte Filtragem e agregação: como manipular séries temporais.

Alinhar dados

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 Função de alinhamento 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 mais antigo: para reter apenas a amostra mais recente em um período de alinhamento, use o alinhador próximos mais antigos. 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 acessar os campos de alinhamento, faça o seguinte:

  • Modo Básico: todos os campos de alinhamento são pré-configurados.

  • Modo Avançado: todas as opções de alinhamento ficam acessíveis depois que você seleciona o tipo de recurso e a métrica. Os valores padrão dos campos são fornecidos. No entanto, é possível modificar as seleções.

  • Modo MQL: todas as opções de alinhamento estão disponíveis.

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, a média de mais pontos é calculada em conjunto, o que causa um efeito de suavização nos dados representados.

Combinar série temporal

É 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 agrupar e combinar séries temporais, siga um destes procedimentos:

  • Modo Básico:

    1. Determinar como agrupar séries temporais:

      • Para exibir todas as séries temporais, deixe a opção Agrupado clara.
      • Para agrupar séries temporais por valores de rótulo, selecione Agrupados e use o menu Agrupar por para selecionar os rótulos para agrupamento. Depois de fazer as seleções, clique em OK.
    2. Determinar como combinar pontos de dados:

      • Se os botões de opção listarem somente percentis, significa que você selecionou uma métrica que tem um valor de distribuição. Use os botões de opção para selecionar o percentil da distribuição que será visualizado.

      • Se os botões de opção listarem mean, min e max, significa que você selecionou uma métrica com um valor numérico. Use esses botões para especificar como os pontos de dados são combinados como parte do processo de geração de gráficos. Para entender como esses combinados funcionam, suponha que um gráfico possa exibir 60 pontos de dados e presumir que a taxa de dados é de um ponto por minuto. Se você exibir uma hora de dados, o gráfico poderá exibir todos os pontos. No entanto, se você quiser exibir três horas de dados, será necessário reduzir 180 pontos de dados a 60, que é o número de pontos que o gráfico pode exibir. Uma forma de reduzir os dados é fazer a média de três amostras adjacentes, outra é considerar o mínimo.

  • Modo Avançado:

    • Para combinar todos os dados de série temporal em uma única série temporal, verifique se a opção Agrupar por está vazia e selecione como as séries temporais são combinadas. Para isso, use o método Agrupar por função.

    • Para exibir todos os dados de séries temporais, siga um destes procedimentos:

      • Verifique se a opção Agrupar por está vazia e selecione none para Agrupar por função.
      • Clique no menu Agrupar por, selecione Adicionar tudo e selecione um Agrupar por função. Para métricas que armazenam um valor numérico, a escolha da função de agrupamento pode não produzir um gráfico visivelmente diferente.
    • Para agrupar séries temporais por valores de rótulo específicos, clique em Agrupar por e selecione os rótulos para agrupamento. Para especificar como a série temporal é combinada, selecione uma função usando o menu Agrupar por função.

  • Modo MQL:

    Para informações sobre como monitorar a linguagem, consulte Como usar o Editor de consultas.

A captura de tela a seguir mostra um agrupamento por user_labels.version com a função de agrupamento definida como o valor padrão de sum. 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, a função "agrupar por" é aplicada 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 uma função de agrupamento, a série temporal mapeada contém apenas rótulos obrigatórios, como o identificador do projeto e os rótulos especificados pelo agrupamento.

Remover condições de agrupamento

Para remover todas as condições de agrupamento por, siga um destes procedimentos:

  • Modo Básico: desmarque Agrupados.

  • Modo Avançado: faça o seguinte:

    1. No menu Agrupar por, clique em Remover tudo e em OK.
    2. No menu Agrupar por função, selecione none.
  • Modo MQL: exclui os comandos de agrupamento.

    Para informações sobre como monitorar a linguagem, consulte Como usar o Editor de consultas.

Agregação secundária

A guia selecionada determina as opções de agregação:

  • Modos básicos e avançados: o editor do painel determina como mapear as seleções de agregação para os campos principal e secundário de agregação especificados pelo Cloud Monitoring. API usando as seguintes informações:

    • Tipo de widget
    • Tipo de métrica
    • Tipo de valor da métrica
    • Qual modo está sendo usado para configurar o widget

    Para determinar esse mapeamento para gráficos em painéis personalizados, é possível recuperar a configuração do painel usando a ferramenta de linha de comando gcloud. Para mais informações, consulte Como listar painéis.

  • Modo MQL: esses campos podem ser acessados.

A seguir