Configurar legendas

Neste documento, descrevemos 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 a seguir mostra um gráfico em um painel com a legenda padrão:

Para 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 mapeada, e outras colunas exibem os valores dos rótulos de métricas ou recursos escolhidos. A barra tracejada no gráfico indica o horário em que 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 em 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 cada gráfico em um painel, na barra de ferramentas, clique em Configurações e selecione Condensado 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 de alternância Tabela de gráficos ambos, selecione Ambos.
• Para ocultar a legenda completa de um gráfico, no botão de alternância rotulado Tabela de gráficos ambos, selecione Gráfico.

As legendas de gráficos que exibem vários tipos de métrica podem ser difíceis de interpretar. Por padrão, as colunas de legendas são selecionadas a partir dos rótulos de métricas e recursos para o tipo de métrica no gráfico. Quando um gráfico tem vários tipos de métricas, o resultado é que uma coluna de legenda específica pode não ser significativa 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 os dados da leitura de bytes sejam filtrados para a zona us-central1-a. A legenda inclui uma coluna zone, e os valores nessa coluna podem ser diferentes de us-central1-a. O motivo é que o tipo de métrica com gravação em bytes contém um rótulo zone e os dados da métrica não foram filtrados por zona.

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

Selecionar colunas de legenda

Para alterar as colunas que aparecem na legenda, expanda-a e clique em Colunas da legenda. Ao clicar no botão, um painel de configuração será exibido. 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.

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 exibe uma barra de rolagem quando tem muitas colunas para exibir e a pagina quando há muitas linhas a serem exibidas. A captura de tela a seguir ilustra uma legenda com uma barra de rolagem e setas para navegar pelas páginas:

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:

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

Configurar o nome de uma coluna de legendas

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, expanda Modelo de legendas.
2. Clique em Exibir sugestões de variáveis de modelo e selecione uma entrada no menu. Por exemplo, se você selecionar zone, o modelo ${resource.labels.zone} será 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}:

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:

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

   Acessar Painéis

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

2. Clique no nome do painel que você quer ver.
3. Identifique o gráfico e expanda a legenda para ver mais detalhes clicando em  Expandir legenda.

4. Abra a página de gerenciamento do recurso:

   1. Localize a série temporal específica de interesse e clique em Ações para esta série temporal.
   2. Selecione a opção que começa com 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.