Criar gráficos com o Metrics Explorer

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Neste documento, descrevemos como explorar os dados da métrica criando um gráfico temporário com o Metrics Explorer. Por exemplo, para ver a utilização da CPU de uma máquina virtual (VM), use o Metrics Explorer para criar um gráfico com os dados mais recentes.

Você pode criar gráficos simples, como os que representam 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 um único tipo de métrica, a utilização da CPU de uma instância de VM, mapeada na página do Metrics Explorer:

Métrica criada com 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.

Criar 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 seguinte botão:
    Acessar 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 orientada por menu ou inserir um filtro do Monitoring, selecione a guia Configuração. Para usar a Monitoring Query Language (MQL), selecione a guia MQL.

    Guia Configuração

    Para configurar um gráfico, siga estas etapas:

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

    Selecione os dados de 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 o uso da CPU de uma VM, siga estas etapas:

      1. Abra 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 da solicitação para uma instância de VM, é possível inserir "latência".
      3. Use os menus para selecionar um recurso e uma métrica específicos. Por exemplo, você pode fazer as seguintes opções:

        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.
      4. (Opcional) Para especificar um subconjunto de dados a serem exibidos, 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 os dados exibidos no gráfico.

    • 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 claros.
    • 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édia, o gráfico exibirá a média da série temporal.
    • Para configurar como a série temporal individual é processada, selecione Opções avançadas.

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

    Guia MQL

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

    Guia "PromQL"

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

    avg(compute_googleapis_com:instance_cpu_utilization)
    

    Para mais informações sobre o uso de PromQL, consulte PromQL no Cloud Monitoring.

  5. Se você tiver mapeado um tipo de métrica de cota ou de métrica que tenha o 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étricas 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 linhas e depois Gráfico de área empilhada no menu.

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

    • Na barra de ferramentas do Metrics Explorer, selecione Gráfico de linhas e 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 outliers, comparar dados atuais aos anteriores ou alterar a configuração de cores, selecione Configurações. Para ver 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, convém exibir séries temporais de diferentes tipos 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 gerar um gráfico com várias métricas, use a guia Configuração. A interface da 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 seguinte botão:
    Acessar 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 o uso da CPU de uma VM, siga estas etapas:

      1. Abra 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 da solicitação para uma instância de VM, é possível inserir "latência".
      3. Use os menus para selecionar um recurso e uma métrica específicos. Por exemplo, você pode fazer as seguintes opções:

        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.
      4. (Opcional) Para especificar um subconjunto de dados a serem exibidos, 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 os dados exibidos no gráfico.

    • 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 claros.
    • 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édia, o gráfico exibirá a média da série temporal.
    • Para configurar como a série temporal individual é processada, selecione Opções avançadas.

    Para mais informações, consulte Escolher como exibir os dados nos 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 gerar um gráfico da segunda métrica.

      A captura de tela abaixo 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.

Criar um gráfico com uma proporção de métricas

Monitorar o número de erros relatados pode ser útil, mas é 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 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, selecione Monitoring ou clique no seguinte botão:
    Acessar 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 orientada por menu ou inserir um filtro do Monitoring, selecione a guia Configuração. Para usar a 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 quais séries temporais são 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 são exibidas no painel 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 gerar um gráfico com a segunda métrica.

      A captura de tela abaixo 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 de métrica. Por exemplo, se a métrica para Time Series-A for uma métrica GAUGE, a métrica selecionada para Time Series-B precisará ser uma métrica GAUGE.

      2. (Opcional) Para restringir quais séries temporais são exibidas, adicione filtros.

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

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

        Recomendamos que os campos de agrupamento da segunda métrica correspondam aos valores da 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 a ambas as métricas.

    4. Ative a opção 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 será renomeado como Denominator.

    5. (Opcional) Para mudar a métrica que é 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 de 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 o MQL:

    Guia "PromQL"

    Insira sua consulta no editor de consultas. Por exemplo, para criar um gráfico da proporção da 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 o uso de PromQL, consulte PromQL no Cloud Monitoring.

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 conclua 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. Você pode acessar 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 à 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ê cola esse URL em um navegador, o gráfico configurado é exibido.

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

Salvar a configuração de um gráfico

Ao gerenciar painéis personalizados usando a API Cloud Monitoring, é possível usar o Metrics Explorer para ajudar a 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 as opções do 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 orientada por menu do Metrics Explorer para configurar o gráfico. Depois de selecionar a métrica e os filtros, mude para o modo de filtro direto e veja o filtro equivalente do Monitoring.

A seguir