Configurar legendas

Este documento descreve como trabalhar com legendas de gráficos. A legenda parece uma tabela posicionada ao lado do gráfico. Por padrão, a legenda em um painel é configurada para mostrar apenas os pontos coloridos que correspondem às linhas no gráfico. A captura de tela abaixo mostra um gráfico em um painel com o legenda:

Legenda padrão de um gráfico em um painel.

Nos gráficos em painéis, também é possível expandir a legenda para ver mais detalhes, como colunas de dados configuráveis e uma coluna Valor. A coluna Valor exibe os valores da métrica que está sendo representada no gráfico, e outras colunas exibem o os valores dos rótulos de métricas ou recursos escolhidos. A barra tracejada no gráfico indica a hora para a qual os valores são exibidos.

Para acessar painéis específicos de recursos ou aplicar filtros temporários a um painel, use o menu Ações para esta série temporal em uma legenda expandida.

Mostrar e ocultar legendas

Gráficos nos painéis

É possível mostrar ou ocultar as legendas de todos os gráficos em um painel ou de cada gráfico individualmente:

  • Para mostrar ou ocultar as legendas de todos os gráficos em um painel, clique em Configurações na barra de ferramentas e selecione Resumida ou Tabela.
  • Para mostrar ou ocultar a legenda de um gráfico específico, clique em Expandir legenda ou selecione Expandir legenda do gráfico no menu Mais opções de gráfico.

Metrics Explorer

  • Para mostrar a legenda completa de um gráfico, no botão Tabela de gráficos dos dois, selecione Ambas.
  • Para ocultar a legenda completa de um gráfico, no botão de alternância Tabela do gráfico ambas, selecione Gráfico.

Pode ser difícil criar legendas para gráficos que exibem vários tipos de métrica de interpretar. Por padrão, as colunas de legendas são selecionadas a partir da métrica rótulos de recursos para o tipo de métrica no gráfico. Quando um gráfico tem tipos de métricas, o resultado é que uma coluna de legenda específica pode não ser significativos para uma série temporal específica.

  • Exemplo: um gráfico exibe o número de bytes gravados e o número de bytes lidos de instâncias de máquina virtual (VM). Suponha que a função bytes-read os dados são filtrados para a zona us-central1-a. A legenda inclui uma coluna zone, e os valores nessa coluna podem ser diferentes dos us-central1-a. O motivo é que o tipo de métrica "bytes-written" contém um rótulo zone e os dados da métrica não foram filtrados por zona.

  • Exemplo: um gráfico mostra o número de bytes gravados em instâncias de VM e o uso da CPU para essas instâncias. A legenda contém colunas para o tipo de disco e de armazenamento. No entanto, os valores dessas rótulos estão vazios nos campos de legenda de horário. O motivo é que o tipo de métrica de uso da CPU não oferece suporte a esses rótulos.

Selecionar colunas de legenda

Para mudar as colunas que aparecem na legenda, abra a legenda e clique em Colunas da legenda. Clicar no botão abre uma de configuração do Terraform. Esse painel lista os rótulos de métricas e recursos disponíveis para exibição como colunas. As caixas de seleção das colunas obrigatórias ficam desativadas. A captura de tela a seguir mostra o botão Colunas e o painel de configuração de uma legenda específica.

Legenda que mostra o botão "Colunas"

Quando o gráfico é criado inicialmente, o sistema escolhe um conjunto de rótulos de forma heurística para mostrar por padrão. É possível selecionar ou limpar as colunas rotuladas. As entradas das colunas obrigatórias, geralmente Valor, estão desativadas e não podem ser apagadas. Ao alterar a configuração, é preciso ter pelo menos um rótulo de métrica ou recurso selecionado.

A legenda mostra uma barra de rolagem quando tem muitas colunas para exibir e pagina as legendas quando há muitas linhas para exibir. A captura de tela a seguir ilustra uma legenda com uma barra de rolagem e setas para navegar pelas páginas:

Legenda mostrando barra de rolagem e setas para mudar de página

Classificar linhas de legenda

É possível classificar as linhas da legenda por qualquer uma das colunas. As linhas podem ser classificadas em ordem crescente ou decrescente. Para ordenar uma linha, clique no cabeçalho dela. A coluna ordenada mais recentemente exibe uma seta que indica a ordem de classificação. A captura de tela a seguir mostra uma legenda que foi ordenada por zona em ordem decrescente:

Legenda ordenada por zona

Entender as legendas no modo "Comparar com o passado"

Quando você usa o modo Comparar com o passado em um gráfico, a legenda é modificada para incluir uma segunda coluna de “valores”. A coluna Valor atual se torna Hoje e a coluna de valores anteriores é nomeada de acordo. Por exemplo, Última semana. A captura de tela a seguir mostra a legenda de uma tabela que compara os dados atuais com os da hora anterior.

Legenda que mostra dados anteriores

Configurar o nome de uma coluna de legenda

O campo Modelo de legenda permite personalizar uma descrição para a série temporal no seu gráfico. Essas descrições aparecem na dica do gráfico e na legenda do gráfico na coluna Nome. Por padrão, as descrições na legenda são criadas para você a partir dos valores de diferentes rótulos na série temporal. Como o sistema seleciona os rótulos, os resultados podem não ser úteis para você. Para criar um modelo para descrições, use este campo.

É possível inserir texto simples e modelos no campo Modelo de legendas. Ao adicionar um modelo, uma expressão que é avaliada quando a legenda é exibida é adicionada.

Para adicionar um modelo de legenda a um gráfico, siga estas etapas:

  1. No painel Exibição, abra Modelo de legendas.
  2. Clique em Exibir sugestões de variáveis do modelo. e selecione uma entrada no menu. Por exemplo, se você selecionar zone, os o modelo ${resource.labels.zone} foi adicionado.

Por exemplo, a captura de tela a seguir mostra um modelo de legenda que contém texto simples e a expressão ${resource.labels.zone}:

Um modelo para uma descrição simples

Na legenda do gráfico, os valores gerados a partir do modelo aparecem em uma coluna com o cabeçalho Nome e no cartão de informações:

Descrições geradas a partir de um modelo

É possível configurar o modelo de legenda para incluir várias strings e modelos de texto. No entanto, o espaço de exibição disponível no cartão de informações é limitado.

Acessar painéis específicos de recursos

Gráficos em painéis

Ao visualizar uma série temporal, talvez você queira ver mais informações sobre o recurso em que a série temporal foi gravada. Para alguns recursos, é possível acessar a página de gerenciamento deles usando as opções na legenda do gráfico.

Para acessar a página de gerenciamento de um recurso, faça o seguinte:

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

    Ir para Painéis

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

  2. Selecione um painel e acesse o gráfico ou a tabela que mostra a série temporal de interesse.
  3. Ao visualizar uma tabela, role pela tabela até encontrar a linha de interesse. Em seguida, vá para a coluna que exibe o valor numérico, Clique em Ações para esta série temporal. e selecione Gerenciar.
  4. Se você estiver visualizando um gráfico, faça o seguinte:

    1. No gráfico, clique em  Expandir legenda.
    2. Role pela legenda até encontrar a série temporal específica de interesse, clique em Ações para esta série temporal e selecione Gerenciar.

Veja a seguir uma lista parcial de recursos em que a página de gerenciamento pode ser acessada nas opções de legenda:

  • Conjuntos de dados do BigQuery
  • Buckets do Cloud Storage
  • Discos e instâncias do Compute Engine
  • Clusters, contêineres, nós e pods do Google Kubernetes Engine
  • Balanceadores de carga de aplicativos externos
  • Assinaturas e tópicos do Pub/Sub
  • Instâncias do Spanner

Metrics Explorer

Incompatível.