Linking (Vinculando)

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

Para espaços de trabalho do Grafana compatíveis com a versão 9.x do Grafana, consulteTrabalhando na versão 9 do Grafana.

Você pode usar links para navegar entre painéis comumente usados ou conectar outras pessoas às suas visualizações. Os links permitem criar atalhos para outros painéis, painéis e até sites externos.

O Amazon Managed Grafana oferece suporte a links de painéis, links de painel e links de dados. Os links do painel são exibidos na parte superior do painel. Os links do painel são acessíveis ao escolher um ícone no canto superior esquerdo do painel.

Qual link você deve usar?

Comece examinando como você está navegando atualmente entre os painéis. Se você costuma alternar entre um conjunto de painéis e se esforçar para encontrar o mesmo contexto em cada um, os links podem ajudar a otimizar seu fluxo de trabalho.

A próxima etapa é descobrir qual tipo de link é ideal para seu fluxo de trabalho. Embora todos os tipos de links no Grafana sejam usados para criar atalhos para outros painéis ou sites externos, eles funcionam em contextos diferentes.

• Para adicionar links relacionados à maioria ou a todos os painéis no painel, useLinks de painel.

• Para detalhar painéis específicos, useLinks do painel.

• Para criar links para sites externos, você pode usar um link de painel ou um link de painel.

• Para detalhar uma série específica, ou até mesmo uma única medição, useLinks de dados.

Controlando o intervalo de tempo usando o URL

Você pode controlar o intervalo de tempo de um painel ou painel fornecendo os seguintes parâmetros de consulta na URL do painel:

• fromdefine o limite inferior do intervalo de tempo, especificado em ms epoch.

• todefine o limite superior do intervalo de tempo, especificado em ms epoch.

• timeetime.window defina um intervalo de tempotime-time.window/2 detime+time.window/2 a. Ambos os parâmetros devem ser especificados em milissegundos. Por exemplo,?time=1500000000000&time.window=10000 resultará em um intervalo de tempo de 10 segundos de 1499999995000 a 1500000005000

Variáveis de link de dados

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

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

Você também pode usar variáveis de modelo em seus URLs de links de dados. Para obter mais informações, consulte Modelos e variáveis.

Variáveis de intervalo

É possível usar as variáveis a seguir para incluir o intervalo de tempo atual no URL do link de dados:

• __url_time_range— O intervalo de tempo do painel atual; por exemplo,?from=now-6h&to=now

• $__from and $__to— Para obter mais informações, consulte [Variáveis globais] ({{< relref “.. /variables/tipos variáveis/variáveis globais. md #__from -e-__to” >}}).

Variáveis de série

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

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

• __series.labels.<LABEL>— Adiciona o valor do rótulo ao URL. Se seu rótulo contiver pontos, use a__series.labels["<LABEL>"] sintaxe.

Variáveis de campo

Variáveis específicas de campo estão disponíveis no__field namespace:

• __field.name— O nome do campo

Variáveis de valor

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

• __value.time— A data e hora do valor (Unix ms epoch) para o URL; por exemplo,?time=1560268814105

• __value.raw— O valor bruto

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

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

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

Variáveis de modelo

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

Usevar-myvar=${myvar}, ondemyvar está o nome da variável de modelo que corresponde ao nome do painel atual que você deseja usar.

Para adicionar todas as variáveis do painel atual ao URL, use__all_variables.