Configurer les remplacements de champs

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

Les remplacements vous permettent de personnaliser les paramètres de visualisation pour des champs ou des séries spécifiques. Pour ce faire, il faut ajouter une règle de dérogation qui cible un ensemble particulier de champs et qui peut chacun définir plusieurs options.

Par exemple, vous définissez l'unité pour tous les champs qui incluent le texte en bytes ajoutant une dérogation à l'aide du matcher Fields with name matching regex, puis en ajoutant l'option Unit à la règle de remplacement.

Exemple 1 : température du format

Supposons que notre ensemble de résultats soit un bloc de données composé de deux champs : time ettemperature.

time	temperature
2020-01-02 03:04:00	45.0
2020-01-02 03:05:00	47,0
2020-01-02 03:06:00	48,0

Chaque champ (colonne) de cette structure peut être associé à des options de champ qui modifient la façon dont ses valeurs sont affichées. Cela signifie que vous pouvez, par exemple, régler l'unité sur Température > Celsius, ce qui donne le tableau suivant :

time	temperature
2020-01-02 03:04:00	45,0 °C
2020-01-02 03:05:00	47,0 °C
2020-01-02 03:06:00	48,0 °C

De plus, la décimale n'est pas obligatoire, nous pouvons donc la supprimer. Vous pouvez changer les décimales d'auto à zéro (0), ce qui donne le tableau suivant :

time	temperature
2020-01-02 03:04:00	45 °C
2020-01-02 03:05:00	47 °C
2020-01-02 03:06:00	48 °C

Exemple 2 : Formater la température et l'humidité

Supposons que notre jeu de résultats soit un bloc de données composé de quatre champs : timehigh temp,low temp, ethumidity.

time	haute température	basse température	humidité
2020-01-02 03:04:00	45.0	30.0	67
2020-01-02 03:05:00	47,0	34,0	68
2020-01-02 03:06:00	48,0	31,0	68

Ajoutons l'unité Celsius et éliminons la décimale. Cela donne le tableau suivant :

time	haute température	basse température	humidité
2020-01-02 03:04:00	45 °C	30 °C	67 °C
2020-01-02 03:05:00	47 °C	34 °C	68 °C
2020-01-02 03:06:00	48 °C	31 °C	68 °C

Les champs de température semblent bons, mais l'humidité doit maintenant être modifiée. Nous pouvons résoudre ce problème en appliquant une dérogation aux options de champ au champ d'humidité et en modifiant l'unité sur Divers > pourcentage (0-100).

time	haute température	basse température	humidité
2020-01-02 03:04:00	45 °C	30 °C	67 %
2020-01-02 03:05:00	47 °C	34 °C	68 %
2020-01-02 03:06:00	48 °C	31 °C	68 %

Ajouter une dérogation à un champ

Une règle de remplacement de champ permet de personnaliser les paramètres de visualisation pour un champ ou une série spécifique.

Pour ajouter un remplacement de champ

1. Modifiez le panneau auquel vous souhaitez ajouter une dérogation.

2. Dans le volet latéral des options du panneau, choisissez Ajouter un remplacement de champ en bas du volet.

3. Sélectionnez les champs auxquels une règle de dérogation sera appliquée :

   • Champs avec nom — Sélectionnez un champ dans la liste de tous les champs disponibles. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur ne sont appliquées qu'à ce seul champ.

   • Champs dont le nom correspond à une expression régulière : spécifiez les champs à remplacer par une expression régulière. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs dont le nom correspond à l'expression régulière. Cela sélectionne les champs à remplacer, mais ne les renomme pas ; pour ce faire, utilisez la transformation Rename by regex.

   • Champs avec type : sélectionnez les champs par type, par exemple chaîne, numérique, etc. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs correspondant au type sélectionné.

   • Champs renvoyés par requête : sélectionnez tous les champs renvoyés par une requête spécifique, par exemple A, B ou C. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs renvoyés par la requête sélectionnée.

4. Choisissez Ajouter une propriété de remplacement.

5. Sélectionnez l'option de champ que vous souhaitez appliquer.

6. Entrez les options en ajoutant des valeurs dans les champs. Pour rétablir les valeurs par défaut des options, supprimez le texte blanc dans les champs.

7. Continuez à ajouter des remplacements à ce champ en choisissant Ajouter une propriété de remplacement, ou vous pouvez choisir Ajouter un remplacement et sélectionner un autre champ auquel ajouter des remplacements.

8. Lorsque vous avez terminé, choisissez Enregistrer pour enregistrer toutes les modifications du panneau sur le tableau de bord.

Supprimer une dérogation à un champ

Supprimez une dérogation de champ lorsque vous n'en avez plus besoin. Lorsque vous supprimez une dérogation, l'apparence de la valeur reprend par défaut son format d'origine. Cette modification a un impact sur les tableaux de bord et les utilisateurs de tableaux de bord qui dépendent d'un panneau concerné.

Pour supprimer un remplacement de champ

1. Modifiez le panneau qui contient la dérogation que vous souhaitez supprimer.

2. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

3. Choisissez la dérogation que vous souhaitez supprimer, puis choisissez l'icône de corbeille associée.

Afficher les remplacements de champs

Vous pouvez voir les remplacements de champs dans les options d'affichage du panneau.

1. Modifiez le panneau qui contient les remplacements que vous souhaitez afficher.

2. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

Note

Les paramètres de remplacement qui apparaissent dans l'onglet Tous sont les mêmes que ceux qui apparaissent dans l'onglet Remplacements.

Modification d'un remplacement de champ

Modifiez une dérogation de champ lorsque vous souhaitez apporter des modifications à un paramètre de dérogation. La modification que vous apportez prend effet immédiatement.

Pour modifier un remplacement de champ

1. Modifiez le panneau qui contient les dérogations que vous souhaitez modifier.

2. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

3. Localisez la dérogation que vous souhaitez modifier.

4. Effectuez l'une des opérations suivantes :

   • Modifiez les paramètres des remplacements ou des paramètres de sélection de champs existants.

   • Supprimez les propriétés de remplacement existantes en choisissant le X à côté de la propriété.

   • Ajoutez une propriété de remplacement en choisissant Ajouter une propriété de remplacement.