Variáveis de URL do painel

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

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

O Grafana pode aplicar valores variáveis passados como parâmetros de consulta nos URLs do painel. Para obter mais informações, consulte Gerenciar links de painel, modelos e variáveis.

Passando variáveis como parâmetros de consulta

O Grafana interpreta os parâmetros da sequência de caracteres de consulta prefixadosvar- como variáveis no painel fornecido.

Por exemplo, neste URL:

https://${your-domain}/path/to/your/dashboard?var-example=value

O parâmetro de consultavar-example=value representa o exemplo da variável do painel com um valor devalue.

Passando vários valores para uma variável

Para passar vários valores, repita o parâmetro variável uma vez para cada valor.

https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2

O Grafana interpretavar-example=value1&var-example=value2 como o exemplo da variável do painel com dois valores:value1value2 e.

Adicionar variáveis aos links do painel

O Grafana pode adicionar variáveis aos links do painel quando você as gera a partir das configurações de um painel. Para obter mais informações e etapas para adicionar variáveis, consulte Gerenciar links do painel.

Passando filtros ad hoc

Os filtros ad hoc aplicam filtros de chave ou valor a todas as consultas métricas que usam uma fonte de dados especificada. 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 transmitir a variável de filtro ad hoc e também forneça a chave, o operador como valor e o valor como uma lista separada por pontos.

Por exemplo, neste URL:

https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value

O parâmetro de consultavar-adhoc=key|=|value aplica o filtro ad hoc configurado como a variável adhoc do painel usando aexample_key chave, o= operador e oexample_value valor.

nota

Ao compartilhar URLs com filtros ad hoc, lembre-se de codificar o URL. No exemplo acima, substitua os tubos(|) por%7C e o operador de igualdade(=) por %3D.

Controlando o intervalo de tempo usando o URL

Para definir o intervalo de tempo de um painel, use os parâmetrosfromto,time, e detime.window consulta. Como essas não são variáveis, elas não exigem ovar- prefixo.