Variables URL du tableau de bord

Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.

Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana

Grafana peut appliquer des valeurs variables transmises en tant que paramètres de requête dans les URL du tableau de bord. Pour plus d'informations, consultez Gérer les liens du tableau de bord et les modèles et variables.

Transmission de variables en tant que paramètres de requête

Grafana interprète les paramètres des chaînes de requête préfixés par des variables dans var- le tableau de bord donné.

Par exemple, dans cette URL :

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

Le paramètre de requête var-example=value représente l'exemple de variable de tableau de bord avec une valeur devalue.

Transmission de plusieurs valeurs pour une variable

Pour transmettre plusieurs valeurs, répétez le paramètre de variable une fois pour chaque valeur.

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

Grafana interprète var-example=value1&var-example=value2 comme exemple de variable de tableau de bord avec deux valeurs : et. value1 value2

Ajouter des variables aux liens du tableau de bord

Grafana peut ajouter des variables aux liens du tableau de bord lorsque vous les générez à partir des paramètres d'un tableau de bord. Pour plus d'informations et pour savoir comment ajouter des variables, consultez Gérer les liens du tableau de bord.

Passer des filtres ad hoc

Les filtres ad hoc appliquent des filtres de clé ou de valeur à toutes les requêtes métriques qui utilisent une source de données spécifiée. Pour plus d'informations, consultez la section Filtres ad hoc.

Pour transmettre un filtre ad hoc en tant que paramètre de requête, utilisez la syntaxe de variable pour transmettre la variable de filtre ad hoc, et fournissez également la clé, l'opérateur comme valeur et la valeur sous forme de liste séparée par des tubes.

Par exemple, dans cette URL :

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

Le paramètre de requête var-adhoc=key|=|value applique le filtre ad hoc configuré en tant que variable de tableau de bord ad hoc à l'aide de la example_key clé, de l'=opérateur et de la example_value valeur.

Note

Lorsque vous partagez des URL avec des filtres ad hoc, n'oubliez pas de les encoder. Dans l'exemple ci-dessus, remplacez les tubes (|) par %7C et l'opérateur d'égalité (=) par%3D.

Contrôle de l'intervalle de temps à l'aide de l'URL

Pour définir la plage horaire d'un tableau de bord, utilisez les from paramètres totime,, et de time.window requête. Comme il ne s'agit pas de variables, le var- préfixe n'est pas nécessaire.