Configurar links de dados

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

Os links de dados permitem que você forneça um contexto mais granular aos seus links. Você pode criar links que incluam o nome da série ou até mesmo o valor abaixo do cursor. Por exemplo, se sua visualização mostrar quatro servidores, você poderá adicionar um link de dados a um ou dois deles. Você também pode vincular painéis usando links de dados.

O link em si pode ser acessado de maneiras diferentes, dependendo da visualização. Para a visualização de séries temporais, por exemplo, você escolhe um ponto ou linha de dados. Para visualizações de grandes áreas, como estatísticas, medidor ou medidor de barras, você pode escolher qualquer lugar na visualização para abrir o menu de contexto.

Se houver apenas um link de dados na visualização, escolher qualquer lugar na visualização abrirá o link em vez do menu de contexto.

Visualizações suportadas

• Gráfico de barras

• Medidor de barras

• Vela

• Canvas

• Medidor

• Mapa geográfico

• Mapa de calor

• Histograma

• Gráfico de pizza

• Stat

• Cronograma estadual

• Histórico de status

• Tabela

• Séries temporais

• Tendência

Variáveis de link de dados

As variáveis nos links de dados permitem que você envie pessoas para um painel detalhado com filtros de dados preservados. Por exemplo, você pode usar a variável para especificar um rótulo, intervalo de tempo, série ou seleção de variável.

Para ver uma lista das variáveis disponíveis, digite $ no campo URL do link de dados.

Você também pode usar variáveis de modelo em seus URLs de links de dados, consulteVariáveis.

Variáveis do painel de intervalo de tempo

Essas variáveis permitem que você inclua o intervalo de tempo atual no URL do link de dados.

• __url_time_range— intervalo de tempo atual do painel (i.e.?from=now-6h&to=now)

• $__from - Para obter mais informações, consulte Variáveis globais.

• $__to - Para obter mais informações, consulte Variáveis globais.

Variáveis da série

Variáveis específicas da série estão disponíveis no __series namespace:

• __series.name— nome da série para o URL

Variáveis de campo

As variáveis específicas do campo estão disponíveis no namespace: __field

• __field.name— o nome do campo

• __field.labels.<LABEL>— valor do rótulo para o URL. Se sua etiqueta contiver pontos, use a __field.labels["<LABEL>"] sintaxe.

Variáveis de valor

Variáveis específicas de valor estão disponíveis no namespace: __value

• __value.time— data e hora do valor (Unix ms epoch) para o URL (ou seja,) ?time=1560268814105

• __value.raw— valor bruto

• __value.numeric— representação numérica de um valor

• __value.text— representação em texto de um valor

• __value.calc— nome do cálculo se o valor for resultado do cálculo

O uso de variáveis específicas de valor em links de dados pode mostrar resultados diferentes, dependendo da opção definida no modo Tooltip.

Variáveis de dados

Para acessar valores de outros campos, use:

• __data.fields[i]— Valor do campo i (na mesma linha).

• __data.fields["NameOfField"]— Valor do campo usando nome em vez de índice.

• __data.fields[i].labels.cluster— Acesse os rótulos de outro campo.

Variáveis do modelo

Ao vincular a outro painel que usa variáveis de modelo, selecione valores variáveis para quem clicar no link.

${var-myvar:queryparam}— onde var-myvar está o nome da variável de modelo que corresponde a uma no painel atual que você deseja usar.

Estado variável	Resultado na URL criada
selecionou um valor	var-myvar=value1
vários valores selecionados	var-myvar=value1&var-myvar=value2
selecionado All	var-myvar=All

Se você quiser adicionar todas as variáveis do painel atual ao URL, use${__all_variables}.

Adicionando um link de dados

Você pode adicionar links de dados aos seus painéis.

1. Navegue até o painel ao qual você deseja adicionar o link de dados.

2. Passe o mouse sobre o painel para exibir o ícone do menu no canto superior direito.

3. No menu, escolha Editar para abrir o editor do painel.

4. No painel de edição do painel, role para baixo até a seção Links de dados e expanda-a.

5. Escolha Adicionar link.

6. Na caixa de diálogo que se abre, insira um Título. Esse é um rótulo legível para o link, que será exibido na interface do usuário.

7. Insira o URL ou a variável para a qual você deseja vincular.

   Para adicionar uma variável de link de dados, selecione o campo URL e, em seguida, insira $ ou pressione Ctrl+Espaço ou Cmd+Espaço para ver uma lista das variáveis disponíveis.

8. Se você quiser que o link seja aberto em uma nova guia, selecione Abrir em uma nova guia.

9. Escolha Salvar para salvar as alterações e fechar a caixa de diálogo.

10. Salve suas alterações no painel.