Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création de tableaux de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Une fois que vous avez créé un espace de travail Grafana et que vous vous êtes connecté, vous pouvez créer des tableaux de bord et modifier les paramètres en fonction de vos besoins.
**Topics**
+ [Création de tableaux de bord](v9-dash-creating.md)
+ [Ajouter ou modifier des panneaux](v9-dash-edit-panels.md)
+ [Modification des paramètres du tableau de bord](v9-dash-modify-settings.md)
+ [Variables URL du tableau de bord](v9-dash-dashboard-url-variables.md)
+ [Ajouter un panneau de bibliothèque à votre tableau de bord](v9-dash-manage-library-panels.md)
+ [Gérer l'historique des versions du tableau de bord](v9-dash-manage-version-history.md)
+ [Gestion des liens du tableau de bord](v9-dash-manage-dashboard-links.md)
+ [Modèle JSON du tableau de bord](v9-dash-dashboard-json-model.md)
# Création de tableaux de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
**Création d'un tableau de bord**
Les tableaux de bord et les panneaux vous permettent de présenter vos données sous forme visuelle à l'aide de Grafana. Chaque panneau a besoin d'au moins une requête pour afficher une visualisation. Avant de commencer, remplissez les conditions préalables suivantes.
+ Assurez-vous de disposer des autorisations appropriées. Pour en savoir plus sur les autorisations, consultez [Utilisateurs, équipes et autorisations](Grafana-administration-authorization.md).
+ Identifiez le tableau de bord auquel vous souhaitez ajouter le panneau.
+ Comprenez le langage de requête de la source de données cible.
+ Assurez-vous que la source de données pour laquelle vous rédigez une requête a été ajoutée.
Pour créer un tableau de bord :
1. Connectez-vous à Grafana, passez votre curseur sur le tableau de **bord**, puis cliquez sur **\$1** Nouveau tableau de bord.
1. Cliquez sur **Ajouter un nouveau panneau**.
1. Dans la première ligne de l'onglet **Requête**, cliquez sur la liste déroulante et sélectionnez une source de données.
1. Rédigez ou créez une requête dans le langage de requête de votre source de données.
1. Dans la liste **Visualisation**, sélectionnez un type de visualisation. Grafana affiche un aperçu des résultats de votre requête avec la visualisation appliquée. Pour plus d'informations, consultez [la section Options de visualisation.](v9-panels-viz.md)
1. Ajustez les paramètres du panneau de la manière suivante.
+ [Configurer les mappages de valeurs](v9-panels-configure-value-mappings.md)
+ [Options spécifiques à la visualisation](v9-panels-viz.md)
+ [Remplacer les valeurs des champs](v9-panels-configure-overrides.md)
+ [Configuration des seuils](v9-panels-configure-thresholds.md)
+ [Configuration des options standard](v9-panels-configure-standard-options.md)
**Note**
La plupart des visualisations nécessitent quelques ajustements avant d'afficher correctement les informations dont vous avez besoin.
1. Ajoutez une note pour décrire la visualisation (ou décrivez vos modifications), puis cliquez sur **Enregistrer** dans le coin supérieur droit de la page.
**Note**
Les notes sont utiles si vous devez rétablir une version précédente du tableau de bord.
**Configuration des lignes répétitives**
Vous pouvez configurer Grafana pour ajouter dynamiquement des panneaux ou des lignes à un tableau de bord en fonction de la valeur d'une variable. Les variables modifient dynamiquement vos requêtes sur toutes les lignes d'un tableau de bord. Pour plus d'informations sur les panneaux récurrents, voir [Configuration des panneaux répétitifs]().
Vous pouvez également répéter des lignes si des variables sont définies `Multi-value` ou `Include all values` sélectionnées.
Avant de commencer, assurez-vous que la requête inclut une variable à valeurs multiples, puis effectuez les étapes suivantes.
1. Sur la page d'accueil du tableau de bord, cliquez sur **Ajouter un panneau**.
1. Dans la boîte de dialogue **Ajouter un panneau**, cliquez sur **Ajouter une nouvelle ligne**.
1. Passez le curseur sur le titre de la ligne et cliquez sur l'icône en forme de roue dentée.
1. Dans la boîte de dialogue **Options de ligne**, ajoutez un titre et sélectionnez la variable pour laquelle vous souhaitez ajouter des lignes répétitives.
**Note**
Pour fournir du contexte aux utilisateurs du tableau de bord, ajoutez la variable au titre de la ligne.
**Pour déplacer un panneau**
1. Ouvrez le tableau de bord.
1. Cliquez sur le titre du panneau et faites-le glisser vers le nouvel emplacement. Vous pouvez placer un panneau sur un tableau de bord à n'importe quel endroit.
**Pour redimensionner un panneau**
1. Ouvrez le tableau de bord.
1. Pour ajuster la taille du panneau, cliquez et faites glisser le coin inférieur droit du panneau. Vous pouvez dimensionner un panneau de tableau de bord en fonction de vos besoins.
# Ajouter ou modifier des panneaux
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Après avoir créé un tableau de bord, vous pouvez ajouter, modifier ou supprimer des panneaux à tout moment.
+ **Afficher le tableau de bord** : pour afficher un tableau de bord, dans **le** menu principal, sélectionnez **Tableaux** de bord, puis choisissez le tableau de bord que vous souhaitez consulter. Vous devrez peut-être développer le dossier contenant le tableau de bord.
+ **Ajouter un panneau** : pour ajouter un panneau à un tableau de bord, cliquez sur l'icône **Ajouter un panneau** dans la barre de menu en haut de la page.
+ **Panneau** d'édition Pour modifier un panneau existant sur un tableau de bord, choisissez l'icône de menu qui apparaît lorsque vous survolez le panneau, puis choisissez **Modifier**.
+ **Supprimer le panneau** Pour supprimer un panneau existant sur un tableau de bord, choisissez l'icône de menu qui apparaît lorsque vous passez le curseur sur le panneau, puis choisissez **Supprimer**.
# Modification des paramètres du tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
La page des paramètres du tableau de bord vous permet de :
+ Modifiez les propriétés générales du tableau de bord, y compris les paramètres horaires.
+ Ajoutez des requêtes d'annotation.
+ Ajoutez des variables de tableau de bord.
+ Ajoutez des liens.
+ Afficher le modèle JSON du tableau de bord
Pour accéder à la page de configuration du tableau de bord :
1. Ouvrez un tableau de bord en mode édition.
1. Cliquez sur **Paramètres du tableau de bord** (icône en forme de roue dentée) en haut de la page.
**Modification des paramètres horaires du tableau de bord**
Ajustez les paramètres horaires du tableau de bord lorsque vous souhaitez modifier le fuseau horaire du tableau de bord, l'heure du navigateur local et spécifier des intervalles de temps d'actualisation automatique.
**Pour modifier les paramètres horaires du tableau de bord**
1. Sur la page des paramètres du **tableau** de bord, sélectionnez **Général**.
1. Accédez à la section **Options temporelles**.
1. Spécifiez les paramètres horaires conformément aux descriptions suivantes.
1. Le fuseau horaire indique le fuseau horaire local du service ou du système que vous surveillez. Cela peut être utile lors de la surveillance d'un système ou d'un service qui fonctionne sur plusieurs fuseaux horaires.
+ Grafana utilise le fuseau horaire sélectionné *par défaut* pour le profil utilisateur, l'équipe ou l'organisation. Si aucun fuseau horaire n'est spécifié pour le profil utilisateur, l'équipe dont l'utilisateur est membre ou l'organisation, Grafana utilise l'heure locale du navigateur.
+ Le fuseau horaire configuré pour le navigateur de l'utilisateur qui consulte, l'*heure du navigateur local*, est utilisé. Il s'agit généralement du même fuseau horaire que celui défini sur l'ordinateur.
+ Utilisez les [fuseaux horaires standard ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), y compris l'UTC.
+ L'**actualisation automatique** personnalise les options affichées pour le temps relatif et les options d'actualisation automatique Les entrées sont séparées par des virgules et acceptent toute unité de temps valide.
+ **Désormais, le délai** remplace l'`now`heure en saisissant un délai. Utilisez cette option pour tenir compte des délais connus dans l'agrégation des données afin d'éviter les valeurs nulles.
+ **Masquer le sélecteur de temps** supprime l'affichage du sélecteur de temps Grafana.
**Note**
Pour pouvoir contrôler le temps, vos données doivent inclure une colonne horaire. Consultez la documentation de votre [source de données](AMG-data-sources.md) spécifique pour plus d'informations sur l'inclusion d'une colonne de temps.
**Ajouter une requête d'annotation**
Une requête d'annotation est une requête qui demande des événements. Ces événements peuvent être visualisés sous forme de graphiques sur le tableau de bord sous forme de lignes verticales accompagnées d'une petite icône que vous pouvez survoler pour afficher les informations relatives à l'événement.
**Pour ajouter une requête d'annotation**
1. Sur la page des **paramètres du tableau** de bord, sélectionnez **Annotations.**
1. Sélectionnez **Ajouter une requête d'annotation**.
1. Entrez un nom et sélectionnez une source de données.
1. Complétez le reste du formulaire pour créer une requête et une annotation.
L'interface utilisateur de l'éditeur de requêtes change en fonction de la source de données que vous sélectionnez. Consultez la documentation sur les [sources de données](AMG-data-sources.md) pour savoir comment créer une requête.
**Ajouter une variable**
Les variables vous permettent de créer des tableaux de bord plus interactifs et dynamiques. Au lieu de coder en dur des éléments tels que les noms des serveurs, des applications et des capteurs dans vos requêtes métriques, vous pouvez utiliser des variables à leur place. Les variables sont affichées sous forme de listes déroulantes en haut du tableau de bord. Ces listes déroulantes permettent de modifier facilement les données affichées dans votre tableau de bord.
Pour plus d'informations sur les variables, consultez la section [Variables](v9-dash-variables.md).
1. Sur la page des **paramètres du tableau de bord**, cliquez sur **Variable** dans le menu de gauche, puis sur le bouton **Ajouter une variable**.
1. Dans la section **Général**, saisissez le nom de la variable. Il s'agit du nom que vous utiliserez ultérieurement dans les requêtes.
1. Sélectionnez un **type de** variable.
**Note**
Le type de variable que vous sélectionnez a un impact sur les champs que vous remplissez sur la page.
1. Définissez la variable et cliquez sur **Mettre à jour**.
**Ajouter un lien**
Les liens du tableau de bord vous permettent de placer des liens vers d'autres tableaux de bord et sites Web directement sous l'en-tête du tableau de bord. Les liens permettent de naviguer facilement vers d'autres tableaux de bord et contenus connexes.
1. Sur la page des **paramètres du tableau de bord**, cliquez sur **Liens** dans le menu de gauche, puis sur le bouton **Ajouter un lien**.
1. Entrez le titre, puis dans le champ **Type**, sélectionnez **Tableau de bord** ou **Lien**.
1. Pour ajouter un lien au tableau de bord, ajoutez une balise facultative, sélectionnez l'une des options du lien du tableau de bord, puis cliquez sur **Appliquer**.
**Note**
Les balises sont utiles pour créer une liste déroulante dynamique de tableaux de bord dotés tous d'une balise spécifique.
1. Pour ajouter un lien, ajoutez une URL et un texte d'infobulle qui s'affichent lorsque l'utilisateur survole le lien, sélectionnez une icône qui apparaît à côté du lien et sélectionnez l'une des options de lien du tableau de bord.
**Afficher le modèle JSON du tableau de bord**
Un tableau de bord dans Grafana est représenté par un objet JSON, qui stocke les métadonnées de son tableau de bord. Les métadonnées du tableau de bord incluent les propriétés du tableau de bord, les métadonnées des panneaux, les variables de modèle, les requêtes des panneaux, etc.
Pour afficher un modèle JSON de tableau de bord, sur la page des **paramètres du tableau de bord**, cliquez sur **JSON**.
Pour plus d'informations sur les champs JSON, consultez la section [Champs JSON](v9-dash-dashboard-json-model.md).
# Variables URL du tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Grafana peut appliquer des valeurs de variables transmises en tant que paramètres de requête dans le tableau de bord. URLs Pour plus d'informations, consultez [Gérer les liens du tableau de bord](v9-dash-manage-dashboard-links.md) et [les modèles et variables](v9-dash-variables.md).
**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 de`value`.
**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](v9-dash-manage-dashboard-links.md).
**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 URLs avec des filtres ad hoc, n'oubliez pas de coder l'URL. 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 `to``time`,, et de `time.window` requête. Comme il ne s'agit pas de variables, le `var-` préfixe n'est pas nécessaire.
# Ajouter un panneau de bibliothèque à votre tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Un panneau de bibliothèque est un panneau réutilisable que vous pouvez utiliser dans n'importe quel tableau de bord. Lorsque vous modifiez un panneau de bibliothèque, la modification se propage à toutes les instances où le panneau est utilisé. Les panneaux de bibliothèque rationalisent la réutilisation des panneaux sur plusieurs tableaux de bord.
Vous pouvez enregistrer un panneau de bibliothèque dans un dossier à côté des tableaux de bord enregistrés.
**Création d'un panneau de bibliothèque**
Lorsque vous créez un panneau de bibliothèque, le panneau du tableau de bord source est également converti en panneau de bibliothèque. Vous devez enregistrer le tableau de bord d'origine après la conversion d'un panneau.
1. Ouvrez un panneau en mode édition.
1. Dans les options d'affichage du panneau, cliquez sur l'option flèche vers le bas pour apporter des modifications à la visualisation.
1. Pour ouvrir la boîte de dialogue **Créer**, cliquez sur l'option **Panneaux de bibliothèque**, puis sur **Créer un panneau de bibliothèque**.
1. Dans **Nom du panneau Bibliothèque**, entrez le nom.
1. Dans **Enregistrer dans le dossier**, sélectionnez le dossier dans lequel enregistrer le panneau de bibliothèque.
1. Pour enregistrer vos modifications, cliquez sur **Créer le panneau de bibliothèque**.
1. Pour enregistrer le tableau de bord, cliquez sur **Enregistrer**.
Une fois le panneau de bibliothèque créé, vous pouvez le modifier à l'aide de n'importe quel tableau de bord sur lequel il apparaît. Après avoir enregistré les modifications, toutes les instances du panneau de bibliothèque reflètent ces modifications.
**Ajouter un panneau de bibliothèque à un tableau de bord**
Ajoutez un panneau de bibliothèque Grafana à un tableau de bord lorsque vous souhaitez fournir des visualisations à d'autres utilisateurs du tableau de bord.
1. Passez la souris sur l'option **Tableaux** de bord dans le menu de gauche, puis sélectionnez **Nouveau tableau de bord** dans les options déroulantes. La boîte de dialogue **Ajouter un panneau** s'ouvre.
1. Cliquez sur l'option **Ajouter un panneau** à partir de la bibliothèque de panneaux. Vous verrez la liste des panneaux de votre bibliothèque.
1. Filtrez la liste ou effectuez une recherche pour trouver le panneau que vous souhaitez ajouter.
1. Cliquez sur un panneau pour l'ajouter au tableau de bord.
**Dissociation d'un panneau de bibliothèque**
Dissociez un panneau de bibliothèque lorsque vous souhaitez apporter une modification au panneau sans affecter les autres instances du panneau de bibliothèque.
1. Passez la souris sur **Tableau de bord** dans le menu de gauche, puis cliquez sur **Panneaux de bibliothèque**.
1. Sélectionnez un panneau de bibliothèque utilisé dans différents tableaux de bord.
1. Sélectionnez le panneau dont vous souhaitez dissocier le lien.
1. Cliquez sur le titre du panneau, puis sur **Modifier**. Le panneau s'ouvre en mode édition.
1. Cliquez sur l'option **Dissocier** dans le coin supérieur droit de la page.
**Afficher la liste des panneaux de bibliothèque**
Dissociez un panneau de bibliothèque lorsque vous souhaitez apporter une modification au panneau sans affecter les autres instances du panneau de bibliothèque.
1. Passez la souris sur l'option **Tableau de bord** dans le menu de gauche, puis cliquez sur **Panneaux de bibliothèque**. Vous pouvez consulter la liste des panneaux de bibliothèque définis précédemment.
1. Recherchez un panneau de bibliothèque spécifique si vous connaissez son nom. Vous pouvez également filtrer les panneaux par dossier ou par type.
**Supprimer un panneau de bibliothèque**
Supprimez un panneau de bibliothèque lorsque vous n'en avez plus besoin.
1. Passez la souris sur **Tableau de bord** dans le menu de gauche, puis sélectionnez **Panneaux de bibliothèque**.
1. Sélectionnez le panneau que vous souhaitez supprimer.
1. Cliquez sur l'icône de suppression à côté du nom de la bibliothèque.
# Gérer l'historique des versions du tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Chaque fois que vous enregistrez une version de votre tableau de bord, une copie de cette version est enregistrée afin que les versions précédentes de votre tableau de bord ne soient jamais perdues. Une liste de ces versions est disponible en saisissant les paramètres du tableau de bord, puis en sélectionnant **Versions** dans le menu de gauche.
La fonction d'historique des versions du tableau de bord vous permet de comparer et de restaurer des versions de tableau de bord précédemment enregistrées.
**Comparaison de deux versions de tableau de bord**
Pour comparer deux versions de tableau de bord, sélectionnez les deux versions dans la liste que vous souhaitez comparer. Cliquez sur **Comparer les versions** pour voir la différence entre les deux versions.
Après avoir cliqué sur le bouton, vous serez redirigé vers la vue des différences. Par défaut, vous verrez un résumé textuel des modifications.
Si vous souhaitez voir le diff du JSON brut qui représente votre tableau de bord, vous pouvez également le faire en cliquant sur le bouton **Afficher le JSON Diff** en bas.
Si vous souhaitez rétablir la version que vous utilisez, vous pouvez le faire en cliquant sur le bouton **Restaurer à la version** en haut à droite.
**Restauration vers une version de tableau de bord précédemment enregistrée**
Si vous devez restaurer une version du tableau de bord précédemment enregistrée, vous pouvez soit cliquer sur le bouton **Restaurer** situé à droite d'une ligne de la liste des versions du tableau de bord, soit cliquer sur le bouton **Restaurer à la version** qui apparaît dans la vue des différences. Cliquez sur le bouton pour afficher la fenêtre contextuelle suivante vous demandant de confirmer la restauration.
Après la restauration d'une version précédente, une nouvelle version sera créée contenant exactement les mêmes données que la version précédente, mais avec un numéro de version différent. Cela est indiqué dans la **colonne Notes** de la ligne de la nouvelle version du tableau de bord. Cela est fait simplement pour s'assurer que les versions précédentes de votre tableau de bord ne sont pas affectées par la modification.
# Gestion des liens du tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Vous pouvez utiliser des liens pour naviguer entre les tableaux de bord couramment utilisés ou pour connecter d'autres personnes à vos visualisations. Les liens vous permettent de créer des raccourcis vers d'autres tableaux de bord, panneaux et même vers des sites Web externes.
Grafana prend en charge les liens de tableau de bord, les liens de panneau et les liens de données. Les liens du tableau de bord sont affichés en haut du tableau de bord. Les liens du panneau sont accessibles en cliquant sur une icône dans le coin supérieur gauche du panneau.
**Choix du lien à utiliser**
Commencez par déterminer comment vous naviguez actuellement entre les tableaux de bord. Si vous passez souvent d'un tableau de bord à l'autre et que vous avez du mal à trouver le même contexte dans chacun d'eux, les liens peuvent vous aider à optimiser votre flux de travail.
L'étape suivante consiste à déterminer le type de lien le mieux adapté à votre flux de travail. Même si tous les types de liens de Grafana sont utilisés pour créer des raccourcis vers d'autres tableaux de bord ou des sites Web externes, ils fonctionnent dans des contextes différents.
+ Si le lien concerne la plupart, sinon la totalité des panneaux du tableau de bord, utilisez les liens du tableau de bord.
+ Si vous souhaitez accéder à des panneaux spécifiques, utilisez les liens vers les panneaux.
+ Si vous souhaitez créer un lien vers un site externe, vous pouvez utiliser un lien de tableau de bord ou un lien de panneau.
+ Si vous souhaitez approfondir une série spécifique, ou même une seule mesure, utilisez des liens de données.
**Contrôle de l'intervalle de temps à l'aide de l'URL**
Pour contrôler la plage horaire d'un panneau ou d'un tableau de bord, vous pouvez fournir des paramètres de requête dans l'URL du tableau de bord :
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch.
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, `?time=1500000000000&time.window=10000` cela donnera une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
**Liens du tableau de bord**
Lorsque vous créez un lien vers un tableau de bord, vous pouvez inclure la plage de temps et les variables du modèle actuel pour accéder directement au même contexte dans un autre tableau de bord. Ainsi, vous n'avez pas à vous soucier de savoir si la personne à qui vous envoyez le lien consulte les bonnes données. Pour les autres types de liens, consultez la section [Variables de liaison de données]().
Les liens du tableau de bord peuvent également être utilisés comme raccourcis vers des systèmes externes, par exemple pour signaler [un GitHub problème avec le nom du tableau de bord actuel](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
Après avoir ajouté un lien au tableau de bord, celui-ci s'affichera dans le coin supérieur droit de votre tableau de bord.
**Ajouter des liens aux tableaux de bord**
Ajoutez des liens vers d'autres tableaux de bord en haut de votre tableau de bord actuel.
1. Lorsque vous consultez le tableau de bord que vous souhaitez associer, cliquez sur l'engrenage en haut de l'écran pour ouvrir les **paramètres du tableau de bord**.
1. Cliquez sur **Liens**, puis sur **Ajouter un lien au tableau de bord** ou sur **Nouveau**.
1. Dans **Type**, sélectionnez les **tableaux de bord.**
1. Sélectionnez les options de lien parmi les options suivantes.
+ **Avec des balises** : entrez des balises pour limiter les tableaux de bord liés à ceux contenant les balises que vous avez saisies. Sinon, Grafana inclut des liens vers tous les autres tableaux de bord.
+ **En tant que liste déroulante** : si vous créez des liens vers de nombreux tableaux de bord, vous souhaiterez probablement sélectionner cette option et ajouter un titre facultatif à la liste déroulante. Sinon, Grafana affiche les liens du tableau de bord côte à côte en haut de votre tableau de bord.
+ **Plage horaire** : sélectionnez cette option pour inclure la plage horaire du tableau de bord dans le lien. Lorsque l'utilisateur clique sur le lien, le tableau de bord associé s'ouvre avec la plage de temps indiquée déjà définie.
+ **Valeurs des variables** : sélectionnez cette option pour inclure dans le lien les variables de modèle actuellement utilisées comme paramètres de requête. Lorsque l'utilisateur clique sur le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien. Pour plus d'informations, consultez la section [Variables d'URL du tableau](v9-dash-dashboard-url-variables.md) de bord.
+ **Ouvrir dans un nouvel onglet** : sélectionnez cette option si vous souhaitez que le lien du tableau de bord s'ouvre dans un nouvel onglet ou une nouvelle fenêtre.
1. Cliquez sur **Ajouter**.
**Ajouter un lien URL à un tableau de bord**
Ajoutez un lien vers une URL en haut de votre tableau de bord actuel. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana.
1. Lorsque vous consultez le tableau de bord que vous souhaitez associer, cliquez sur l'engrenage en haut de l'écran pour ouvrir les **paramètres du tableau de bord**.
1. Cliquez sur **Liens**, puis sur **Ajouter un lien au tableau de bord** ou sur **Nouveau**.
1. Dans Type, sélectionnez **Lien**.
1. Sélectionnez les options de lien parmi les options suivantes.
+ **URL** : entrez l'URL vers laquelle vous souhaitez créer un lien. En fonction de la cible, vous souhaiterez peut-être inclure des valeurs de champ. Pour plus d'informations, consultez cet [exemple de Github](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
+ **Titre** : Entrez le titre que vous souhaitez que le lien affiche.
+ **Info-bulle** : Entrez l'infobulle que le lien doit afficher.
+ **Icône** : Choisissez l'icône que vous souhaitez afficher avec le lien.
+ **Plage horaire** : sélectionnez cette option pour inclure la plage horaire du tableau de bord dans le lien. Lorsque l'utilisateur clique sur le lien, le tableau de bord associé s'ouvre avec la plage de temps spécifiée définie.
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch.
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, `?time=1500000000000&time.window=10000` cela donnera une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
+ **Valeurs des variables** : sélectionnez cette option pour inclure dans le lien les variables de modèle actuellement utilisées comme paramètres de requête. Lorsque l'utilisateur clique sur le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien.
Le format de la variable est le suivant :
`https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
+ **Ouvrir dans un nouvel onglet** : sélectionnez cette option si vous souhaitez que le lien du tableau de bord s'ouvre dans un nouvel onglet ou une nouvelle fenêtre
1. Cliquez sur **Ajouter**.
**Mettre à jour un lien de tableau de bord**
Pour modifier ou mettre à jour un lien de tableau de bord existant, suivez cette procédure.
1. Dans **les paramètres du tableau de bord**, sous l'onglet **Liens**, cliquez sur le lien existant que vous souhaitez modifier.
1. Modifiez les paramètres, puis cliquez sur **Mettre à jour**.
**Dupliquer le lien d'un tableau de bord**
Pour dupliquer un lien de tableau de bord existant, cliquez sur l'icône de duplication à côté du lien existant que vous souhaitez dupliquer.
**Supprimer un lien vers un tableau de bord**
Pour supprimer un lien de tableau de bord existant, cliquez sur l'icône de corbeille à côté de l'icône dupliquée que vous souhaitez supprimer.
**Liens vers le panneau**
Chaque panneau peut avoir son propre ensemble de liens qui sont affichés dans le coin supérieur gauche du panneau. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana.
Pour voir les liens des panneaux disponibles, cliquez sur l'icône située dans le coin supérieur gauche d'un panneau.
+ **Ajout d'un lien vers** un panneau : Chaque panneau peut avoir son propre ensemble de liens qui sont affichés dans le coin supérieur gauche du panneau. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana. Cliquez sur l'icône située dans le coin supérieur gauche d'un panneau pour voir les liens vers les panneaux disponibles.
1. Passez votre curseur sur le panneau auquel vous souhaitez ajouter un lien, puis appuyez sur`e`. Vous pouvez également cliquer sur la flèche déroulante située à côté du titre du panneau, puis sur **Modifier**.
1. Dans l'onglet **Panneau**, faites défiler l'écran jusqu'à la section **Liens**.
1. Développez **les liens**, puis cliquez sur **Ajouter un lien**.
1. Entrez un **titre**. Le **titre** est une étiquette lisible par l'homme pour le lien qui sera affiché dans l'interface utilisateur.
1. Entrez l'**URL** vers laquelle vous souhaitez créer un lien. Vous pouvez même ajouter l'une des variables de modèle définies dans le tableau de bord. Appuyez sur `Ctrl+Space` ou `Cmd+Space` et cliquez dans le champ URL pour voir les variables disponibles. En ajoutant des variables de modèle au lien de votre panneau, le lien renvoie l'utilisateur vers le bon contexte, les variables pertinentes étant déjà définies.
Vous pouvez également utiliser des variables temporelles.
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch.
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, les `?time=1500000000000&time.window=10000` résultats indiquent une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
+ **Mettre à jour le lien d'un panneau**
1. Dans l'onglet **Panneau**, recherchez le lien que vous souhaitez modifier.
1. Cliquez sur l'icône **Modifier** (crayon) pour ouvrir la fenêtre Modifier le lien.
1. Apportez toutes les modifications nécessaires.
1. Cliquez sur **Enregistrer** pour enregistrer les modifications et fermer la fenêtre.
1. Cliquez sur **Enregistrer** dans le coin supérieur droit pour enregistrer les modifications apportées au tableau de bord.
+ **Supprimer un lien vers un panneau**
1. Dans l'onglet **Panneau**, recherchez le lien que vous souhaitez modifier.
1. Cliquez sur l'icône **X** à côté du lien que vous souhaitez supprimer.
1. Cliquez sur **Enregistrer** dans le coin supérieur droit pour enregistrer les modifications apportées au tableau de bord.
# Modèle JSON du tableau de bord
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Un tableau de bord dans Grafana est représenté par un objet JSON, qui stocke les métadonnées de son tableau de bord. Les métadonnées du tableau de bord incluent les propriétés du tableau de bord, les métadonnées des panneaux, les variables de modèle et les requêtes des panneaux.
Pour afficher le JSON d'un tableau de bord.
1. Accédez à un tableau de bord.
1. Dans le menu de navigation supérieur, cliquez sur l'icône des **paramètres du tableau de bord** (engrenage).
1. Cliquez sur **Modèle JSON**.
**champs JSON**
Lorsqu'un utilisateur crée un nouveau tableau de bord, un nouvel objet JSON de tableau de bord est initialisé avec les champs suivants.
**Note**
Dans le JSON suivant, id est affiché sous la forme null, qui est la valeur par défaut qui lui est attribuée jusqu'à ce qu'un tableau de bord soit enregistré. Une fois le tableau de bord enregistré, une valeur entière est attribuée au `id` champ.
```
{
"id": null,
"uid": "cLV5GDCkz",
"title": "New dashboard",
"tags": [],
"style": "dark",
"timezone": "browser",
"editable": true,
"graphTooltip": 1,
"panels": [],
"time": {
"from": "now-6h",
"to": "now"
},
"timepicker": {
"time_options": [],
"refresh_intervals": []
},
"templating": {
"list": []
},
"annotations": {
"list": []
},
"refresh": "5s",
"schemaVersion": 17,
"version": 0,
"links": []
}
```
Ce qui suit décrit chaque champ du JSON du tableau de bord.
| Name | Usage |
| --- | --- |
| **id** | identifiant numérique unique pour le tableau de bord (généré par la base de données) |
| **uid** | identifiant de tableau de bord unique pouvant être généré par n'importe qui. String (8-40) |
| **title** | titre actuel du tableau de bord |
| **tags** | balises associées au tableau de bord, un tableau de chaînes |
| **style** | thème du tableau de bord, tel que *sombre* ou *clair* |
| **timezone** | *fuseau horaire du tableau de bord, tel que *UTC* ou navigateur* |
| **modifiable** | si un tableau de bord est modifiable ou non |
| **Astuce graphique** | 0 pour aucun réticule ou infobulle partagé (par défaut), 1 pour un réticule partagé, 2 pour un réticule partagé et une infobulle partagée |
| **time** | plage de temps pour le tableau de bord, telle que les *6 dernières heures* ou les *7 derniers jours* |
| **sélecteur de temps** | métadonnées du timepicker, voir la section [timepicker](#v9-dash-dashboard-json-model) pour plus de détails |
| **modélisation** | modélisation des métadonnées, voir la [section relative aux modèles pour plus de détails](#v9-dash-dashboard-json-model) |
| **annotations** | métadonnées des annotations, voir les [annotations](v9-panels-annotate-visualizations.md) pour savoir comment les ajouter |
| **rafraîchir** | intervalle d'actualisation automatique |
| **schemaVersion ** | version du schéma JSON (entier), incrémentée chaque fois qu'une mise à jour de Grafana apporte des modifications audit schéma |
| **Version** | version du tableau de bord (entier), incrémentée à chaque mise à jour du tableau de bord |
| **panneaux** | matrice de panneaux (voir ci-dessous pour plus de détails) |
**Panneaux**
Les panneaux sont les éléments de base d'un tableau de bord. Il comprend des requêtes de source de données, des types de graphes, des alias, etc. Le panneau JSON se compose d'un tableau d'objets JSON, chacun représentant un panneau différent. La plupart des champs sont communs à tous les panneaux, mais certains champs dépendent du type de panneau. Voici un exemple de panneau JSON d'un panneau de texte.
```
"panels": [
{
"type": "text",
"title": "Panel Title",
"gridPos": {
"x": 0,
"y": 0,
"w": 12,
"h": 9
},
"id": 4,
"mode": "markdown",
"content": "# title"
}
```
**Taille et position du panneau**
La propriété GridPos décrit la taille et la position du panneau en coordonnées de la grille.
+ `w`: 1 à 24 (la largeur du tableau de bord est divisée en 24 colonnes)
+ `h`: En unités de hauteur de grille, chacune représente 30 pixels.
+ `x`: La position x, dans la même unité que`w`.
+ `y`: La position y, dans la même unité que`h`.
La grille a une gravité négative qui déplace les panneaux vers le haut s'il y a un espace vide au-dessus d'un panneau.
**Timepicker**
```
"timepicker": {
"collapse": false,
"enable": true,
"notice": false,
"now": true,
"refresh_intervals": [
"5s",
"10s",
"30s",
"1m",
"5m",
"15m",
"30m",
"1h",
"2h",
"1d"
],
"status": "Stable",
"type": "timepicker"
}
```
**Création de modèles**
Le `templating` champ contient un tableau de variables de modèle avec leurs valeurs enregistrées ainsi que d'autres métadonnées.
```
"templating": {
"enable": true,
"list": [
{
"allFormat": "wildcard",
"current": {
"tags": [],
"text": "prod",
"value": "prod"
},
"datasource": null,
"includeAll": true,
"name": "env",
"options": [
{
"selected": false,
"text": "All",
"value": "*"
},
{
"selected": false,
"text": "stage",
"value": "stage"
},
{
"selected": false,
"text": "test",
"value": "test"
}
],
"query": "tag_values(cpu.utilization.average,env)",
"refresh": false,
"type": "query"
},
{
"allFormat": "wildcard",
"current": {
"text": "apache",
"value": "apache"
},
"datasource": null,
"includeAll": false,
"multi": false,
"multiFormat": "glob",
"name": "app",
"options": [
{
"selected": true,
"text": "tomcat",
"value": "tomcat"
},
{
"selected": false,
"text": "cassandra",
"value": "cassandra"
}
],
"query": "tag_values(cpu.utilization.average,app)",
"refresh": false,
"regex": "",
"type": "query"
}
]
}
```