As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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 campoi
(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.
-
Navegue até o painel ao qual você deseja adicionar o link de dados.
-
Passe o mouse sobre o painel para exibir o ícone do menu no canto superior direito.
-
No menu, escolha Editar para abrir o editor do painel.
-
No painel de edição do painel, role para baixo até a seção Links de dados e expanda-a.
-
Escolha Adicionar link.
-
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.
-
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. -
Se você quiser que o link seja aberto em uma nova guia, selecione Abrir em uma nova guia.
-
Escolha Salvar para salvar as alterações e fechar a caixa de diálogo.
-
Salve suas alterações no painel.