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
<a name="v9-dash-dashboard-url-variables"></a>

****  
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](using-grafana-v10.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Grafana pode aplicar valores variáveis passados como parâmetros de consulta no painel. URLs Para obter mais informações, consulte [Gerenciar links do dashboard](v9-dash-manage-dashboard-links.md) e [Modelos e variáveis](v9-dash-variables.md).

**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](v9-dash-manage-dashboard-links.md).

**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-`.