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á.
Variáveis de URL do dashboard
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
O Grafana pode aplicar valores de variáveis passados como parâmetros de consulta nos URLs do dashboard. Para obter mais informações, consulte Gerenciar links do dashboard e Modelos e variáveis.
Passar variáveis como parâmetros de consulta
O Grafana interpreta os parâmetros da string de consulta prefixados com var- como variáveis no dashboard fornecido.
Por exemplo, neste URL:
https://${your-domain}/path/to/your/dashboard?var-example=value
O parâmetro de consulta var-example=value representa o exemplo da variável do dashboard com um valor de value.
Passar vários valores para uma variável
Para passar vários valores, repita o parâmetro da variável uma vez para cada valor.
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
O Grafana interpreta var-example=value1&var-example=value2 como o exemplo de variável do dashboard com dois valores: value1 e value2.
Adicionar variáveis aos links do dashboard
O Grafana pode adicionar variáveis aos links do dashboard quando você as gera das configurações de um dashboard. Para obter mais informações e as etapas para adicionar variáveis, consulte Gerenciar links do dashboard.
Passar filtros ad hoc
Os filtros ad hoc aplicam filtros de chave ou valor a todas as consultas de métricas que usam uma fonte de dados específica. Para obter mais informações, consulte Filtros ad hoc.
Para passar um filtro ad hoc como parâmetro de consulta, use a sintaxe da variável para passar a variável do filtro ad hoc e também forneça a chave, o operador como valor e o valor como uma lista separada por barras verticais.
Por exemplo, neste URL:
https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value
O parâmetro de consulta var-adhoc=key|=|value aplica o filtro ad hoc configurado como a variável ad hoc do dashboard usando a chave example_key, o operador = e o valor example_value.
nota
Ao compartilhar URLs com filtros ad hoc, lembre-se de codificar o URL. No exemplo acima, substitua as barras verticais (|) por %7C e o operador de igualdade (=) por %3D.
Controlar o intervalo de tempo usando o URL
Para definir o intervalo de tempo de um dashboard, use os parâmetros de consulta from, to, time e time.window. Como não são variáveis, elas não exigem o prefixo var-.
