Criar gráficos com o Metrics Explorer

Neste documento, descrevemos como explorar os dados de métricas 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), use o Metrics Explorer para criar um gráfico que exibe os dados mais recentes.

É possível criar gráficos simples, como os 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, descarte-o, salve-o em um painel personalizado, salve a configuração dele ou compartilhe-o.

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 Metrics Explorer:

Métrica definida usando o Metrics Explorer.

A captura de tela anterior mostra três linhas. Cada linha mostra os dados de série temporal de uma VM específica.

Crie um gráfico para um único tipo de métrica

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

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

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

  3. Na barra de ferramentas, selecione a guia Explorer.

  4. Especifique os dados que aparecerão no gráfico. Para usar uma interface baseada em menus ou inserir um filtro de monitoramento, selecione a guia Configuração. Para usar a linguagem de consulta do Monitoring (MQL), selecione a guia MQL.

    Guia Configuração

    Para configurar um gráfico, siga estas etapas:

    1. Selecione os dados da série temporal que você quer ver.
    2. (Opcional) Agrupar e alinhar séries temporais.

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

    Selecione um recurso e uma métrica seguindo um destes procedimentos:

    • Para gerar um gráfico de um tipo de métrica, como a utilização da CPU de uma VM, faça o seguinte:

      1. Expanda o menu Selecionar uma métrica.
      2. (Opcional) Para limitar o número de opções, insira o nome da métrica ou do recurso na barra de filtro. Por exemplo, para gerar um gráfico da latência de solicitações a uma instância de VM, insira "latency".
      3. Use os menus para selecionar um recurso e uma métrica específicos. 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 Latência de solicitação.
        4. Clique em Aplicar.
      4. (Opcional) Para especificar um subconjunto de dados a ser exibido, selecione Adicionar filtro e conclua a caixa de diálogo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar dados de gráficos.

    • Para gerar um gráfico de um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

      1. Clique em Ajuda no menu Selecionar uma métrica.
      2. Selecione Modo de filtro direto.
      3. Insira um filtro do Monitoring na caixa de texto.

    Para mais informações, consulte Selecionar métricas ao usar o Metrics Explorer

    (Opcional) Agrupar e alinhar séries temporais

    • Para exibir todas as séries temporais, deixe os campos Agrupar por e Agregador livres.
    • Para agrupar séries temporais por um rótulo, use o campo Agrupar por. Selecionar um valor para esse campo seleciona automaticamente um valor para o campo Agregador.
    • Para especificar como combinar séries temporais, defina o campo Agregador. Por exemplo, se o campo Agrupar por estiver vazio e o campo Agregador estiver definido como médio, o gráfico exibirá a média da série temporal.
    • Para configurar como as séries temporais individuais são processadas, selecione Opções avançadas.

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

    Guia MQL

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

  5. Se você gráfico um tipo de métrica de cota ou de métrica que tenha um tipo de valor Distribution, atualize o estilo do gráfico e a configuração de controle de tempo. Para outros tipos de métrica, a alteração dos valores padrão é opcional.

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

    • Defina o controle de tempo como pelo menos uma semana porque essas métricas geralmente informam uma amostra por dia.
    • Na barra de ferramentas do Metrics Explorer, selecione Gráfico de linha e Gráfico de área empilhada no menu.

    Para tipos de métrica com valor de distribuição, use as seguintes configurações:

    • Na barra de ferramentas do Metrics Explorer, selecione Gráfico de linha e, em seguida, Gráfico de mapa de calor. Para mais informações, consulte Métricas de distribuição.
  6. (Opcional) Para adicionar um limite ao gráfico, visualizar apenas valores atípicos, comparar dados atuais a dados anteriores ou alterar a configuração de cores, selecione Configurações. Para mais informações sobre as opções, consulte Definir opções de visualização.

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

Em algumas situações, pode ser necessário exibir séries temporais a partir de diferentes tipos de métricas 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 guia Configuração. A interface MQL no Metrics Explorer não é compatível 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, selecione Monitoring ou clique no botão a seguir:
    Acesse o Monitoring
  2. No painel de navegação, selecione Metrics Explorer .
  3. Na barra de ferramentas, selecione a guia Explorer.
  4. Selecione a guia Configuração.
  5. Selecione um recurso e uma métrica seguindo um destes procedimentos:

    • Para gerar um gráfico de um tipo de métrica, como a utilização da CPU de uma VM, faça o seguinte:

      1. Expanda o menu Selecionar uma métrica.
      2. (Opcional) Para limitar o número de opções, insira o nome da métrica ou do recurso na barra de filtro. Por exemplo, para gerar um gráfico da latência de solicitações a uma instância de VM, insira "latency".
      3. Use os menus para selecionar um recurso e uma métrica específicos. 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 Latência de solicitação.
        4. Clique em Aplicar.
      4. (Opcional) Para especificar um subconjunto de dados a ser exibido, selecione Adicionar filtro e conclua a caixa de diálogo. Por exemplo, é possível ver os dados de uma zona aplicando um filtro. É possível adicionar vários filtros. Para mais informações, consulte Filtrar dados de gráficos.

    • Para gerar um gráfico de um objetivo de nível de serviço ou a contagem de processos em execução em VMs, insira um filtro do Monitoring:

      1. Clique em Ajuda no menu Selecionar uma métrica.
      2. Selecione Modo de filtro direto.
      3. Insira um filtro do Monitoring na caixa de texto.

    Para mais informações, consulte Selecionar métricas ao usar o Metrics Explorer

  6. (Opcional) Agrupar e alinhar séries temporais:

    • Para exibir todas as séries temporais, deixe os campos Agrupar por e Agregador livres.
    • Para agrupar séries temporais por um rótulo, use o campo Agrupar por. Selecionar um valor para esse campo seleciona automaticamente um valor para o campo Agregador.
    • Para especificar como combinar séries temporais, defina o campo Agregador. Por exemplo, se o campo Agrupar por estiver vazio e o campo Agregador estiver definido como médio, o gráfico exibirá a média da série temporal.
    • Para configurar como as séries temporais individuais são processadas, selecione Opções avançadas.

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

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

    1. Selecione Adicionar outra métrica.

      Na primeira vez que você clicar em Adicionar outra métrica, as seleções feitas anteriormente serão exibidas no painel expansível Série temporal A. Além disso, o painel Série temporal B é aberto. Esse painel contém os campos de configuração preenchidos para representar a segunda métrica.

      A captura de tela a seguir ilustra esse comportamento:

      Exemplo de configuração do Metrics Explorer com duas métricas.

    2. Para especificar a métrica a ser adicionada ao gráfico, use as opções de configuração no novo painel. Por exemplo, para a segunda métrica, use os campos no painel Série temporal B.

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

Monitorar o número de erros pode ser útil. No entanto, é mais provável que você precise monitorar a taxa de erros. Ou seja, você quer saber quantos erros ocorreram conforme medido 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:
    Acesse o Monitoring

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

  3. Na barra de ferramentas, selecione a guia Explorer.

  4. Especifique os dados que aparecerão no gráfico. Para usar uma interface baseada em menus ou inserir um filtro de monitoramento, selecione a guia Configuração. Para usar o MQL, selecione a guia MQL:

    Guia Configuração

    1. Configure o numerador:

      1. Para selecionar um recurso e uma métrica, use os menus.
      2. (Opcional) Para restringir as séries temporais exibidas, adicione filtros.
      3. (Opcional) Atualize os campos de agrupamento e os parâmetros de alinhamento.
    2. Selecione Adicionar outra métrica.

      Ao clicar em Adicionar outra métrica, as seleções feitas anteriormente serão exibidas no painel Série temporal A. Além disso, o painel da Série temporal B será aberto. Esse painel contém os campos de configuração preenchidos para representar a segunda métrica.

      A captura de tela a seguir ilustra esse comportamento:

      Exemplo de configuração do Metrics Explorer com duas métricas.

    3. Configure o denominador:

      1. Para selecionar um recurso e uma métrica para o denominador, use os menus no painel Time Series-B.

        Ambas as métricas precisam ter o mesmo tipo. Por exemplo, se a métrica de Série temporal A for GAUGE, a métrica selecionada para Time Series-B precisará ser GAUGE.

      2. (Opcional) Para restringir as séries temporais exibidas, adicione filtros.

      3. Verifique se o valor do campo Período mínimo de alinhamento é igual para as duas métricas.

      4. Defina os parâmetros de agrupamento da segunda métrica.

        Recomendamos que os campos de agrupamento da segunda métrica correspondam aos valores de Time Series-A. Por exemplo, é possível agrupar as duas métricas pelo rótulo zone.

        Não é necessário usar o mesmo agrupamento para as duas métricas. No entanto, só é possível agrupar por rótulos comuns às duas métricas.

    4. Ative Exibir métricas como proporção.

      Quando você fizer essa seleção, o rótulo Time Series-A será renomeado como Numerator, e o rótulo Time Series-B como Denominator.

    5. (Opcional) Para alterar a métrica que representa o numerador, clique em Trocar numerador.

    6. (Opcional) Expanda Mostrar opções de proporção para configurar as opções de agregação secundárias.

    Guia MQL

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

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 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, 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 um painel personalizado existente ou criar um painel.

    • Se você usa a API Cloud Monitoring para gerenciar seus painéis personalizados, atualize o arquivo JSON que define o painel e o conteúdo dele. Acesse a representação JSON no menu Mais opções, localizado na barra de ferramentas do Metrics Explorer.

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

  • Para manter uma referência da configuração do gráfico, salve o URL dele. Como o URL do gráfico codifica a configuração do gráfico, quando você cola esse URL em um navegador, o gráfico que você configurou é exibido.

    Para ver o URL do gráfico, selecione Mais opções na barra de ferramentas do Metrics Explorer e selecione Compartilhar por URL.

Salvar a configuração de um gráfico

Ao gerenciar painéis personalizados usando a API Cloud Monitoring, você pode usar o Metrics Explorer para ajudar a criar os dados fornecidos à API:

  • Para gerar a representação JSON de um gráfico que você pretende adicionar a um painel, configure-o 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 visualizar o filtro equivalente do Monitoring.

A seguir