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 9
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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](v9-panels-editor-overview.md)
+ [Configurer les options du panneau](v9-panels-configure-panel-options.md)
+ [Configuration des options standard](v9-panels-configure-standard-options.md)
+ [Interrogez et transformez les données](v9-panels-query-xform.md)
+ [Configuration des seuils](v9-panels-configure-thresholds.md)
+ [Configuration des liaisons de données](v9-panels-configure-data-links.md)
+ [Configurer les remplacements de champs](v9-panels-configure-overrides.md)
+ [Configurer les mappages de valeurs](v9-panels-configure-value-mappings.md)
+ [Configuration d'une légende](v9-panels-configure-legend.md)
+ [Types de calculs](v9-panels-calculation-types.md)
+ [Annoter des visualisations](v9-panels-annotate-visualizations.md)
+ [Vue d'inspection du panneau](v9-panels-panel-inspector.md)
+ [Visualisations disponibles dans la version 9 de Grafana](v9-panels-viz.md)
# Présentation de l'éditeur de panneaux
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 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 :
+ **Icône des paramètres du tableau de bord (engrenage) :** cliquez pour accéder aux paramètres du tableau de bord.
+ **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 résoudre les problèmes. Cette vue ne contient que 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](v9-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.
+ **Onglet Transformation :** appliquez des transformations de données.
+ **Onglet Alerte :** écrivez les règles d'alerte.
+ 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 de vos données.
## Ouvrez le panneau, inspectez le tiroir
Le tiroir d'inspection vous aide à comprendre vos panneaux et à les dépanner. 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.
**Remarque :** 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 d'inspection des tiroirs ouvre un tiroir sur le côté droit. Cliquez sur 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 l'erreur. Visible uniquement lorsque la requête renvoie une erreur.
# Configurer les options du panneau
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 l'interface utilisateur que vous utilisez pour définir une requête de source de données, ainsi que pour transformer et formater les données qui apparaissent dans les visualisations.
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
+ Ajouter des lignes et des panneaux répétitifs
## Modifier un panneau
Après avoir ajouté un panneau à un tableau de bord, vous pouvez l'ouvrir à tout moment pour modifier ou mettre à jour les requêtes, ajouter une transformation de données et modifier les paramètres de visualisation.
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. Cliquez sur le menu et sélectionnez **Modifier**.
Pour ouvrir le panneau à l'aide d'un raccourci clavier, passez le pointeur de la souris sur celui-ci 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 en haut de votre panneau 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](v9-dash-variables.md) dans les champs **Titre** et **Description**, mais pas [les variables globales](v9-dash-variable-add.md#v9-dash-variable-add-global).
## Afficher 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.
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. Cliquez sur le menu et sélectionnez **Inspecter > Panel JSON**.
1. Dans le champ **Sélectionner la source**, sélectionnez 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 le jeu de résultats bruts avec les transformations, les configurations de champs et les configurations de remplacement appliquées.
1. Pour explorer le JSON, cliquez sur **>** 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.
**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.
**Avant de commencer :**
+ Assurez-vous que la requête inclut une variable à valeurs multiples.
**Pour configurer des panneaux récurrents, procédez comme suit :**
1. Modifiez le panneau que vous souhaitez répéter.
1. Dans le volet des options d'affichage, cliquez sur **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é. À l'heure actuelle, 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 compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 les résultats des séries chronologiques et des requêtes de table. Chaque colonne de cette structure est appelée *champ*. Un champ peut représenter une seule série chronologique ou une colonne de table.
Les options de champ vous permettent de modifier le mode d'affichage des données dans vos visualisations. Les options et les dérogations que vous appliquez ne modifient pas les données, elles modifient la façon dont Grafana affiche les données. Lorsque vous modifiez une option, elle est appliquée à tous les champs, c'est-à-dire à toutes les séries ou colonnes. Par exemple, si vous remplacez l'unité par un pourcentage, tous les champs contenant des valeurs numériques sont affichés en pourcentages.
Pour obtenir la liste complète des options de formatage des champs, reportez-vous à la section [Définitions des options standard](#v9-panels-standard-options-definitions).
**Note**
Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.
1. Ouvrez un tableau de bord, cliquez sur le titre du panneau, puis sur **Modifier**.
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, cliquez en dehors de la zone d'options du champ que vous êtes en train de modifier ou appuyez sur **Entrée**.
## Définitions des options standard
Cette section explique toutes les options standard disponibles.
Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.
La plupart des options de champ n'affectent pas la visualisation tant que vous n'avez pas cliqué en dehors de la zone d'options de champ que vous êtes en train de modifier ou que vous n'avez pas appuyé sur Entrée.
**Note**
Nous nous efforçons constamment d'ajouter et de développer des options pour toutes les visualisations. Il est donc possible que toutes les options ne soient pas disponibles pour toutes les visualisations.
### Unit
Permet de choisir l'unité qu'un champ doit utiliser. Cliquez dans le champ **Unité**, puis naviguez vers le bas jusqu'à ce que vous trouviez l'unité souhaitée. L'unité que vous sélectionnez est appliquée à tous les champs sauf le temps.
#### Unités personnalisées
Vous pouvez également utiliser la liste déroulante des unités pour spécifier des unités personnalisées, un préfixe ou un suffixe personnalisé et des formats de date et d'heure.
Pour sélectionner une unité personnalisée, entrez l'unité et sélectionnez la dernière option **Personnalisée : xxx** dans le menu déroulant.
+ **suffixe :** pour l'unité personnalisée qui doit suivre la valeur.
+ **préfixe :** pour l'unité personnalisée qui doit précéder la valeur.
+ **heure :** pour les formats de date et heure personnalisés, tapez par exemple **time:YYYY-MM-DD**. Voir [formats](https://momentjs.com/docs/#/displaying/) pour connaître la syntaxe et les options de format.
+ **si :** pour les unités SI personnalisées. Par exemple : **si : mF**. Celui-ci est un peu plus avancé car vous pouvez spécifier à la fois une unité et l'échelle des données source. Donc, si vos données source sont représentées sous forme de milli (milliers de), préfixez l'unité avec ce caractère d'échelle SI.
+ **nombre :** 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.**
### Min
Permet de définir la valeur minimale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour le calcul automatique basé sur toutes les séries et tous les champs.
### Max
Permet de définir la valeur maximale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour le calcul automatique basé sur toutes les séries et tous les champs.
### Décimales
Spécifiez le nombre de décimales que Grafana inclut dans la valeur rendue. Si vous laissez ce champ vide, Grafana tronque automatiquement le nombre de décimales en fonction de la valeur. Par exemple, 1.1234 s'affichera sous la forme 1,12 et 100,456 sous la forme 100.
**Pour afficher toutes les décimales, définissez l'unité sur Chaîne.**
### Nom d’affichage
Permet de définir le titre d'affichage de tous les champs. Vous pouvez utiliser [des variables](v9-dash-variables.md).
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 nommé Temp et les libellés \$1"loc"="Pbi », « Sensor"="3"\$1
| Syntaxe des expressions | Exemple | Effectue des rendus vers | Explication |
| --- | --- | --- | --- |
| \$1 \$1\$1\$1Field.DisplayName\$1 | Identique à la syntaxe | Temp \$1loc="PBI », capteur="3"\$1 | Affiche le nom du champ et les libellés dans \$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 », Capteur="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\$1valeurs\$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 |
| À partir des seuils | Demande à Grafana de prendre la couleur correspondant au seuil correspondant |
| Palette classique | Grafana attribuera une couleur en recherchant une couleur dans une palette par index de série. Utile pour les graphiques, les diagrammes à secteurs et autres visualisations de données catégoriques |
| Green-Yellow-Red (par valeur) | Schéma de couleurs continu |
| Blue-Yellow-Red (par valeur) | Schéma de couleurs continu |
| Blues (par valeur) | Schéma de couleurs continu (fond du panneau en bleu) |
| Rouges (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu) |
| Verts (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu) |
| Violet (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au bleu) |
### Aucune valeur
Entrez ce que Grafana doit afficher si la valeur du champ est vide ou nulle. La valeur par défaut est un tiret (-).
# Interrogez et transformez les données
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 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.
## À 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, consultez sa documentation :
+ Pour les sources de données incluses dans Grafana, voir Sources de [données intégrées](AMG-data-sources-builtin.md).
+ Pour les sources de données incluses dans l'édition Grafana Enterprise, voir. [Connectez-vous aux sources de données de l'entreprise](AMG-data-sources-enterprise.md)
**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 plus de détails, reportez-vous à la section Sources de données
## 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 de l'inspecteur de requêtes :** — Ouvre le panneau de l'inspecteur de requêtes, dans lequel vous pouvez visualiser et optimiser votre requête.
+ **Liste de l'éditeur de requêtes :** — Répertorie les requêtes que vous avez écrites.
+ **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](v9-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](#v9-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 une requête, 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. Par exemple, Loki diffuse des données en mode Live Tailing.
+ **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](v9-dash-variable-add.md#v9-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/v9-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/v9-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 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 principalement utilisées par [Grafana](v9-alerts.md) Alerting. 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. À l'avenir, nous avions l'intention d'ajouter une assertion des données de type de retour de requête (nombre ou série chronologique) afin que les expressions puissent mieux gérer les erreurs.
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 :
| Lock | Host (Hôte) | Processeur AVG |
| --- | --- | --- |
| MIA | A | 1 |
| NYC | B | 2 |
L'exemple ci-dessus produira 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.
**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`), en octal (avec un zéro en tête`072`) ou en 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 OP = numéro
+ Numéro : série OP = série
+ Série OP = 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 sont mathématiques exactes, 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 existe parce qu'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 : la durée du rééchantillonnage, par exemple, les `10s.` unités peuvent être des `s` 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** se remplit 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. [Gestion de l'absence de données ou des cas d'erreur](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)
# Partager les résultats des requêtes avec un autre panneau
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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](v9-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, qui renvoie une série chronologique aléatoire que vous pouvez utiliser pour les tests. **TestData**
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 l'une 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 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 indiquent comment ajouter une transformation aux données.
**Pour ajouter une transformation à un panneau**
1. Accédez au panneau dans lequel vous souhaitez ajouter une ou plusieurs transformations.
1. Choisissez le titre du panneau, puis cliquez sur **Modifier**.
1. Choisissez l'onglet **Transformation**.
1. Choisissez 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 bogue sur le côté droit de la ligne de transformation.
Les ensembles de résultats en entrée et en sortie peuvent vous aider à déboguer une transformation.
## 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. Choisissez l'onglet **Transformation**.
1. Cliquez sur l'icône de corbeille à côté de la transformation que vous souhaitez supprimer.
## Fonctions de transformation
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.
+ **Option binaire** — Appliquez des opérations mathématiques de base (somme, multiplication, etc.) sur les valeurs d'une seule ligne à partir de deux champs sélectionnés.
+ **Nom du champ** — Sélectionnez les noms des champs que vous souhaitez utiliser dans le calcul du nouveau champ.
+ **Calcul** : si vous sélectionnez **le mode Réduire les lignes**, le champ **Calcul** apparaît. Cliquez dans 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](v9-panels-calculation-types.md).
+ **Fonctionnement** — Si vous sélectionnez le mode **option binaire**, 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.
+ **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.
**Concaténer des champs**
Cette transformation combine tous les champs de tous les cadres en un seul résultat. Tenez compte de ces deux requêtes.
Requête A :
| Temp | 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 | Disponibilité | IQA | Erreurs |
| --- | --- | --- | --- |
| 15,4 | 1230233 | 3.2 | 5 |
**Config à partir des résultats de la requête**
Cette transformation vous permet de sélectionner une requête et d'en extraire des options standard telles que **Min**, **Max**, **Unit et **Thresholds**** et de les appliquer à d'autres résultats de requête. Cela permet une configuration de visualisation dynamique basée sur des requêtes.
Si vous souhaitez extraire une configuration unique pour chaque ligne du résultat de la requête de configuration, essayez de transformer les lignes en champs.
**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 séries auxquels appliquer la configuration.
+ **Appliquer aux options** : il s'agit généralement d'un type de champ ou d'un nom de champ regex, selon l'option que vous avez sélectionnée dans **Appliquer à**.
**Convertir le type de champ**
Cette transformation modifie le type de champ du champ spécifié.
+ **Champ** — Sélectionnez parmi les champs disponibles
+ **as** — Sélectionnez le FieldType à convertir en
+ **Numérique** : tente de convertir les valeurs en nombres
+ **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 a 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
Par exemple, la requête suivante peut ê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 | ci-dessus | 25 |
| 01/01/2018 | ci-dessous | 22 |
| 01/01/2019 | ci-dessous | 29 |
| 01/01/2020 | ci-dessus | 22 |
**Filtrer les données par nom**
Utilisez cette transformation pour supprimer des parties des résultats de la requête.
Grafana affiche le champ **Identifiant**, suivi des champs renvoyés par votre requête.
Vous pouvez appliquer des filtres de deux manières différentes :
+ Entrez une expression regex.
+ Choisissez un champ pour activer le filtrage sur ce champ. Les champs filtrés sont affichés en gris foncé, les champs non filtrés en blanc.
**Filtrer les données par requête**
Utilisez cette transformation dans les panneaux contenant plusieurs requêtes, si vous souhaitez masquer une ou plusieurs requêtes.
Grafana affiche les lettres d'identification de la requête en texte gris foncé. Cliquez sur 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 valeur**
Cette transformation vous permet de filtrer vos données directement dans Grafana et de supprimer certains points de données du résultat de votre requête. Vous avez la possibilité d'inclure ou d'exclure les données qui répondent à une ou plusieurs conditions que vous définissez. Les conditions sont appliquées à un champ sélectionné.
Cette transformation est utile si votre source de données ne filtre pas nativement par valeurs. Vous pouvez également l'utiliser pour affiner les valeurs à afficher si vous utilisez une requête partagée.
Les conditions disponibles pour tous les champs sont les suivantes :
+ **Regex** — Correspond à une expression regex
+ **Is Null** — Correspond si la valeur est nulle
+ **N'est pas nulle** — Correspond si la valeur n'est pas nulle
+ **Égal** — Correspond si la valeur est égale à la valeur spécifiée
+ **Différent** : correspond si la valeur est différente de la valeur spécifiée
Les conditions disponibles pour les champs numériques sont les suivantes :
+ **Plus grand** — Correspond si la valeur est supérieure à la valeur spécifiée
+ **Inférieur** — Correspond si la valeur est inférieure à la valeur spécifiée
+ **Supérieur ou égal** — Correspond si la valeur est supérieure ou égale
+ **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, les valeurs minimale et maximale incluses
Tenez compte de l'ensemble de données suivant :
| Heure | Température | Altitude |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 23 S | 32 | 101 |
| 07/07/2020 11 H 34 MIN 22 S | 28 | 125 |
| 07/07/2020 11 H 34 MIN 21 H | 26 | 110 |
| 07/07/2020 11 H 34 MIN 20 S | 23 | 98 |
| 07/07/2020 10 H 32 MIN 24 H | 31 | 95 |
| 07/07/2020 10 H 31 H 22 | 20 | 85 |
| 07/07/2020 9 H 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** — `Include`
+ **Condition** — Lignes où il y a des `Temperature` correspondances `Lower Than 30`
Et vous obtiendrez le résultat suivant, où seules les températures inférieures à 30 °C sont incluses :
| Heure | Température | Altitude |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 22 S | 28 | 125 |
| 07/07/2020 11 H 34 MIN 21 H | 26 | 110 |
| 07/07/2020 11 H 34 MIN 20 S | 23 | 98 |
| 07/07/2020 10 H 31 H 22 | 20 | 85 |
| 07/07/2020 9 H 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 : `Include` lignes qui `Match All` conditionnent
+ Condition 1 — Lignes dont les `Temperature` valeurs correspondent `Lower` à `30`
+ Condition 2 — Lignes dont les `Altitude` valeurs correspondent `Greater` à `100`
**Lorsque vous avez plusieurs conditions, vous pouvez choisir si vous souhaitez que l'action (inclure/exclure) 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 ET dont l'altitude est supérieure à 100. Si nous voulions plutôt inclure les lignes dont la température est inférieure à 30 OU dont l'altitude est supérieure à 100, 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.
**Regrouper par**
Cette transformation regroupe les données selon une valeur de champ (colonne) spécifiée et traite les calculs pour chaque groupe. Cliquez pour voir la liste des options 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.
**Inscrivez-vous par domaine**
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 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 | 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 | 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 | 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 | 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 |
**Étiquettes pour les champs**
Cette transformation transforme les résultats des séries chronologiques qui incluent des étiquettes ou des balises en un tableau où les clés et les valeurs de chaque étiquette sont incluses dans le résultat du tableau. Les étiquettes peuvent être affichées sous forme de colonnes ou de valeurs de ligne.
É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.
**Note**
La transformation de *fusion* peut être utilisée seule et est décrite en détail ci-dessous.
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 |
**Fusionner**
Utilisez cette transformation pour combiner le résultat de plusieurs requêtes en un seul résultat. Cela est utile lorsque vous utilisez la visualisation du panneau de tableau. Les valeurs pouvant être fusionnées sont combinées dans la même ligne. Les valeurs peuvent être fusionnées si les champs partagés contiennent les mêmes données.
Dans l'exemple ci-dessous, nous avons deux requêtes renvoyant des données de table. Il est visualisé sous forme de deux tableaux distincts avant d'appliquer la transformation.
Requête A :
| Heure | Tâche | 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 | 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 |
**Organiser les champs**
Utilisez cette transformation pour renommer, réorganiser ou masquer les champs renvoyés par la requête.
**Note**
Cette transformation ne fonctionne que dans les panneaux contenant une seule requête. Si votre panneau contient plusieurs requêtes, vous devez soit appliquer une transformation de jointure externe, soit supprimer les requêtes supplémentaires.
Grafana affiche une liste des champs renvoyés par la requête. Vous pouvez effectuer les actions suivantes :
+ Modifiez l'ordre des champs en plaçant votre curseur sur un champ. Le curseur prend la forme d'une main, puis vous pouvez faire glisser le champ vers son nouvel emplacement.
+ Masquez ou affichez un champ en cliquant sur l'icône en forme d'œil à côté du nom du champ.
+ Renommez les champs en saisissant un nouveau nom dans la zone Renommer.
**Partition par valeurs**
Cette transformation permet d'éliminer le besoin d'effectuer plusieurs requêtes vers la même source de données avec des `WHERE` clauses différentes lors de la représentation graphique de plusieurs séries. Prenons l'exemple d'une table SQL de métriques contenant les données suivantes :
| 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 |
Avant la version 9.3, si vous vouliez tracer une courbe de tendance rouge pour les États-Unis et une courbe bleue pour l'UE dans le même TimeSeries panneau, vous deviez probablement la diviser en deux requêtes :
```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```
Cela nécessite également que vous sachiez à l'avance quelles régions figurent réellement dans le tableau des métriques.
Avec le transformateur *Partition par valeurs*, vous pouvez désormais émettre une seule requête et diviser les résultats par valeurs uniques dans une ou plusieurs colonnes (`fields`) 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 |
**Réduire**
*La transformation Reduce applique un calcul à chaque champ du cadre et renvoie une valeur unique.* Les champs temporels sont supprimés lors de l'application de cette transformation.
Tenez compte de l'entrée :
Requête A :
| Heure | Temp | Disponibilité |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | 12.3 | 256122 |
| 07/07/2020 11 H 24 H 20 | 15,4 | 1230233 |
Requête B :
| Heure | IQA | Erreurs |
| --- | --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | 6,5 | 15 |
| 07/07/2020 11 H 24 H 20 | 3.2 | 5 |
Le transformateur de réduction dispose 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 |
| 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 | 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.
**Des lignes vers des champs**
La transformation des lignes en champs convertit 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 qui répertorie 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 \$1Utiliser as\$1\$1). 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 :
| Name | DataCenter | Value |
| --- | --- | --- |
| Serveur A | ETATS-UNIS | 100 |
| Serveur B | UE | 200 |
Sortie :
| ServerA (étiquettes DataCenter : États-Unis) | ServerB (étiquettes DataCenter : EU) |
| --- | --- |
| 10 | 20 |
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 :
| Name | Value | Max |
| --- | --- | --- |
| Serveur A | 10 | 100 |
| Serveur B | 20 | 200 |
| Serveur C | 30 | 300 |
Sortie :
| Serveur A (configuration : max = 100) | ServeurB (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.
**Préparer des séries chronologiques**
Préparer la transformation des séries chronologiques est utile lorsqu'une source de données renvoie des données de séries chronologiques dans un format qui n'est pas pris en charge par le panneau que vous souhaitez utiliser.
Cette transformation vous aide à résoudre ce problème en convertissant les données de séries chronologiques du format large au format long ou inversement.
Sélectionnez l'option **Série chronologique multitrame** pour transformer la trame de données chronologique du format large au format long.
Sélectionnez l'option **Série chronologique étendue** pour transformer le bloc de données de série chronologique du format long au format large.
**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 |
| --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | 25 |
| 07/07/2020 10 H 31 H 22 | 22 |
| 07/07/2020 9 H 30 : 05 | 19 |
Requête B :
| Heure | Humidité |
| --- | --- |
| 07/07/2020 11 H 34 MIN 20 S | 24 |
| 07/07/2020 10 H 32 MIN 20 S | 29 |
| 07/07/2020 9 H 30 : 57 | 33 |
Voici le résultat après avoir appliqué la transformation Série aux lignes.
| 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 |
**Trier par**
Cette transformation triera chaque image en fonction du champ configuré. Lorsque cette case `reverse` est cochée, les valeurs seront renvoyées dans l'ordre inverse.
**Limite**
Utilisez cette transformation pour limiter le nombre de lignes affichées.
Dans l'exemple ci-dessous, nous avons la réponse suivante provenant de la 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 |
# Résoudre les problèmes liés aux requêtes
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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](v9-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.
# Configuration des seuils
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 section contient des informations sur l'utilisation de seuils dans vos visualisations. Vous découvrirez les seuils et leurs valeurs par défaut, comment ajouter ou supprimer un seuil, et comment ajouter un seuil à un ancien panneau.
## À propos des seuils
Un seuil est une valeur que vous spécifiez pour une métrique qui est reflétée visuellement dans un tableau de bord lorsque la valeur du seuil est atteinte ou dépassée.
Les seuils constituent une méthode qui vous permet de styliser et de colorer vos visualisations de manière conditionnelle en fonction des résultats des requêtes. Vous pouvez appliquer des seuils à la plupart des visualisations, mais pas à toutes. Pour plus d'informations sur les visualisations, reportez-vous à la section [Panneaux de visualisation](v9-panels.md).
Vous pouvez utiliser des seuils pour :
+ Lignes de quadrillage de couleur ou zones de quadrillage dans la visualisation des [séries chronologiques](v9-panels-time-series.md)
+ Lignes de couleur dans la visualisation des [séries chronologiques](v9-panels-time-series.md)
+ Colorez l'arrière-plan ou le texte de la valeur dans la [visualisation des statistiques](v9-panels-stat.md)
+ Colorez les marqueurs de jauge et de seuil dans la [visualisation de la jauge](v9-panels-gauge.md)
+ Marqueurs de couleur dans la visualisation [Geomap](v9-panels-geomap.md)
+ Couleur du texte ou de l'arrière-plan des cellules dans la [visualisation du tableau](v9-panels-table.md)
+ Définissez les régions et les couleurs des régions dans la [visualisation de la chronologie de l'État](v9-panels-state-timeline.md)
Il existe deux types de seuils :
+ Les seuils **absolus** sont définis par un nombre. Par exemple, 80 sur une échelle de 1 à 150.
+ Les seuils de **pourcentage** sont définis par rapport au minimum ou au maximum. Par exemple, 80 %.
### Seuils par défaut
Sur les visualisations qui le prennent en charge, Grafana définit des valeurs de seuil par défaut de :
+ 80 = rouge
+ Base = vert
+ Mode = Absolu
La valeur **de base** représente moins l'infini. C'est généralement la « bonne » couleur.
## Ajouter ou supprimer un seuil
Vous pouvez ajouter autant de seuils que vous le souhaitez à un panneau. Grafana trie automatiquement les valeurs des seuils du plus élevé au plus bas.
Supprimez un seuil lorsqu'il n'est plus pertinent pour vos activités commerciales. Lorsque vous supprimez un seuil, le système le supprime de toutes les visualisations qui incluent le seuil.
1. Pour ajouter un seuil :
1. Modifiez le panneau auquel vous souhaitez ajouter un seuil.
1. Dans le volet latéral des options, recherchez la section **Seuils** et cliquez sur **\$1 Ajouter un seuil**.
1. Sélectionnez une couleur, un nombre et un mode de seuil. Le mode Seuil s'applique à tous les seuils de ce panneau.
1. Pour un panneau de séries chronologiques, sélectionnez l'option **Afficher les seuils**.
1. Pour supprimer un seuil, accédez au panneau qui contient le seuil et cliquez sur l'icône de corbeille à côté du seuil que vous souhaitez supprimer.
## Ajouter un seuil à un ancien panneau graphique
Dans la visualisation du panneau Graphe, les seuils vous permettent d'ajouter des lignes ou des sections à un graphique afin de reconnaître plus facilement le moment où le graphique franchit un seuil.
1. Accédez au panneau graphique auquel vous souhaitez ajouter un seuil.
1. Dans l'onglet **Panneau**, cliquez sur **Seuils**.
1. Cliquez sur **Ajouter un seuil**.
1. Renseignez les champs suivants :
+ **T1 -** Les deux valeurs sont requises pour afficher un seuil.
+ **lt** ou **gt** - Sélectionnez **lt** pour inférieur à ou **gt** pour supérieur à pour indiquer à quoi s'applique le seuil.
+ **Valeur -** Entrez une valeur de seuil. Grafana trace une ligne de seuil le long de l'axe Y à cette valeur.
+ **Couleur :** choisissez une condition correspondant à une couleur ou définissez votre propre couleur.
+ **personnalisé -** Vous définissez la couleur de remplissage et la couleur de la ligne.
+ **critique -** Les couleurs de remplissage et de ligne sont rouges.
+ **avertissement -** La couleur du fond et de la ligne est jaune.
+ **ok -** La couleur du fond et de la ligne est verte.
+ **Remplissage :** contrôle si le seuil de remplissage est affiché.
+ **Ligne :** contrôle si la ligne de seuil est affichée.
+ **Axe Y :** choisissez **gauche** ou **droite.**
1. Cliquez sur **Enregistrer** pour enregistrer les modifications dans le tableau de bord.
# Configuration des liaisons de données
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.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 utiliser des variables de liaison de données ou des liaisons de données pour créer des liens entre les panneaux.
## Variables de liaison de données
Vous pouvez utiliser des variables dans les liaisons de données pour faire référence à des champs de série, à des étiquettes et à des valeurs. Pour plus d'informations sur les liaisons de données, consultez[Liaisons de données](#v9-panels-data-links).
Pour voir la liste des variables disponibles, tapez **\$1** dans le champ **URL** du lien de données pour afficher la liste des variables que vous pouvez utiliser.
**Note**
Ces variables ont changé dans la version 6.4. Par conséquent, si vous avez une ancienne version de Grafana, utilisez le sélecteur de version pour sélectionner les documents relatifs à une ancienne version de Grafana.
Vous pouvez également utiliser des variables de modèle dans vos liens de données URLs, voir[Ajouter et gérer des variables de tableau de bord](v9-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.
+ **\$1\$1url\$1time\$1range - plage** **horaire du tableau de bord actuel (par exemple ? (de=maintenant-6h&to=maintenant)**
+ **\$1\$1\$1from et \$1\$1\$1to - Pour** plus d'informations, consultez. [Variables globales](v9-dash-variable-add.md#v9-dash-variable-add-global)
## Variables de série
Les variables spécifiques aux séries sont disponibles sous l'espace de noms **\$1\$1series** :
+ **\$1\$1series.name - nom de** série associé à l'URL
## Variables de champ
Les variables spécifiques aux champs sont disponibles sous l'espace de noms **\$1\$1field** :
+ **\$1\$1field.name** - le nom du champ
+ **\$1\$1field.labels. **