Configurar links de dados

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

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

Você pode usar variáveis de link de dados ou links de dados para criar links entre painéis.

Variáveis de link de dados

Você pode usar variáveis em links de dados para se referir a campos, rótulos e valores de séries. Para obter mais informações sobre links de dados, consulteLinks de dados.

Para ver uma lista de variáveis disponíveis, digite $ no campo URL do link de dados para ver uma lista de variáveis que você pode usar.

nota

Essas variáveis foram alteradas na versão 6.4, portanto, se você tiver uma versão mais antiga do Grafana, use o seletor de versão para selecionar documentos para uma versão mais antiga do Grafana.

Você também pode usar variáveis de modelo em seus URLs de links de dados, consulteAdicionar e gerenciar variáveis do painel.

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 (ou seja,? de=agora-6h&a=agora)

• $__from e $__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 namespace __series:

• __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. <LABEL>Se seu rótulo contiver pontos, use a sintaxe __field.labels [” “].

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 a 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

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 é 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=valor1
vários valores selecionados	var-myvar=valor1&var-myvar=valor2
selecionado Tudo	var-Myvar=Todos

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

Links de dados

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 mostrasse quatro servidores, você poderia adicionar um link de dados a um ou dois deles.

O link em si pode ser acessado de maneiras diferentes, dependendo da visualização. Para o gráfico, você precisa clicar em um ponto ou linha de dados; para um painel como Stat, Gauge ou Bar Gauge, você pode clicar em qualquer lugar na visualização para abrir o menu de contexto.

Você pode usar variáveis nos links de dados para enviar as pessoas para um painel detalhado com filtros de dados preservados. Por exemplo, você pode usar variáveis para especificar um intervalo de tempo, uma série e uma seleção de variáveis. Para ter mais informações, consulte Variáveis de link de dados.

sugestões de digitação antecipada

Ao criar ou atualizar um link de dados, pressione Cmd+Space ou Ctrl+Space no teclado para abrir as sugestões de digitação antecipada e adicionar variáveis ao seu URL com mais facilidade.

Adicionar um link de dados

1. Passe o cursor sobre o painel ao qual você deseja adicionar um link e pressione e. Ou clique na seta suspensa ao lado do título do painel e clique em Editar.

2. Na guia Campo, role para baixo até a seção Links de dados.

3. Expanda Links de dados e clique em Adicionar link.

4. Insira um título. O título é um rótulo legível para o link que será exibido na interface do usuário.

5. Insira o URL para o qual você deseja vincular.

   Você pode até mesmo adicionar uma das variáveis do modelo definidas no painel. Clique no campo URL e digite $ ou pressione Ctrl+Space ou Cmd+Space para ver uma lista das variáveis disponíveis. Ao adicionar variáveis de modelo ao link do painel, o link direciona o usuário para o contexto correto, com as variáveis relevantes já definidas. Para ter mais informações, consulte Variáveis de link de dados.

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

7. Clique em Salvar para salvar as alterações e fechar a janela.

8. Clique em Salvar no canto superior direito para salvar suas alterações no painel.

Atualizar um link de dados

1. Na guia Campo, encontre o link no qual você deseja fazer alterações.

2. Clique no ícone Editar (lápis) para abrir a janela do link Editar.

3. Faça alterações se for necessário.

4. Clique em Salvar para salvar as alterações e fechar a janela.

5. Clique em Salvar no canto superior direito para salvar suas alterações no painel.

Excluir um link de dados

1. Na guia Campo, encontre o link que você deseja excluir.

2. Clique no ícone X ao lado do link que você deseja excluir.

3. Clique em Salvar no canto superior direito para salvar suas alterações no painel.