Gráficos de KPI (valor único)

Quando o recurso de visualização de KPI está ativado, é possível visualizar os pontos de dados de KPI com a opção de gráfico KPI (valor único) no Looker. A opção de gráfico KPI (valor único) substitui a opção de gráfico Valor único nas Análises.

Uma visualização de KPI com uma barra de progresso e um minigráfico.

O recurso de visualização de KPI oferece aos usuários os seguintes recursos:

  • Adicionar visualizações secundárias: os usuários podem adicionar um minigráfico ou um gráfico de barras em uma visualização para mostrar tendências ou distribuições relacionadas ao KPI principal.
  • Mostrar comparações aprimoradas: os usuários podem especificar e comparar um valor principal com qualquer outra métrica em uma consulta de análise, usando dados da primeira linha, da segunda linha, da última linha ou da linha de totais.
  • Acessar opções de estilo aprimoradas: os usuários têm mais controle sobre a aparência da visualização, incluindo a cor do plano de fundo do bloco e o alinhamento dos valores.

Esta página fornece orientações para ativar e usar o recurso de visualização de KPI na instância do Looker (original) ou do Looker (Google Cloud Core). Esta página inclui as seguintes seções:

Requisitos do usuário e da instância

Para ativar e usar o recurso de visualização de KPI, é necessário atender aos seguintes requisitos:

  • A instância do Looker (original) ou do Looker (Google Cloud Core) precisa executar o Looker 26.10 ou uma versão mais recente, e a instância do Looker (original) precisa ser hospedada pelo Looker.
  • É necessário ter o papel de administrador do Looker para ativar o recurso de visualização de KPI.
  • Para visualizar e interagir com as Análises, incluindo a criação de visualizações, você precisa ter o seguinte acesso:
    • O papel de usuário do Looker ou outro papel que contenha a permissão explore
    • Acesso ao modelo LookML subjacente em que a Análise se baseia para visualizar e usar os campos em uma visualização

Como ativar a visualização de KPI

O recurso de visualização de KPI está desativado por padrão.

Os administradores podem ativar o recurso de visualização de KPI seguindo estas etapas:

  1. No Looker, clique na opção Administrador no menu de navegação principal.
  2. Clique na opção Pré-lançamento na seção Geral para abrir a página Recursos de pré-lançamento.
  3. Clique no botão Visualização de KPI para ativar o recurso de pré-lançamento.

Informações importantes

Quando várias visualizações de valor único aparecem em um painel, cada visualização usa o mesmo tamanho de fonte por padrão para uma aparência consistente. No entanto, as visualizações de valor único redimensionam automaticamente as fontes quando o tamanho do bloco é reduzido. Se a fonte de uma visualização não puder mostrar o valor inteiro no espaço disponível, o valor será truncado por uma reticência (...).

Se o recurso Tamanho de texto de valor único inteligente estiver ativado, as fontes exibidas nas visualizações de valor único nos blocos do painel serão redimensionadas automaticamente para mostrar pelo menos 8 a 10 caracteres de valor no bloco em qualquer tamanho.

Opções de gráfico de KPI (valor único)

Para editar o gráfico de KPI (valor único), clique em Editar no painel Visualização da Análise.

No modo de edição, os usuários podem fazer seleções nos menus Estilo, Comparação e Formatação para personalizar a aparência da visualização de KPI (valor único).

Opções do menu "Estilo"

O menu Estilo inclui as seguintes opções.

Coleção de cores

Escolha uma coleção de cores no menu Coleção de cores. Uma coleção permite criar visualizações e painéis temáticos que ficam bem juntos. É possível conferir todas as paletas em cada uma das coleções de cores integradas do Looker na página de documentação Coleções de cores. O administrador do Looker também pode criar uma coleção de cores personalizada para sua organização.

Cor do valor

Para definir a cor do valor do gráfico, clique na amostra de cor na seção Cor do valor para abrir o menu do seletor de cores.

  • Para escolher uma cor em uma paleta, clique na guia Paletas do menu do seletor de cores e use as setas esquerda e direita para rolar pelas paletas disponíveis. Selecione uma cor clicando em uma cor em uma das paletas.
  • Para selecionar uma cor personalizada, clique na guia Personalizado do seletor de paletas e use o controle deslizante de gradiente de cor e valor para escolher uma cor personalizada ou insira uma string hexadecimal RGB, como #2ca6cd, ou um nome de cor CSS, como mediumblue, no campo de entrada.

O Looker vai usar a cor selecionada para visualizações de valor único com e sem hiperlinks.

Dependendo das suas necessidades, considere usar as seguintes técnicas alternativas:

  • Mude a cor da fonte para diferenciar entre resultados bons ou ruins: ative a configuração Mostrar comparação no menu Comparação e escolha a opção Mostrar como mudança.
  • Mude a cor da fonte para o valor de um campo específico em todos os lugares, incluindo no painel Dados da Análise: um desenvolvedor do LookML pode adicionar um parâmetro html à definição do campo.

Valor de redimensionamento automático

Ativar a opção Valor de redimensionamento automático redimensiona automaticamente a fonte na visualização de valor único exibida nos blocos do painel. As fontes são redimensionadas para mostrar pelo menos 8 a 10 caracteres de valor em um bloco. Se os caracteres na visualização excederem horizontal ou verticalmente em um determinado tamanho, o tamanho da fonte será reduzido incrementalmente. O tamanho mínimo de fonte permitido é de 14 pixels. Quando o tamanho mínimo da fonte é atingido, todos os caracteres excedentes são truncados com uma reticência (...). O tamanho máximo de fonte permitido é de 104 pixels.

Ao usar esse recurso, os blocos de valor único nos painéis podem parecer menos consistentes, mas mais caracteres vão caber em blocos menores.

Essa configuração não tem efeito se a configuração Tamanho de texto de valor único inteligente estiver ativada na página Administrador > Configurações gerais. Para usar esse controle por visualização, a configuração no nível do administrador precisa ser desativada.

Mostrar título

É possível determinar se um título aparece abaixo do número. Para um Look salvo, o título padrão é o nome do Look. Você também pode especificar um título diferente usando o campo Título.

Substituição do título

É possível especificar um título a ser exibido com o valor. Esse campo está disponível quando a opção Mostrar título está ativada. Para um Look salvo, se esse campo for deixado em branco, o título será o nome do Look salvo.

Mostrar gráfico sparkline

Ative a configuração Mostrar gráfico sparkline para exibir uma visualização secundária que mostra a mudança do valor dos dados. Quando essa configuração está ativada, é possível personalizar a visualização secundária com as seguintes configurações:

  • Tipo de gráfico: escolha o gráfico de área ou de colunas como a visualização secundária.
  • Cor do gráfico: escolha uma cor para a visualização secundária, semelhante à configuração "Cor do valor".
  • Eixo X visível: ative essa configuração para mostrar os valores do eixo X do gráfico secundário.

Valor principal

As configurações nesta seção permitem escolher o valor principal da visualização de KPI (valor único), incluindo o seguinte:

  • Série principal: escolha uma métrica da Análise para definir como uma série principal. O valor da métrica será o valor comparado quando a configuração Mostrar comparação no menu Comparação estiver ativada.
  • Linha principal: especifique o valor de uma linha da Série principal a ser exibida. As opções incluem 1ª, 2ª, Última e Total (quando os Totais estão ativados). 1ª é selecionada por padrão.
  • Alinhamento: escolha uma opção de alinhamento para os valores na visualização. As opções incluem Esquerda, Centro e Direita. Essa configuração se aplica a todos os valores na visualização.

Opções do menu "Comparação"

O menu Comparação inclui as seguintes opções.

Mostrar comparação

É possível ativar a configuração Mostrar comparação para adicionar informações de comparação de um segundo campo à visualização de KPI (valor único). Quando a configuração Mostrar comparação está ativada, é possível usar as opções de estilo que aparecem no menu Comparação.

Série de comparação

A série de comparação aparece abaixo da série principal na visualização. As configurações nesta seção permitem escolher o valor secundário para comparação, incluindo o seguinte:

  • Série de comparação: escolha uma métrica da Análise para definir como uma série de comparação. O valor da métrica selecionada será o valor comparado ao valor principal.
  • Linha de comparação: especifique o valor de uma linha da Série de comparação a ser exibida. As opções incluem 1ª, 2ª, Última e Total (quando os Totais estão ativados). 1ª é selecionada por padrão.
  • Rótulos de valor: é possível especificar como a série de comparação é usada na visualização. As opções incluem o seguinte:
    • Mostrar como valor: o valor da série de comparação é mostrado.
    • Mostrar como mudança: o valor da comparação é mostrado, com formatação condicional para indicar o tipo de mudança em comparação com a série principal. Se a mudança no valor for negativa, um triângulo aponta para baixo. Se a mudança no valor for positiva, o triângulo aponta para cima. Por padrão, um número negativo aparece em vermelho com um triângulo vermelho, e um número positivo aparece em verde com um triângulo verde. Essas cores podem ser trocadas ativando a configuração Valores positivos são ruins.
    • Mostrar como mudança percentual: o valor da série de comparação é mostrado com a mudança percentual em comparação com a série principal, com formatação condicional que indica o tipo de mudança. Se a mudança percentual no valor for negativa, um triângulo aponta para baixo. Se a mudança percentual no valor for positiva, o triângulo aponta para cima. Por padrão, uma porcentagem negativa aparece em vermelho com um triângulo vermelho, e uma porcentagem positiva aparece em verde com um triângulo verde. Essas cores podem ser trocadas ativando a configuração Valores positivos são ruins.
    • Calcular progresso: o valor do campo principal é dividido pelo valor do campo de comparação, e a porcentagem aparece como uma barra de progresso.
    • Calcular progresso (com porcentagem): o valor do campo principal é dividido pelo valor do campo de comparação. A porcentagem aparece como uma barra de progresso rotulada com a porcentagem e o valor do campo de comparação, como "83% de US $347,8 mil". Se a configuração Mostrar marcador estiver ativada, a barra de progresso também vai mostrar o marcador do campo de comparação, como "83% de US $347,8 mil de meta mensal".
  • Mostrar marcador: ative essa configuração para mostrar um marcador do campo de comparação. Por padrão, o marcador é o nome do campo de comparação. Se você quiser mostrar um marcador diferente, insira um novo marcador no campo Marcador.

Opções do menu "Formatação"

Ative a opção Ativar formatação condicional para definir regras que codificam por cores a visualização especificando valores de interesse.

Coleção de cores

Uma coleção permite criar visualizações e painéis temáticos que ficam bem juntos. Todas as coleções de cores integradas do Looker aparecem na página de documentação Coleções de cores. O administrador do Looker também pode criar uma coleção de cores personalizada para sua organização.

É possível escolher uma coleção de cores no menu Coleção de cores. As paletas que aparecem para as amostras de cores em cada regra vêm dessa coleção.

Incluir valores nulos como zero

Ative a configuração Incluir valores nulos como zero para que o Looker trate os valores nulos como zero. Incluir valores nulos como zero ajuda a eliminar erros matemáticos nos cálculos, evita lacunas nas visualizações e garante a agregação precisa de métricas.

Várias regras

É possível ter várias regras para formatação condicional. Para adicionar uma regra, siga estas etapas:

  1. Para adicionar uma regra, clique em Adicionar regra.
  2. Se você tiver mais de uma regra, as regras que estão mais acima na lista terão precedência sobre as regras que estão mais abaixo na lista. Para mudar a precedência de uma regra, clique no identificador e arraste a regra para cima ou para baixo na lista.
  3. Para excluir uma regra, clique em Excluir regra.

Formato

Para cada regra, use as opções do menu Formato para selecionar uma das seguintes opções de regra:

  • entre
  • igual a
  • maior que
  • menor que
  • não está entre
  • diferente de
  • não é nulo
  • nulo

Em seguida, insira valores de comparação nos campos de texto que aparecem, com base na sua seleção. Ao inserir valores na regra, não use separadores de milhares.

Estilos

Clique nas amostras de cores ao lado de Cor do plano de fundo ou Cor da fonte para abrir o menu do seletor de cores, que permite escolher ou personalizar uma cor:

  • Para escolher uma cor em uma paleta, clique na guia Paletas do menu do seletor de cores e use as setas esquerda e direita para rolar pelas paletas disponíveis. Selecione uma cor clicando em uma cor em uma das paletas.
  • Para selecionar uma cor personalizada, clique na guia Personalizado do seletor de paletas e use o controle deslizante de gradiente de cor e valor para escolher uma cor personalizada ou insira uma string hexadecimal RGB, como #2ca6cd, ou um nome de cor CSS, como mediumblue, no campo de entrada.

Agora que você já sabe como criar uma visualização de KPI (valor único) no Looker, talvez queira aprender a fazer o seguinte: