Como configurar legendas

As legendas configuráveis estão disponíveis para gráficos com os seguintes tipos de visualização:

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

A legenda parece uma tabela posicionada abaixo do gráfico. Ela tem uma coluna de pontos coloridos, um número variável de colunas de dados e uma coluna chamada Valor. Veja na captura de tela a seguir um gráfico com uma legenda:

Legenda que mostra o botão

A coluna de pontos coloridos liga as linhas do gráfico às linhas da legenda. A coluna Valor mostra os valores da métrica mapeada, e outras colunas mostram os valores dos rótulos de métricas ou recursos escolhidos. A barra tracejada no gráfico indica a hora em que os valores são exibidos.

Nesta página, descrevemos como trabalhar com essas legendas. Você pode:

  • Mostrar ou ocultar as legendas.
  • escolher os rótulos de métricas e recursos a serem exibidos como colunas na legenda;
  • ordenar as linhas na legenda com base nos valores de uma coluna;
  • mostrar os valores atuais e passados ao usar a opção de visualização Comparar com o passado. Para mais informações, consulte a seção Comparar com o passado.
  • Configure as strings descritivas que aparecem na legenda. Para mais informações, consulte Modelo de legenda.

Como exibir e ocultar legendas

É 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 e selecione Mostrar todas as legendas ou Ocultar tudo legendas.
  • Para mostrar ou ocultar a legenda de um gráfico específico, clique em Alternar legenda na barra de ferramentas.

A captura de tela anterior é um exemplo de gráfico de linhas com a legenda ativada.

Selecionar colunas

Para alterar as colunas que aparecem na legenda, clique em Colunas . 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.

Legenda que mostra o botão

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

Se você selecionou mais campos, excedendo a largura do gráfico, ou se a legenda tiver muitas linhas para exibir, poderá visualizar os itens usando as barras de rolagem adequadas, conforme mostrado na captura de tela a seguir:

Legenda que mostra as barras de rolagem

Ordenar as linhas

Você pode ordenar as linhas da legenda por qualquer uma das colunas, exceto Valor. 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

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 mais uma 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

Como configurar o modelo de legenda

No Console do Cloud, se você expandir as opções de agregação clicando em Mostrar opções avançadas um Modelo de legenda será exibido, além de campos para o alinhador, o período de alinhamento e o agregador secundário.

Como exibir o local do campo do modelo 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 no cartão de informações 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ê. Você pode usar este campo para criar um modelo para as descrições.

O campo Modelo de legenda aceita o seguinte:

  • Filtros que se referem a rótulos na série temporal. Para ver todos os filtros disponíveis na série temporal, clique em Adicionar um filtro. Depois de selecionar um filtro, ele será adicionado à caixa de texto e representado como uma expressão como ${resource.labels.zone}. Quando a expressão é avaliada, o valor é extraído dos rótulos de uma série temporal e inserido na legenda.

  • Texto simples. Se você fornecer apenas texto, as descrições da série temporal no gráfico serão idênticas. No entanto, é possível combinar texto e filtros.

Por exemplo, a captura de tela a seguir mostra um modelo que consiste em uma string de texto simples e a expressão de filtro ${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 criar modelos que usam várias strings e filtros, mas o espaço de exibição disponível no cartão de informações é limitado.