Mostrar dados de métricas em um painel personalizado

Neste documento, descrevemos como mostrar dados de métricas em um painel personalizado. Os gráficos de linhas mostram os valores dos dados de métricas ao longo do tempo. No entanto, você também pode usar tabelas ou outras visualizações para mostrar os valores mais recentes dos dados de métricas. É possível mostrar dados de métricas com um valor numérico ou de distribuição, incluindo métricas definidas pelo usuário e métricas com base em registros.

Se você quiser mostrar outros tipos de dados, consulte os seguintes documentos:

Para informações sobre a API Cloud Monitoring para configurar painéis personalizados, consulte Gerenciar painéis por API.

Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

Visualizações para dados de métricas

Para mostrar dados ao longo do tempo, use Gráficos. Há quatro estilos disponíveis:

  • Linha
  • Área empilhada
  • Barra empilhada
  • Mapa de calor

Os gráficos de linhas são a visualização padrão e adequados para a maioria dos dados de métricas. Os gráficos de barras empilhadas são ideais para representar dados de métricas com amostras pouco frequentes, como as métricas de cota. Para dados de métricas cujo tipo de valor é uma distribuição, use o mapa de calor.

Para mostrar apenas os valores mais recentes, use um dos seguintes estilos:

  • As tabelas mostram rótulos, permitem limitar o número de linhas e codificar as células por cores com base no valor.
  • Os medidores e os quadros de visão geral mostram uma indicação verde, amarela ou vermelha com base na comparação do valor com um conjunto de limites.
  • Os histogramas mostram a frequência relativa dos valores mais recentes de várias série temporal.
  • Os gráficos de pizza mostram o valor mais recente de cada série temporal como uma fração da soma de todos os valores.
  • Os mapas de árvore mostram os valores mais recentes de dados agrupados como uma série de retângulos aninhados, em que a cor de um retângulo é proporcional ao valor dele.

Depois de configurar um widget, você pode mudar a visualização dele.

Antes de começar

Faça o seguinte no projeto Google Cloud em que você quer criar e gerenciar painéis:

Mostrar dados de métricas em um painel

Para mostrar os dados de métricas no painel, siga estas etapas:

  1. Abrir um painel e adicionar um widget
  2. Selecione um tipo de métrica para mostrar
  3. Salve as mudanças

Talvez você queira mudar a aparência do gráfico, mostrar uma proporção de métricas ou fazer outras mudanças. Para saber mais sobre as opções disponíveis, consulte a seção Opções de configuração avançada deste documento.

Abrir um painel e adicionar um widget

Para mostrar dados de métricas em um painel personalizado, faça o seguinte:

  1. No console Google Cloud , acesse a página  Painéis:

    Acesse Painéis

    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. Escolha uma destas opções:

    • Para criar um novo painel, selecione Criar painel.
    • Para atualizar um painel existente, encontre o painel na lista de todos os painéis e selecione o nome dele.

  4. Na barra de ferramentas, clique em  Adicionar widget.

  5. Na caixa de diálogo Adicionar widget, selecione um widget.

    • Para adicionar um gráfico de linhas, selecione  Métrica.
    • Para adicionar outra visualização, selecione uma opção na biblioteca de widgets.

    É possível mudar o estilo de visualização usando as opções de widget.

Selecione um tipo de métrica para mostrar

Nesta etapa, você configura uma consulta. A consulta define quais dados o widget mostra.

  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.

Salvar alterações

Depois de selecionar um tipo de métrica para mostrar, você pode salvar as mudanças, alterar as configurações padrão ou configurar campos específicos do widget. As seções a seguir deste documento podem ser úteis ao configurar campos específicos do widget:

Quando estiver satisfeito com o gráfico, salve as mudanças e atualize o painel.

  1. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.
  2. Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.

Depois de salvar o widget, é possível editar e modificar qualquer uma das configurações dele. Por exemplo, você pode mudar o estilo de visualização.

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

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

Mudar a visualização

Para mostrar os valores mais recentes dos dados de métricas, em vez de exibir esses dados ao longo do tempo, use uma das seguintes visualizações:

Para modificar a visualização do widget, no painel Mostrar, selecione Tipo de widget e faça uma seleção no menu.

O Tipo de widget lista todos os tipos de widget que podem mostrar o mesmo tipo de dados. No entanto, alguns widgets podem não estar ativados. Por exemplo, suponha que um gráfico de linhas mostre várias série temporal. O menu Tipo de widget mostra que a maioria dos tipos de visualização está listada como Compatível. Por exemplo, é sempre possível alternar de um gráfico de linhas para uma tabela. No entanto, os seguintes tipos de widget não estão disponíveis:

  • O widget Mapa de calor está desativado porque esses widgets só podem mostrar dados com valor de distribuição.
  • O painel de registros não está listado porque não pode mostrar dados de métricas.

Definir 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:

Definir a visibilidade

Por padrão, o painel mostra o widget. Se você definir variáveis, poderá tornar o widget visível apenas quando a variável tiver valores específicos. Para mais informações, consulte Definir a visibilidade de um widget.

Mostrar vários tipos de métricas

É possível configurar gráficos e tabelas para mostrar vários tipos de métricas. Para tabelas, o Cloud Monitoring tenta mostrar os valores dos dois tipos de métricas na mesma linha, quando possível. Para mais informações, consulte Como as tabelas combinam dados de vários tipos de métricas.

  1. Selecione Adicionar consulta. Uma nova consulta é adicionada. Por exemplo, uma consulta com o rótulo B pode ser adicionada.
  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 e ordenar 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.

PromQL

Incompatível.

Filtro de monitoramento

Incompatível.

Mostrar uma proporção de tipos de métrica

Talvez você queira criar um gráfico de uma proporção de métricas quando Google Cloud não fornecer os dados de métricas no formato que você prefere.

  1. Configure o gráfico para mostrar dois tipos de métricas que tenham o mesmo tipo de métrica. Por exemplo, ambas são métricas GAUGE.
  2. Verifique se o valor do campo Intervalo mínimo é o mesmo para os dois tipos de métrica. Para acessar esse campo, clique em Adicionar elemento de consulta e selecione Intervalo mínimo.

  3. 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.

  4. 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.

  5. 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.

Filtro de monitoramento

Incompatível.

Configurar uma tabela

Para ver os dados mais recentes em formato tabular, adicione uma tabela. As tabelas podem mostrar dados numéricos. Por exemplo, eles podem mostrar um ou mais tipos de métrica ou percentis para métricas de valor de distribuição.

A captura de tela a seguir ilustra duas tabelas. A primeira tabela mostra dois tipos de métricas: o número de bytes lidos e gravados nas instâncias. Um valor agregado é mostrado junto com uma barra de referência. A segunda tabela mostra o valor mais recente de um tipo de métrica, e a coluna de valor foi configurada para codificar a cor da célula com base em como o valor se compara a um limite:

Exemplo de tabela mostrando dois tipos de métricas.

Há dois widgets que mostram dados em formato tabular: Lista principal e Tabela. A principal diferença entre esses dois widgets é que o Lista dos principais classifica a ordem das linhas e mostra o valor junto com um indicador visual dele em comparação com o intervalo de valores possíveis. Como o widget Lista dos principais oferece uma representação visual do valor, não é possível codificar a célula por cores com base em como o valor se compara a um limite.

Para adicionar uma tabela ao painel, faça o seguinte:

  1. Abra um painel e adicione um widget e um widget de Tabela ou Lista dos principais.

  2. Selecione um tipo de métrica para exibir.

    Cada linha na tabela corresponde a uma série temporal. Uma coluna da tabela mostra um valor numérico que é o mais recente ou um valor agregado. As outras colunas mostram os rótulos na série temporal.

  3. Opcional: selecione outro tipo de métrica.

    Quando uma tabela mostra vários tipos de métricas, os dados dos dois tipos são exibidos na mesma linha, quando possível. Para mais informações, consulte Entender tabelas que mostram vários tipos de métricas.

  4. Configure a tabela:

Você também pode usar a API Cloud Monitoring para adicionar um widget de tabela a um painel. Para mais informações, consulte Painel com um widget TimeSeriesTable.

Mostrar o valor mais recente ou agregado

Por padrão, as tabelas mostram o valor mais recente. No entanto, uma tabela pode mostrar um valor calculado no período selecionado para o painel.

Para escolher entre o valor mais recente e o valor agregado, use o campo Opção de valor.

Se você mostrar o valor agregado, para cada série temporal, os dados no período selecionado pelo painel serão combinados pela função de alinhamento. A função de alinhamento é uma das opções de agregação e não aparece por padrão. Para ver a função de alinhamento, expanda o elemento Agregação e, no primeiro elemento, selecione Configurar alinhador. Depois de fazer essa seleção, o elemento Agregação será substituído por um elemento Agrupamento e um menu chamado Função de alinhamento.

Selecione as colunas a serem exibidas

Por padrão, uma coluna na tabela mostra um valor numérico. Todas as outras colunas correspondem a um rótulo na série temporal. Para colunas baseadas em rótulos, o nome da coluna é derivado do rótulo.

Para configurar as colunas mostradas pela tabela, abra o menu Colunas visíveis e faça suas seleções.

Configurar o formato da coluna

  • Para configurar uma coluna individual, no elemento Colunas, abra o menu Substituir coluna, selecione a coluna a ser modificada e faça uma destas ações:

    • Para definir o nome da coluna, use o campo Nome de exibição.
    • Para definir o alinhamento dos dados na coluna, use os botões Alinhar à esquerda, Alinhar ao centro e Alinhar à direita.
    • Para atribuir cores à célula com base na comparação do valor numérico com um limite, defina os limites de alerta e de perigo.
    • Se você escrever consultas em PromQL, use o menu Unidade para definir as unidades mostradas com os dados. As unidades são configuradas automaticamente quando você configura a consulta usando as seleções de menu.

Mostrar valor de referência

As tabelas podem mostrar apenas um valor ou um valor relativo ao intervalo de valores. Quando a opção de intervalo é selecionada, o valor é mostrado junto com uma barra azul, cujo comprimento é proporcional ao valor mostrado.

Para configurar se um valor de referência é mostrado, use o elemento Visualização de métricas.

Classificar e filtrar

É possível mudar a ordem das linhas na tabela e filtrar o conteúdo para mostrar apenas linhas específicas. Essas configurações não são permanentes. Quando você sai da página do painel ou o recarrega, as opções de classificação e filtragem aplicadas são descartadas.

Você tem as seguintes opções de classificação e filtragem:

  • Para classificar a tabela por coluna, clique no cabeçalho da coluna.

  • Para alterar as colunas da tabela, clique em Visualizar colunas, faça as modificações e clique em OK.

  • Para listar apenas linhas específicas, adicione um ou mais filtros. É possível adicionar vários filtros. Quando você não especifica o operador OR entre dois filtros, um AND lógico se une a eles.

    Para adicionar um filtro, clique em Enter property name or value, selecione uma propriedade no menu e insira um valor ou selecione-o no menu de valores. Por exemplo, se você filtrar a propriedade Name e inserir o valor demo, a tabela listará somente as linhas em que o campo Name inclui o valor demo.

Entender tabelas que mostram vários tipos de métricas

Se uma tabela consultar vários tipos de métricas, o console Google Cloud vai realizar uma operação de mesclagem examinando os rótulos anexados aos dados agregados dos dois tipos de métricas. Quando os rótulos comuns às duas consultas permitem que o Monitoring determine um identificador de linha exclusivo, uma única linha na tabela mostra o valor mais recente de cada consulta. Caso contrário, há uma linha para cada série temporal.

Por exemplo, suponha que uma tabela consulte dois tipos de métricas diferentes. Vamos chamar essas consultas de A e B. A seguir, descrevemos como os resultados da consulta são mesclados:

  • Se o resultado das duas consultas tiver o mesmo conjunto de rótulos, a mesclagem sempre será bem-sucedida. Cada linha contém o valor mais recente de cada consulta. Se uma consulta não retornar um valor para uma combinação específica de rótulos, a célula da tabela ficará vazia.

    Por exemplo, suponha que as duas consultas contenham um rótulo zone. A tabela contém uma linha para cada zona informada pelas consultas A e B. No entanto, se a consulta A retornar uma série temporal cuja zona seja us-central1-a, mas a consulta B não retornar uma série temporal com esse valor, o valor mais recente da consulta B será mostrado como uma célula vazia.

  • Se os rótulos dos resultados de uma consulta forem um subconjunto dos rótulos dos resultados da outra consulta, os resultados serão mesclados.

    Por exemplo, suponha que os resultados das duas consultas incluam rótulos para location e cluster_name, mas que os resultados da consulta A também incluam um rótulo para memory_type. Nessa situação, cada linha corresponde a uma série temporal com valores exclusivos para os três rótulos.

    Em qualquer linha, o valor mostrado para a consulta B é o valor da série temporal que corresponde aos dois rótulos comuns, location e cluster_name, e o terceiro rótulo é ignorado.

  • Se os resultados das duas consultas não compartilharem rótulos ou se compartilharem alguns, mas não o suficiente para formar um identificador de linha exclusivo, não será possível mesclar os resultados. A tabela lista uma linha para cada série temporal retornada pela consulta A ou B, e algumas células estão vazias.

    Por exemplo, suponha que os rótulos da consulta A sejam location e memory_type, e que os rótulos da consulta B sejam location e cluster_name. Embora o rótulo location seja comum, ele não é suficiente para criar um identificador de linha exclusivo.

    Conforme descrito na próxima seção, talvez seja possível resolver uma falha de mesclagem.

Como resolver uma falha de mesclagem

Ao criar um gráfico com várias métricas, pode ocorrer uma falha na junção porque elas usam nomes de rótulo diferentes para o mesmo campo. Uma maneira de resolver essa falha é converter uma consulta em PromQL e usar a função label_replace() para converter os nomes de rótulos usados por um tipo de métrica para corresponder aos do outro tipo de métrica.

Por exemplo, considere uma tabela configurada com duas consultas:

  • A: consulta o tipo de métrica Prometheus/kube_pod_container_status_ready/gauge. As opções de agregação são definidas para somar série temporal depois de agrupar os dados pelo rótulo cluster.

  • B: consulta o tipo de métrica kubernetes.io/container/memory/request_bytes. As opções de agregação são definidas para somar série temporal depois de agrupar os dados pelo rótulo cluster_name.

A tabela não pode mesclar os resultados porque as consultas A e B têm rótulos diferentes.

Para resolver a falha, converta a consulta A para PromQL e substitua cluster por cluster_name. O exemplo a seguir ilustra a consulta modificada:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Com as mudanças, as duas consultas produzem o mesmo conjunto de rótulos. Portanto, cada linha na tabela lista um nome de cluster, o valor da consulta A e o valor da consulta B.

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

Configurar medidores e visões gerais

Para visualizar a medição mais recente em comparação com um conjunto de limites codificado por cores, adicione um medidor ou uma visão geral. Os medidores mostram apenas a medição mais recente, enquanto as visões gerais também mostram um histórico de medições recentes. A cor de fundo desses widgets também é codificada por cores. Quando o valor mais recente está dentro dos intervalos esperados, a cor do widget é branca. Quando o valor está em um intervalo de aviso, o widget fica âmbar. Da mesma forma, quando o valor está em um intervalo de perigo, o widget fica vermelho.

Esses widgets podem mostrar vários medidores ou quadros de visão geral. Por exemplo, a imagem a seguir mostra um widget de medidor com três medidores:

Exemplo de um medidor.

O número de indicadores mostrados pelo widget depende das suas configurações de agregação. No exemplo, as configurações de agregação resultam em três série temporal, então três indicadores são mostrados. Você define os limites no nível do widget, para que eles sejam aplicados a cada série temporal. Neste exemplo, um medidor está vermelho, um está amarelo e o terceiro está verde.

O restante das informações nesta seção é para o console Google Cloud . Para informações sobre como usar a API Cloud Monitoring, consulte Painel com um Scorecard básico.

Para adicionar um medidor ou quadro de visão geral a um painel, faça o seguinte:

  1. Abra um painel e adicione um widget de Medidor ou Visão geral.

  2. Selecione um tipo de métrica para exibir.

  3. No painel Exibição, configure o widget:

    1. Para widgets de medidor, clique em Intervalo do medidor e defina os valores mínimo e máximo. Quando um medidor exibir uma porcentagem, defina esses valores como 0 e 1, respectivamente.

    2. Clique em Limite do medidor e defina os limites de alerta e de perigo. Os campos de limite vazios não são usados.

      Para o medidor mostrado anteriormente, dois limites são definidos. Valores acima de 0,9 estão no intervalo de perigo. Valores maiores que 0,7, mas não no intervalo de perigo, estão no intervalo de alerta.

    3. Para uma visão geral, clique em Visualização de gráfico do Spark, expanda o menu de opções e selecione o estilo de exibição.

  4. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

  5. Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.

Configurar histogramas, gráficos de pizza e mapas de árvore

Nesta seção, explicamos como configurar widgets que mostram os valores de métricas mais recentes em formato gráfico.

Configurar um histograma

Um histograma fornece informações sobre a frequência relativa do valor mais recente de várias série temporal. Ou seja, o eixo x é indexado por bins, cada um correspondendo a um intervalo de valores. O eixo y especifica uma contagem, que é o número de amostras cujos valores estão no intervalo do agrupamento.

A captura de tela a seguir mostra um widget de histograma:

Exemplo de um widget de **histograma**.

O exemplo mostra o valor mais recente de cerca de 50 série temporal. O valor mais recente para a maioria das série temporal é 0,145 ou menos.

Para adicionar um histograma a um painel, faça o seguinte:

  1. Abra um painel e adicione um widget e um widget de Histograma.

  2. Selecione um tipo de métrica para exibir.

    Um histograma é mostrado com uma configuração de agrupamento padrão.

  3. Opcional: atualize a configuração de agrupamento em intervalos:

    • Para configurar o número ou o tamanho dos agrupamentos, selecione Agrupamentos de histograma e faça uma seleção.

      • Para especificar o número de classes, selecione Contagem e insira um valor. Recomendamos que o valor inserido seja de pelo menos 5, mas não mais de 50. No entanto, esse recurso aceita até 1.000 classes.

      • Para especificar o tamanho de cada agrupamento, selecione Tamanho e insira um valor.

    • Para especificar os valores mínimo e máximo do eixo X, selecione Intervalo do eixo X e preencha a caixa de diálogo.

    • Para especificar o escalonamento linear ou logarítmico no eixo y, selecione Escala do eixo Y e preencha a caixa de diálogo.

  4. Selecione Aplicar e Salvar.

Você também pode usar a API Cloud Monitoring para adicionar um widget de histograma a um painel. Para mais informações, consulte Painel com um widget Histogram.

Configurar um gráfico de pizza

Para conferir os dados mais recentes como uma fração do total, adicione um gráfico de pizza. Assim como as tabelas, um gráfico de pizza pode mostrar qualquer tipo de métrica que tenha um valor numérico, além de percentis para métricas de valor de distribuição. Cada série temporal contribui com uma fatia do gráfico.

A captura de tela a seguir ilustra um painel que mostra a utilização da CPU de instâncias de máquina virtual usando duas configurações diferentes de um widget de gráfico de pizza:

Exemplo de widgets **PieChart**.

Para informações sobre como adicionar gráficos de pizza a um painel, consulte os seguintes documentos:

  1. Abra um painel e adicione um widget e um widget de gráfico de pizza.

    Para mostrar o valor total, defina o campo Tipo de gráfico como Rosca.

  2. Selecione um tipo de métrica para exibir.

Para informações sobre como usar a API para configurar um gráfico de pizza, consulte Painel com um widget PieChart.

Configurar um mapa de árvore

Para ver os dados mais recentes como uma série aninhada de retângulos, em que cada retângulo corresponde a uma coleção única de valores de rótulo, adicione um mapa de árvore. Suponha que você tenha agregado os dados que está representando pelo rótulo zone. Se você definir o tipo de widget como mapa de árvore, cada retângulo no mapa vai corresponder a uma zona. A saturação de cor de um retângulo é proporcional ao valor que ele representa.

A captura de tela a seguir mostra um widget de mapa de árvore em que as série temporal são agregadas por zone e storage_type:

Exemplo de um widget de **mapa de árvore**.

Na captura de tela, a dica é mostrada para um retângulo.

Para configurar um mapa de árvore, faça o seguinte:

  1. Abra um painel e adicione um widget e um widget Mapa de árvore.
  2. Selecione um tipo de métrica para exibir.
  3. Se o elemento Agregação mostrar Não agregado, use o menu para selecionar uma função de agregação. Por exemplo, selecione Média ou Máximo.
  4. No segundo campo do elemento Agregação, selecione pelo menos um rótulo.
  5. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.
  6. Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.

Para informações sobre como usar a API para configurar um mapa de árvore, consulte Painel com um widget Treemap.

A seguir

Você também pode adicionar os seguintes widgets aos seus painéis personalizados:

Para informações sobre como analisar dados com gráficos e filtrar seus painéis, consulte os seguintes documentos: