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.

Transformez les données

Les transformations constituent un moyen puissant de manipuler les données renvoyées par une requête avant que le système n'applique une visualisation. À l'aide de transformations, vous pouvez :

Pour les utilisateurs qui s'appuient sur plusieurs vues du même jeu de données, les transformations constituent une méthode efficace pour créer et gérer de nombreux tableaux de bord.

Vous pouvez également utiliser le résultat d'une transformation comme entrée d'une autre transformation, ce qui se traduit par un gain de performance.

Types de transformation

Grafana propose un certain nombre de méthodes pour transformer les données. Vous trouverez ci-dessous une liste complète des fonctions de transformation.

Ordre des transformations

Lorsqu'il y a plusieurs transformations, Grafana les applique dans l'ordre dans lequel elles sont répertoriées. Chaque transformation crée un jeu de résultats qui est ensuite transmis à la transformation suivante dans le pipeline de traitement.

L'ordre dans lequel Grafana applique les transformations a un impact direct sur les résultats. Par exemple, si vous utilisez une transformation Reduce pour condenser tous les résultats d'une colonne en une seule valeur, vous ne pouvez appliquer des transformations qu'à cette valeur unique.

Ajouter une fonction de transformation aux données

Les étapes suivantes vous guident dans l'ajout d'une transformation aux données. Cette documentation n'inclut pas les étapes pour chaque type de transformation.

Déboguer une transformation

Pour voir les ensembles de résultats d'entrée et de sortie de la transformation, cliquez sur l'icône de débogage (bogue) sur le côté droit de la ligne de transformation. Cela affichera les données d'entrée et le résultat de la transformation en sortie.

Les ensembles de résultats en entrée et en sortie peuvent vous aider à déboguer une transformation.

Désactiver une transformation

Vous pouvez désactiver ou masquer une transformation en cliquant sur l'icône Afficher (œil) en haut à droite de la ligne de transformation. Cela désactive les actions appliquées à cette transformation spécifique et peut aider à identifier les problèmes lorsque vous modifiez plusieurs transformations les unes après les autres.

Filtrer une transformation

Si votre transformation utilise plusieurs requêtes, vous pouvez les filtrer et appliquer la transformation sélectionnée à une seule des requêtes. Pour ce faire, cliquez sur l'icône du filtre en haut à droite de la ligne de transformation. Cela ouvre une liste déroulante contenant la liste des requêtes utilisées sur le panneau. À partir de là, vous pouvez sélectionner la requête que vous souhaitez transformer.

Vous pouvez également filtrer par annotations (y compris les exemplaires) pour leur appliquer des transformations. Dans ce cas, la liste des champs change pour refléter ceux de l'annotation ou de l'infobulle exemplaire.

L'icône du filtre est toujours affichée si votre panneau contient plusieurs requêtes ou sources de données (données de panneau ou d'annotation), mais elle risque de ne pas fonctionner si les transformations précédentes visant à fusionner les sorties des requêtes sont appliquées. Cela est dû au fait qu'une transformation prend le résultat de la précédente.

Supprimer une transformation

Nous vous recommandons de supprimer les transformations dont vous n'avez pas besoin. Lorsque vous supprimez une transformation, vous supprimez les données de la visualisation.

Prérequis :

Identifiez tous les tableaux de bord qui reposent sur la transformation et informez les utilisateurs des tableaux de bord concernés.