Transformations

Mode de mise au point

Transformations - Amazon Managed Grafana

Appliquer une transformation Types et options de transformation

Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.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 9.x de Grafana, voir. Travailler dans la version 9 de Grafana

Les transformations traitent le jeu de résultats avant qu'il ne soit transmis à la visualisation. Vous pouvez accéder aux transformations dans l'onglet Transformation de l'éditeur de panneaux Amazon Managed Grafana.

Vous pouvez utiliser des transformations pour renommer des champs, joindre des séries chronologiques distinctes, effectuer des calculs entre des requêtes, etc. Si vous avez des tableaux de bord volumineux ou des requêtes volumineuses, la possibilité de réutiliser le résultat de la requête d'un panneau à l'autre peut apporter un gain de performance considérable.

Note

Les transformations se traduisent parfois par des données qui ne peuvent pas être représentées graphiquement. Dans ce cas, Amazon Managed Grafana affiche une suggestion concernant la visualisation. Choisissez la suggestion pour passer à la visualisation de tableaux. Cela vous permet souvent de mieux comprendre les effets de la transformation sur vos données.

Amazon Managed Grafana applique les transformations dans l'ordre dans lequel elles sont répertoriées à l'écran. Chaque transformation crée un nouveau jeu de résultats qui est transmis à la transformation suivante du pipeline.

La commande peut faire une énorme différence dans l'apparence de vos résultats. Par exemple, si vous utilisez la transformation de réduction pour condenser tous les résultats d'une colonne en une seule valeur, vous ne pouvez appliquer des transformations qu'à cette valeur unique.

Prérequis

Avant d'appliquer des transformations, toutes les conditions suivantes doivent être remplies :

Vous avez saisi une requête et renvoyé des données provenant d'une source de données. Pour plus d'informations sur les requêtes, consultez la section Requêtes.
Vous avez appliqué une visualisation qui prend en charge les requêtes, telle que l'une des visualisations suivantes :
- Jauge à barres
- Jauge
- Graphe
- Heatmap
- Journaux
- Stat
- Tableau

Appliquer une transformation

Les transformations sont disponibles dans l'onglet Transformation dans le volet inférieur de l'éditeur de panneaux, à côté de l'onglet Requêtes.

Pour appliquer une transformation

Dans le panneau auquel vous souhaitez ajouter des transformations, choisissez le titre du panneau, puis sélectionnez Modifier.
Choisissez l'onglet Transformation.
Sélectionnez une transformation.

Dans la ligne de transformation qui apparaît, vous pouvez configurer les options de transformation.
Pour appliquer une autre transformation, choisissez Ajouter une transformation. N'oubliez pas que la transformation suivante agit sur le jeu de résultats renvoyé par la transformation précédente.

Si vous rencontrez des difficultés, cliquez sur l'icône de bogue pour débuguer vos transformations.

Pour supprimer une transformation, cliquez sur l'icône de la corbeille.

Types et options de transformation

Les espaces de travail Grafana incluent les transformations suivantes.

Réduire

Appliquez une transformation Reduce lorsque vous souhaitez réduire vos résultats à une seule valeur. Reduce supprime essentiellement la composante temporelle. S'il est visualisé sous forme de tableau, il réduit une colonne à une ligne (valeur).

Dans le champ Calculs, entrez un ou plusieurs types de calcul. Choisissez pour afficher la liste des choix de calcul. Pour plus d'informations sur les calculs disponibles, consultezListe des calculs.

Après avoir sélectionné au moins un calcul, Amazon Managed Grafana affiche une valeur utilisant le calcul que vous avez sélectionné. Si vous sélectionnez plusieurs calculs, plusieurs valeurs sont affichées.

Fusionner

Utilisez cette transformation pour combiner les résultats de plusieurs requêtes en un seul résultat. Cela est utile lorsque vous utilisez la visualisation du panneau de tableau. Les valeurs pouvant être fusionnées sont combinées dans la même ligne. Les valeurs peuvent être fusionnées si les champs partagés contiennent les mêmes données.

Dans l'exemple suivant, deux requêtes renvoient des données de table. Les données sont visualisées sous forme de deux tableaux distincts avant d'appliquer la transformation.

Requête A

Heure	Tâche	Disponibilité
2020-07-07 11:34:20	nœud	25260122
2020-07-07 11:24:20	postgre	123001233

Requête B

Heure	Tâche	Erreurs
2020-07-07 11:34:20	nœud	15
2020-07-07 11:24:20	postgre	5

Voici le résultat après avoir appliqué la transformation Merge.

Heure	Tâche	Erreurs	Disponibilité
2020-07-07 11:34:20	nœud	15	25260122
2020-07-07 11:24:20	postgre	5	123001233

Filtrage par nom

Utilisez cette transformation pour supprimer des parties des résultats de la requête.

Amazon Managed Grafana affiche le champ Identifiant, suivi des champs renvoyés par votre requête.

Vous pouvez appliquer des filtres de deux manières différentes :

Entrez une expression regex.
Choisissez un champ pour activer le filtrage sur ce champ. Les champs filtrés sont affichés en gris foncé, les champs non filtrés en blanc.

Filtrer les données par requête

Utilisez cette transformation dans les panneaux contenant plusieurs requêtes, si vous souhaitez masquer une ou plusieurs requêtes.

Amazon Managed Grafana affiche les lettres d'identification de la requête en texte gris foncé. Pour activer le filtrage, choisissez un identifiant de requête. Si la lettre de requête est blanche, les résultats sont affichés. Si la lettre de requête est foncée, les résultats sont masqués.

Organiser les champs

Utilisez cette transformation pour renommer, réorganiser ou masquer les champs renvoyés par la requête.

Note

Cette transformation ne fonctionne que dans les panneaux contenant une seule requête. Si votre panneau comporte plusieurs requêtes, vous devez soit appliquer une transformation Joindre par champ (jointure externe), soit supprimer les requêtes supplémentaires.

Amazon Managed Grafana affiche la liste des champs renvoyés par la requête. Vous pouvez apporter l'une des modifications suivantes :

Modifiez l'ordre des champs en faisant une pause sur un champ. Le curseur prend la forme d'une main, puis vous pouvez faire glisser le champ vers son nouvel emplacement.
Masquez ou affichez un champ en cliquant sur l'icône en forme d'œil à côté du nom du champ.
Renommez les champs en saisissant un nouveau nom dans la zone Renommer.

Joindre par champ (jointure extérieure)

Utilisez cette transformation pour joindre plusieurs séries chronologiques à partir d'un ensemble de résultats par champ.

Cette transformation est utile si vous souhaitez combiner des requêtes afin de calculer les résultats à partir des champs.

Ajouter un champ à partir du calcul

Utilisez cette transformation pour ajouter un nouveau champ calculé à partir de deux autres champs. Chaque transformation permet d'ajouter un nouveau champ.

Mode — Sélectionnez un mode :
- Réduire la ligne — Appliquez le calcul sélectionné sur chaque ligne des champs sélectionnés indépendamment.
- Option binaire — Appliquez une opération mathématique de base (summultiply,, etc.) aux valeurs d'une seule ligne provenant de deux champs sélectionnés.
Nom du champ : sélectionnez les noms des champs que vous souhaitez utiliser dans le calcul du nouveau champ.
Calcul : sélectionnez un calcul à utiliser lorsqu'Amazon Managed Grafana crée le nouveau champ. Choisissez le champ pour voir la liste des choix de calcul. Pour plus d'informations sur les calculs disponibles, consultezListe des calculs.
Alias — (Facultatif) Entrez le nom de votre nouveau champ. Si vous laissez ce champ vide, le nom du champ correspondra au calcul.
Remplacer tous les champs — (Facultatif) Utilisez cette option si vous souhaitez masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation.

Étiquettes pour les champs

Note

Pour appliquer cette transformation, votre requête doit renvoyer des champs étiquetés.

Lorsque vous sélectionnez cette transformation, Amazon Managed Grafana transforme automatiquement toutes les données étiquetées en champs.

Par exemple, considérez le résultat d'une requête de deux séries chronologiques.

1 : étiquettes Serveur = serveur A, centre de données = UE 2 : étiquettes Serveur = serveur B, centre de données = UE

Cette transformation se traduirait par le tableau suivant.

Heure	Serveur	Centre de données	Valeur
2020-07-07 11:34:20	Serveur A	UE	1
2020-07-07 11:34:20	Serveur B	UE	2

Nom du champ de valeur ; Si vous l'avez sélectionné Server comme nom de champ de valeur, vous obtiendrez un champ pour chaque valeur de l'Serverétiquette.

Heure	Centre de données	Serveur A	Serveur B
2020-07-07 11:34:20	UE	1	2

Grouper par

Cette transformation trie chaque image en fonction du champ configuré. Lorsque cette case reverse est cochée, les valeurs sont renvoyées dans l'ordre inverse.

Grouper par

Cette transformation regroupe les données selon une valeur de champ (colonne) spécifiée et traite les calculs pour chaque groupe. Les calculs disponibles sont les mêmes que pour la transformation Reduce.

Voici un exemple de données d'origine.

Heure	ID serveur	Température du processeur	État du serveur
2020-07-07 11:34:20	serveur 1	80	Fermeture
2020-07-07 11:34:20	serveur 3	62	OK
2020-07-07 10:32:20	serveur 2	90	Surcharge
2020-07-07 10:31:22	serveur 3	55	OK
2020-07-07 09:30:57	serveur 3	62	Rebooting
2020-07-07 09:30:05	serveur 2	88	OK
2020-07-07 09:28:06	serveur 1	80	OK
2020-07-07 09:25:05	serveur 2	88	OK
2020-07-07 09:23:07	serveur 1	86	OK

Cette transformation s'effectue en deux étapes. Vous devez d'abord spécifier un ou plusieurs champs pour regrouper les données. Cela regroupera les mêmes valeurs de ces champs, comme si vous les aviez triées. Par exemple, si vous regroupez par Server ID champ, les données seront regroupées de la façon suivante :

Heure	ID serveur	Température du processeur	État du serveur
2020-07-07 11:34:20	serveur 1	80	Fermeture
2020-07-07 09:28:06	serveur 1	80	OK
2020-07-07 09:23:07	serveur 1	86	OK


2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting

Toutes les lignes ayant la même valeur de Server ID sont regroupées.

Après avoir choisi le champ par lequel vous souhaitez regrouper vos données, vous pouvez ajouter différents calculs sur les autres champs, et le calcul sera appliqué à chaque groupe de lignes. Par exemple, vous souhaiterez peut-être calculer la moyenne CPU temperature pour chacun de ces serveurs. Vous pouvez ajouter le calcul de la moyenne appliqué au CPU Temperature champ pour obtenir ce qui suit.

ID serveur	Température du processeur (moyenne)
serveur 1	82
serveur 2	88,6
serveur 3	59,6

Et vous pouvez ajouter plusieurs de ces calculs. Par exemple, vous pouvez utiliser les calculs suivants.

Pour le champTime, vous pouvez calculer la dernière valeur, pour savoir quand le dernier point de données a été reçu pour chaque serveur.
Pour le champServer Status, vous pouvez calculer la dernière valeur pour connaître la dernière valeur d'état de chaque serveur.
Sur le terrainTemperature, vous pouvez également calculer la dernière valeur pour connaître la dernière température surveillée pour chaque serveur.

La transformation Group By produit les résultats suivants.

ID serveur	Température du processeur (moyenne)	Température du processeur (dernière)	Heure (dernière)	État du serveur (dernier)
serveur 1	82	80	2020-07-07 11:34:20	Fermeture
serveur 2	88,6	90	2020-07-07 10:32:20	Surcharge
serveur 3	59,6	62	2020-07-07 11:34:20	OK

Grâce à cette transformation, vous pouvez extraire certaines informations clés de vos séries chronologiques et les afficher de manière pratique.

De la série aux rangées

Utilisez cette transformation pour combiner les résultats de plusieurs requêtes de données de séries chronologiques en un seul résultat. Cela est utile lorsque vous utilisez la visualisation du panneau de tableau.

Le résultat de cette transformation contiendra trois colonnes : TimeMetric, etValue. La Metric colonne est ajoutée afin que vous puissiez voir de quelle requête provient la métrique. Personnalisez cette valeur en Label la définissant dans la requête source.

Dans l'exemple ci-dessous, deux requêtes renvoient des données de séries chronologiques. Il est visualisé sous forme de deux tableaux distincts avant que la transformation ne soit appliquée.

Requête A

Heure	Température
2020-07-07 11:34:20	25
2020-07-07 10:31:22	22
2020-07-07 09:30:05	19

Requête B

Heure	Humidité
2020-07-07 11:34:20	24
2020-07-07 10:32:20	29
2020-07-07 09:30:57	33

L'application de Series to rows la transformation produit les résultats suivants.

Heure	Métrique	Valeur
2020-07-07 11:34:20	Température	25
2020-07-07 11:34:20	Humidité	22
2020-07-07 10:32:20	Humidité	29
2020-07-07 10:31:22	Température	22
2020-07-07 09:30:57	Humidité	33
2020-07-07 09:30:05	Température	19

Filtrer les données par valeur

Cette transformation vous permet de filtrer vos données directement dans l'espace de travail Grafana et de supprimer certains points de données du résultat de votre requête. Vous avez la possibilité d'inclure ou d'exclure les données qui répondent à une ou plusieurs conditions que vous définissez. Les conditions sont appliquées à un champ sélectionné.

Cette transformation est utile si votre source de données ne filtre pas nativement par valeurs. Vous pouvez également l'utiliser pour affiner les valeurs à afficher si vous utilisez une requête partagée.

Les conditions disponibles pour tous les champs sont les suivantes :

Regex — Correspond à une expression regex.
Is Null — Correspond si la valeur est nulle.
N'est pas nulle — Correspond si la valeur n'est pas nulle.
Égal — Correspond si la valeur est égale à la valeur spécifiée.
Différent — Correspond si la valeur est différente de la valeur spécifiée.

Les conditions disponibles pour les champs numériques sont les suivantes :

Plus grand — Correspond si la valeur est supérieure à la valeur spécifiée.
Inférieur — Correspond si la valeur est inférieure à la valeur spécifiée.
Supérieur ou égal — Correspond si la valeur est supérieure ou égale à la valeur spécifiée.
Inférieur ou égal — Correspond si la valeur est inférieure ou égale à la valeur spécifiée.
Plage : correspond à une plage comprise entre un minimum et un maximum spécifiés. Le minimum et le maximum sont inclus dans la gamme.

Vous pouvez ajouter plusieurs conditions au filtre. Lorsque vous avez plusieurs conditions, vous pouvez choisir si vous souhaitez que l'action d'inclusion ou d'exclusion soit appliquée aux lignes qui correspondent à toutes les conditions que vous avez ajoutées ou à certaines d'entre elles.

Les conditions qui ne sont pas valides ou qui ne sont pas complètement configurées sont ignorées.