Configuration des options standard

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

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

Le modèle de données utilisé dans Grafana est une structure de table orientée en colonnes qui unifie les résultats des séries chronologiques et des requêtes de table. Chaque colonne de cette structure est appelée champ. Un champ peut représenter une seule série chronologique ou une colonne de table.

Les options de champ vous permettent de modifier le mode d'affichage des données dans vos visualisations. Les options et les dérogations que vous appliquez ne modifient pas les données, elles modifient la façon dont Grafana affiche les données. Lorsque vous modifiez une option, elle est appliquée à tous les champs, c'est-à-dire à toutes les séries ou colonnes. Par exemple, si vous remplacez l'unité par un pourcentage, tous les champs contenant des valeurs numériques sont affichés en pourcentages.

Pour obtenir la liste complète des options de formatage des champs, reportez-vous à la section Définitions des options standard.

Note

Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.

1. Ouvrez un tableau de bord, cliquez sur le titre du panneau, puis sur Modifier.

2. Dans le volet des options d'affichage du panneau, recherchez la section Options standard.

3. Sélectionnez les options standard que vous souhaitez appliquer.

4. Pour prévisualiser votre modification, cliquez en dehors de la zone d'options du champ que vous êtes en train de modifier ou appuyez sur Entrée.

Définitions des options standard

Cette section explique toutes les options standard disponibles.

Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.

La plupart des options de champ n'affectent pas la visualisation tant que vous n'avez pas cliqué en dehors de la zone d'options de champ que vous êtes en train de modifier ou que vous n'avez pas appuyé sur Entrée.

Note

Nous nous efforçons constamment d'ajouter et de développer des options pour toutes les visualisations. Il est donc possible que toutes les options ne soient pas disponibles pour toutes les visualisations.

Unité

Permet de choisir l'unité qu'un champ doit utiliser. Cliquez dans le champ Unité, puis naviguez vers le bas jusqu'à ce que vous trouviez l'unité souhaitée. L'unité que vous sélectionnez est appliquée à tous les champs sauf le temps.

Unités personnalisées

Vous pouvez également utiliser la liste déroulante des unités pour spécifier des unités personnalisées, un préfixe ou un suffixe personnalisé et des formats de date et d'heure.

Pour sélectionner une unité personnalisée, entrez l'unité et sélectionnez la dernière option Personnalisée : xxx dans le menu déroulant.

• suffixe : <suffix>pour l'unité personnalisée qui doit suivre la valeur.

• préfixe : <prefix>pour l'unité personnalisée qui doit précéder la valeur.

• heure : <format>pour les formats de date et heure personnalisés, tapez par exemple time:YYYY-MM-DD. Voir formats pour connaître la syntaxe et les options de format.

• si : <base scale><unit characters>pour les unités SI personnalisées. Par exemple : si : mF. Celui-ci est un peu plus avancé car vous pouvez spécifier à la fois une unité et l'échelle des données source. Donc, si vos données source sont représentées sous forme de milli (milliers de), préfixez l'unité avec ce caractère d'échelle SI.

• nombre : <unit>pour une unité de comptage personnalisée.

• devise : <unit>pour personnaliser une unité monétaire.

Vous pouvez également coller un emoji natif dans le sélecteur d'unités et le choisir comme unité personnalisée.

Unités de chaînes

Grafana peut parfois être trop agressif lorsqu'il s'agit d'analyser des chaînes et de les afficher sous forme de nombres. Pour configurer Grafana afin qu'il affiche la valeur de chaîne d'origine, créez un remplacement de champ et ajoutez une propriété d'unité avec l'unité String.

Min

Permet de définir la valeur minimale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour le calcul automatique basé sur toutes les séries et tous les champs.

Max

Permet de définir la valeur maximale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour le calcul automatique basé sur toutes les séries et tous les champs.

Décimales

Spécifiez le nombre de décimales que Grafana inclut dans la valeur rendue. Si vous laissez ce champ vide, Grafana tronque automatiquement le nombre de décimales en fonction de la valeur. Par exemple, 1.1234 s'affichera sous la forme 1,12 et 100,456 sous la forme 100.

Pour afficher toutes les décimales, définissez l'unité sur Chaîne.

Nom d'affichage

Permet de définir le titre d'affichage de tous les champs. Vous pouvez utiliser des variables.

Lorsque plusieurs statistiques, champs ou séries sont affichés, ce champ contrôle le titre de chaque statistique. Vous pouvez utiliser des expressions telles que $ {__field.name} pour n'utiliser que le nom de la série ou le nom du champ dans le titre.

Étant donné un champ nommé Temp et les libellés {"loc"="Pbi », « Sensor"="3"}

Syntaxe des expressions	Exemple	Effectue des rendus vers	Explication
$ {__Field.DisplayName}	Identique à la syntaxe	Temp {loc="PBI », capteur="3"}	Affiche le nom du champ et les libellés dans {} s'ils sont présents. S'il n'y a qu'une seule clé d'étiquette dans la réponse, Grafana affiche la valeur de l'étiquette sans les accolades.
$ {__field.name}	Identique à la syntaxe	Temp	Affiche le nom du champ (sans étiquette).
$ {__field.labels}	Identique à la syntaxe	loc="PBI », Capteur="3"	Affiche les étiquettes sans leur nom.
$ {__Field.Labels.x}	$ {__Field.Labels.loc}	PBI	Affiche la valeur de la clé d'étiquette spécifiée.
$ {__field.labels. __valeurs}	Identique à la syntaxe	PBI, 3	Affiche les valeurs des étiquettes séparées par une virgule (sans les clés d'étiquette).

Si la valeur est une chaîne vide après le rendu de l'expression pour un champ particulier, la méthode d'affichage par défaut est utilisée.

Schéma de couleurs

Les options de couleur et leur effet sur la visualisation dépendent de la visualisation sur laquelle vous travaillez. Certaines visualisations proposent différentes options de couleur.

Vous pouvez spécifier une seule couleur ou sélectionner un jeu de couleurs continu (dégradé) en fonction d'une valeur. La couleur continue interpole une couleur en utilisant le pourcentage d'une valeur par rapport aux valeurs min et max.

Sélectionnez l'une des palettes suivantes :

Mode couleur	Description
Couleur unique	Spécifiez une seule couleur, utile dans une règle de remplacement
À partir des seuils	Demande à Grafana de prendre la couleur correspondant au seuil correspondant
Palette classique	Grafana attribuera une couleur en recherchant une couleur dans une palette par index de série. Utile pour les graphiques, les diagrammes à secteurs et autres visualisations de données catégoriques
Vert-jaune-rouge (par valeur)	Schéma de couleurs continu
Bleu-jaune-rouge (par valeur)	Schéma de couleurs continu
Blues (par valeur)	Schéma de couleurs continu (fond du panneau en bleu)
Rouges (par valeur)	Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu)
Verts (par valeur)	Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu)
Violet (par valeur)	Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu)

Aucune valeur

Entrez ce que Grafana doit afficher si la valeur du champ est vide ou nulle. La valeur par défaut est un tiret (-).