Criar gráficos com o Metrics Explorer

Neste documento, descrevemos como explorar dados de métricas criando um gráfico temporário com o Metrics Explorer. Por exemplo, para exibir o valor da utilização de uma máquina virtual (VM), é possível usar o Metrics Explorer para construa um gráfico que mostre os dados mais recentes. Se você quiser uma atualização permanente gráficos, será possível criar um usando o Metrics Explorer e e salvá-lo em um painel personalizado. Uma alternativa é criar um painel personalizado, que exibe gráficos, registros, incidentes e outros conteúdos, e usa o do painel do BigQuery para adicionar gráficos a ele. Para informações sobre painéis personalizados, consulte Criar e gerenciar painéis personalizados.

É possível criar gráficos, como aqueles que mostram um único tipo de métrica, e gráficos complexos, como os que mostram 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 tipo de métrica, a utilização da CPU de uma instância de VM, mostrado página Metrics Explorer:

A captura de tela anterior mostra várias linhas, cada uma mostrando a média Uso 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 as configuração do gráfico ou copiá-lo para um painel diferente e ver se o as opções de gráfico permitem que você visualize o Metrics Explorer do gráfico. Quando você seleciona essa opção, o Metrics Explorer é aberto e exibe os dados que você visualização. É possível conferir ou modificar a configuração, ou salvar o gráfico em um painel personalizado.

Criar um gráfico com um único tipo de métrica

Configure um gráfico para mostrar uma única métrica:

1. No Console do Google Cloud, acesse a página do  Metrics Explorer:

   Acesse o Metrics explorer

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Especifique os dados a serem exibidos no gráfico. Você pode usar um interface guiada por menu, a linguagem de consulta de monitoramento (MQL, na sigla em inglês), o PromQL, ou inserir uma Filtro de monitoramento:

   Interface orientada por menus

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

      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étrica disponíveis:

         • Para encontrar um tipo de métrica específico, use o Barra de filtros . Por exemplo, se você digitar util, restringir o menu a mostra entradas que incluem util. As entradas aparecem quando são aprovadas um valor "contém" que não diferencia maiúsculas de minúsculas teste.

         • Para mostrar todos os tipos de métrica, mesmo as que não têm dados, clique em Ativo. Por padrão, os menus mostrar apenas tipos de métricas com dados.

         Por exemplo, é possível 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 Latência da solicitação.
         4. Clique em Aplicar.

      2. Opcional: para especificar um subconjunto de dados que serão exibidos, no elemento Filtro, selecione Adicionar filtro e para completar a caixa de diálogo. Por exemplo, você pode exibir dados para uma zona por aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar os dados do gráfico.

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

   2. Combinar e alinhar série temporal:

      • Para exibir cada série temporal, no elemento Agregação, faça o seguinte: defina o primeiro menu como Não agregado e o segundo como Nenhum.

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

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

           O gráfico é atualizado e exibe uma única série temporal. Por exemplo: Se você selecionar Média, a série temporal exibida será a média de todas série temporal.

        2. Para combinar série temporal que têm os mesmos valores de rótulo, expanda o segundo menu e selecione um ou mais marcadores.

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

           Quando o segundo menu é definido como Nenhum, o gráfico mostra um série temporal.

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

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

   3. Opcional: para exibir somente a série temporal com o maior ou o menor valor valores, use a função Sort & Limit.

   MQL

   1. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
   2. 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.

   3. Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico utilização da CPU pelas instâncias de VM no projeto do Google Cloud. 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 documentos a seguir:

      • Introdução ao MQL
      • Como usar o editor de código para MQL

   PromQL

   1. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
   2. 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.

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   Filtro de monitoramento

   1. No elemento Métrica, clique em Ajuda e, em seguida, selecione Modo de filtro direto.

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

      Se você selecionou um tipo de recurso, métrica, antes de alternar para o modo modo de filtro direto e, em seguida, Essas configurações são mostradas no campo do elemento Filtros.

   2. Insira um filtro do Monitoring no campo do Elemento Filters.

   3. Combinar e alinhar série temporal:

      • Para exibir cada série temporal, no elemento Agregação, faça o seguinte: defina o primeiro menu como Não agregado e o segundo como Nenhum.

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

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

           O gráfico é atualizado e exibe uma única série temporal. Por exemplo: Se você selecionar Média, a série temporal exibida será a média de todas série temporal.

        2. Para combinar série temporal que têm os mesmos valores de rótulo, expanda o segundo menu e selecione um ou mais marcadores.

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

           Quando o segundo menu é definido como Nenhum, o gráfico mostra um série temporal.

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

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

3. 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 horário para pelo menos uma semana. Cota normalmente informam uma amostra por dia.
     • No painel Exibição, expanda Tipo de widget. e selecione Gráfico de barras empilhadas.

   • Para tipos de métricas que têm um Distribution tipo de valor, 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

   • Para outros tipos de métrica, use o menu Tipo de widget para mostrar como o a exibição dos dados. O menu Tipo de widget lista todos os itens disponíveis tipos de widget No entanto, alguns widgets podem não estar ativados. Considere um gráfico que exibe várias série temporal e suponha que cada valor medido é um duplo:

     • Gráfico de linhas, Gráfico de barras empilhadas e Gráfico de área empilhada são listados como Compatível. Você pode selecionar qualquer um desses tipos.
     • O widget Mapa de calor está desativado porque esses widgets só podem exibir dados com valor de distribuição.

4. Opcional: para mudar como o gráfico mostra os dados selecionados, use o opções no painel Exibição:

   • Para configurar o gráfico para exibir em modo de raio-x ou exibir estatísticas, Clique em Modo de análise.
   • Para comparar os dados atuais com os passados, faça o seguinte: clique em Comparar com o passado.
   • Para adicionar um limite de referência, clique em Linha de limite.
   • Para configurar o nome de uma coluna de legenda, clique em Modelo de legendas.
   • Para configurar a atribuição do eixo Y, rótulos ou scale, use o Menus de Atribuição do eixo Y, Rótulos do eixo Y e Escala do eixo Y.

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

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

Para criar um gráfico com várias métricas, é necessário usar a interface com menus. O outro não são compatíveis com o gráfico 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, acesse a página do  Metrics Explorer:

   Acesse o Metrics explorer

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Especifique os dados a serem exibidos no gráfico.

   Interface orientada por menus

   1. No elemento Métrica e, em seguida, selecione o o primeiro tipo de métrica cujos dados você quer visualizar. Para informações sobre essas etapas, consulte Representar um único tipo de métrica.

      A consulta para esta seleção tem o identificador A.

   2. Para cada outro tipo de métrica, faça o seguinte:

      1. Selecione Adicionar consulta. Uma nova consulta é adicionada. Por exemplo, uma consulta com o o marcador B seja adicionado.

      2. Para a nova consulta, no elemento Métrica, selecione um tipo de recurso e de métrica. Também é possível adicionar filtros, combinar série temporal classificar e limitar o número de série temporal exibidas.

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

      

   3. Opcional: no painel Exibição, expandir o menu Eixo Y e configurar qual eixo Y é usado para cada tipo de métrica.

   MQL

   Incompatível.

   PromQL

   Incompatível.

   Filtro de monitoramento

   Incompatível.

Criar um gráfico com a proporção das 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, Quer saber quantos erros ocorreram conforme medido em relação ao total o 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 para informações sobre anomalias que podem ocorrer quando você cria gráficos de proporções de métricas, consulte Proporções 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, acesse a página do  Metrics Explorer:

   Acesse o Metrics explorer

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

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

   Interface orientada por menus

   1. Configure o numerador:

      1. No elemento Métrica, use os menus para selecionar uma tipo de recurso e de métrica. Para informações sobre essas etapas, consulte Representar um único tipo de métrica.
      2. Atualize os campos de agregação. Por padrão, calcula a média de todas série temporal.
      3. Opcional: atualizar o período fixo de pontos de uma série temporal para serem combinados. Para modificar esse campo, clique em Adicionar elemento de consulta selecione Intervalo mínimo e preencha a caixa de diálogo.

   2. Selecione Adicionar consulta e configure o denominador:

      1. Para a nova consulta, no elemento Métrica, selecione um tipo de recurso e de métrica.

         Selecione um tipo de métrica que seja igual ao do numerador. Por exemplo, se a métrica do numerador for GAUGE, Selecione uma métrica GAUGE para o denominador.

      2. Atualize os campos de agregação.

         Recomendamos que os rótulos do tipo de métrica do denominador correspondem aos valores definidos para o tipo de métrica do numerador. Por exemplo: selecione o rótulo zone para o numerador e o denominador.

         Não é obrigatório usar o mesmo conjunto de rótulos para os dois tipos de métrica. No entanto, só é possível selecionar rótulos comuns tipos de métrica.

      3. Clique em Adicionar elemento de consulta. selecione Intervalo mínimo e verifique esse campo é definido como o valor usado pelo numerador.

   3. Na barra de ferramentas do painel de consulta, selecione Criar proporção e, em seguida, para completar a caixa de diálogo.

      Depois de criar a proporção, três consultas são mostradas:

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

      O exemplo a seguir ilustra uma razão que compara a soma de o total de bytes gravados no disco por zona e no número total de bytes gravado no disco:

      

   4. Opcional: para alternar as métricas do numerador e do denominador, No elemento Proporção, expanda o menu e faça uma seleção.

   MQL

   1. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
   2. 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.

   3. Insira sua consulta no editor de consultas. Com o MQL, é possível calcular proporção de duas métricas diferentes e permite 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 para o 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
      

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

      • Introdução ao MQL
      • Como usar o editor de código
      • Proporções computacionais

   PromQL

   1. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
   2. 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.

   3. Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico da proporção latência média da métrica my_summary_latency_seconds, use o 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 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ê sair da página do Metrics Explorer, o gráfico será descartado.

Salvar um gráfico configurado com o Metrics Explorer para uso futuro adicione o gráfico a um painel personalizado ou salve o URL dele:

• 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, Depois, selecione Salvar gráfico na barra de ferramentas do Metrics Explorer e preencha a caixa de diálogo. É possível salvar o gráfico em uma painel personalizado, ou você pode criar um painel.

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

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

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

  Para acessar o URL do gráfico, clique em Link nele. barra de ferramentas.

Salvar a configuração de um gráfico

Ao usar a API Cloud Monitoring para gerenciar painéis personalizados, usar o Metrics Explorer para criar os dados que você fornece à API:

• Para gerar a representação JSON para um gráfico que você planeja para adicionar a um painel, configurar o gráfico com o Metrics Explorer. É possível usar opções no Metrics Explorer para visualizar e copiar representação JSON do gráfico.

• Para identificar a sintaxe de um filtro do Monitoring, que é usada com a API Cloud Monitoring, use a interface orientada por menus do Metrics Explorer para configurar o gráfico. Depois de selecionar métrica e filtros, mude para o modo de filtro direto para ver o filtro equivalente do Monitoring.

Salvar os dados mostrados pelo gráfico

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

A seguir

• Analisar os dados em gráficos
• Selecionar métricas com o Metrics Explorer
• Ver e gerenciar o uso de métricas
• Definir as opções de exibição do gráfico