Como configurar legendas

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

  • Gráfico de linhas
  • Gráfico de barras empilhadas
  • Gráfico de áreas empilhadas
  • Gráfico do 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 "Colunas"

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.

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

    Quando a largura do gráfico não é suficiente para exibir o botão de ativar as legendas na barra de ferramentas do gráfico, essa opção é acessível usando o menu Outras opções do gráfico.

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

Selecionar colunas de legenda

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 "Colunas"

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

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"

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 apropriadamente, por exemplo, Lastltima 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 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.

Para acessar o modelo de legenda de um gráfico, no Console do Cloud, selecione a guia Avançado no painel de configuração do gráfico. O modelo de legenda está listado no cabeçalho Opções adicionais.

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

Para adicionar um modelo, siga estas instruções:

  • Clique em Inserir um modelo.
  • Selecione uma entrada no menu. Depois de selecionar uma entrada, um modelo será adicionado automaticamente. Por exemplo, se você selecionar response_code, 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}:

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.