Selecionar métricas para gráficos em painéis

Neste documento, descrevemos como configurar um gráfico em um painel personalizado para exibir dados de série temporal coletados pelo projeto. Os gráficos só podem exibir dados numéricos de série temporal. Para mais informações sobre como configurar o estilo de um gráfico, consulte Definir opções de exibição do gráfico.

Selecionar os dados a serem exibidos

Para configurar quais série temporal exibir em um gráfico, crie uma consulta selecionando menus ou escreva uma consulta. Ao escrever uma consulta, você seleciona a linguagem de consulta e usa um editor de consultas ou uma interface baseada em texto:

  • As consultas da linguagem de consulta do Monitoring (MQL, na sigla em inglês) especificam as série temporal e como elas são agrupadas e alinhadas. A interface do MQL oferece suporte a um editor de código com sugestões e verificação de sintaxe.

    Geralmente, não é possível converter consultas MQL em formulários que possam ser usados por outras interfaces. As consultas não salvas são descartadas quando você muda de ou para a guia MQL.

  • As consultas da Linguagem de consulta do Prometheus (PromQL, na sigla em inglês) especificam série temporal e como elas são agrupadas e alinhadas. A interface do PromQL oferece suporte a um editor com sugestões.

    Geralmente, não é possível converter consultas do PromQL em formulários que podem ser usados por outras interfaces. As consultas não salvas são descartadas quando você muda de ou para a guia PromQL.

  • As consultas do filtro de monitoramento especificam a série temporal, mas não incluem instruções de agrupamento ou alinhamento.

    É possível especificar qualquer série temporal que o Monitoring possa traçar usando um filtro. Por exemplo, para criar um gráfico com o número de processos em execução em uma VM, use um filtro do Monitoring que especifique uma função.

    Nem sempre é possível converter um filtro do Monitoring no formato exigido por outras interfaces. Portanto, sua consulta poderá ser descartada se você mudar para uma interface diferente.

As consultas normalmente especificam um tipo de métrica, um tipo de recurso e filtros:

  • Um tipo de métrica identifica as medidas a serem coletadas de um recurso. Ele inclui uma descrição do que está sendo medido e como as medições são interpretadas. Um tipo de métrica às vezes é chamado de métrica. Um exemplo de métrica é "Utilização da CPU". Para informações conceituais, consulte Tipos de métricas.

  • Um tipo de recurso especifica de qual recurso os dados da métrica são capturados. O tipo de recurso às vezes é chamado de tipo de recurso monitorado ou recurso. Um exemplo de recurso é uma "instância de máquina virtual (VM) do Compute Engine". Para informações conceituais, consulte Recursos monitorados.

As consultas MQL e PromQL incluem instruções de agrupamento e alinhamento. No entanto, ao gravar um filtro do Monitoring ou usar menus para selecionar a série temporal no gráfico, você define as configurações de agrupamento e alinhamento usando menus.

Criar consultas usando menus

A criação de consultas usando menus é a configuração padrão. Normalmente, se você selecionar uma métrica e um filtro e, em seguida, alternar para uma interface diferente, suas seleções serão preservadas e reformatadas para essa interface. Ou seja, uma consulta criada por menus pode ser convertida em uma consulta MQL.

Para retornar das outras interfaces para a interface orientada por menu, selecione Builder. No entanto, sua consulta será descartada. Ou seja, não é possível converter uma consulta MQL em um formulário equivalente baseado em menus.

Para criar sua consulta usando menus, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

    Acessar Painéis

  2. Escolha uma destas opções:

    • Para criar um novo painel, selecione Criar painel.
    • Para atualizar um painel existente, encontre-o na lista de painéis e selecione seu nome.
  3. Na barra de ferramentas, clique em  Adicionar widget.

  4. Na caixa de diálogo Adicionar widget, selecione  Métrica.

  5. 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 recursos que ajudam você a encontrar os tipos de métricas disponíveis:

      • Para encontrar um tipo de métrica específico, use a barra de filtros . Por exemplo, se você inserir util, o menu será restrito para mostrar entradas que incluem util. As entradas são mostradas quando passam em um teste "contains" que não diferencia maiúsculas de minúsculas.

      • Para mostrar todos os tipos de métrica, mesmo aqueles sem dados, clique em Ativa. Por padrão, os menus mostram apenas os tipos de métricas com dados.

    2. Selecione uma das opções nos menus Recursos, Categorias de métricas e Métricas e clique em Aplicar.

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

      O menu Recursos lista o recurso de onde os dados são coletados. Quando uma métrica não for gravada em um recurso, selecione Não especificado.

    Depois que você concluir a etapa anterior, o gráfico mostrará a série temporal disponível:

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

    O gráfico anterior contém mais dados do que é possível exibir. Os gráficos estão limitados a 50 linhas de exibição. O gráfico fornece um aviso de que há dados demais a serem exibidos. Para reduzir a quantidade de dados, use os campos no elemento Sort & limit. Para mais informações, consulte Mostrar outliers.

    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.

  6. Opcional: adicione filtros para restringir as série temporal que vão ser exibidas. A próxima seção descreve as opções de filtragem.

  7. Opcional: configure como as série temporal são agrupadas e alinhadas. Para mais informações, consulte Escolher como exibir dados nos gráficos.

  8. Para aplicar as mudanças ao painel, clique em Apply na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

Filtrar dados gráficos

Os filtros garantem que somente série temporal que atendam a algum conjunto de critérios sejam usadas no gráfico. Ao aplicar filtros, você reduz o número de linhas no gráfico, melhorando o desempenho dele. Outra maneira de melhorar a capacidade de resposta de um gráfico é configurar opções de agregação e classificar e limitar o número de série temporal que são exibidas. Para mais informações, consulte Mostrar outliers.

Um filtro é composto por um rótulo, um comparador e um valor. Por exemplo, para corresponder a todas as série temporal em que o rótulo zone começa com "us-central1", é possível usar o filtro zone=~"us-central1.*", que usa uma expressão regular para realizar a comparação. Há quatro operadores do comparador:

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

Ao filtrar pelo ID do projeto ou pelo contêiner do recurso, é necessário usar o operador de igualdade (=). Ao filtrar por outros rótulos, você pode usar qualquer comparador compatível. Normalmente, você pode filtrar rótulos de métricas e recursos e por grupo de recursos.

Quando você fornece vários critérios de filtragem, o gráfico correspondente mostra apenas as série temporal que atendem a todos os critérios, um lógico AND.

Para adicionar um filtro ao usar a interface orientada por menus do console do Google Cloud, faça o seguinte:

  1. No elemento Filter, clique em Add filter e selecione no menu.

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

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

    • Para uma comparação direta, = ou !=, selecione o valor no menu ou insira um valor e clique em Ok. Insira valores como us-central1-a ou crie uma string de filtro que comece com starts_with ou ends_with. Por exemplo, para exibir dados de qualquer zona us-central1, digite a string de filtro starts_with("us-central1"). Consulte Como monitorar filtros para mais informações sobre strings de filtro.

      Como as entradas do menu são derivadas da série temporal recebida, quando um recurso monitorado não está gerando dados para a métrica selecionada, é preciso inserir um valor para o rótulo.

    • Para uma comparação de expressões regulares, =~ ou !=~, insira uma expressão regular RE2 no campo Valor e clique em Ok. Por exemplo, a expressão regular us-central1-.* corresponde a qualquer zona 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, para visualizar apenas a série temporal de uma das zonas us-central1, aplique um filtro zone=~"us-central1.*".

Ao adicionar vários filtros, os seguintes pontos se aplicam:

  • É possível usar o mesmo rótulo várias vezes, o que permite especificar um filtro para um intervalo de valores.

  • Todos os critérios de filtro precisam ser atendidos; eles constituem um AND lógico.

Para editar o valor ou o comparador de um filtro, no elemento de filtro, clique em Menu, faça as mudanças e clique em Ok.

Para excluir um filtro, clique em Cancelar.

Criar consultas MQL

Para inserir uma consulta MQL ou PromQL, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

    Acessar Painéis

  2. Escolha uma destas opções:

    • Para criar um novo painel, selecione Criar painel.
    • Para atualizar um painel existente, encontre-o na lista de todos os painéis e selecione o nome dele.
  3. Na barra de ferramentas, clique em  Adicionar widget.

  4. Na caixa de diálogo Adicionar widget, selecione  Métrica.

  5. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.

  6. Verifique se MQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

  7. Opcional: desative o botão de alternância Execução automática.

  8. Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico com o uso da CPU das instâncias de VM no projeto do Google Cloud, use a seguinte consulta:

    fetch gce_instance
    | metric 'compute.googleapis.com/instance/cpu/utilization'
    | group_by 1m, [value_utilization_mean: mean(value.utilization)]
    | every 1m
    

    Para mais informações sobre o MQL, consulte os seguintes documentos:

  9. Clique em Executar consulta.

    Quando o botão Execução automática está ativado, o botão Executar consulta não é exibido.

Criar consultas PromQL

Para inserir uma consulta MQL ou PromQL, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

    Acessar Painéis

  2. Escolha uma destas opções:

    • Para criar um novo painel, selecione Criar painel.
    • Para atualizar um painel existente, encontre-o na lista de todos os painéis e selecione o nome dele.
  3. Na barra de ferramentas, clique em  Adicionar widget.

  4. Na caixa de diálogo Adicionar widget, selecione  Métrica.

  5. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.

  6. Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

  7. Opcional: desative o botão de alternância Execução automática.

  8. Insira sua 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 projeto do Google Cloud, use a seguinte consulta:

    avg(compute_googleapis_com:instance_cpu_utilization)
    

    Para mais informações sobre como usar PromQL, consulte PromQL no Cloud Monitoring.

  9. Clique em Executar consulta.

    Quando o botão Execução automática está ativado, o botão Executar consulta não é exibido.

Criar consultas com filtro de monitoramento

Quando você quiser realizar uma das seguintes ações, use o modo de filtro direto, que permite inserir um filtro do Monitoring:

  • Mostre um objetivo de nível de serviço (SLO).
  • Exibir a contagem de processos em execução em máquinas virtuais (VMs).
  • Exibir uma métrica personalizada para a qual você ainda não tem dados.
  • Filtre uma série temporal com base em um rótulo que ainda não tem dados.

Um filtro do Monitoring ou equivalente ao filtro de métrica é uma expressão que o Monitoring usa para identificar a série temporal do gráfico. Por exemplo, a expressão a seguir resulta em um gráfico exibindo uma contagem de processos cujo nome inclui nginx:

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

Também é possível usar filtros do Monitoring para identificar série temporal pelo tipo de recurso e métrica. A expressão a seguir resulta em um gráfico que exibe a contagem de 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"

Para inserir um filtro de Monitoramento, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Painéis:

    Acessar Painéis

  2. Escolha uma destas opções:

    • Para criar um novo painel, selecione Criar painel.
    • Para atualizar um painel existente, encontre-o na lista de painéis e selecione seu nome.
  3. Na barra de ferramentas, clique em  Adicionar widget.

  4. Na caixa de diálogo Adicionar widget, selecione  Métrica.

  5. Clique em Help no elemento Metric e, em seguida, selecione Modo de filtro direto.

    Os elementos Metric e Filter são excluídos, e um elemento Filters permite inserir texto, e é criado.

    Se você selecionou um tipo de recurso, uma métrica ou filtros antes de mudar para o modo Modo de filtro direto, essas configurações serão mostradas no elemento Filtros.

  6. Na área de texto do elemento Filters, insira uma expressão de filtro do Monitoring. Para informações sobre a sintaxe, consulte os seguintes documentos:

    Quando você usa o modo de filtro direto e não há dados disponíveis que satisfaçam o filtro, um erro será exibido. Mensagens de erro comuns incluem Chart definition invalid e No data is available for the selected timeframe.

  7. Opcional: configure como as série temporal são agrupadas e alinhadas. Para mais informações, consulte Escolher como exibir dados nos gráficos.

Para retornar à interface orientada por menu, clique em Sair do modo de filtro direto.

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?

Nesta seção, explicamos como definir 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.

O conteúdo desta seção não se aplica quando você seleciona os dados para o gráfico usando um MQL ou PromQL.

Combinar série temporal

É possível reduzir a quantidade de dados retornados para uma métrica combinando diferentes séries temporais. Para combinar diversas série temporal, costuma ser necessário especificar um ou mais rótulos e uma função. As séries temporais que têm o mesmo valor para todos os rótulos especificados são agrupadas e, em seguida, a função especificada combina essas séries temporais em uma nova série temporal.

As configurações no elemento Agregação podem alterar o número de série temporal exibidas pelo seu gráfico. As configurações padrão desse elemento são determinadas pelo tipo de métrica selecionado. Para modificar a exibição, siga um destes procedimentos:

  • Para exibir todas as série temporal, no elemento Agregação, verifique se o primeiro menu está definido como Não agregado e o segundo como Nenhum.

  • Para combinar série temporal, faça o seguinte no elemento Agregação:

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

      O gráfico é atualizado e mostra uma única série temporal. Por exemplo, se você selecionar Média, a série temporal exibida será a média de todas as séries temporais.

    2. Para combinar série temporal com os mesmos valores de rótulo, expanda o segundo menu e selecione um ou mais rótulos.

      O gráfico é atualizado e mostra uma série temporal para cada combinação exclusiva de valores de rótulo. Por exemplo, para exibir em série temporal por zona, defina o segundo menu como zone.

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

Por exemplo, se você definir a função como Sum e selecionar o rótulo user_labels.version, haverá uma série temporal para cada valor do rótulo 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 de uma versão específica:

Mostrando série temporal agrupadas por user_labels.version.

Quando você seleciona vários rótulos, as série temporal que têm os mesmos valores para os rótulos selecionados são combinadas. 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. A captura de tela a seguir mostra um gráfico em que as série temporal são combinadas pelos rótulos user_labels.version e system_labels.machine_image:

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

Como mostrado, o gráfico mostra uma série temporal para cada par de valores de rótulo. Como você tem uma série temporal para cada combinação de rótulos, essa técnica pode criar mais dados do que é possível colocar em um único gráfico.

Mostrar todas série temporal

Para mostrar todas série temporal, no elemento Agregação, defina o primeiro menu como Não agregado e o segundo como Nenhum.

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.

Definir intervalo de alinhamento

Para especificar o período fixo de combinação dos pontos, clique em Adicionar elemento de consulta no painel de consultas, selecione Intervalo mínimo e preencha a caixa de diálogo.

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 campo Intervalo mínimo for definido como 10 minutes, o gráfico exibirá seis pontos de dados. No entanto, ao configurar o gráfico para exibir uma semana de dados, há muitos pontos a serem exibidos. Portanto, o intervalo em que os pontos são combinados será modificado automaticamente. Neste exemplo, o intervalo modificado é de uma hora.

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, o campo Intervalo mínimo está 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 intervalo de 1 minute para 5 minutes:

Uso 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. Ao aumentar o campo Intervalo mínimo, mais pontos são combinados, o que tem um efeito de suavização nos dados representados.

Definir função de alinhamento

Quando você seleciona a função de agregação, o Cloud Monitoring seleciona a função de alinhamento para você. 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, é possível 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 alinher. Os elementos Função de alinhamento e Agrupamento são adicionados.
  2. Expanda o elemento Alignment function e faça uma seleção.

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

  • próximo mais antigo: para manter apenas a amostra mais recente em um período de alinhamento, selecione próximo mais antigo. Geralmente, essa função é usada com verificações de tempo de atividade e é uma boa opção quando você só precisa se preocupar com o valor mais recente.

    Esta função é válida apenas 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 uma função 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.

    Esta função é válida apenas para 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 esta função. Pode ocorrer interpolação de dados quando você usa essa função. Para ver um exemplo, consulte Tipos, tipos e conversões.

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

  • rate: use essa função para converter uma métrica cumulativa ou delta em uma métrica de medidor. Se você escolher essa função, poderá pensar na transformação da série temporal como ocorreu com uma função 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 a segunda, o gráfico terá uma unidade de MiB por segundo. Para mais informações, consulte Tipos, tipos e conversões.

    Esta função é válida apenas 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.

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 alguns tipos de métricas, você tem a opção de transformar os dados. Se essa opção estiver disponível e você definir o campo Transform com um valor diferente de None, todos os outros campos serão as configurações de agregação secundárias.

Quando os campos de agregação secundários são configuráveis, para acessar esses campos, é possível:

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

A seguir