Criar gráficos com o Metrics Explorer

Neste documento, explicamos como analisar dados de métricas criando gráficos temporários com o Metrics Explorer. Por exemplo, para conferir 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. Para criar gráficos permanentes, crie um gráfico com o Metrics Explorer e salve-o em um painel personalizado. Ou crie um painel personalizado e use a interface dele para adicionar gráficos. Os painéis podem mostrar dados de registro, métricas, rastreamentos, incidentes e outros conteúdos. Para mais informações, consulte Criar e gerenciar painéis personalizados.

É possível criar gráficos que mostram um único tipo de métrica ou gráficos complexos que exibem 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 compartilhar.

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

Gráfico mostrando um único tipo de métrica, utilização da CPU, usando o Metrics Explorer.

A imagem mostra várias linhas. Cada linha mostra o uso médio da CPU de todas as VMs em uma zona específica.

Esse recurso só está disponível para projetos Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

Antes de começar

Para receber as permissões necessárias para detalhar um gráfico por rótulos, peça ao administrador para conceder a você o papel do IAM de Leitor do Monitoring (roles/monitoring.viewer) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

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

Por padrão, quando você cria um gráfico, o estilo de exibição é definido como gráfico de linhas. Esse estilo de gráfico é adequado para a maioria dos dados de métricas. Para mudar o estilo do gráfico, use o menu Tipo de widget.

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

  1. No console 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 Monitoring.

  2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

  3. Especifique os dados que vão aparecer no gráfico. É possível usar uma interface baseada em menus, o PromQL ou inserir um filtro do Monitoring:

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

        • Para encontrar um tipo de métrica específico, use a barra de filtro. Por exemplo, se você digitar util, o menu vai mostrar apenas as entradas que incluem util. As entradas são mostradas quando passam em um teste "contém" sem diferenciação de maiúsculas e minúsculas.
        • Para mostrar todos os tipos de métricas, mesmo aqueles sem dados, clique em Ativo. Por padrão, os menus mostram apenas tipos de métricas com dados.

        Por exemplo, você pode fazer as seguintes escolhas:

        1. No menu Recursos ativos, selecione Instância de VM.
        2. No menu Categorias de métrica 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 vão ser exibidos, no elemento Filtro, selecione Adicionar filtro e preencha 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 com gráfico.

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

    2. Combine e alinhe 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.
      • Para combinar série temporal, no elemento Agregação, faça o seguinte:

        1. Abra 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 mostrada 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 mostrar a série temporal por zona, defina o segundo menu como zona.

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

      • Opcional: para configurar o espaçamento entre 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 mostrar apenas as série temporal com os valores mais altos ou mais baixos, use o elemento Classificar e limitar.

    PromQL

    1. Na barra de ferramentas do painel do criador de consultas, selecione o botão com o nome  PromQL.

    2. 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 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. No elemento Métrica, clique em Ajuda e selecione Modo de filtro direto.

      Os elementos Métrica e Filtro são excluídos, e um elemento Filtros que permite inserir texto é criado.

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

    2. Insira um filtro do Monitoring no campo do elemento Filtros.

    3. Combine e alinhe 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.
      • Para combinar série temporal, no elemento Agregação, faça o seguinte:

        1. Abra 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 mostrada 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 mostrar a série temporal por zona, defina o segundo menu como zona.

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

      • Opcional: para configurar o espaçamento entre 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.

Opções de configuração avançada

Esta seção descreve as opções disponíveis para personalizar seu widget:

Detalhar o gráfico por rótulos

Por padrão, o Metrics Explorer mostra um gráfico com os dados da métrica selecionada. Ao investigar um problema, o recurso de detalhamento pode ajudar a determinar se tipos ou locais de recursos específicos são a causa.

Para ver o tipo de métrica selecionado detalhado por rótulos, selecione Mostrar detalhamento.

Para saber mais sobre esse recurso, consulte Detalhar um gráfico por rótulos.

Mudar a visualização

Por padrão, o Metrics Explorer mostra os dados da métrica selecionada como um gráfico de linhas. Esse estilo de gráfico é adequado para a maioria, mas não para todos os tipos de métricas.

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 como pelo menos uma semana. As métricas de cota geralmente informam uma amostra por dia.
    • No painel Exibição, expanda o menu Tipo de widget e selecione Gráfico de barras empilhadas.
  • Para tipos de métricas que têm um tipo de valor Distribuição, verifique se o menu Tipo de widget está definido como Gráfico de mapa de calor. Para mais informações, consulte Sobre métricas de valor de distribuição.
  • Para outros tipos de métricas, use o menu Tipo de widget para mostrar como os dados são exibidos. O menu Tipo de widget lista todos os tipos de widget disponíveis, mas alguns podem não estar ativados. Considere um gráfico que mostra várias série temporal e suponha que cada valor medido seja um número de ponto flutuante de precisão dupla:
    • Os widgets Gráfico de linhas, Gráfico de barras empilhadas e Gráfico de áreas empilhadas são listados como Compatíveis. Você pode selecionar qualquer um desses tipos.
    • O widget Mapa de calor está desativado porque esses widgets só podem mostrar dados com valor de distribuição.

Mudar a aparência do gráfico

Por padrão, o Metrics Explorer mostra série temporal usando o modo de cor. Cada série temporal recebe uma cor exclusiva, e o plano de fundo é branco. No entanto, é possível modificar essa aparência.

Opcional: para mudar a forma como um gráfico ou uma tabela mostra os dados selecionados, use as opções no painel Exibir:

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

Esse recurso só está disponível quando você usa a interface baseada em menus. Ela não está disponível quando você usa filtros do PromQL ou do Monitoring.

Em algumas situações, convém mostrar série temporal 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 mostrar o número de bytes lidos e 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 a criação de gráficos de várias métricas.

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

  1. No console 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 Monitoring.

  2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

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

    1. No elemento Métrica, selecione o primeiro tipo de métrica com os dados que você quer visualizar. Para informações sobre essas etapas, consulte Criar um gráfico de um único tipo de métrica.

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

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

      1. Selecione Adicionar consulta. Uma nova consulta é adicionada. Por exemplo, uma consulta com o rótulo B pode ser adicionada.
      2. Na nova consulta, no elemento Métrica, selecione um tipo de recurso e de métrica. Você também pode adicionar filtros, combinar série temporal e classificar e limitar o número de série temporal mostradas.

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

      Exemplo do Metrics Explorer com dois tipos de métricas.

    3. Opcional: no painel Mostrar, expanda o menu Eixo Y e configure qual eixo Y será usado para cada tipo de métrica.

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

Esse recurso só está disponível quando você usa a interface orientada por menu ou o PromQL. Ela não fica disponível quando você usa filtros de monitoramento.

Monitorar o número de erros informados 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 mostrar 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 mostrar uma proporção de métricas em um gráfico, faça o seguinte:

  1. No console 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 Monitoring.

  2. Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

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

    1. Configure o numerador:
      1. No elemento Métrica, use os menus para selecionar um tipo de recurso e de métrica. Para informações sobre essas etapas, consulte Criar um gráfico de 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: atualize o período fixo para combinar pontos em uma série temporal. 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. Na nova consulta, no elemento Métrica, selecione um tipo de recurso e de métrica.

        Selecione um tipo de métrica cujo tipo 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 correspondam aos valores definidos para o tipo de métrica do numerador. Por exemplo, você pode selecionar o rótulo zone para o numerador e o denominador.

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

      3. Clique em Adicionar elemento de consulta, selecione Intervalo mínimo e verifique se esse campo está definido com o valor usado pelo numerador.

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

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

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

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

      Exemplo de uma proporção de métricas.

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

    PromQL

    1. Na barra de ferramentas do painel do criador de consultas, selecione o botão com o nome  PromQL.

    2. Insira sua consulta no editor de consultas. Por exemplo, para representar a proporção da latência média da 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 PromQL, consulte PromQL no Cloud Monitoring.

Salvar um gráfico

Depois de configurar um gráfico, talvez você queira salvá-lo para referência futura ou salvar os dados que ele mostra. Esta seção descreve essas opções.

Salvar um link em um gráfico

Para manter uma referência à 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 configurado é exibido.

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

Adicionar o gráfico a um painel personalizado

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 seu gráfico a um painel personalizado, faça o seguinte:

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

    • Se você usa a API Cloud Monitoring para gerenciar seus painéis personalizados, atualize o arquivo JSON que define o painel e os widgets dele. O JSON de cada widget inclui a consulta que o sistema usa para buscar os dados a serem mostrados.

      Para acessar a representação JSON, clique em  Editor 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.

Salvar os dados mostrados pelo gráfico

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

Criar uma política de alertas com base no gráfico

É possível criar uma política de alertas para monitorar os dados que você representou em um gráfico. Para criar uma política de alertas, faça o seguinte:

  1. Na barra de ferramentas, clique em Salvar como e selecione Política de alertas.

    A caixa de diálogo da política de alertas é aberta com os campos de seleção de métricas preenchidos. Sua política de alertas está configurada para notificar você quando o valor dos dados monitorados for maior que o limite.

  2. Preencha o seguinte e salve a política:

    • Na seção Configurar gatilho, atualize o limite.
    • Adicionar canais de notificação.
    • Insira um nome para sua política de alertas.

A seguir