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.
# Tableaux de bord dans Grafana version 9
` à la fin. Pour consulter les périodes fiscales, utilisez `fQ (fiscal quarter)` et unités de `fy (fiscal year)` temps.
L'opérateur plus vous permet d'avancer dans le temps par rapport au présent. Par exemple, vous pouvez utiliser cette fonctionnalité pour examiner les données prédites dans le futur.
Le tableau suivant fournit des exemples de plages relatives.
| Exemple de plage relative | De | À |
| --- | --- | --- |
| Les 5 dernières minutes | `now-5m` | `now` |
| Jusqu'à présent | `now/d` | `now` |
| Cette semaine | `now/w` | `now/w` |
| Jusqu'à présent cette semaine | `now/w` | `now` |
| Ce mois-ci | `now/M` | `now/M` |
| Ce mois-ci, jusqu'à présent | `now/M` | `now` |
| Mois précédent | `now-1M/M` | `now-1M/M` |
| Cette année, jusqu'à présent | `now/Y` | `now` |
| Cette année | `now/Y` | `now/Y` |
| Exercice financier précédent | `now-1y/fy` | `now-1y/fy` |
**Note**
Grafana Alerting ne prend pas en charge les horodatages `now+n` futurs ni le *début `now-1n/n` de n jusqu'à la fin de n.*
**Contrôles de plage de temps courants**
Les commandes horaires du tableau de bord et du panneau ont une interface utilisateur commune. Ce qui suit décrit les contrôles de plage de temps courants.
+ La plage horaire actuelle, également appelée *sélecteur de temps*, indique la plage de temps actuellement affichée dans le tableau de bord ou le panneau que vous consultez. Passez votre curseur sur le champ pour voir les horodatages exacts de la plage et leur source (par exemple, le navigateur local). Cliquez sur la *plage horaire actuelle* pour la modifier. Vous pouvez modifier l'heure actuelle en utilisant une *plage de temps relative*, telle que les 15 dernières minutes, ou une plage de temps absolue, telle que `2020-05-14 00:00:00` à`2020-05-15 23:59:59`.
+ La **plage de temps relative** peut être sélectionnée dans la liste des **plages de temps relatives**. Vous pouvez filtrer la liste à l'aide du champ de saisie situé en haut. Quelques exemples de plages horaires incluent les *30 dernières minutes*, les *12 dernières heures*, les *7 derniers jours*, les *2 dernières années*, *hier*, *avant-hier*, *ce jour la semaine dernière*, *aujourd'hui jusqu'à présent*, *cette semaine jusqu'à présent* et *Ce mois jusqu'à présent*.
+ La **plage de temps absolue** peut être définie de deux manières : en saisissant des valeurs temporelles exactes ou relatives dans les champs **De** et **à** et en cliquant sur **Appliquer la plage de temps**, ou en cliquant sur une date ou une plage de dates dans le calendrier affiché lorsque vous cliquez sur le champ **De ou **de**** fin. Pour appliquer vos sélections, cliquez sur **Appliquer la plage horaire**.
*Autres fonctionnalités de plage horaire*
1. **Pour effectuer un zoom arrière, cliquez sur **Cmd\$1Z ou Ctrl\$1Z**.** Cliquez sur l'icône pour afficher une plage de temps plus étendue dans la visualisation du tableau de bord ou du panneau.
1. Pour utiliser la fonction de zoom avant, cliquez et faites glisser pour sélectionner la plage de temps dans la visualisation que vous souhaitez afficher.
**Note**
Le zoom avant ne s'applique qu'aux visualisations graphiques.
*Actualiser les tableaux de bord*
Cliquez sur l'icône **Actualiser le tableau de bord** pour exécuter immédiatement chaque requête sur le tableau de bord et actualiser les visualisations. Grafana annule toutes les demandes en attente lorsque vous déclenchez une actualisation.
Par défaut, Grafana n'actualise pas automatiquement le tableau de bord. Les requêtes sont exécutées selon leur propre calendrier en fonction des paramètres du panneau. Toutefois, si vous souhaitez actualiser régulièrement le tableau de bord, cliquez sur la flèche vers le bas à côté de l'icône **Actualiser le tableau de bord**, puis sélectionnez un intervalle d'actualisation.
**Contrôlez la plage horaire à l'aide d'une URL**
Vous pouvez contrôler la plage horaire d'un tableau de bord en fournissant les paramètres de requête suivants 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 ou en [temps relatif.](#v9-dash-setting-dashboard-time-range)
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch ou en temps relatif.
+ `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.
# Création de tableaux de bord
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
.
**Exemples**
Les variables sont répertoriées dans des listes déroulantes en haut de l'écran. Sélectionnez différentes variables pour voir comment les visualisations changent.
Pour voir les paramètres des variables, accédez à **Paramètres du tableau de bord > Variables**. Cliquez sur une variable dans la liste pour voir ses paramètres.
Les variables peuvent être utilisées dans les titres, les descriptions, les panneaux de texte et les requêtes. Les requêtes dont le texte commence par `$` sont des modèles. Tous les panneaux ne comporteront pas de modèles de requêtes.
**Bonnes pratiques variables**
+ Les listes déroulantes de variables sont affichées dans l'ordre dans lequel elles sont répertoriées dans la liste des variables dans les **paramètres du tableau de bord.**
+ Placez les variables que vous allez souvent modifier en haut, afin qu'elles apparaissent en premier (à l'extrême gauche du tableau de bord).
# Ajouter et gérer des variables
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Cela produirait la liste déroulante suivante :
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
Seuls `text` les noms de groupes de `value` capture et de capture sont pris en charge.
##
}`— Ce format vous permet de mieux contrôler la façon dont Grafana interprète les valeurs. Pour plus d'informations, consultez la section *Options avancées de format variable*.
+ `[[varname]]`— Ne pas utiliser. Cette syntaxe est ancienne et est obsolète. Il sera supprimé dans une future version.
Avant que les requêtes ne soient envoyées à votre source de données, la requête est *interpolée*, ce qui signifie que la variable est remplacée par sa valeur actuelle. Pendant l'interpolation, la valeur de la variable peut être *évitée* afin de se conformer à la syntaxe du langage de requête et à l'endroit où elle est utilisée. Par exemple, une variable utilisée dans une expression regex dans une requête InfluxDB ou Prometheus sera échappée à l'expression régulière.
**Options avancées de format variable**
Le formatage de l'interpolation variable dépend de la source de données, mais dans certains cas, vous souhaiterez peut-être modifier le formatage par défaut.
Par exemple, la source de données MySQL par défaut consiste à joindre plusieurs valeurs séparées par des virgules par des guillemets :. `'server01','server02'` Dans certains cas, vous souhaiterez peut-être avoir une chaîne séparée par des virgules sans guillemets :. `server01,server02` Vous pouvez y parvenir grâce aux options avancées de mise en forme des variables répertoriées ci-dessous.
**Syntaxe générale**
Syntaxe : `${var_name:option}`
Si une option de mise en forme non valide est spécifiée, `glob` c'est l' default/fallback option.
**CSV**
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
**Distribué - OpenTSDB**
Formate les variables avec plusieurs valeurs dans un format personnalisé pour OpenTSDB.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
**Devis double**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `\"` et `"` met chaque valeur entre guillemets avec. `"`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
**Globe - Graphite**
Formate les variables comportant plusieurs valeurs dans un glob (pour les requêtes Graphite).
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
**JSON**
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene - Elasticsearch**
Formate les variables avec plusieurs valeurs au format Lucene pour Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Code en pourcentage**
Formate les variables à valeurs uniques et multiples à utiliser dans les paramètres d'URL.
```
servers = [ 'foo()bar BAZ', 'test2' ]
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
**Tuyau**
Formate les variables comportant plusieurs valeurs dans une chaîne séparée par des tubes.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
**Brut**
Désactive le formatage spécifique à la source de données, tel que les guillemets simples dans une requête SQL.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
Formate les variables comportant plusieurs valeurs dans une chaîne regex.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
**Devis unique**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `\'` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
**Chaîne SQL**
Formate les variables à valeurs uniques ou multiples dans une chaîne séparée par des virgules, saisit chaque valeur par `''` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = [ "test'1", "test2" ]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
**Text**
Formate les variables à valeurs uniques et multiples dans leur représentation textuelle. Pour une seule variable, elle renverra simplement la représentation textuelle. Pour les variables à valeurs multiples, elle renverra la représentation textuelle combinée avec`+`.
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
**Paramètres Query (Requête)**
Formate les variables à valeurs uniques et multiples dans leur représentation des paramètres de requête. Exemple : `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Evaluation de l'utilisation du tableau