Criar gráficos com o Metrics Explorer

Neste documento, descrevemos como explorar dados de métrica criando um gráfico temporário com o Metrics Explorer. Por exemplo, para visualizar a utilização da CPU de uma máquina virtual (VM, na sigla em inglês), use o Metrics Explorer para criar um gráfico que exibe os dados mais recentes. Se você quiser gráficos permanentes, crie um gráfico usando o Metrics Explorer e salve-o em um painel personalizado. Uma alternativa é criar um painel personalizado que possa exibir gráficos, registros, incidentes e outros conteúdos e, em seguida, usar a interface do painel para adicionar gráficos a esse painel. Para informações sobre painéis personalizados, consulte Criar e gerenciar painéis personalizados.

É possível criar gráficos simples, como aqueles que representam um único tipo de métrica, e gráficos complexos, como aqueles que representam vários tipos de métricas. Depois de criar um gráfico com o Metrics Explorer, é possível descartá-lo, salvá-lo em um painel personalizado, salvar a configuração ou compartilhá-lo.

A captura de tela a seguir mostra um único tipo de métrica (a utilização da CPU de uma instância de VM) na página do Metrics Explorer:

A captura de tela anterior mostra várias linhas. Cada linha mostra a utilização média da CPU para todas as VMs em uma zona específica.

Observação: se você estiver visualizando um gráfico em um painel e quiser visualizar a configuração dele ou copiá-lo para um painel diferente, verifique se as opções de gráfico permitem visualizar o Metrics Explorer. Quando você seleciona essa opção, o Metrics Explorer é aberto e exibe os dados que você estava visualizando. Em seguida, é possível visualizar ou modificar a configuração ou salvar o gráfico em um painel personalizado.

Gráfico de um único tipo de métrica

Para configurar um gráfico para exibir uma única métrica, faça o seguinte:

1. No Console do Google Cloud, selecione Monitoring ou clique no botão a seguir:
   Acessar Monitoring

2. No painel de navegação, selecione Metrics Explorer .

3. Especifique os dados a serem exibidos no gráfico. É possível usar uma interface orientada por menu, a linguagem de consulta do Monitoring (MQL), o PromQL ou inserir um filtro do Monitoring:

   Interface orientada por menus

   1. Selecione os dados da série temporal que você quer ver:

      1. No painel Selecionar uma métrica, expanda o menu Métrica e use os menus para selecionar um tipo de recurso e um tipo de métrica. Por exemplo, você pode fazer as seguintes escolhas:

         1. No menu Recursos ativos, selecione Instância de VM.
         2. No menu Categorias de métricas ativas, selecione uptime_check.
         3. No menu Métricas ativas, selecione Solicitar latência.
         4. Clique em Aplicar.

         Para limitar o número de opções nos menus, insira a métrica ou o nome do recurso na barra de filtro. Por exemplo, para gerar um gráfico da latência de solicitação para uma instância de VM, digite "latency".

         Depois de fazer suas seleções, o título do painel será alterado. Por exemplo, se você fez as sugestões anteriores, o título do painel se tornará Latência da solicitação.

      2. Opcional: para especificar um subconjunto de dados a serem exibidos, selecione Adicionar filtro e preencha a caixa de diálogo. Por exemplo, é possível ver dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar dados do gráfico.

      Para mais informações, consulte Selecionar os dados para o gráfico.

   2. Agrupar e alinhar série temporal:

      • Para exibir todas as série temporal, na entrada Agrupar por, clique em Excluir agrupamento.
      • Para combinar série temporal com o mesmo valor de rótulo, expanda o menu Rótulos e selecione os valores. Também é possível alterar o valor da função de agrupamento. Por exemplo, um gráfico pode exibir o valor médio da série temporal, em que a média é calculada por zona.
      • Opcional: para configurar o espaçamento entre pontos de dados, clique em Mais opções e use os campos Alinhamento de ponto de dados.

      Para mais informações sobre agrupamento e alinhamento, consulte Escolher como exibir dados gráficos.

   MQL

   1. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
   2. Selecione MQL no botão de alternância Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

   3. Insira sua consulta no editor de consultas. Por exemplo, para gerar um gráfico da utilização da CPU das instâncias de VM no seu 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
      

      Os documentos a seguir fornecem informações sobre MQL:

      • Introdução à MQL
      • Como usar o Editor de consultas

   QL

   1. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
   2. Selecione PromQL no botão de alternância Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   Filtro de monitoramento

   1. Na barra de ferramentas do painel Select a metric, clique em Help no menu Metric e selecione Direct Filter Mode.

      Uma caixa de texto Inserir um filtro do Monitoring é exibida. Se você tiver selecionado um tipo de recurso, métrica ou filtros antes de alternar para o modo Direct Filter Mode, essas configurações serão mostradas na caixa de texto.

   2. Insira um filtro do Monitoring.

   3. Agrupar e alinhar série temporal:

      • Para exibir todas as série temporal, na entrada Agrupar por, clique em Excluir agrupamento.
      • Para combinar série temporal com o mesmo valor de rótulo, expanda o menu Rótulos e selecione os valores. Também é possível alterar o valor da função de agrupamento. Por exemplo, um gráfico pode exibir o valor médio da série temporal, em que a média é calculada por zona.
      • Opcional: para configurar o espaçamento entre pontos de dados, clique em Mais opções e use os campos Alinhamento de ponto de dados.

      Para mais informações sobre agrupamento e alinhamento, consulte Escolher como exibir dados gráficos.

4. Atualize as configurações do gráfico com base no tipo de métrica selecionado:

   • Para tipos de métricas de cota, use as seguintes configurações:

     • Na barra de ferramentas, defina o controle de tempo para pelo menos uma semana. As métricas de cota normalmente informam uma amostra por dia.
     • No painel Display, expanda o menu Widget type e selecione Empilhado no gráfico de barras.

   • Para tipos de métricas que têm um tipo de valor Distribution, verifique se o menu Tipo de widget está definido como Gráfico de mapa de calor. Para mais informações, consulte Sobre métricas com valor de distribuição.

5. Opcional: altere como o gráfico exibe os dados selecionados. Você tem as seguintes opções:

   • Altere o tipo de widget. Por exemplo, converta um gráfico de linhas em um gráfico de barras empilhadas.
   • Adicione limites de referência.
   • Configure o eixo Y e defina-o para escala de registro.
   • Configure o gráfico para ser exibido no modo de raio-x ou no modo de estatísticas.
   • Comparar os dados atuais aos antigos.
   • Configure o nome de uma coluna de legenda.

Criar um gráfico com vários tipos de métrica

Em algumas situações, convém exibir série temporal de tipos diferentes de métrica no mesmo gráfico. Por exemplo, para comparar as cargas de leitura e gravação em uma VM, configure um gráfico para exibir o número de bytes lidos e o número de bytes gravados.

Para criar um gráfico com várias métricas, use a interface orientada por menu. As outras interfaces não são compatíveis com gráficos de várias métricas.

Para exibir várias métricas em um gráfico, faça o seguinte:

1. No Console do Google Cloud, selecione Monitoring ou clique no botão a seguir:
   Acessar Monitoring
2. No painel de navegação, selecione Metrics Explorer .

3. Use as opções no painel Selecionar uma métrica para selecionar o primeiro tipo de métrica com os dados que você quer visualizar. Para informações sobre essas etapas, consulte Gráfico de um único tipo de métrica.

   O título do painel Selecionar uma métrica muda para ser a métrica selecionada.

4. Para cada tipo de métrica adicional, faça o seguinte:

   1. Selecione Adicionar consulta.

      O novo painel Selecionar uma métrica oculta as consultas configuradas anteriormente.

   2. No painel Selecionar uma métrica, use os menus para selecionar um tipo de recurso e de métrica. Como opção, você também pode usar os menus para adicionar filtros, agrupar série temporal e definir os campos de alinhamento.

   Para ver todos os tipos de métrica configurados, acesse a barra de ferramentas do painel que você está visualizando e selecione Recolher.

   A captura de tela a seguir ilustra a exibição do Metrics Explorer quando há dois tipos de gráfico no gráfico:

   

5. Opcional: no painel Display, expanda o menu do eixo Y e configure qual eixo Y é usado para cada tipo de métrica.

Gráfico de proporção de métricas

Monitorar o número de erros relatados pode ser útil. No entanto, é mais provável que você precise monitorar a taxa de erros. Ou seja, você quer saber quantos erros ocorreram em relação ao número total de respostas. Para atender a esse requisito, configure um gráfico para exibir a proporção de duas métricas. Para referências a exemplos e informações sobre anomalias que podem ocorrer ao criar gráficos com proporções de métricas, consulte Proporção de métricas.

Para exibir uma proporção de métricas em um gráfico, faça o seguinte:

1. No Console do Google Cloud, selecione Monitoring ou clique no botão a seguir:
   Acessar Monitoring
2. No painel de navegação, selecione Metrics Explorer .

3. Especifique os dados que aparecerão no gráfico:

   Interface orientada por menus

   1. Configure o numerador:

      1. No painel Selecionar uma métrica, use os menus para selecionar um tipo de recurso e de métrica. Para informações sobre essas etapas, consulte Gráfico de um único tipo de métrica.
      2. Atualize os campos de agrupamento e os parâmetros de alinhamento. Por padrão, o Metrics Explorer adiciona um agrupamento que calcula a média de todas as série temporal.
      3. Opcional: atualize os parâmetros de alinhamento. Para visualizar os parâmetros de alinhamento, clique em Mais opções.

   2. Configure o denominador:

      1. Selecione Adicionar consulta.

         O novo painel Selecionar uma métrica oculta as consultas configuradas anteriormente.

      2. No painel Selecionar uma métrica, use os menus para selecionar um tipo de recurso e de métrica.

         Os tipos de métrica de numerador e denominador precisam ter o mesmo tipo de métrica. Por exemplo, se a métrica do numerador for GAUGE, a métrica selecionada para o denominador precisará ser GAUGE.

      3. Verifique se o valor do campo Período de alinhamento mínimo é o mesmo nas duas métricas. Para visualizar os parâmetros de alinhamento, clique em Mais opções.

      4. Atualize os campos de agrupamento.

         Recomendamos que os campos de agrupamento do tipo de métrica do denominador correspondam aos valores definidos para o tipo de métrica do numerador. Por exemplo, é possível agrupar os dois tipos de métrica pelo rótulo zone.

         Não é necessário usar o mesmo agrupamento para os dois tipos de métrica. No entanto, só é possível agrupar por rótulos comuns aos dois tipos de métrica.

      5. Para ver todos os tipos de métrica configurados, acesse a barra de ferramentas do painel que você está visualizando e selecione Recolher.

         Suas consultas de numerador e denominador são mostradas.

   3. Selecione Criar proporção na barra de ferramentas do painel de consultas e preencha a caixa de diálogo.

      Depois que você criar a proporção, três consultas serão exibidas:

      • Proporção A/B identifica a consulta de proporção.
      • A identifica a consulta para o numerador.
      • B identifica a consulta para o denominador.

      O exemplo a seguir ilustra uma proporção que compara a soma de bytes gravados no disco por zona com o número total de bytes gravados no disco:

      

   4. Opcional: para alternar entre as métricas de numerador e denominador, faça o seguinte:

      1. Clique em Expandir na barra de ferramentas da consulta cujo nome começa com A/B.
      2. Expanda o menu Numerador e denominador e faça uma seleção.

   MQL

   1. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.

   2. Insira sua consulta no editor de consultas. O MQL permite computar uma proporção de duas métricas diferentes, filtrar uma única métrica por um rótulo e depois calcular a proporção. A consulta a seguir calcula a proporção de respostas com um valor de 500 em relação ao número total de respostas:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
      | {
          filter response_code_class = 500
        ;
          ident
        }
      | group_by [matched_url_path_rule]
      | outer_join 0
      | div
      

      Os documentos a seguir fornecem informações sobre MQL:

      • Introdução à MQL
      • Como usar o Editor de consultas
      • Proporção de computação

   QL

   1. Na barra de ferramentas do painel Selecionar uma métrica, selecione Editor de código.
   2. Selecione MQL no botão de alternância Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

   3. Insira sua consulta no editor de consultas. Por exemplo, para gerar um gráfico da proporção de latência média da sua métrica my_summary_latency_seconds, use a seguinte consulta:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
      sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
      

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

   Filtro de monitoramento

   Incompatível.

Salvar um gráfico para referência futura

Com o Metrics Explorer, você cria um gráfico que pode ser usado para explorar uma métrica. No entanto, os gráficos criados por essa ferramenta não são permanentes. Quando você sai da página do Metrics Explorer, o gráfico é descartado.

Para salvar um gráfico configurado com o Metrics Explorer para referência futura, adicione o gráfico a um painel personalizado ou salve o URL do gráfico:

• Para adicionar o gráfico a um painel personalizado, siga um destes procedimentos:

  • Se você usa o console do Google Cloud para gerenciar seus painéis personalizados, selecione Salvar gráfico na barra de ferramentas do Metrics Explorer e preencha a caixa de diálogo. Você pode salvar o gráfico em um painel personalizado existente ou criar um.

  • Se você usar a API Cloud Monitoring para gerenciar seus painéis personalizados, atualize o arquivo JSON que define o painel e o conteúdo dele. Para acessar a representação JSON, clique em Editor do JSON na barra de ferramentas do gráfico.

    Para informações detalhadas sobre como usar a API para gerenciar painéis personalizados, consulte Criar e gerenciar painéis por API.

• Para manter uma referência à configuração do gráfico, salve o URL do gráfico. Como o URL do gráfico codifica a configuração do gráfico, quando você colar esse URL em um navegador, o gráfico configurado será exibido.

  Para ver o URL do gráfico, clique em Link na barra de ferramentas.

Salvar a configuração de um gráfico

Quando você gerencia painéis personalizados usando a API Cloud Monitoring, é possível usar o Metrics Explorer para criar os dados fornecidos à API:

• Para gerar a representação JSON de um gráfico que você planeja adicionar a um painel, configure o gráfico com o Metrics Explorer. Você pode usar opções no Metrics Explorer para visualizar e copiar a representação JSON do gráfico.

• Para identificar a sintaxe de um filtro do Monitoring, usado com a API Cloud Monitoring, use a interface baseada em menus do Metrics Explorer para configurar o gráfico. Depois de selecionar a métrica e os filtros, alterne para o modo de filtro direto para ver o filtro equivalente do Monitoring.

Salvar os dados exibidos pelo gráfico

Para salvar os dados exibidos pelo gráfico no seu sistema local, clique em Fazer o download como CSV.

A seguir

• Analisar os dados em gráficos
• Selecionar métricas com o Metrics Explorer
• Ver diagnóstico de métricas
• Definir opções de exibição de gráficos