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.
# Panneaux et visualisations dans Grafana version 10
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Le *panneau* est l'élément de base de la visualisation dans Grafana. Chaque panneau possède un éditeur de requêtes spécifique à la source de données sélectionnée dans le panneau. L'éditeur de requêtes vous permet de créer une requête qui renvoie les données que vous souhaitez visualiser.
Il existe une grande variété d'options de style et de mise en forme pour chaque panneau. Les panneaux peuvent être glissés, déposés et redimensionnés pour les réorganiser sur le tableau de bord.
Avant d'ajouter un panneau, assurez-vous d'avoir configuré une source de données.
Des types de panneaux supplémentaires peuvent être disponibles en installant des [plug-ins](grafana-plugins.md) supplémentaires dans votre espace de travail.
Pour plus de détails sur l'utilisation de sources de données spécifiques, consultez[Connexion aux sources de données](AMG-data-sources.md).
**Topics**
+ [Présentation de l'éditeur de panneaux](v10-panels-editor-overview.md)
+ [Vue d'inspection du panneau](v10-panels-panel-inspector.md)
+ [Interrogez et transformez les données](v10-panels-query-xform.md)
+ [Configurer les options du panneau](v10-panels-configure-panel-options.md)
+ [Configuration des options standard](v10-panels-configure-standard-options.md)
+ [Configuration d'une légende](v10-panels-configure-legend.md)
+ [Configuration des liaisons de données](v10-panels-configure-data-links.md)
+ [Configurer les mappages de valeurs](v10-panels-configure-value-mappings.md)
+ [Configuration des seuils](v10-panels-configure-thresholds.md)
+ [Configurer les remplacements de champs](v10-panels-configure-overrides.md)
+ [Visualisations disponibles dans la version 10 de Grafana](v10-panels-viz.md)
# Présentation de l'éditeur de panneaux
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec 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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Dans l'éditeur de panneaux, vous pouvez mettre à jour tous les éléments d'une visualisation, notamment la source de données, les requêtes, la plage de temps et les options d'affichage.
Pour ajouter un panneau à un nouveau tableau de bord, sélectionnez **\$1 Ajouter une visualisation** au milieu du tableau de bord. Pour ajouter un panneau à un tableau de bord existant, sélectionnez **Ajouter** dans l'en-tête du tableau de bord et sélectionnez **Visualisation** dans le menu déroulant. Vous pouvez également copier-coller un panneau existant à partir du même tableau de bord ou d'un autre tableau de bord.
## Menu du panneau
Pour accéder à l'éditeur de panneaux, survolez le coin supérieur droit de n'importe quel panneau. Sélectionnez l'icône du menu du panneau qui apparaît, puis sélectionnez **Modifier**.
Le menu du panneau vous permet également d'accéder aux actions suivantes :
+ **Afficher** — Affichez le panneau en plein écran.
+ **Modifier** : ouvrez l'éditeur de panneaux pour modifier le panneau et les options de visualisation.
+ **Partager** : partagez le panneau sous forme de lien ou de panneau de bibliothèque.
+ **Explorer** : ouvrez le panneau dans **Explore**, dans lequel vous pouvez vous concentrer sur votre requête.
+ **Inspecter** — Ouvrez le tiroir d'**inspection**, dans lequel vous pouvez consulter les données du panneau, les statistiques, les métadonnées, le JSON et la requête.
+ **Données** — Ouvrez le tiroir **d'inspection** dans l'onglet **Données**.
+ **Requête** — Ouvrez le tiroir **d'inspection** dans l'onglet **Requête**.
+ **Panel JSON** — Ouvrez le tiroir **Inspect** dans l'onglet **JSON**.
+ **Extensions** : accédez à d'autres actions fournies par les applications installées, telles que la déclaration d'un incident. Cette option n'apparaît que si vous avez installé des plugins d'application qui apportent une extension au menu du panneau.
+ **Plus** : accédez aux autres actions du panneau.
+ **Dupliquer** — Créez une copie du panneau. Les panneaux dupliqués interrogent les données séparément du panneau d'origine. Si vous souhaitez utiliser les mêmes résultats de requête, vous pouvez utiliser la source de `Dashboard` données dans le deuxième panneau.
+ **Copier** — Copiez le panneau dans le presse-papiers.
+ **Créer un panneau de bibliothèque** : créez un panneau qui peut être importé dans d'autres tableaux de bord.
+ **Créer une alerte** : ouvrez la page de configuration des règles d'**alerte dans Alerting**, où vous pouvez créer une [alerte gérée par Grafana en](v10-alerts.md) fonction des requêtes du panneau.
+ **Masquer la légende** : masque la légende du panneau.
+ **Obtenir de l'aide** — Envoyez un instantané ou des données de panel au Support technique de Grafana Labs.
+ **Supprimer** — Supprimez le panneau du tableau de bord.
## Éditeur de panneaux
Cette section décrit les zones de l'éditeur de panneaux Grafana.
+ En-tête du panneau — La section d'en-tête répertorie le tableau de bord dans lequel le panneau apparaît et les commandes suivantes :
+ **Ignorer** : annule les modifications que vous avez apportées au panneau depuis le dernier enregistrement du tableau de bord.
+ **Enregistrer** : enregistre les modifications que vous avez apportées au panneau.
+ **Appliquer** : applique les modifications que vous avez apportées et ferme l'éditeur de panneaux, vous renvoyant au tableau de bord. Vous devrez enregistrer le tableau de bord pour conserver les modifications appliquées.
+ Aperçu de la visualisation : la section d'aperçu de la visualisation contient les options suivantes :
+ **Affichage sous forme de tableau** : convertissez n'importe quelle visualisation en tableau afin de voir les données. Les vues sous forme de tableau sont utiles pour le dépannage. Cette vue contient uniquement les données brutes. Il n'inclut pas les transformations que vous avez peut-être appliquées aux données ni les options de mise en forme disponibles dans la visualisation de [table](v10-panels-table.md).
+ **Remplissage** : l'aperçu de la visualisation remplit l'espace disponible. Si vous modifiez la largeur du panneau latéral ou la hauteur du panneau inférieur, la visualisation change pour remplir l'espace disponible.
+ **Réel** — L'aperçu de la visualisation aura la même taille que celle du tableau de bord. Si l'espace disponible est insuffisant, la visualisation sera réduite en préservant le rapport hauteur/largeur.
+ **Contrôles de plage horaire** — La **valeur par défaut** est soit le fuseau horaire local du navigateur, soit le fuseau horaire sélectionné à un niveau supérieur.
+ Section des données : la section des données contient des onglets dans lesquels vous pouvez saisir des requêtes, transformer vos données et créer des règles d'alerte (le cas échéant).
+ **Onglet Requête** : sélectionnez votre source de données et saisissez des requêtes ici. Pour de plus amples informations, veuillez consulter [Interrogez et transformez les données](v10-panels-query-xform.md). Lorsque vous créez un tableau de bord pour la première fois, vous êtes invité à sélectionner une source de données. Vous pouvez mettre à jour la source de données ou la requête dans cet onglet.
+ **Onglet Transformation** : appliquez des transformations de données. Pour de plus amples informations, veuillez consulter [Interrogez et transformez les données](v10-panels-query-xform.md).
+ **Onglet Alerte** : écrivez les règles d'alerte. Pour de plus amples informations, veuillez consulter [Alertes dans la version 10 de Grafana](v10-alerts.md).
+ Options d'affichage du panneau : la section des options d'affichage contient des onglets dans lesquels vous pouvez configurer presque tous les aspects de la visualisation des données. Les détails varient en fonction du type de visualisation sélectionné.
## Panneau d'inspection du tiroir
Le tiroir d'inspection vous aide à comprendre et à dépanner vos panneaux. Vous pouvez afficher les données brutes de n'importe quel panneau, exporter ces données vers un fichier de valeurs séparées par des virgules (CSV), consulter les demandes de requête et exporter le panneau et les données au format JSON.
**Note**
Tous les types de panneaux n'incluent pas tous les onglets. Par exemple, les panneaux de liste des tableaux de bord ne contiennent pas de données brutes à inspecter. Ils n'affichent donc pas les onglets Statistiques, Données ou Requête.
L'inspecteur du panneau comprend les options suivantes :
+ Le panneau inspecte les écrans des tiroirs sous la forme d'un tiroir situé sur le côté droit. Sélectionnez la flèche dans le coin supérieur droit pour agrandir ou réduire le volet du tiroir.
+ **Onglet Données** : affiche les données brutes renvoyées par la requête avec les transformations appliquées. Les options de champ telles que les remplacements et les mappages de valeurs ne sont pas appliquées par défaut.
+ **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.
+ **Onglet JSON** — Vous permet d'afficher et de copier le JSON du panneau, le JSON des données du panneau et le JSON de la structure du bloc de données. Cela est utile si vous approvisionnez ou administrez Grafana.
+ **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.
+ **Onglet Erreur** : affiche toutes les erreurs renvoyées par une requête. L'onglet n'est visible que lorsqu'une requête renvoie une erreur.
# Vue d'inspection du panneau
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
La vue d'inspection des panneaux, que vous pouvez ouvrir via le menu du panneau, vous aide à comprendre et à résoudre les problèmes liés à vos panneaux. Vous pouvez inspecter les données brutes de n'importe quel panneau Amazon Managed Grafana, exporter ces données vers un fichier de valeurs séparées par des virgules (CSV), consulter les demandes de requête et exporter le panneau et les données au format JSON.
**Note**
Tous les types de panneaux n'incluent pas tous les onglets. Par exemple, les panneaux de liste des tableaux de bord ne contiennent pas de données brutes à inspecter. Ils n'affichent donc pas les onglets Statistiques, Données ou Requête.
L'inspecteur du panneau comprend les options suivantes :
1. L'inspecteur du panneau affiche **Inspect :** en haut du volet. Sélectionnez la flèche dans le coin supérieur droit pour agrandir ou réduire le volet.
1. **Onglet Données** : affiche les données brutes renvoyées par la requête avec les transformations appliquées. Les options de champ telles que les remplacements et les mappages de valeurs ne sont pas appliquées par défaut.
1. **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.
1. **Onglet JSON** — Vous permet d'afficher et de copier le JSON du panneau, le JSON des données du panneau et le JSON de la structure du bloc de données. Cela est utile si vous approvisionnez ou administrez Grafana.
1. **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.
1. **Onglet Erreur** : affiche toutes les erreurs. Visible uniquement lorsqu'une requête renvoie une erreur.
## Téléchargement des résultats de requête bruts
Amazon Managed Grafana génère un fichier CSV contenant vos données, y compris les transformations apportées à ces données. Vous pouvez choisir d'afficher les données avant ou après que le panneau applique des options de champ ou des remplacements d'options de champ.
**Pour télécharger les résultats bruts des requêtes**
1. Modifiez le panneau qui contient les données de requête que vous souhaitez télécharger.
1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.
1. Sélectionnez **Données**.
Si votre panneau contient plusieurs requêtes ou interroge plusieurs nœuds, des options supplémentaires s'offrent à vous.
+ **Sélectionnez le résultat** : choisissez les données du jeu de résultats que vous souhaitez afficher.
+ **Transformez les données**
+ **Inscrivez-vous par heure** : visualisez les données brutes de toutes vos requêtes en une seule fois, un ensemble de résultats par colonne. Sélectionnez un en-tête de colonne pour réorganiser les données.
1. Pour afficher les données avant que le système n'applique des remplacements de champs, sélectionnez le bouton **Données formatées**.
1. Pour télécharger un fichier CSV spécialement formaté pour Excel, sélectionnez le bouton **Télécharger pour Excel**.
1. Sélectionnez **Download CSV (Télécharger le CSV)**.
## Inspection des performances des requêtes
L'onglet **Statistiques** affiche des statistiques qui indiquent la durée de votre requête, le nombre de requêtes que vous envoyez et le nombre de lignes renvoyées. Ces informations peuvent vous aider à résoudre vos requêtes, en particulier si l'un des chiffres est élevé ou faible de façon inattendue.
**Pour inspecter les performances des requêtes**
1. Modifiez le panneau qui contient la requête avec les performances que vous souhaitez inspecter.
1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.
1. Sélectionnez **Stats**.
Les statistiques sont affichées en lecture seule.
## Inspection de la requête, de la demande et de la réponse
Vous pouvez inspecter les données relatives aux demandes et aux réponses lorsque vous souhaitez résoudre les problèmes liés à une requête qui renvoie des résultats inattendus ou qui ne renvoie pas les résultats attendus.
1. Modifiez le panneau qui contient la requête que vous souhaitez exporter.
1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.
1. Sélectionnez **Rafraîchir**.
Le panneau est renseigné avec les données de réponse.
1. Apportez les modifications nécessaires et réexécutez la requête.
1. Pour télécharger les données de demande de requête et de réponse, cliquez sur l'icône **Copier dans le presse-papiers** et collez les résultats dans une autre application.
# Interrogez et transformez les données
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec 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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Amazon Managed Grafana prend en charge de nombreux types de sources de [données](AMG-data-sources.md). Les *requêtes* de source de données renvoient des données que Grafana peut *transformer et visualiser*. Chaque source de données utilise son propre langage de requête, et les plug-ins de source de données implémentent chacun une interface utilisateur de création de requêtes appelée éditeur de requêtes.
**Topics**
+ [À propos des requêtes](#v10-panels-query-xform-about)
+ [Naviguez dans l'onglet de requête](#v10-panels-query-xform-navigate)
+ [Ajouter une requête](#v10-panels-query-xform-add)
+ [Gérer les requêtes](#v10-panels-query-xform-manage)
+ [Options de requête](#v10-panels-query-xform-options)
+ [Écrire des requêtes d'expression](v10-panels-query-xform-expressions.md)
+ [Partage des résultats de requête avec un autre panneau](v10-panels-query-share.md)
+ [Transformation de données](v10-panels-xform.md)
+ [Résoudre les problèmes liés aux requêtes](v10-panels-query-troubleshoot.md)
+ [Types de calculs](v10-panels-calculation-types.md)
## À propos des requêtes
Les panneaux Grafana communiquent avec les sources de données via des requêtes, qui récupèrent les données pour la visualisation. Une requête est une question rédigée dans le langage de requête utilisé par la source de données.
Vous pouvez configurer la fréquence des requêtes et les limites de collecte de données dans les options de source de données du panneau. Grafana prend en charge jusqu'à 26 requêtes par panel.
Vous trouverez plus d'informations sur le langage de requête de chaque source de données dans la section [Sources de données](AMG-data-sources.md).
**Éditeurs de requêtes**
L'*éditeur de requêtes* de chaque source de données fournit une interface utilisateur personnalisée qui vous permet de rédiger des requêtes qui tirent parti de ses fonctionnalités uniques.
En raison des différences entre les langages de requête, chaque éditeur de requêtes de source de données présente une apparence et un fonctionnement différents. En fonction de votre source de données, l'éditeur de requêtes peut fournir des fonctionnalités de saisie automatique, des noms de métriques, des suggestions de variables ou une interface visuelle de création de requêtes.
Pour plus de détails sur les fonctionnalités uniques de l'éditeur de requêtes d'une source de données spécifique, notamment des informations sur les requêtes et la syntaxe, consultez la documentation de la source de données :
+ Pour les sources de données incluses dans Amazon Managed Grafana, consultez la section Sources de [données intégrées](AMG-data-sources-builtin.md).
+ Pour les sources de données incluses dans Grafana Enterprise, voir. [Connectez-vous aux sources de données de l'entreprise](AMG-data-sources-enterprise.md)
+ Pour les autres plugins de source de données que vous installez via le[Trouvez des plugins avec le catalogue de plugins](grafana-plugins.md#plugin-catalog), la documentation est liée dans la liste du catalogue des plugins.
**Syntaxe de requête**
Les sources de données utilisent différents langages de requête pour demander des données. Pour plus de détails sur le langage de requête unique d'une source de données spécifique, reportez-vous à sa documentation.
**Exemple de PostgreSQL :**
```
SELECT hostname FROM host WHERE region IN($region)
```
**Exemple de ProMQL :**
```
query_result(max_over_time([${__range_s}s]) != )
```
**Sources de données spéciales**
**Grafana inclut également trois sources de données spéciales : **Grafana**, **Mixed** et Dashboard.** Pour de plus amples informations, veuillez consulter [Connexion aux sources de données](AMG-data-sources.md).
## Naviguez dans l'onglet de requête
L'onglet **Requête** d'un panneau comprend les éléments suivants :
+ **Sélecteur de source de données** : sélectionne la source de données à interroger.
+ **Options de requête** : définit les paramètres maximaux de récupération des données et les intervalles d'exécution des requêtes.
+ **Bouton Inspecteur** de requêtes : ouvre le panneau de l'inspecteur de requêtes, dans lequel vous pouvez afficher et optimiser votre requête.
+ **Liste de l'éditeur de requêtes** : répertorie les requêtes que vous avez rédigées.
+ **Expressions** : utilise le générateur d'expressions pour créer des expressions d'alerte. Pour plus d’informations sur les expressions, consultez [Écrire des requêtes d'expression](v10-panels-query-xform-expressions.md).
## Ajouter une requête
Une requête renvoie des données que Grafana visualise dans les panneaux du tableau de bord. Lorsque vous créez un panneau, Grafana sélectionne automatiquement la source de données par défaut.
**Pour ajouter une requête**
1. Modifiez le panneau dans lequel vous ajoutez une requête.
1. Choisissez l'onglet **Query** (Requête).
1. Choisissez le menu déroulant **Source de données** et sélectionnez une source de données.
1. Choisissez **les options de requête** pour configurer le nombre maximum de points de données dont vous avez besoin. Pour plus d'informations sur les options de requête, consultez[Options de requête](#v10-panels-query-xform-options).
1. Rédigez la requête à l'aide de l'éditeur de requêtes.
1. Cliquez sur **Appliquer**.
Grafana interroge la source de données et visualise les données.
## Gérer les requêtes
Grafana organise les requêtes en lignes de requêtes pliables. Chaque ligne de requête contient un éditeur de requêtes et est identifiée par une lettre (A, B, C, etc.).
Pour gérer vos requêtes, vous pouvez copier des requêtes, masquer des requêtes, supprimer des requêtes, réorganiser les requêtes et activer l'aide de l'éditeur de requêtes.
## Options de requête
Choisissez **Options de requête** à côté du sélecteur de source de données pour voir les paramètres de la source de données sélectionnée. Les modifications que vous apportez ici concernent uniquement les requêtes effectuées dans ce panneau.
Grafana définit les valeurs par défaut qui sont affichées en texte gris foncé. Les modifications sont affichées en blanc. Pour rétablir les paramètres par défaut d'un champ, supprimez le texte blanc du champ.
Les options de requête de source de données du panneau incluent :
+ **Nombre maximal de points de données** : si la source de données le prend en charge, cela définit le nombre maximum de points de données pour chaque série renvoyée. Si la requête renvoie plus de points de données que le paramètre maximum de points de données, la source de données réduit le nombre de points renvoyés en les agrégeant par moyenne, par maximum ou par une autre fonction.
Vous pouvez limiter le nombre de points pour améliorer les performances des requêtes ou lisser la ligne visualisée. La valeur par défaut est la largeur (ou le nombre de pixels) du graphique, car vous ne pouvez visualiser que le nombre de points de données que le panneau du graphique peut afficher.
Pour les données en streaming, Grafana utilise la valeur maximale de points de données pour la mémoire tampon mobile. Le streaming est un flux continu de données, et la mise en mémoire tampon divise le flux en plusieurs parties.
+ **Intervalle minimum** : définit une limite minimale pour l'intervalle calculé automatiquement, qui est généralement l'intervalle de capture minimum. Si un point de données est enregistré toutes les 15 secondes, vous n'avez aucun avantage à avoir un intervalle inférieur à ce chiffre. Vous pouvez également définir ce paramètre sur un minimum supérieur à l'intervalle de capture pour récupérer des requêtes plus grossières et plus performantes.
+ **Intervalle** — Définit un intervalle de temps que vous pouvez utiliser pour agréger ou regrouper des points de données par temps.
Grafana calcule automatiquement un intervalle approprié que vous pouvez utiliser comme variable dans les requêtes modélisées. La variable est mesurée en secondes (`$__interval`) ou en millisecondes (). `$__interval_ms`
Les intervalles sont généralement utilisés dans les fonctions d'agrégation telles que la somme ou la moyenne. Par exemple, il s'agit d'une requête Prometheus qui utilise la variable d'intervalle :. `rate(http_requests_total[$__interval])`
Cet intervalle automatique est calculé en fonction de la largeur du graphique. Lorsque l'utilisateur effectue un zoom arrière sur une visualisation, l'intervalle augmente, ce qui donne lieu à une agrégation plus grossière. De même, si l'utilisateur zoome, l'intervalle diminue, ce qui permet une agrégation plus fine.
Pour de plus amples informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Temps relatif** : remplace la plage de temps relative des différents panneaux, ce qui les rend différents de ceux sélectionnés dans le sélecteur de temps du tableau de bord situé dans le coin supérieur droit du tableau de bord. Vous pouvez l'utiliser pour afficher les statistiques de différentes périodes ou de différents jours sur le même tableau de bord.
**Note**
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Décalage horaire** : remplace la plage de temps de chaque panneau en décalant son début et sa fin par rapport au sélecteur de temps. Par exemple, vous pouvez modifier la plage horaire du panneau pour qu'elle soit deux heures plus tôt que celle du sélecteur d'heure du tableau de bord.
**Note**
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Délai d'expiration du cache** — *(visible uniquement s'il est disponible dans la source de données)* Remplace le délai d'expiration du cache par défaut si votre magasin de séries chronologiques possède un cache de requêtes. Spécifiez cette valeur sous forme de valeur numérique en secondes.
# Écrire des requêtes d'expression
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Les expressions côté serveur vous permettent de manipuler les données renvoyées par des requêtes à l'aide d'opérations mathématiques ou autres. Les expressions créent de nouvelles données et ne manipulent pas les données renvoyées par les sources de données.
## À propos des expressions
Les expressions côté serveur vous permettent de manipuler les données renvoyées par des requêtes à l'aide d'opérations mathématiques ou autres. Les expressions créent de nouvelles données et ne manipulent pas les données renvoyées par les sources de données, à l'exception de quelques restructurations mineures des données afin de rendre les données acceptables en entrée pour les expressions.
**Utilisation d'expressions**
Les expressions sont le plus souvent utilisées par les alertes [Grafana](v10-alerts.md). Le traitement est effectué côté serveur, de sorte que les expressions peuvent fonctionner sans session de navigateur. Toutefois, les expressions peuvent également être utilisées avec les sources de données principales et la visualisation.
**Note**
Les expressions ne fonctionnent pas avec les anciennes alertes de tableau de bord.
Les expressions sont destinées à augmenter les sources de données en permettant de combiner des requêtes provenant de différentes sources de données ou en fournissant des opérations non disponibles dans une source de données.
**Note**
Dans la mesure du possible, vous devez effectuer le traitement des données dans la source de données. Copier des données depuis le stockage vers le serveur Grafana à des fins de traitement est inefficace. Les expressions sont donc destinées au traitement léger des données.
Les expressions fonctionnent avec des requêtes de source de données qui renvoient des séries chronologiques ou des données numériques. Ils fonctionnent également sur des données [multidimensionnelles](getting-started-grafanaui.md#time-series-dimensions). Par exemple, une requête qui renvoie plusieurs séries, chaque série étant identifiée par des étiquettes ou des balises.
Une expression individuelle prend une ou plusieurs requêtes ou autres expressions en entrée et ajoute des données au résultat. Chaque expression ou requête individuelle est représentée par une variable qui est un identifiant nommé appelé RefID (par exemple, la lettre par défaut `A` ou`B`).
Pour référencer le résultat d'une expression individuelle ou d'une requête de source de données dans une autre expression, cet identifiant est utilisé comme variable.
**Types d'expressions**
Les expressions fonctionnent avec deux types de données.
+ Une collection de séries chronologiques.
+ Une collection de numéros, où chaque numéro est un élément.
Chaque collection est renvoyée à partir d'une seule requête ou expression de source de données et est représentée par le RefID. Chaque collection est un ensemble, chaque élément de l'ensemble étant identifié de manière unique par ses dimensions, qui sont stockées sous forme d'[étiquettes](getting-started-grafanaui.md#labels) ou de paires clé-valeur.
**Requêtes sur les sources de données**
Les expressions côté serveur prennent uniquement en charge les requêtes de source de données pour les sources de données principales. Les données sont généralement considérées comme des données de séries chronologiques.
Les requêtes de source de données, lorsqu'elles sont utilisées avec des expressions, sont exécutées par le moteur d'expression. Dans ce cas, il restructure les données pour qu'il s'agisse d'une série chronologique ou d'un nombre par trame de données. Ainsi, par exemple, si vous utilisez une source de données qui renvoie plusieurs séries sur un seul cadre dans la vue tabulaire, vous remarquerez peut-être que son apparence est différente lorsqu'elle est exécutée avec des expressions.
Actuellement, le seul format autre que les séries chronologiques (nombre) est pris en charge lors de l'utilisation de trames de données est que vous avez une réponse tabulaire qui renvoie une trame de données sans heure, des colonnes de chaîne et une colonne numérique :
Le tableau d'exemple suivant produit un nombre qui fonctionne avec les expressions. Les colonnes de chaîne deviennent des étiquettes et la colonne numérique la valeur correspondante. Par exemple, `{"Loc": "MIA", "Host": "A"}` avec une valeur de 1.
| Lock | Host (Hôte) | Processeur AVG |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
**Opérations**
Vous pouvez utiliser les opérations suivantes dans les expressions : mathématiques, réduction et rééchantillonnage.
**Math**
Les mathématiques concernent les formules mathématiques de forme libre sur des séries chronologiques ou des données numériques. Les opérations mathématiques prennent des nombres et des séries chronologiques en entrée et les transforment en différents nombres et séries chronologiques.
Les données provenant d'autres requêtes ou expressions sont référencées avec le RefID préfixé par un signe dollar, par exemple. `$A` Si le nom de la variable comporte des espaces, vous pouvez utiliser une syntaxe entre accolades telle que`${my variable}`.
Les constantes numériques peuvent être exprimées en décimal (`2.24`), octal (avec un zéro en tête`072`) ou hexadécimal (avec un 0x en tête). `0x2A` Les exponentielles et les signes sont également pris en charge (par exemple,`-0.8e-2`).
**Opérateurs**
Les opérateurs arithmétiques (`+`, binaires et unaires`-`,`*`,`/`,`%`, exposant`**`), relationnels (,`<`,,, `>` `==``!=`, `>=``<=`) et logiques (, `&&``||`, et unaires`!`) sont pris en charge.
Le comportement de l'opération avec les données varie selon qu'il s'agit d'un nombre ou d'une série chronologique.
Dans le cas d'opérations binaires, telles que `$A + $B` ou`$A || $B`, l'opérateur est appliqué de la manière suivante en fonction du type de données :
+ Si les deux `$A` et `$B` sont des nombres, l'opération est effectuée entre les deux nombres.
+ Si l'une des variables est un nombre et l'autre une série chronologique, l'opération entre la valeur de chaque point de la série chronologique et le nombre est effectuée.
+ Si `$A` les deux `$B` sont des données de séries chronologiques, l'opération entre chaque valeur des deux séries est effectuée pour chaque horodatage existant dans `$A` les deux séries`$B`. L'`Resample`opération peut être utilisée pour aligner les horodatages.
Résumé :
+ Numéro numéro = numéro
+ Série de numéros = série
+ Série = série
Comme les expressions fonctionnent avec plusieurs séries ou nombres représentés par une seule variable, les opérations binaires effectuent également une union (jointure) entre les deux variables. Cela se fait sur la base des étiquettes d'identification associées à chaque série ou numéro individuel.
Ainsi, si vous avez des numéros avec des étiquettes comme `{host=web01}` in `$A` et un autre numéro `$B` avec les mêmes étiquettes, l'opération est effectuée entre ces deux éléments au sein de chaque variable, et le résultat partagera les mêmes étiquettes. Les règles de comportement de ce syndicat sont les suivantes :
+ Un article sans étiquette s'associera à quoi que ce soit.
+ Si `$A` les `$B` deux ne contiennent qu'un seul article (une série ou un numéro), ils se joindront.
+ Si les étiquettes correspondent exactement, elles se joindront.
+ Si les étiquettes sont un sous-ensemble des autres, par exemple si un élément `$A` est étiqueté `{host=A,dc=MIA}` et qu'un élément `$B` est étiqueté, `{host=A}` elles se joindront.
+ Si dans une variable, par exemple, `$A` il existe des clés de balise différentes pour chaque élément, le comportement de jointure n'est pas défini.
Les opérateurs relationnels et logiques renvoient 0 pour faux, 1 pour vrai.
**Fonctions mathématiques**
Bien que la plupart des fonctions existent dans les propres opérations d'expression, l'opération mathématique comporte certaines fonctions similaires aux opérateurs mathématiques ou aux symboles. Lorsque les fonctions peuvent prendre des nombres ou des séries, le même type que l'argument sera renvoyé. Lorsqu'il s'agit d'une série, l'opération est effectuée pour la valeur de chaque point de la série.
*abdos*
abs renvoie la valeur absolue de son argument qui peut être un nombre ou une série. Par exemple, `abs(-1)` ou `abs($A)`.
*is\$1inf*
is\$1inf prend un nombre ou une série et renvoie `1` des `Inf` valeurs (négatives ou positives) et `0` d'autres valeurs. Par exemple `is_inf($A)`.
**Note**
Si vous devez vérifier spécifiquement l'infini négatif par exemple, vous pouvez effectuer une comparaison comme`$A == infn()`.
*is\$1nan*
is\$1nan prend un nombre ou une série et renvoie `1` des `NaN` valeurs et `0` d'autres valeurs. Par exemple `is_nan($A)`. Cette fonction est requise pour cette vérification car elle n'`NaN`est pas égale à`NaN`.
*est\$1nul*
is\$1null prend un nombre ou une série et renvoie `1` des `null` valeurs et `0` d'autres valeurs. Par exemple `is_null($A)`.
*is\$1number*
is\$1number prend un nombre ou une série et renvoie toutes `1` les valeurs réelles et `0` les autres valeurs (qui sont`null`, `Inf+``Inf-`, et`NaN`). Par exemple `is_number($A)`.
*journal*
Log renvoie le logarithme naturel de son argument, qui peut être un nombre ou une série. Si la valeur est inférieure à 0, `NaN` est renvoyée. Par exemple, `log(-1)` ou `log($A)`.
*inf, infn, nan et null*
Les fonctions inf, infn, nan et null renvoient toutes une seule valeur du nom. Ils existent principalement pour les tests. Exemple: `null()`.
*round*
Round renvoie une valeur entière arrondie. Par exemple, `round(3.123)` ou `round($A)`.
*ceil*
Ceil arrondit le nombre à la valeur entière la plus proche. Par exemple, `ceil(3.123)` renvoie `4`.
*floor*
Floor arrondit le nombre à la valeur entière la plus proche. Par exemple,`floor(3.123`) renvoie`3`.
**Réduire**
Reduce prend une ou plusieurs séries chronologiques renvoyées par une requête ou une expression et transforme chaque série en un seul numéro. Les étiquettes de la série chronologique sont conservées sous forme d'étiquettes sur chaque nombre réduit produit.
*Champs :*
+ **Fonction** — La fonction de réduction à utiliser
+ **Entrée** — La variable (RefID (telle que`A`)) à rééchantillonner
+ **Mode** — Permet de contrôler le comportement de la fonction de réduction lorsqu'une série contient des valeurs non numériques (null, NaN, \$1-Inf)
**Fonctions de réduction**
*Count*
Count renvoie le nombre de points dans chaque série.
*Méchant*
La moyenne renvoie le total de toutes les valeurs de chaque série divisé par le nombre de points de cette série. En `strict` mode, si l'une des valeurs de la série est nulle ou nan, ou si la série est vide, NaN est renvoyé.
*Min et Max*
Min et Max renvoient respectivement la plus petite ou la plus grande valeur de la série. En `strict` mode, si l'une des valeurs de la série est nulle ou nan, ou si la série est vide, NaN est renvoyé.
*Sum*
Sum renvoie le total de toutes les valeurs de la série. Si la série est de longueur nulle, la somme sera égale à 0. En `strict` mode, s'il existe des valeurs NaN ou Null dans la série, NaN est renvoyé.
*Dernier*
Last renvoie le dernier chiffre de la série. Si la série n'a aucune valeur, elle renvoie NaN.
**Modes de réduction**
*Stricte*
En mode strict, la série d'entrées est traitée telle quelle. Si l'une des valeurs de la série n'est pas numérique (null, NaN ou \$1-Inf), NaN est renvoyé.
*Supprimer les données non numériques*
Dans ce mode, toutes les valeurs non numériques (null, NaN ou \$1-Inf) de la série d'entrée sont filtrées avant d'exécuter la fonction de réduction.
*Remplacer les données non numériques*
Dans ce mode, toutes les valeurs non numériques sont remplacées par une valeur prédéfinie.
**Rééchantillonner**
Resample modifie les horodatages de chaque série chronologique afin d'avoir un intervalle de temps constant. Le principal cas d'utilisation est que vous pouvez rééchantillonner des séries chronologiques qui ne partagent pas les mêmes horodatages afin de pouvoir effectuer des calculs entre elles. Cela peut être fait en rééchantillonnant chacune des deux séries, puis en effectuant une opération mathématique faisant référence aux variables rééchantillonnées.
*Champs :*
+ **Entrée** — Variable des données de séries chronologiques (RefID (par exemple`A`)) à rééchantillonner
+ **Rééchantillonner** vers : durée pendant laquelle le rééchantillonnage doit être effectué, par exemple. `10s` Les unités peuvent être `s` des secondes, `m` des minutes, `h` des heures, `d` des jours, `w` des semaines et `y` des années.
+ **Sous-échantillonnage** : fonction de réduction à utiliser lorsqu'il existe plusieurs points de données par échantillon de fenêtre. Voir l'opération de réduction pour plus de détails sur le comportement.
+ **Upsample** — Méthode à utiliser pour remplir un échantillon de fenêtre ne contenant aucun point de données.
+ **le pad** est rempli avec la dernière valeur connue
+ **remblai** avec la prochaine valeur connue
+ **fillna** pour remplir les fenêtres d'exemple vides avec NaNs
## Écrire une expression
Si votre source de données les prend en charge, Grafana affiche le bouton **Expression** et affiche toutes les expressions existantes dans la liste de l'éditeur de requêtes.
**Pour écrire une expression**
1. Ouvrez le panneau.
1. Sous la requête, choisissez **Expression**.
1. Dans le champ **Opération**, sélectionnez le type d'expression que vous souhaitez écrire.
1. Écrivez l'expression.
1. Cliquez sur **Appliquer**.
## Cas spéciaux
Lorsqu'une source de données interrogée ne renvoie aucune série ni aucun chiffre, le moteur d'expression le renvoie. `NoData` Par exemple, si une demande contient deux requêtes de source de données fusionnées par une expression, si elle `NoData` est renvoyée par au moins l'une des requêtes de source de données, le résultat renvoyé pour l'ensemble de la requête est`NoData`. Pour plus d'informations sur la façon dont Grafana Alerting traite les `NoData` résultats, consultez. [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md)
Dans le cas de l'utilisation d'une expression sur plusieurs requêtes, le moteur d'expression exige que toutes les requêtes renvoient un horodatage identique. Par exemple, si vous utilisez les mathématiques pour combiner le résultat de plusieurs requêtes SQL utilisées par chacune d'entre elles`SELECT NOW() AS "time"`, l'expression ne fonctionnera que si toutes les requêtes sont évaluées `NOW()` selon un horodatage identique, ce qui n'est pas toujours le cas. Pour résoudre ce problème, vous pouvez `NOW()` remplacer par une heure arbitraire, telle que`SELECT 1 AS "time"`, ou tout autre horodatage UNIX valide.
# Partage des résultats de requête avec un autre panneau
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Grafana vous permet d'utiliser le résultat de la requête d'un panneau pour n'importe quel autre panneau du tableau de bord. Le partage des résultats des requêtes entre les panneaux réduit le nombre de requêtes adressées à votre source de données, ce qui peut améliorer les performances de votre tableau de bord.
La source *de données du tableau de bord* vous permet de sélectionner un panneau de votre tableau de bord contenant les requêtes pour lesquelles vous souhaitez partager les résultats. Au lieu d'envoyer une requête distincte pour chaque panneau, Grafana envoie une requête et les autres panneaux utilisent les résultats de la requête pour créer des visualisations.
Cette stratégie permet de réduire considérablement le nombre de requêtes effectuées lorsque vous avez, par exemple, plusieurs panneaux visualisant les mêmes données.
**Pour partager les résultats d'une requête**
1. [Créez un tableau de bord](v10-dash-creating.md).
1. Changez le titre en`Source panel`. Vous allez utiliser ce panneau comme source pour les autres panneaux.
1. Définissez la ou les requêtes que vous souhaitez partager.
Si aucune source de données n'est disponible, utilisez la source de données **Grafana**, qui renvoie une série chronologique aléatoire que vous pouvez utiliser pour les tests.
1. Ajoutez un deuxième panneau et sélectionnez la source de données du **tableau** de bord dans l'éditeur de requêtes.
1. Dans la **liste Utiliser les résultats du panneau**, sélectionnez le premier panneau que vous avez créé.
Toutes les requêtes définies dans le panneau source sont désormais disponibles dans le nouveau panneau. Les requêtes effectuées dans le panneau source peuvent être partagées avec plusieurs panneaux.
Vous pouvez cliquer sur n'importe laquelle des requêtes pour accéder au panneau où elles sont définies.
# Transformation de données
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
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 :
+ Renommer les champs
+ Joindre les données de séries chronologiques
+ Effectuez des opérations mathématiques sur plusieurs requêtes
+ Utiliser le résultat d'une transformation comme entrée d'une autre transformation
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.
**Note**
Parfois, le système ne peut pas représenter graphiquement les données transformées. Dans ce cas, cliquez sur le bouton **Vue tabulaire** au-dessus de la visualisation pour passer à une vue tabulaire des données. Cela peut vous aider à comprendre le résultat final de vos transformations.
## 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.
**Pour ajouter une transformation à un panneau**
1. Accédez au panneau dans lequel vous souhaitez ajouter une ou plusieurs transformations.
1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.
1. Dans le menu Actions, choisissez **Modifier**.
1. Sélectionnez l'onglet **Transformation**.
1. Sélectionnez une transformation. Une ligne de transformation apparaît dans laquelle vous configurez les options de transformation.
1. Pour appliquer une autre transformation, choisissez **Ajouter une transformation**. Cette transformation agit sur le jeu de résultats renvoyé par la transformation précédente.
## 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.
**Pour supprimer une transformation**
1. Ouvrez un panneau pour le modifier.
1. Sélectionnez l'onglet **Transformation**.
1. Cliquez sur l'icône de corbeille à côté de la transformation que vous souhaitez supprimer.
# Fonctions de transformation
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Vous pouvez effectuer les transformations suivantes sur vos données.
## 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.
+ **Opération binaire** : appliquez des opérations binaires de base (par exemple, additionnez ou multipliez) sur les valeurs d'une seule ligne à partir de deux champs sélectionnés.
+ **Opération unaire** — Appliquez des opérations unaires de base sur les valeurs d'une seule ligne à partir d'un champ sélectionné. Les opérations disponibles sont les suivantes :
+ **Valeur absolue (abs)** — Renvoie la valeur absolue d'une expression donnée. Il représente la distance à partir de zéro sous forme de nombre positif.
+ **Exponentiel naturel (exp)** — Renvoie *e* élevé à la puissance d'une expression donnée.
+ **Logarithme naturel (ln)** — Renvoie le logarithme naturel d'une expression donnée.
+ **Floor (floor)** — Renvoie le plus grand entier inférieur ou égal à une expression donnée.
+ **Plafond (ceil)** : renvoie le plus petit entier supérieur ou égal à une expression donnée.
+ **Fonctions cumulatives** — Appliquez des fonctions à la ligne actuelle et à toutes les lignes précédentes.
+ **Total** — Calcule le total cumulé jusqu'à la ligne actuelle incluse.
+ **Moyenne** — Calcule la moyenne jusqu'à la ligne actuelle incluse.
+ **Fonctions de fenêtre** — Appliquez des fonctions de fenêtre. La fenêtre peut être *inclinée ou* *centrée*. Dans le cas d'une fenêtre de fin, la ligne actuelle sera la dernière ligne de la fenêtre. Avec une fenêtre centrée, la fenêtre sera centrée sur la ligne actuelle. Pour des fenêtres de tailles égales, la fenêtre sera centrée entre la ligne actuelle et la ligne précédente.
+ **Moyenne** — Calcule la moyenne mobile ou la moyenne courante.
+ ****— Calcule l'écart type mobile.
+ **Variance** : calculez la variance mobile.
+ **Index de ligne** — Insérez un champ avec l'index de ligne.
+ **Nom du champ** — Sélectionnez les noms des champs que vous souhaitez utiliser dans le calcul du nouveau champ.
+ **Calcul** : si vous sélectionnez **le mode Réduire les lignes**, le champ **Calcul** apparaît. Sélectionnez le champ pour voir la liste des choix de calcul que vous pouvez utiliser pour créer le nouveau champ. Pour plus d'informations sur les calculs disponibles, reportez-vous à la section [Types de calculs](v10-panels-calculation-types.md).
+ **Fonctionnement** : si vous sélectionnez le mode de **fonctionnement binaire** ou le mode de **fonctionnement unaire**, les champs **Opération** apparaissent. Ces champs vous permettent d'effectuer des opérations mathématiques de base sur les valeurs d'une seule ligne à partir de deux champs sélectionnés. Vous pouvez également utiliser des valeurs numériques pour les opérations binaires.
+ **En tant que percentile** : si vous sélectionnez le mode **index des lignes**, le commutateur **En tant que percentile** apparaît. Ce commutateur vous permet de transformer l'indice de ligne en pourcentage du nombre total de lignes.
+ **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) Sélectionnez cette option si vous souhaitez masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation.
**Note**
**Les fonctions cumulatives** et **les fonctions de fenêtre** sont actuellement disponibles dans l'aperçu public. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.
## Concaténer des champs
**Concaténer des champs**
Utilisez cette transformation pour combiner tous les champs de tous les cadres en un seul résultat.
Par exemple, si vous avez des requêtes distinctes pour récupérer des données de température et de disponibilité (requête A) ainsi que des informations sur l'indice de qualité de l'air et les erreurs (requête b), l'application de la transformation concaténée produit un bloc de données consolidé contenant toutes les informations pertinentes dans une seule vue.
Considérez les deux suivants.
*Requête A :*
| Temp | Temps de disponibilité |
| --- | --- |
| 15,4 | 1230233 |
*Requête B :*
| IQA | Erreurs |
| --- | --- |
| 3.2 | 5 |
Après avoir concaténé les champs, le bloc de données serait le suivant :
| Temp | Temps de disponibilité | IQA | Erreurs |
| --- | --- | --- | --- |
| 15,4 | 1230233 | 3.2 | 5 |
Cette transformation simplifie le processus de fusion de données provenant de différentes sources, fournissant une vue complète pour l'analyse et la visualisation.
## Config à partir des résultats de la requête
**Config à partir des résultats de la requête**
Utilisez cette transformation pour sélectionner une requête et extraire les options standard telles que **Min**, **Max**, **Unit** et **Thresholds** et les appliquer aux autres résultats de requête. Cela permet une configuration de visualisation dynamique, basée sur les données renvoyées par une requête spécifique.
**Options**
+ **Requête de configuration** : sélectionnez la requête qui renvoie les données que vous souhaitez utiliser comme configuration.
+ **Appliquer à** : sélectionnez les champs ou les séries auxquels la configuration doit être appliquée.
+ **Appliquer aux options** : spécifiez un type de champ ou utilisez un nom de champ regex, en fonction de votre sélection dans **Appliquer à**.
**Table de mappage des champs**
Sous les options de configuration, vous trouverez le tableau de mappage des champs. Ce tableau répertorie tous les champs présents dans les données renvoyées par la requête de configuration, ainsi que les options **Utiliser comme** et **Sélectionner**. Il permet de contrôler le mappage des champs avec les propriétés de configuration, et pour plusieurs lignes, il vous permet de choisir la valeur à sélectionner.
L'exemple suivant montre une requête d'entrée et une requête utilisée comme configuration de champ.
*Requête d'entrée*
| Heure | Value |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
*Requête de configuration*
| Heure | Value |
| --- | --- |
| 1626178119127 | 100 |
| 1626178119129 | 100 |
*Requête de sortie (identique à l'entrée, mais maintenant avec config sur le champ de valeur)*
| Heure | Valeur (configuration : Max=100) |
| --- | --- |
| 1626178119127 | 10 |
| 1626178119129 | 30 |
Chaque champ possède désormais un ensemble d'options de configuration maximal. Des options telles que **Min**, **Max**, **Unit** et **Thresholds** font partie de la configuration du champ. Si elles sont définies, elles sont utilisées par la visualisation à la place des options configurées manuellement dans le volet d'options de l'éditeur de panneaux.
**Mappages de valeurs**
Vous pouvez également transformer le résultat d'une requête en mappages de valeurs. Avec cette option, chaque ligne du résultat de la requête de configuration définit une seule ligne de mappage de valeurs. Consultez l'exemple suivant.
*Résultat de la requête de configuration*
| Value | Texte | Couleur |
| --- | --- | --- |
| L | Faible | blue |
| M | Moyenne | green |
| H | Élevée | red |
*Dans le mappage des champs, spécifiez :*
| Champ | Utiliser comme | Select |
| --- | --- | --- |
| Value | Mappages de valeurs/Valeur | Toutes les valeurs |
| Texte | Mappages de valeurs/Texte | Toutes les valeurs |
| Couleur | Mappages de valeurs//Couleur | Toutes les valeurs |
Grafana crée des mappages de valeurs à partir du résultat de votre requête et les applique aux résultats réels des requêtes de données. Vous devriez voir les valeurs mappées et colorées en fonction des résultats de la requête de configuration.
## Convertir le type de champ
Utilisez cette transformation pour modifier le type de champ du champ spécifié.
Cette transformation comporte les options suivantes :
+ **Champ** : sélectionnez l'un des champs disponibles.
+ **as** — Sélectionnez le FieldType vers lequel convertir.
+ **Numérique** : tente de numéroter les valeurs.
+ **Chaîne** — transformera les valeurs en chaînes.
+ **Heure** : tente d'analyser les valeurs en fonction du temps.
+ Affiche une option permettant de spécifier un DateFormat comme entrée par une chaîne, comme `yyyy-mm-dd` ou`DD MM YYYY hh:mm:ss`.
+ **Boolean** — rendra les valeurs booléennes.
+ **Enum** — fera en sorte que les valeurs s'énumèrent.
+ Affiche un tableau pour gérer les énumérations.
+ **Autre** — tente d'analyser les valeurs au format json.
Par exemple, considérez la requête suivante qui pourrait être modifiée en sélectionnant le champ horaire, comme **Heure**, et le format de date comme`YYYY`.
| Heure | Mark | Value |
| --- | --- | --- |
| 01/07/2017 | ci-dessus | 25 |
| 02/08/2018 | ci-dessous | 22 |
| 02/09/2019 | ci-dessous | 29 |
| 04/10/2020 | ci-dessus | 22 |
Le résultat :
| Heure | Mark | Value |
| --- | --- | --- |
| 01/01/2017 00:00:00 | ci-dessus | 25 |
| 01/01/2018 00:00:00 | ci-dessous | 22 |
| 01/01/2019 00:00:00 | ci-dessous | 29 |
| 01/01/2020 00:00:00 | ci-dessus | 22 |
Cette transformation vous permet d'adapter de manière flexible vos types de données, garantissant ainsi la compatibilité et la cohérence de vos visualisations.
## Extraire les champs
Utilisez cette transformation pour sélectionner une source de données et en extraire le contenu sous différents formats. Cette transformation comporte les champs suivants :
+ **Source** : sélectionnez le champ correspondant à la source des données.
+ **Format** — Choisissez l'une des options suivantes :
+ **JSON** — Analyse le contenu JSON à partir de la source.
+ **Paires clé\$1valeur** : analyse le contenu au format `a=b` ou à `c:d` partir de la source.
+ **Auto** — Découvrez les champs automatiquement.
+ **Remplacer tous les champs** — (Facultatif) Sélectionnez cette option pour masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation.
+ **Keep Time** - (Facultatif) Disponible uniquement si **Remplacer tous les champs** est vrai. Conserve le champ horaire dans la sortie.
Considérez le jeu de données suivant :
**Exemple de jeu de données**
| Horodatage | données\$1json |
| --- | --- |
| 1636678740000000000 | \$1« valeur » : 1\$1 |
| 1636678680000000000 | \$1« valeur » : 5\$1 |
| 1636678620000000000 | \$1« valeur » : 12\$1 |
Vous pouvez préparer les données à utiliser par un [panneau de séries chronologiques](v10-panels-time-series.md) avec cette configuration :
+ Source : json\$1data
+ Format : JSON
+ Champ : valeur
+ Alias : my\$1value
+ Remplacer tous les champs : vrai
+ Keep Time : vrai
Cela générera le résultat suivant :
**Données transformées**
| Horodatage | ma\$1valeur |
| --- | --- |
| 1636678740000000000 | 1 |
| 1636678680000000000 | 5 |
| 1636678620000000000 | 12 |
Cette transformation vous permet d'extraire et de formater des données de différentes manières. Vous pouvez personnaliser le format d'extraction en fonction de vos besoins spécifiques en matière de données.
## Champs de recherche à partir de la ressource
Utilisez cette transformation pour enrichir la valeur d'un champ en recherchant des champs supplémentaires à partir d'une source externe.
Cette transformation comporte les champs suivants :
+ **Champ** : sélectionnez un champ de texte dans votre jeu de données.
+ **Recherche** — Choisissez parmi **les pays**, **les États américains** et les **aéroports**.
**Note**
Cette transformation prend uniquement en charge les données spatiales.
Par exemple, si vous disposez de ces données :
**Exemple de jeu de données**
| Location | Valeurs |
| --- | --- |
| AL | 0 |
| CHÊNE | 10 |
| Arizona | 5 |
| Arkansas | 1 |
| Quelque part | 5 |
Avec cette configuration :
+ Domaine : localisation
+ Rechercher : États-Unis
Vous obtiendrez le résultat suivant :
**Données transformées**
| Location | ID | Nom | Lng | Lat | Valeurs |
| --- | --- | --- | --- | --- | --- |
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 |
| CHÊNE | CHÊNE | Arkansas | -100,891064 | 24,448457 | 10 |
| Arizona | | | | | 5 |
| Arkansas | | | | | 1 |
| Quelque part | | | | | 5 |
Cette transformation vous permet d'augmenter vos données en récupérant des informations supplémentaires auprès de sources externes, fournissant ainsi un ensemble de données plus complet pour l'analyse et la visualisation.
## Filtrer les données par requête RefID
Utilisez cette transformation pour masquer une ou plusieurs requêtes dans les panneaux contenant plusieurs requêtes.
Grafana affiche les lettres d'identification de la requête en texte gris foncé. Choisissez un identifiant de requête pour activer le filtrage. 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.
**Note**
Cette transformation n'est pas disponible pour Graphite car cette source de données ne permet pas de corréler les données renvoyées avec les requêtes.
## Filtrer les données par valeurs
Utilisez cette transformation pour filtrer de manière sélective les points de données directement dans votre visualisation. Cette transformation fournit des options permettant d'inclure ou d'exclure des données en fonction d'une ou de plusieurs conditions appliquées à un champ sélectionné.
Cette transformation est très 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.
+ **Est nul** — 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 supplémentaires 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.
+ **Inférieur ou égal** — Correspond si la valeur est inférieure ou égale.
+ **Plage** : correspond à une plage comprise entre un minimum et un maximum spécifiés, un minimum et un maximum inclus.
Considérez le jeu de données suivant :
| Heure | Température | Altitude |
| --- | --- | --- |
| 2020-07-07 11:34:23 | 32 | 101 |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:32:24 | 31 | 95 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
Si vous **incluez** les points de données dont la température est inférieure à 30 °C, la configuration se présentera comme suit :
+ Type de filtre : « Inclure »
+ Condition : lignes où « Température » correspond à « Inférieure à » 30 »
Et vous obtiendrez le résultat suivant, où seules les températures inférieures à 30 °C sont incluses :
**Données transformées**
| Heure | Température | Altitude |
| --- | --- | --- |
| 2020-07-07 11:34:22 | 28 | 125 |
| 2020-07-07 11:34:21 | 26 | 110 |
| 2020-07-07 11:34:20 | 23 | 98 |
| 2020-07-07 10:31:22 | 20 | 85 |
| 2020-07-07 09:30:57 | 19 | 101 |
Vous pouvez ajouter plusieurs conditions au filtre. Par exemple, vous souhaiterez peut-être inclure les données uniquement si l'altitude est supérieure à 100. Pour ce faire, ajoutez cette condition à la configuration suivante :
+ Type de filtre : « Inclure » les lignes qui « répondent à toutes les conditions »
+ Condition 1 : Lignes où « Température » correspond à « Inférieur » à « 30 »
+ Condition 2 : Lignes où « Altitude » correspond à « Supérieur » à « 100 »
**Lorsque vous avez plusieurs conditions, vous pouvez choisir si vous souhaitez que l'action (inclusion/exclusion) soit appliquée aux lignes qui **correspondent à toutes les** conditions ou à l'une des conditions que vous avez ajoutées.**
Dans l'exemple ci-dessus, nous avons choisi **Match all** parce que nous voulions inclure les lignes dont la température est inférieure à 30 °C *ET* dont l'altitude est supérieure à 100. Si nous voulions plutôt inclure les lignes dont la température est inférieure à 30 °C *OU* dont l'altitude est supérieure à 100 °C, nous sélectionnerions **Match any**. Cela inclurait la première ligne des données d'origine, qui a une température de 32 °C (ne correspond pas à la première condition) mais une altitude de 101 (ce qui correspond à la deuxième condition), elle est donc incluse.
Les conditions non valides ou incomplètement configurées sont ignorées.
Cette transformation polyvalente de filtrage des données vous permet d'inclure ou d'exclure de manière sélective des points de données en fonction de conditions spécifiques. Personnalisez les critères pour adapter la présentation de vos données à vos besoins analytiques uniques.
## Filtrer les champs par nom
Utilisez cette transformation pour supprimer des parties des résultats de votre requête. Il existe trois méthodes pour filtrer les noms de champs :
+ Entrez une expression régulière.
+ Sélectionnez manuellement les champs inclus.
+ Utilisez une variable de tableau de bord.
*Utiliser une expression régulière*
Lorsque vous filtrez à l'aide d'une expression régulière, les noms de champs correspondant à l'expression régulière sont inclus. Par exemple, l'utilisation de l'expression régulière `'prod.*'` renverrait uniquement les champs commençant par `prod`
L'expression régulière peut inclure une variable de tableau de bord interpolée à l'aide de la `${variableName}` syntaxe.
*Sélectionnez manuellement les champs inclus*
Sélectionnez ou désélectionnez les noms de champs pour les supprimer du résultat. Si une expression régulière est également incluse, les champs auxquels l'expression correspond sont inclus, même s'ils ne sont pas cochés.
*Utiliser une variable de tableau de bord*
Sélectionnez **À partir de la variable** pour sélectionner une variable de tableau de bord utilisée pour inclure des champs. En configurant une variable de tableau de bord à choix multiples, les mêmes champs peuvent être affichés dans plusieurs visualisations.
Cette transformation offre la flexibilité nécessaire pour personnaliser les résultats de vos requêtes afin de vous concentrer sur les champs spécifiques dont vous avez besoin pour une analyse et une visualisation efficaces.
## Chaîne de format
Utilisez cette transformation pour personnaliser la sortie d'un champ de chaîne. Cette transformation comporte les champs suivants :
+ **Majuscules** — Formate la chaîne entière en majuscules.
+ **Minuscules** : met en forme la chaîne entière en minuscules.
+ **Phrase** majuscule — Formate le premier caractère de la chaîne en majuscules.
+ **Titre en majuscules** : met en majuscules le premier caractère de chaque mot de la chaîne.
+ **Cas Pascal** — Formate le premier caractère de chaque mot de la chaîne en majuscules et n'inclut pas d'espaces entre les mots.
+ **Camel case** — Formate le premier caractère de chaque mot de la chaîne en majuscules, à l'exception du premier mot, et n'inclut pas d'espaces entre les mots.
+ **Snake case** — Formate tous les caractères de la chaîne en minuscules et utilise des traits de soulignement au lieu d'espaces entre les mots.
+ **Étui pour kebab** : met en forme tous les caractères de la chaîne en minuscules et utilise des tirets au lieu d'espaces entre les mots.
+ **Découper** — Supprime tous les espaces de début et de fin de la chaîne.
+ **Sous-chaîne** — Renvoie une sous-chaîne de la chaîne, en utilisant les positions de début et de fin spécifiées.
Cette transformation constitue un moyen pratique de standardiser et d'adapter la présentation des données de chaîne pour une meilleure visualisation et une meilleure analyse.
**Note**
Cette transformation est actuellement en avant-première publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.
## Heure du formatage
Utilisez cette transformation pour personnaliser le résultat d'un champ temporel. La sortie peut être formatée à l'aide des [chaînes de format Moment.js](https://momentjs.com/docs/#/displaying/). Par exemple, si vous souhaitez afficher uniquement l'année d'un champ horaire, la chaîne de format « YYYY » peut être utilisée pour afficher l'année civile (par exemple, 1999 ou 2012).
**Avant la transformation :**
| Horodatage | Événement |
| --- | --- |
| 1636678740000000000 | Démarrage du système |
| 1636678680000000000 | Login utilisateur |
| 1636678620000000000 | Données mises à jour |
**Après avoir appliqué « YYYY-MM-DD HH:MM:SS » :**
| Horodatage | Événement |
| --- | --- |
| 2021-11-12 14:25:40 | Démarrage du système |
| 2021-11-12 14:24:40 | Login utilisateur |
| 2021-11-12 14:23:40 | Données mises à jour |
Cette transformation vous permet d'adapter la représentation temporelle dans vos visualisations, offrant ainsi flexibilité et précision lors de l'affichage des données temporelles.
**Note**
Cette transformation est disponible dans les espaces de travail compatibles avec Grafana v10 en tant que fonctionnalité alpha.
## Regrouper par
Cette transformation regroupe les données selon une valeur de champ (colonne) spécifiée et traite les calculs pour chaque groupe. Sélectionnez pour afficher la liste des choix de calcul.
Voici un exemple de données d'origine.
| Heure | ID serveur | Température du processeur | État du serveur |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture |
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK |
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge |
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK |
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting |
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK |
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK |
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK |
| 07/07/2020 9 H 23 H 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 nous groupons par le champ ID du serveur, les données seront regroupées de la façon suivante :
| Heure | ID serveur | Température du processeur | État du serveur |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture |
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK |
| 07/07/2020 9 H 23 H 07 | serveur 1 | 86 | OK |
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge |
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK |
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK |
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK |
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK |
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting |
Toutes les lignes ayant la même valeur d'ID de serveur 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 appliquer le calcul à chaque groupe de lignes. Par exemple, nous pourrions vouloir calculer la température moyenne du processeur pour chacun de ces serveurs. Nous pouvons donc ajouter le calcul *moyen* appliqué sur le champ de température du processeur pour obtenir ce qui suit :
| ID serveur | Température du processeur (moyenne) |
| --- | --- |
| serveur 1 | 82 |
| serveur 2 | 88,6 |
| serveur 3 | 59,6 |
Et nous pouvons ajouter plusieurs calculs. Par exemple :
+ Pour le champ Time, nous pouvons calculer la *dernière* valeur, afin de savoir quand le dernier point de données a été reçu pour chaque serveur
+ Pour le champ État du serveur, nous pouvons calculer la *dernière* valeur pour savoir quelle est la dernière valeur d'état pour chaque serveur
+ Pour la température du terrain, nous pouvons également calculer la *dernière* valeur pour savoir quelle est la dernière température surveillée pour chaque serveur
Nous obtiendrions alors :
| ID serveur | Température du processeur (moyenne) | Température du processeur (dernière) | Heure (dernière) | État du serveur (dernier) |
| --- | --- | --- | --- | --- |
| serveur 1 | 82 | 80 | 07/07/2020 11 H 34 MIN 20 S | Fermeture |
| serveur 2 | 88,6 | 90 | 07/07/2020 10 H 32 MIN 20 S | Surcharge |
| serveur 3 | 59,6 | 62 | 07/07/2020 11 H 34 MIN 20 S | OK |
Cette transformation vous permet d'extraire des informations clés de vos séries chronologiques et de les afficher de manière pratique.
## Regroupement dans une matrice
Utilisez cette transformation pour combiner trois champs, qui sont utilisés comme entrée pour les champs de **valeur de **colonne**, de **ligne** et de cellule** à partir de la sortie de la requête, et pour générer une matrice. La matrice est calculée comme suit :
**Données d'origine**
| ID serveur | Température du processeur | État du serveur |
| --- | --- | --- |
| serveur 1 | 82 | OK |
| serveur 2 | 88,6 | OK |
| serveur 3 | 59,6 | Fermeture |
Nous pouvons générer une matrice en utilisant les valeurs `Server Status` des noms de colonnes, des `Server ID` valeurs des noms de lignes et du `CPU Temperature` contenu de chaque cellule. Le contenu de chaque cellule apparaîtra pour la combinaison de colonnes (`Server Status`) et de lignes (`Server ID`) existante. Pour le reste des cellules, vous pouvez sélectionner la valeur à afficher : **Null**, **True**, **False** ou **Empty**.
**Sortie**
| IDServer État du serveur | OK | Fermeture |
| --- | --- | --- |
| serveur 1 | 82 | |
| serveur 2 | 88,6 | |
| serveur 3 | | 59,6 |
Utilisez cette transformation pour créer une matrice en spécifiant des champs à partir des résultats de votre requête. La sortie de la matrice reflète les relations entre les valeurs uniques de ces champs. Cela vous permet de présenter des relations complexes dans un format matriciel clair et structuré.
## Grouper vers une table imbriquée
Utilisez cette transformation pour regrouper les données selon une valeur de champ (colonne) spécifiée et effectuer le calcul sur chaque groupe. Les enregistrements générés partagent la même valeur de champ groupée, à afficher dans une table imbriquée.
Pour calculer une statistique pour un champ, cochez la case à côté du champ et choisissez l'option **Calculer**. Cela ajoutera une autre boîte de sélection avec les statistiques à sélectionner.
Le tableau suivant présente des exemples de données.
| Heure | ID serveur | Température du processeur | État du serveur |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture |
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK |
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge |
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK |
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting |
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK |
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK |
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK |
| 07/07/2020 9 H 23 H 07 | serveur 1 | 86 | OK |
Cette transformation comporte deux étapes. Spécifiez d'abord un ou plusieurs champs selon lesquels vous souhaitez regrouper les données. Cela regroupe toutes les mêmes valeurs de ces champs, comme si vous les triiez. Par exemple, si vous regroupez par `Server ID` champ, Grafana regroupe les données de la façon suivante :
| ID serveur | Données |
| --- | --- |
| Heure | Température du processeur | État du serveur |
| --- | --- | --- |
| Heure | Température du processeur | État du serveur |
| --- | --- | --- |
| Heure | Température du processeur | État du serveur |
| --- | --- | --- |
| serveur 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| serveur 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| serveur 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 07/07/2020 11 H 34 MIN 20 S | 80 | Fermeture |
| 07/07/2020 9 H 28 : 06 | 80 | OK |
| 07/07/2020 9 H 23 H 07 | 86 | OK |
| 07/07/2020 10 H 32 MIN 20 S | 90 | Surcharge |
| 07/07/2020 9 H 30 : 05 | 88 | OK |
| 07/07/2020 9 H 25 MIN 05 S | 88 | OK |
| 07/07/2020 11 H 34 MIN 20 S | 62 | OK |
| 07/07/2020 10 H 31 H 22 | 55 | OK |
| 07/07/2020 9 H 30 : 57 | 62 | Rebooting |
Après avoir choisi le champ selon lequel vous souhaitez regrouper vos données, vous pouvez ajouter différents calculs sur les autres champs et appliquer le calcul à chaque groupe de lignes. Par exemple, vous souhaiterez peut-être calculer la température moyenne du processeur pour chacun de ces serveurs. Pour ce faire, ajoutez le calcul moyen appliqué dans le champ Température du processeur pour obtenir le résultat suivant :
| ID serveur | Température du processeur (moyenne) | |
| --- | --- | --- |
| Heure | État du serveur |
| --- | --- |
| Heure | État du serveur |
| --- | --- |
| Heure | État du serveur |
| --- | --- |
| serveur 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| serveur 2 | 88,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| serveur 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) |
| 07/07/2020 11 H 34 MIN 20 S | Fermeture |
| 07/07/2020 9 H 28 : 06 | OK |
| 07/07/2020 9 H 23 H 07 | OK |
| 07/07/2020 10 H 32 MIN 20 S | Surcharge |
| 07/07/2020 9 H 30 : 05 | OK |
| 07/07/2020 9 H 25 MIN 05 S | OK |
| 07/07/2020 11 H 34 MIN 20 S | OK |
| 07/07/2020 10 H 31 H 22 | OK |
| 07/07/2020 9 H 30 : 57 | Rebooting |
## Création d'une carte thermique
Utilisez cette transformation pour préparer les données d'histogramme afin de visualiser les tendances au fil du temps. À l'instar de la visualisation par carte thermique, cette transformation convertit les métriques de l'histogramme en compartiments temporels.
**Seau X**
Ce paramètre détermine la façon dont l'axe X est divisé en compartiments.
+ **Taille** — Spécifiez un intervalle de temps dans le champ de saisie. Par exemple, une plage de temps de `1h` crée des cellules d'une heure de large sur l'axe X.
+ **Nombre** — Pour les non-time-related séries, utilisez cette option pour définir le nombre d'éléments dans un compartiment.
**Seau Y**
Ce paramètre détermine la façon dont l'axe Y est divisé en compartiments.
+ **Linear (Linéaire)**
+ **Logarithmique** — Choisissez entre log base 2 ou log base 10.
+ **Symlog** — Utilise une échelle logarithmique symétrique. Choisissez entre le log base 2 ou le log base 10, en tenant compte des valeurs négatives.
Supposons que vous disposiez du jeu de données suivant :
| Horodatage | Value |
| --- | --- |
| 01/01/2023 12:00:00 | 5 |
| 01/01/2023 12:15:00 | 10 |
| 01/01/2023 12:30:00 | 15 |
| 01/01/2023 12:45:00 | 8 |
+ Lorsque X Bucket est défini sur `Size: 15m` et Y Bucket sur tel`Linear`, l'histogramme organise les valeurs en intervalles de temps de 15 minutes sur l'axe X et de manière linéaire sur l'axe Y.
+ Pour X Bucket as `Count: 2` et Y Bucket as`Logarithmic (base 10)`, l'histogramme regroupe les valeurs en tranches de deux sur l'axe X et utilise une échelle logarithmique sur l'axe Y.
## Histogramme
Utilisez cette transformation pour générer un histogramme basé sur les données d'entrée, afin de visualiser la distribution des valeurs.
+ **Taille du compartiment** : plage entre les éléments les plus bas et les plus élevés d'un compartiment (XMin à XMax).
+ **Décalage du godet** — Le décalage pour les non-zero-based godets.
+ **Combiner des séries** : créez un histogramme unifié à l'aide de toutes les séries disponibles.
**Données d'origine**
Série 1 :
| A | B | C |
| --- | --- | --- |
| 1 | 3 | 5 |
| 2 | 4 | 6 |
| 3 | 5 | 7 |
| 4 | 6 | 8 |
| 5 | 7 | 9 |
Série 2 :
| C |
| --- |
| 5 |
| 6 |
| 7 |
| 8 |
| 9 |
**Sortie**
| X min | X Max | A | B | C | C |
| --- | --- | --- | --- | --- | --- |
| 1 | 2 | 1 | 0 | 0 | 0 |
| 2 | 3 | 1 | 0 | 0 | 0 |
| 3 | 4 | 1 | 1 | 0 | 0 |
| 4 | 5 | 1 | 1 | 0 | 0 |
| 5 | 6 | 1 | 1 | 1 | 1 |
| 6 | 7 | 0 | 1 | 1 | 1 |
| 7 | 8 | 0 | 1 | 1 | 1 |
| 8 | 9 | 0 | 0 | 1 | 1 |
| 9 | 10 | 0 | 0 | 1 | 1 |
Visualisez la distribution des valeurs à l'aide de l'histogramme généré, qui fournit des informations sur la répartition et la densité des données.
## Inscrivez-vous par domaine
Utilisez cette transformation pour fusionner plusieurs résultats dans une seule table, ce qui permet de consolider les données issues de différentes requêtes.
Cela est particulièrement utile pour convertir plusieurs résultats de séries chronologiques en une seule table large avec un champ horaire partagé.
**Jointure intérieure**
Une jointure interne fusionne les données de plusieurs tables où toutes les tables partagent la même valeur que le champ sélectionné. Ce type de jointure exclut les données dont les valeurs ne correspondent pas dans tous les résultats.
Utilisez cette transformation pour combiner les résultats de plusieurs requêtes (combinaison sur un champ de jointure passé ou sur la première colonne chronologique) en un seul résultat, et supprimez les lignes où une jointure réussie ne peut pas avoir lieu.
Dans l'exemple suivant, deux requêtes renvoient des données de table. Il est visualisé sous la forme de deux tables distinctes avant d'appliquer la transformation de jointure interne.
Requête A :
| Heure | Tâche | Temps de disponibilité |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 |
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 |
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 |
Requête B :
| Heure | Serveur | Erreurs |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 15 |
| 07/07/2020 11 H 24 H 20 | serveur 2 | 5 |
| 07/07/2020 11 H 04 : 20 | serveur 3 | 10 |
Le résultat obtenu après l'application de la transformation de jointure interne est le suivant :
| Heure | Tâche | Temps de disponibilité | Serveur | Erreurs |
| --- | --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | serveur 1 | 15 |
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | serveur 2 | 5 |
*Jointure extérieure*
Une jointure externe inclut toutes les données d'une jointure interne et les lignes dont les valeurs ne correspondent pas dans toutes les entrées. Alors que la jointure interne joint la requête A et la requête B dans le champ temporel, la jointure externe inclut toutes les lignes qui ne correspondent pas dans le champ temporel.
Dans l'exemple suivant, deux requêtes renvoient des données de table. Il est visualisé sous la forme de deux tables avant d'appliquer la transformation de jointure externe.
Requête A :
| Heure | Tâche | Temps de disponibilité |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 |
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 |
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 |
Requête B :
| Heure | Serveur | Erreurs |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 15 |
| 07/07/2020 11 H 24 H 20 | serveur 2 | 5 |
| 07/07/2020 11 H 04 : 20 | serveur 3 | 10 |
Le résultat obtenu après l'application de la transformation de jointure externe est le suivant :
| Heure | Tâche | Temps de disponibilité | Serveur | Erreurs |
| --- | --- | --- | --- | --- |
| 07/07/2020 11 H 04 : 20 | | | serveur 3 | 10 |
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 | | |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | serveur 1 | 15 |
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | serveur 2 | 5 |
## Adhérer par labels
Utilisez cette transformation pour joindre plusieurs résultats dans un seul tableau.
Cela est particulièrement utile pour convertir plusieurs résultats de séries chronologiques en une seule table large avec un champ **Label** partagé.
+ **Joindre** : sélectionnez l'étiquette à joindre entre les étiquettes disponibles ou communes à toutes les séries chronologiques.
+ **Valeur** — Nom du résultat de sortie.
**Exemple**
Entrée 1 : `series1{what='Temp', cluster='A', job='J1'}`
| Heure | Value |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Entrée 2 : `series2{what='Temp', cluster='B', job='J1'}`
| Heure | Value |
| --- | --- |
| 1 | 10 |
| 2 | 200 |
Entrée 3 : `series3{what='Speed', cluster='B', job='J1'}`
| Heure | Value |
| --- | --- |
| 22 | 22 |
| 28 | 77 |
Config :
```
value: 'what'
```
Sortie :
| cluster | tâche | Temp | Vitesse |
| --- | --- | --- | --- |
| A | J1 | 10 | |
| A | J1 | 200 | |
| B | J1 | 10 | 22 |
| B | J1 | 200 | 77 |
Combinez et organisez efficacement les données de séries chronologiques grâce à cette transformation pour obtenir des informations complètes.
## Étiquettes pour les champs
Utilisez cette transformation pour convertir les résultats de séries chronologiques contenant des étiquettes ou des balises dans un tableau, en incluant les clés et les valeurs de chaque étiquette dans le résultat. Affichez les étiquettes sous forme de colonnes ou de valeurs de ligne pour une meilleure visualisation des données.
Étant donné le résultat d'une requête de deux séries chronologiques :
+ Série 1 — étiquettes`Server=Server A`, `Datacenter=EU`
+ Série 2 — étiquettes`Server=Server B`, `Datacenter=EU`
En mode **Colonnes**, le résultat est le suivant :
| Heure | Serveur | Centre de données | Value |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | UE | 1 |
| 07/07/2020 11 H 34 MIN 20 S | Serveur B | UE | 2 |
En mode « Lignes », le résultat comporte un tableau pour chaque série et affiche chaque valeur d'étiquette comme suit :
| étiquette | value |
| --- | --- |
| Serveur | Serveur A |
| Centre de données | UE |
| étiquette | value |
| --- | --- |
| Serveur | Serveur B |
| Centre de données | UE |
**Nom du champ de valeur**
Si vous avez sélectionné Serveur comme **nom du champ Valeur**, vous obtiendrez un champ pour chaque valeur de l'étiquette Serveur.
| Heure | Centre de données | Serveur A | Serveur B |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | UE | 1 | 2 |
**Comportement de fusion**
Le transformateur des étiquettes en champs est constitué en interne de deux transformations distinctes. Le premier agit sur des séries individuelles et extrait les étiquettes des champs. La seconde est la transformation de fusion qui réunit tous les résultats dans une seule table. La transformation de fusion essaie de joindre tous les champs correspondants. Cette étape de fusion est obligatoire et ne peut pas être désactivée.
Pour illustrer cela, voici un exemple dans lequel deux requêtes renvoient des séries chronologiques sans que les libellés ne se chevauchent.
+ Série 1 — étiquettes `Server=ServerA`
+ Série 2 — étiquettes `Datacenter=EU`
Cela donnera d'abord ces deux tableaux :
| Heure | Serveur | Value |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | 10 |
| Heure | Centre de données | Value |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | UE | 20 |
Après la fusion :
| Heure | Serveur | Value | Centre de données |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | 10 | |
| 07/07/2020 11 H 34 MIN 20 S | | 20 | UE |
## Limite
Utilisez cette transformation pour limiter le nombre de lignes affichées, offrant ainsi une vue plus précise de vos données. Cela est particulièrement utile lorsqu'il s'agit de grands ensembles de données.
Voici un exemple illustrant l'impact de la transformation **Limit** sur une réponse provenant d'une source de données :
| Heure | Métrique | Value |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | Température | 25 |
| 07/07/2020 11 H 34 MIN 20 S | Humidité | 22 |
| 07/07/2020 10 H 32 MIN 20 S | Humidité | 29 |
| 07/07/2020 10 H 31 H 22 | Température | 22 |
| 07/07/2020 9 H 30 : 57 | Humidité | 33 |
| 07/07/2020 9 H 30 : 05 | Température | 19 |
Voici le résultat après avoir ajouté une transformation Limit avec une valeur de « 3 » :
| Heure | Métrique | Value |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | Température | 25 |
| 07/07/2020 11 H 34 MIN 20 S | Humidité | 22 |
| 07/07/2020 10 H 32 MIN 20 S | Humidité | 29 |
Cette transformation vous permet d'adapter la présentation visuelle de vos données afin de vous concentrer sur les données les plus pertinentes.
## Fusionner les séries et les tableaux
Utilisez cette transformation pour combiner le résultat de plusieurs requêtes en un seul résultat, ce qui est particulièrement utile lorsque vous utilisez la visualisation du panneau de tableau. La transformation fusionne les valeurs dans la même ligne si les champs partagés contiennent les mêmes données.
Voici un exemple illustrant l'impact de la transformation des **séries et des tables Merge** sur deux requêtes renvoyant des données de table :
*Requête A :*
| Heure | Tâche | Temps de disponibilité |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 |
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 |
Requête B :
| Heure | Tâche | Erreurs |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 15 |
| 07/07/2020 11 H 24 H 20 | postgre | 5 |
Voici le résultat après avoir appliqué la transformation Merge :
| Heure | Tâche | Erreurs | Temps de disponibilité |
| --- | --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | nœud | 15 | 25260122 |
| 07/07/2020 11 H 24 H 20 | postgre | 5 | 123001233 |
Cette transformation combine les valeurs de la requête A et de la requête B dans une table unifiée, améliorant ainsi la présentation pour de meilleures informations.
## Organiser les champs par nom
Utilisez cette transformation pour renommer, réorganiser ou masquer les champs renvoyés par une seule requête dans votre panneau. Cette transformation ne fonctionne que dans les panneaux contenant une seule requête. Si votre panneau contient plusieurs requêtes, vous devez soit appliquer une transformation de *jointure externe*, soit supprimer les requêtes supplémentaires.
**Des champs de transformation**
Grafana affiche une liste des champs renvoyés par la requête. Vous pouvez effectuer les actions suivantes :
+ **Modifier l'ordre des champs** : faites glisser un champ vers un nouvel emplacement dans la liste.
+ **Masquer ou afficher un champ** : utilisez l'icône en forme d'œil à côté du nom du champ pour activer ou désactiver la visibilité d'un champ.
+ **Renommer les champs** : saisissez un nouveau nom dans la zone **Renommer**.
**Exemple**
Compte tenu du résultat initial de la requête :
| Heure | Métrique | Value |
| --- | --- | --- |
| 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 |
Vous pouvez appliquer une modification du nom du champ pour créer :
| Heure | Sensor | Lecture |
| --- | --- | --- |
| 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 |
Cette transformation vous permet de personnaliser l'affichage des résultats des requêtes, garantissant ainsi une représentation claire et pertinente de vos données dans Grafana.
## Partition par valeurs
Utilisez cette transformation pour rationaliser le processus de représentation graphique de plusieurs séries sans avoir besoin de plusieurs requêtes avec des `WHERE` clauses différentes.
**Note**
Cette fonction est disponible dans les espaces de travail compatibles avec Grafana version 9 et supérieure.
Cela est particulièrement utile lorsque vous utilisez une table SQL de métriques, comme dans cet exemple :
| Heure | Région | Value |
| --- | --- | --- |
| 20/10/2022 12 H 00 | ETATS-UNIS | 1520 |
| 20/10/2022 12 H 00 | UE | 2936 |
| 20/10/2022 1 H 00 | ETATS-UNIS | 1327 |
| 20/10/2022 1 H 00 | UE | 912 |
Avec le transformateur *Partition par valeurs*, vous pouvez émettre une seule requête et diviser les résultats par valeurs uniques dans une ou plusieurs colonnes (champs) de votre choix. L’exemple suivant utilise `Region`.
```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```
| Heure | Région | Value |
| --- | --- | --- |
| 20/10/2022 12 H 00 | ETATS-UNIS | 1520 |
| 20/10/2022 1 H 00 | ETATS-UNIS | 1327 |
| Heure | Région | Value |
| --- | --- | --- |
| 20/10/2022 12 H 00 | UE | 2936 |
| 20/10/2022 1 H 00 | UE | 912 |
Cette transformation simplifie le processus et améliore la flexibilité de visualisation de plusieurs séries au sein d'une même visualisation de séries chronologiques.
## Préparer des séries chronologiques
Utilisez cette transformation pour résoudre les problèmes lorsqu'une source de données renvoie des séries chronologiques dans un format incompatible avec la visualisation souhaitée. Cette transformation vous permet de convertir des données de séries chronologiques entre des formats larges et longs.
**Séries chronologiques multicadres**
Utilisez cette option pour transformer le bloc de données de séries chronologiques du format large au format long. Cela est particulièrement utile lorsque votre source de données fournit des informations de séries chronologiques dans un format qui doit être remodelé pour une compatibilité optimale avec votre visualisation.
*Exemple*
Cette entrée :
| Horodatage | Value1 | Value2 |
| --- | --- | --- |
| 01/01/2023 00:00:00 | 10 | 20 |
| 01/01/2023 01:00:00 | 15 | 25 |
Peut être transformé en :
| Horodatage | Variable | Value |
| --- | --- | --- |
| 01/01/2023 00:00:00 | Value1 | 10 |
| 01/01/2023 00:00:00 | Value2 | 20 |
| 01/01/2023 01:00:00 | Value1 | 15 |
| 01/01/2023 01:00:00 | Value2 | 25 |
**Séries chronologiques étendues**
Utilisez cette option pour transformer le bloc de données de séries chronologiques du format long au format large. Cela est particulièrement utile lorsque votre source de données fournit des séries chronologiques dans un format long et que votre visualisation nécessite un format large.
*Exemple*
Cette entrée :
| Horodatage | Variable | Value |
| --- | --- | --- |
| 01/01/2023 00:00:00 | Value1 | 10 |
| 01/01/2023 00:00:00 | Value2 | 20 |
| 01/01/2023 01:00:00 | Value1 | 15 |
| 01/01/2023 01:00:00 | Value2 | 25 |
Peut être transformé en :
| Horodatage | Value1 | Value2 |
| --- | --- | --- |
| 01/01/2023 00:00:00 | 10 | 20 |
| 01/01/2023 01:00:00 | 15 | 25 |
## Réduire
Utilisez cette transformation pour appliquer un calcul à chaque champ du bloc de données et renvoyer une valeur unique. Cette transformation est particulièrement utile pour consolider plusieurs séries chronologiques dans un format résumé plus compact. Les champs temporels sont supprimés lors de l'application de cette transformation.
Tenez compte de l'entrée :
Requête A :
| Heure | Temp | Temps de disponibilité |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 12.3 | 256122 |
| 2020-07-07 11:24:20 | 15,4 | 1230233 |
Requête B :
| Heure | IQA | Erreurs |
| --- | --- | --- |
| 2020-07-07 11:34:20 | 6,5 | 15 |
| 2020-07-07 11:24:20 | 3.2 | 5 |
Le transformateur de réduction possède deux modes :
+ **Série en lignes** : crée une ligne pour chaque champ et une colonne pour chaque calcul.
+ **Réduire les champs** : conserve la structure de cadre existante, mais réduit chaque champ en une seule valeur.
Par exemple, si vous avez utilisé le **premier** et le **dernier** calcul avec une transformation **de séries en lignes**, le résultat serait le suivant :
| Champ | La première | La dernière |
| --- | --- | --- |
| Temp | 12.3 | 15,4 |
| Temps de disponibilité | 256122 | 1230233 |
| IQA | 6,5 | 3.2 |
| Erreurs | 15 | 5 |
L'**option Réduire les champs** avec le **dernier** calcul donne lieu à deux cadres, chacun comportant une ligne :
Requête A :
| Temp | Temps de disponibilité |
| --- | --- |
| 15,4 | 1230233 |
Requête B :
| IQA | Erreurs |
| --- | --- |
| 3.2 | 5 |
## Renommer par regex
Utilisez cette transformation pour renommer certaines parties des résultats de la requête à l'aide d'une expression régulière et d'un modèle de remplacement.
Vous pouvez spécifier une expression régulière, qui ne s'applique qu'aux correspondances, ainsi qu'un modèle de remplacement prenant en charge les références arrières. Imaginons par exemple que vous visualisez l'utilisation du processeur par hôte et que vous souhaitiez supprimer le nom de domaine. Vous pouvez définir l'expression régulière sur `([^\.]+)\..+` et le modèle de remplacement sur`$1`, `web-01.example.com` `web-01` deviendrait.
Cette transformation vous permet d'adapter vos données pour répondre à vos besoins de visualisation, rendant ainsi vos tableaux de bord plus informatifs et plus conviviaux.
## Lignes vers champs
Utilisez cette transformation pour convertir les lignes en champs distincts. Cela peut être utile car les champs peuvent être stylisés et configurés individuellement. Il peut également utiliser des champs supplémentaires comme sources pour la configuration dynamique des champs ou les mapper aux étiquettes des champs. Les étiquettes supplémentaires peuvent ensuite être utilisées pour définir de meilleurs noms d'affichage pour les champs résultants.
Cette transformation inclut une table de champs répertoriant tous les champs des données renvoyées par la requête de configuration. Ce tableau vous permet de contrôler le champ qui doit être mappé à chaque propriété de configuration (option **Utiliser comme**). Vous pouvez également choisir la valeur à sélectionner si les données renvoyées comportent plusieurs lignes.
Cette transformation nécessite :
+ Un champ à utiliser comme source des noms de champs.
Par défaut, la transformation utilise le premier champ de chaîne comme source. Vous pouvez remplacer ce paramètre par défaut en sélectionnant **Nom du champ** dans la colonne **Utiliser comme** champ pour le champ que vous souhaitez utiliser à la place.
+ Un champ à utiliser comme source de valeurs.
Par défaut, la transformation utilise le premier champ numérique comme source. Vous pouvez toutefois annuler ce paramètre par défaut en sélectionnant **Valeur du champ** dans la colonne **Utiliser comme** champ pour le champ que vous souhaitez utiliser à la place.
Utile lors de la visualisation de données dans :
+ Jauge
+ Stat
+ Graphique à secteurs
**Associez des champs supplémentaires à des étiquettes**
Si un champ ne correspond pas à la propriété de configuration, Grafana l'utilisera automatiquement comme source pour une étiquette sur le champ de sortie.
Exemple :
| Nom | DataCenter | Value |
| --- | --- | --- |
| Serveur A | ETATS-UNIS | 100 |
| Serveur B | UE | 200 |
Sortie :
| ServerA (étiquettes DataCenter : États-Unis) | ServerB (étiquettes DataCenter : EU) |
| --- | --- |
| 100 | 200 |
Les libellés supplémentaires peuvent désormais être utilisés dans le nom d'affichage des champs pour fournir des noms de champs plus complets.
Si vous souhaitez extraire la configuration d'une requête et l'appliquer à une autre, vous devez utiliser la *configuration issue de la transformation des résultats de la requête*.
**Exemple**
Entrée :
| Nom | Value | Max |
| --- | --- | --- |
| Serveur A | 10 | 100 |
| Serveur B | 20 | 200 |
| Serveur C | 30 | 300 |
Sortie :
| Serveur A (configuration : max = 100) | Serveur B (configuration : max = 200) | ServerC (configuration : max = 300) |
| --- | --- | --- |
| 10 | 20 | 30 |
Comme vous pouvez le constater, chaque ligne des données source devient un champ distinct. Chaque champ possède désormais également une option de configuration maximale définie. Les options telles que **Min**, **Max**, **Unit** et **Threshold** font toutes partie de la configuration des champs et, si elles sont définies de cette manière, elles seront utilisées par la visualisation au lieu des options configurées manuellement dans le volet d'options de l'éditeur de panneaux.
Cette transformation permet de convertir des lignes en champs individuels, facilite la configuration dynamique des champs et associe des champs supplémentaires à des étiquettes.
## De la série aux rangées
Utilisez cette transformation pour combiner le résultat 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 : heure, métrique et valeur. La colonne Métrique est ajoutée afin que vous puissiez facilement voir de quelle requête provient la métrique. Personnalisez cette valeur en définissant Label 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 d'appliquer la transformation.
*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 |
Voici le résultat après avoir appliqué la transformation Série aux lignes.
| Heure | Métrique | Value |
| --- | --- | --- |
| 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 |
Cette transformation facilite la consolidation des résultats de plusieurs requêtes de séries chronologiques, fournissant un ensemble de données rationalisé et unifié pour une analyse et une visualisation efficaces sous forme de tableau.
## Trier par
Utilisez cette transformation pour trier chaque cadre d'un résultat de requête en fonction d'un champ spécifique, afin de faciliter la compréhension et l'analyse de vos données. En configurant le champ souhaité pour le tri, vous pouvez contrôler l'ordre dans lequel les données sont présentées dans le tableau ou dans la visualisation.
Utilisez le commutateur **inverse** pour ordonner inversement les valeurs dans le champ spécifié. Cette fonctionnalité est particulièrement utile lorsque vous souhaitez passer rapidement de l'ordre croissant à l'ordre décroissant pour répondre à vos besoins analytiques.
Par exemple, dans un scénario où les données de séries chronologiques sont extraites d'une source de données, la transformation **Trier par** peut être appliquée pour organiser les blocs de données en fonction de l'horodatage, par ordre croissant ou décroissant, en fonction des exigences analytiques. Cette fonctionnalité vous permet de naviguer et d'interpréter facilement les données de séries chronologiques, en obtenant des informations précieuses grâce à une présentation organisée et visuellement cohérente.
## Spatial
Utilisez cette transformation pour appliquer des opérations spatiales aux résultats des requêtes.
+ **Action** — Sélectionnez une action :
+ **Préparer le champ spatial** : définissez un champ de géométrie en fonction des résultats d'autres champs.
+ **Mode de localisation** — Sélectionnez un mode de localisation (ces options sont partagées par les modes **Calculer la valeur** et **Transformer**) :
+ **Auto** : identifie automatiquement les données de localisation en fonction des noms de champs par défaut.
+ **Coordonnées — Spécifiez les** champs de latitude et de longitude.
+ **Geohash** — Spécifiez un champ Geohash.
+ **Recherche** — Spécifiez les champs de localisation du répertoire géographique.
+ **Calculer la valeur** — Utilisez la géométrie pour définir un nouveau champ (heading/distance/area).
+ **Fonction** — Choisissez une opération mathématique à appliquer à la géométrie :
+ **Titre** — Calculez le cap (direction) entre deux points.
+ **Surface** : calculez la zone délimitée par un polygone défini par la géométrie.
+ **Distance** — Calculez la distance entre deux points.
+ **Transformer** — Appliquez des opérations spatiales à la géométrie.
+ **Opération** — Choisissez une opération à appliquer à la géométrie :
+ **En tant que ligne** : créez une entité linéaire unique avec un sommet sur chaque ligne.
+ **Générateur de lignes** : créez une ligne entre deux points.
Cette transformation vous permet de manipuler et d'analyser des données géospatiales, en permettant des opérations telles que la création de lignes entre des points, le calcul de propriétés spatiales, etc.
## Transformation d'une série chronologique en table
Utilisez cette transformation pour convertir les résultats de séries chronologiques en table, transformant ainsi un bloc de données de séries chronologiques en champ de **tendance**. Le champ **Trend** peut ensuite être rendu à l'aide du [type de cellule sparkline](v10-panels-table.md#v10-panels-table-cell-type), générant une ligne sparkline intégrée pour chaque ligne du tableau. S'il existe plusieurs requêtes de séries chronologiques, chacune aboutira à un bloc de données de table distinct. Ils peuvent être joints à l'aide de transformations de jointure ou de fusion pour produire un seul tableau avec plusieurs sparklines par ligne.
Pour chaque valeur de champ de **tendance** générée, une fonction de calcul peut être sélectionnée. La valeur par défaut est **Dernière valeur non nulle**. Cette valeur est affichée à côté du sparkline et est utilisée pour trier les lignes du tableau.
## Analyse de régression
Utilisez cette transformation pour créer un nouveau bloc de données contenant des valeurs prédites par un modèle statistique. Cela est utile pour trouver une tendance dans des données chaotiques. Il fonctionne en ajustant une fonction mathématique aux données, en utilisant une régression linéaire ou polynomiale. Le bloc de données peut ensuite être utilisé dans une visualisation pour afficher une courbe de tendance.
Il existe deux modèles différents :
+ **Régression linéaire** — Ajuste une fonction linéaire aux données.
+ **Régression polynomiale** : adapte une fonction polynomiale aux données.
**Note**
Cette transformation est actuellement en avant-première publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.
# Résoudre les problèmes liés aux requêtes
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Cette page fournit des informations permettant de résoudre les problèmes courants liés aux tableaux de bord.
**J'obtiens des résultats différents lorsque je réorganise mes fonctions**
L'ordre des fonctions est très important. Tout comme en mathématiques, l'ordre dans lequel vous placez vos fonctions peut affecter le résultat.
**Vérifiez votre requête, votre demande et votre réponse**
Les problèmes les plus courants sont liés à la requête et à la réponse provenant de votre source de données. Même s'il s'agit d'un bogue ou d'un problème de visualisation dans Grafana, il s'agit presque toujours d'un problème lié à la requête de source de données ou à la réponse de la source de données. Commencez par inspecter la requête et la réponse de votre panel.
Pour plus d'informations, reportez-vous à la section [Inspecter les données de demande et de réponse](v10-panels-panel-inspector.md).
**Ma requête est lente**
Combien de points de données votre requête renvoie-t-elle ? Une requête qui renvoie un grand nombre de points de données sera lente. Essayez ceci :
+ Dans les **options de requête**, limitez le nombre **maximum de points de données** renvoyés.
+ Dans les **options de requête**, augmentez le temps **d'intervalle minimal**.
+ Dans votre requête, utilisez une `group by` fonction.
# Types de calculs
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec 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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Le tableau suivant contient une liste des calculs que vous pouvez effectuer dans Grafana. Vous pouvez trouver ces calculs dans l'onglet **Transformation** et dans les visualisations des jauges à barres, des jauges et des statistiques.
| Calculs | Description |
| --- | --- |
| Toutes les valeurs nulles | Vrai lorsque toutes les valeurs sont nulles |
| Toutes les valeurs | Tableau avec toutes les valeurs |
| Toutes les valeurs uniques | Tableau avec toutes les valeurs uniques |
| Tous les zéros | Vrai lorsque toutes les valeurs sont égales à 0 |
| Nombre de modifications | Nombre de fois que la valeur du champ change |
| Nombre | Nombre de valeurs dans un champ |
| Delta | Changement de valeur cumulé, ne compte que les incréments |
| Différence | Différence entre la première et la dernière valeur d'un champ |
| Pourcentage de différence | Variation en pourcentage entre la première et la dernière valeur d'un champ |
| Nombre distinct | Nombre de valeurs uniques dans un champ |
| La première | Première valeur d'un champ |
| Premier\$1 (non nul) | Tout d'abord, aucune valeur nulle dans un champ (exclut également NaNs) |
| La dernière | Dernière valeur d'un champ |
| Last\$1 (non nul) | Enfin, valeur non nulle dans un champ (exclut également NaNs) |
| Max | Valeur maximale d'un champ |
| Mean | Valeur moyenne de toutes les valeurs d'un champ |
| Variance | Variance de toutes les valeurs d'un champ |
| StdDev | Écart type de toutes les valeurs d'un champ |
| Min | Valeur minimale d'un champ |
| Minimum (supérieur à zéro) | Valeur positive minimale d'un champ |
| Range | Différence entre les valeurs maximales et minimales d'un champ |
| Step (Étape) | Intervalle minimal entre les valeurs d'un champ |
| Total | Somme de toutes les valeurs d'un champ |
# Configurer les options du panneau
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Un panneau Grafana est une représentation visuelle des données que vous pouvez personnaliser en définissant une requête de source de données, en transformant et en formatant les données et en configurant les paramètres de visualisation.
Un éditeur de panneaux inclut un générateur de requêtes et une série d'options que vous pouvez utiliser pour transformer des données et ajouter des informations à vos panneaux.
Cette rubrique explique comment :
+ Ouvrez un panneau pour le modifier
+ Ajouter un titre et une description au panneau
+ Afficher un modèle JSON de panneau
+ Configuration de lignes et de panneaux répétitifs
## Modification d'un panneau
Après avoir ajouté un panneau à un tableau de bord, vous pouvez l'ouvrir à tout moment pour modifier ou mettre à jour des requêtes, ajouter une transformation de données et modifier les paramètres de visualisation.
**Pour modifier un panneau**
1. Ouvrez le tableau de bord qui contient le panneau que vous souhaitez modifier.
1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.
1. Choisissez le menu, puis sélectionnez **Modifier**.
Pour ouvrir le panneau à l'aide d'un raccourci clavier, survolez le panneau avec le pointeur de la souris et appuyez sur`e`.
Le panneau s'ouvre en mode édition.
## Ajouter un titre et une description à un panneau
Ajoutez un titre et une description à un panneau pour partager avec les utilisateurs toute information importante concernant la visualisation. Par exemple, utilisez la description pour documenter l'objectif de la visualisation.
1. Modifiez un panneau.
1. Dans le volet des options d'affichage du panneau, recherchez la section des **options du panneau**.
1. Entrez un **titre**.
Le texte saisi dans ce champ apparaît dans une infobulle dans l'éditeur de panneaux et dans le tableau de bord.
1. Rédigez une description du panneau et des données que vous affichez.
Le texte saisi dans ce champ apparaît dans une infobulle dans le coin supérieur gauche du panneau.
Vous pouvez utiliser [les variables que vous avez définies](v10-dash-variables.md) dans les champs **Titre** et **Description**, mais pas [les variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
## Affichage d'un modèle JSON de panneau
Explorez et exportez des modèles JSON de panneau, de données de panneau et de trame de données.
**Pour afficher un modèle JSON de panneau**
1. Ouvrez le tableau de bord qui contient le panneau.
1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.
1. Dans le menu, sélectionnez **Inspecter > Panel JSON**.
1. Dans le champ **Sélectionner la source**, choisissez l'une des options suivantes :
+ **Panneau JSON** — Affiche un objet JSON représentant le panneau.
+ **Données du panneau** : affiche un objet JSON représentant les données transmises au panneau.
+ **DataFrame structure** : affiche la structure de données du panneau, y compris les transformations, les configurations de champs et les configurations de remplacement qui ont été appliquées.
1. Pour explorer le JSON, choisissez **>** pour développer ou réduire des parties du modèle JSON.
## Configuration de panneaux récurrents
Vous pouvez configurer Grafana pour ajouter dynamiquement des panneaux ou des lignes à un tableau de bord. Un panneau dynamique est un panneau créé par le système en fonction de la valeur d'une variable. Les variables modifient dynamiquement vos requêtes dans tous les panneaux d'un tableau de bord. Pour plus d'informations sur les panneaux répétitifs, consultez[Création de tableaux de bord](v10-dash-creating.md).
**Note**
Les panneaux qui se répètent nécessitent des variables pour sélectionner un ou plusieurs éléments ; vous ne pouvez pas répéter un panneau zéro fois pour le masquer.
*Prérequis*
+ Assurez-vous que la requête inclut une variable à valeurs multiples.
**Pour configurer des panneaux récurrents**
1. Modifiez le panneau que vous souhaitez répéter.
1. Dans le volet des options d'affichage, choisissez **Options du panneau > Options de répétition**.
1. Sélectionnez une **direction**.
+ Choisissez l'**horizontale** pour disposer les panneaux side-by-side. Grafana ajuste la largeur d'un panneau répété. Vous ne pouvez pas mélanger d'autres panneaux d'une ligne avec un panneau répété.
+ Choisissez la **verticale** pour disposer les panneaux dans une colonne. La largeur des panneaux répétés est la même que celle du panneau répété d'origine.
1. Pour appliquer les modifications à tous les panneaux, rechargez le tableau de bord.
# Configuration des options standard
****
**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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Le modèle de données utilisé dans Grafana est une structure de table orientée en colonnes qui unifie à la fois 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.
Une liste complète des options de formatage des champs est incluse plus loin dans cette rubrique.
**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.
**Pour configurer les options standard**
1. Ouvrez un tableau de bord. Passez le curseur sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit du tableau de bord.
1. Dans le menu Actions, choisissez **Modifier**.
1. Dans le volet des options d'affichage du panneau, recherchez la section **Options standard**.
1. Sélectionnez les options standard que vous souhaitez appliquer.
1. Pour prévisualiser votre modification, sélectionnez en dehors de la zone d'option du champ que vous modifiez 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**
Grafana Labs s'efforce constamment d'ajouter et de développer des options pour toutes les visualisations, de sorte que toutes les options peuvent ne pas être disponibles pour toutes les visualisations.
## Unit
Permet de choisir l'unité qu'un champ doit utiliser. Choisissez 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 :** pour une unité personnalisée qui doit suivre la valeur.
+ **préfixe :** pour une unité personnalisée qui doit précéder la valeur.
+ **heure :** pour les formats de date et d'heure personnalisés, tapez par exemple`time:YYYY-MM-DD`. Voir [format](https://momentjs.com/docs/#/displaying/) dans la *documentation Moment.js* pour la syntaxe et les options de format.
+ **si :** pour les unités SI personnalisées. Par exemple : `si: mF`. C'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 sources sont représentées sous forme de milli (milliers de), préfixez l'unité avec ce caractère d'échelle SI.
+ **nombre :** pour une unité de comptage personnalisée.
+ **devise :** 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.**
### Unités d'échelle
Par défaut, Grafana redimensionne automatiquement l'unité en fonction de l'amplitude de la valeur. Par exemple, si vous avez une valeur de 0,14 kW, Grafana l'affichera sous la forme 140 W. Un autre exemple est que 3 000 kW seront affichés sous la forme de trois MW. Si vous souhaitez désactiver ce comportement, vous pouvez désactiver le commutateur **Unités d'échelle**.
## Min
Permet de définir la valeur minimale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour calculer automatiquement le minimum.
## Max
Permet de définir la valeur maximale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour calculer automatiquement le maximum.
## Champ min/max
Par défaut, le minimum et le maximum calculés seront basés sur le minimum et le maximum, dans toutes les séries et tous les champs. L'activation min/max du champ permet de calculer le minimum ou le maximum de chaque champ individuellement, en fonction du minimum ou du maximum de ce champ.
## 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](v10-dash-variables.md) dans le titre du champ.
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 **\$1 \$1\$1\$1field.name\$1** pour n'utiliser que le nom de la série ou le nom du champ dans le titre.
Étant donné un champ portant le nom et `Temp` les libellés `{"Loc"="PBI", "Sensor"="3"}` suivants :
| Syntaxe des expressions | Exemple | Effectue des rendus vers | Explication |
| --- | --- | --- | --- |
| \$1\$1\$1\$1field.displayName\$1 | Identique à la syntaxe | Temp \$1Loc="PBI", Sensor="3"\$1 | Affiche le nom du champ et les libellés \$1\$1 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. |
| \$1\$1\$1\$1field.name\$1 | Identique à la syntaxe | Temp | Affiche le nom du champ (sans étiquette). |
| \$1\$1\$1\$1field.labels\$1 | Identique à la syntaxe | Loc="PBI", Sensor="3" | Affiche les étiquettes sans leur nom. |
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Affiche la valeur de la clé d'étiquette spécifiée. |
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | 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 |
| Nuances d'une couleur | Sélectionne les nuances d'une seule couleur, ce qui est utile dans le cadre d'une règle de dérogation |
| À 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égorielles |
| Palette classique (par nom de série) | Grafana attribuera la couleur en fonction du nom de la série. Utile lorsque les noms de séries à visualiser dépendent des données disponibles. |
| Green-Yellow-Red (par valeur) | Schéma de couleurs continu |
| Red-Yellow-Green (par valeur) | Schéma de couleurs continu |
| Blue-Yellow-Red (par valeur) | Schéma de couleurs continu |
| Jaune-rouge (par valeur) | Schéma de couleurs continu |
| Bleu-violet (par valeur) | Schéma de couleurs continu |
| Jaune-bleu (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 rouge) |
| Verts (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau virant au vert) |
| Violet (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau virant au violet) |
## 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 (-).
# Configuration d'une légende
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec 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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Un panneau inclut une légende que vous pouvez utiliser pour interpréter les données affichées dans une visualisation. Chaque option de légende ajoute du contexte et de la clarté aux données illustrées dans une visualisation.
Les légendes sont prises en charge pour les visualisations suivantes :
+ [Graphique à barres](v10-panels-bar-chart.md)
+ [Chandelier](v10-panels-candlestick.md)
+ [Histogramme](v10-panels-histogram.md)
+ [Diagramme circulaire](v10-panels-piechart.md)
+ [Chronologie de l'État](v10-panels-state-timeline.md)
+ [Historique des statuts](v10-panels-status-history.md)
+ [Séries chronologiques](v10-panels-time-series.md)
+ [Tendance](v10-panels-trend.md)
[Les géomaps](v10-panels-geomap.md) et les [heatmaps](v10-panels-heatmap.md) comportent également des légendes, mais elles offrent uniquement le choix d'afficher ou non une légende, et ne prennent pas en charge les autres options de légende.
## Options de légende
Vous trouverez les options suivantes dans la section **Légende** du volet d'édition du panneau.
**Note**
Les options répertoriées ne s'appliquent pas toutes à toutes les visualisations comportant des légendes.
**Visibilité**
Définissez si la légende est affichée ou non. Utilisez le commutateur pour activer ou désactiver une légende.
**Mode**
Définissez le format d'affichage de la légende. Choisissez parmi :
+ **List**
+ **Tableau **
Lorsque vous formatez une légende sous forme de tableau, d'autres informations relatives à la légende, telles que les valeurs associées ou son emplacement dans la visualisation, peuvent également être affichées.
**Placement**
Définissez l'endroit où la légende est affichée sur la visualisation. Choisissez parmi :
+ **Bottom (Bas)**
+ **Right (Droite)**
**Width (Largeur)**
Si vous définissez le placement de la légende sur **Droite**, l'option **Largeur** devient disponible. Laissez le champ vide pour permettre à Grafana de définir automatiquement la largeur de la légende, ou entrez une valeur dans le champ.
**Valeurs**
Vous pouvez ajouter du contexte à une visualisation en ajoutant des valeurs de données de série ou [des calculs](v10-panels-calculation-types.md) à une légende. Vous pouvez ajouter autant de valeurs que vous le souhaitez. Après avoir appliqué vos modifications, vous pouvez faire défiler la légende pour voir toutes les valeurs.
## Modification de la couleur d'une série
Par défaut, Grafana définit la couleur des données de votre série, mais vous pouvez les modifier via la légende du panneau.
**Pour modifier la couleur d'une série**
1. Accédez au panneau que vous souhaitez mettre à jour.
1. Dans la légende, sélectionnez la barre de couleur associée à la série.
1. Sélectionnez une couleur prédéfinie dans l'onglet **Couleurs** ou définissez une couleur personnalisée dans l'onglet **Personnalisé**, à l'aide du sélecteur ou des valeurs RGB.
1. Enregistrez le tableau de bord.
## Isolation des données de série dans une visualisation
Les visualisations peuvent souvent être visuellement complexes et inclure de nombreuses séries de données. Vous pouvez simplifier la vue en supprimant les données de série de la visualisation par le biais de la légende, qui isole les données que vous souhaitez consulter. **Lorsque vous faites cela, Grafana crée automatiquement une nouvelle dérogation dans l'onglet Override.**
**Pour isoler les données de série dans une visualisation**
1. Accédez au panneau que vous souhaitez mettre à jour.
1. Dans la légende, sélectionnez l'étiquette de la série que vous souhaitez isoler.
Le système supprime de la vue toutes les autres données de série.
1. Pour ajouter progressivement des données de série à une série isolée, appuyez sur la touche **Ctrl** ou **Commande** et sélectionnez l'étiquette de la série que vous souhaitez ajouter.
1. Pour enregistrer vos modifications afin qu'elles apparaissent à tous les utilisateurs du panneau, enregistrez le tableau de bord.
Pour revenir à la vue par défaut qui inclut toutes les données, cliquez deux fois sur l'étiquette d'une série.
## Série de tri
Lorsque vous formatez une légende sous forme de tableau et que vous y ajoutez des valeurs, vous pouvez trier les séries du tableau en fonction de ces valeurs.
**Pour trier les séries**
1. Accédez au panneau que vous souhaitez mettre à jour.
1. Passez le curseur sur n'importe quelle partie du panneau sur laquelle vous souhaitez travailler pour afficher le menu dans le coin supérieur droit du panneau.
1. Dans le menu, choisissez **Modifier**.
1. Accédez à la section **Légende** du volet d'édition du panneau.
1. Sous **Valeurs**, sélectionnez la valeur ou le calcul que vous souhaitez afficher.
La légende affiche désormais des valeurs.
1. Choisissez l'en-tête du nom du calcul dans le tableau des légendes pour trier les valeurs du tableau par ordre croissant ou décroissant.
**Note**
Cette fonctionnalité n'est prise en charge que dans les panneaux suivants : graphique à barres, histogramme, séries chronologiques.
# Configuration des liaisons de données
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec 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](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Les liens de données vous permettent de fournir un contexte plus détaillé à vos liens. Vous pouvez créer des liens qui incluent le nom de la série ou même la valeur située sous le curseur. Par exemple, si votre visualisation montre quatre serveurs, vous pouvez ajouter une liaison de données vers un ou deux d'entre eux. Vous pouvez également lier des panneaux à l'aide de liens de données.
Le lien lui-même est accessible de différentes manières en fonction de la visualisation. Pour la visualisation des séries chronologiques, par exemple, vous choisissez un point de données ou une ligne. Pour les visualisations de grande surface, telles que les statistiques, les jauges ou les jauges à barres, vous pouvez choisir n'importe où dans la visualisation pour ouvrir le menu contextuel.
S'il n'y a qu'un seul lien de données dans la visualisation, le fait de choisir n'importe où dans la visualisation ouvre le lien plutôt que le menu contextuel.
**Visualisations prises en charge**
+ Diagramme à barres
+ Jauge à barres
+ Candlestick (Chandelier)
+ Canvas
+ Jauge
+ Géomap
+ Heatmap
+ Histogramme
+ Graphique à secteurs
+ Stat
+ Chronologie de l'État
+ Historique des statuts
+ Table
+ Séries chronologiques
+ Tendance
## Variables de liaison de données
Les variables contenues dans les liens de données vous permettent d'envoyer les utilisateurs vers un tableau de bord détaillé avec des filtres de données préservés. Par exemple, vous pouvez utiliser une variable pour spécifier une étiquette, une plage de temps, une série ou une sélection de variables.
Pour voir la liste des variables disponibles, saisissez `$` le champ **URL** du lien de données.
Vous pouvez également utiliser des variables de modèle dans vos liens de données URLs, voir[Variables](v10-dash-variables.md).
### Variables du panneau de plage de temps
Ces variables vous permettent d'inclure la plage horaire actuelle dans l'URL du lien de données.
+ `__url_time_range`— plage horaire du tableau de bord actuel (c'est-à-dire`?from=now-6h&to=now`)
+ `$__from` : pour plus d'informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to` : pour plus d'informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
### Variables de série
Les variables spécifiques aux séries sont disponibles dans l'espace `__series` de noms :
+ `__series.name`— nom de la série vers l'URL
### Variables de champ
Les variables spécifiques aux champs sont disponibles dans l'espace de noms : `__field`
+ `__field.name`— le nom du champ
+ `__field.labels.