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.
Options de champ et remplacements
Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. Travailler dans la version 10 de Grafana
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana
Cette section explique quelles sont les options de champ et les remplacements de champs dans Amazon Managed Grafana et comment les utiliser.
Le modèle de données utilisé dans les espaces de travail Grafana, le bloc de données, 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 Amazon Managed Grafana affiche les données.
Options de champ
Les options de champ, standard et personnalisées, se trouvent dans l'onglet Champ de l'éditeur de panneaux. Les modifications apportées dans cet onglet s'appliquent à tous les champs (c'est-à-dire aux séries et aux colonnes). Par exemple, si vous remplacez l'unité par un pourcentage, tous les champs contenant des valeurs numériques sont affichés en pourcentages. Découvrez comment appliquer une option de champ dansConfigurer tous les champs.
Dérogations de champs
Les remplacements de champs peuvent être ajoutés dans l'onglet Remplacements de l'éditeur de panneaux. Vous pouvez y ajouter les mêmes options que celles que vous trouvez dans l'onglet Champ, mais elles ne s'appliquent qu'à des champs spécifiques. Découvrez comment appliquer une dérogation dans. Configurer des champs spécifiques
Options de champs disponibles et remplacements
Les types d'options de champ sont communs aux options de champ et aux remplacements de champs. La seule différence est de savoir si la modification s'appliquera à tous les champs (appliquée dans l'onglet Champ) ou à un sous-ensemble de champs (appliquée dans l'onglet Remplacements).
-
Options de champ standards'appliquent à toutes les visualisations de panneaux qui autorisent les transformations.
-
Options des champs du tableaus'appliquent uniquement aux visualisations de panneaux de table.
Configurer tous les champs
Pour modifier la façon dont tous les champs affichent les données, vous pouvez modifier une option dans l'onglet Champ. Dans l'onglet Remplacements, vous pouvez ensuite remplacer les options de champ pour des champs spécifiques. Pour plus d’informations, consultez Configurer des champs spécifiques.
Par exemple, vous pouvez modifier le nombre de décimales affichées dans tous les champs en modifiant l'option Décimales. Pour plus d'informations sur les options, reportez-vous Options de champ standard aux sections etOptions des champs du tableau.
Modifier une option de champ
Vous pouvez modifier autant d'options que vous le souhaitez.
Pour modifier une option de champ
-
Choisissez le panneau que vous souhaitez modifier, choisissez le titre du panneau, puis choisissez Modifier.
-
Choisissez l'onglet Champ.
-
Trouvez l'option que vous souhaitez modifier. Vous pouvez définir les éléments suivants :
-
Options de champ standard, qui s'appliquent à toutes les visualisations de panneaux autorisant les transformations.
-
Options des champs du tableau, qui s'appliquent uniquement aux visualisations de panneaux de tableau.
-
-
Ajoutez des options en ajoutant des valeurs dans les champs. Pour rétablir les valeurs par défaut des options, supprimez le texte blanc dans les champs.
-
Lorsque vous avez terminé de modifier le tableau de bord, choisissez Enregistrer.
Exemple d'option de champ
Supposons que le jeu de résultats soit un bloc de données composé de deux champs : heure et température.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45.0 |
| 2020-01-02 03:05:00 | 47,0 |
| 2020-01-02 03:06:00 | 48,0 |
Des options de champ peuvent être appliquées à chaque champ (colonne) de cette structure de manière à modifier la façon dont ses valeurs sont affichées. Par exemple, vous pouvez régler l'unité sur Température > Celsius, ce qui donne le tableau suivant.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45,0 °C |
| 2020-01-02 03:05:00 | 47,0 °C |
| 2020-01-02 03:06:00 | 48,0 °C |
La virgule ne signifie rien dans ce cas. Vous pouvez remplacer les décimales par auto zéro (0), ce qui donne le tableau suivant.
| time | temperature |
|---|---|
| 2020-01-02 03:04:00 | 45 °C |
| 2020-01-02 03:05:00 | 47 °C |
| 2020-01-02 03:06:00 | 48 °C |
Configurer des champs spécifiques
Vous pouvez utiliser des remplacements pour modifier les paramètres d'un ou de plusieurs champs. Les options de champ pour les remplacements sont exactement les mêmes que celles disponibles dans une visualisation donnée. La seule différence est que vous choisissez les champs auxquels les appliquer.
Par exemple, vous pouvez modifier le nombre de décimales affichées dans tous les champs ou colonnes numériques en modifiant l'option Décimales pour les champs dont le type correspond à Numérique. Pour plus d'informations sur les optionsOptions de champ standard, consultez les sections qui s'appliquent à toutes les visualisations de panneaux autorisant les transformations et Options des champs du tableau celles qui s'appliquent uniquement aux visualisations de panneaux de tableau.
Ajouter un remplacement de champ
Vous pouvez remplacer autant d'options de champ que vous le souhaitez.
Pour ajouter un remplacement de champ
-
Choisissez le panneau que vous souhaitez modifier, choisissez le titre du panneau, puis choisissez Modifier.
-
Choisissez l'onglet Overrides.
-
Choisissez Ajouter une dérogation pour.
-
Sélectionnez les champs auxquels vous souhaitez appliquer une règle de dérogation.
-
Champs avec nom : utilisez cette option pour sélectionner un champ dans la liste de tous les champs disponibles. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur ne sont appliquées qu'à ce champ unique.
-
Champs dont le nom correspond à une expression régulière — Utilisez-le pour spécifier les champs à remplacer par une expression régulière. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs dont les noms correspondent à l'expression régulière.
-
Champs avec type : utilisez cette option pour sélectionner des champs par type, tels que chaîne, numérique, etc. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs correspondant au type sélectionné.
-
-
Choisissez Ajouter une propriété de remplacement.
-
Sélectionnez l'option de champ que vous souhaitez appliquer.
-
Entrez les options en ajoutant des valeurs dans les champs. Pour rétablir les valeurs par défaut des options, supprimez le texte blanc dans les champs.
-
Continuez à ajouter des remplacements à ce champ en choisissant Ajouter une propriété de remplacement, ou vous pouvez choisir Ajouter un remplacement et sélectionner un autre champ auquel ajouter des remplacements.
-
Lorsque vous avez terminé, choisissez Save (Sauvegarder).
Supprimer une dérogation à un champ
-
Choisissez l'onglet Remises qui contient la dérogation que vous souhaitez supprimer.
-
Cliquez sur l'icône de la corbeille à côté de la dérogation.
Exemple de remplacement de champ
Supposons que notre ensemble de résultats soit une trame de données composée de quatre champs : temps, haute température, basse température et humidité.
| time | haute température | basse température | humidité |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45.0 | 30.0 | 67 |
| 2020-01-02 03:05:00 | 47,0 | 34,0 | 68 |
| 2020-01-02 03:06:00 | 48,0 | 31,0 | 68 |
Appliquons les options du champ Exemple d'option de champ pour appliquer l'unité Celsius et éliminer la décimale. Cela donne le tableau suivant.
| time | haute température | basse température | humidité |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67 °C |
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68 °C |
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68 °C |
Les champs de température semblent bons, mais l'humidité n'a aucun sens. Vous pouvez résoudre ce problème en appliquant une dérogation aux options de champ au champ d'humidité et en modifiant l'unité sur Divers > pourcentage (0-100). Il en résulte un tableau beaucoup plus logique.
| time | haute température | basse température | humidité |
|---|---|---|---|
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67 % |
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68 % |
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68 % |
Options de champ standard
Cette section explique les options de champ disponibles. Ils sont classés par ordre alphabétique.
Vous pouvez appliquer des options de champ standard à la plupart des panneaux d'espace de travail 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'affecteront pas la visualisation tant que vous n'aurez pas sélectionné d'options de champ 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.
Pour plus d'informations sur l'application de ces options, consultez les sections suivantes :
Décimales
Cette option définit le nombre de décimales à inclure lors du rendu d'une valeur. Laissez ce champ vide pour qu'Amazon Managed Grafana utilise le nombre de décimales fourni par la source de données.
Pour modifier ce paramètre, entrez un chiffre dans le champ.
Liaisons de données
Cette option contrôle l'URL vers laquelle une valeur ou une visualisation est liée. Pour en savoir plus et des instructions, consultez Liaisons de données.
Nom d'affichage
Cette option définit le titre d'affichage de tous les champs. Vous pouvez utiliser des variables dans le titre du champ. Pour plus d'informations sur les modèles et les variables de modèles, consultezModèles et variables.
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 n'${__field.name}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 {"loc"="Pbi », « Sensor"="3"}
| Syntaxe des expressions | Exemple | Effectue des rendus vers | Explication |
|---|---|---|---|
${__field.displayName}
|
Identique à la syntaxe |
Temp {Loc="PBI",
Sensor="3"}
|
Affiche le nom du champ et les libellés {} s'ils sont présents. Si la réponse ne contient qu'une seule clé d'étiquette, Amazon Managed Grafana affiche la valeur de l'étiquette sans les accolades. |
${__field.name}
|
Identique à la syntaxe |
Temp
|
Affiche le nom du champ (sans étiquette). |
${__field.labels}
|
Identique à la syntaxe |
Loc="PBI", Sensor="3"
|
Affiche les étiquettes sans leur nom. |
${__field.labels.X}
|
${__field.labels.Loc}
|
PBI
|
Affiche la valeur de la clé d'étiquette spécifiée. |
${__field.labels.__values}
|
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.
Max
Cette option définit la valeur maximale utilisée dans le calcul du seuil de pourcentage. Pour un calcul automatique basé sur toutes les séries et tous les champs, laissez ce paramètre vide.
Min
Cette option définit la valeur minimale utilisée dans le calcul du seuil de pourcentage. Pour un calcul automatique basé sur toutes les séries et tous les champs, laissez ce paramètre vide.
Aucune valeur
Entrez ce que Amazon Managed Grafana doit afficher si la valeur du champ est vide ou nulle.
Unité
Cette option indique 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/heure.
Pour sélectionner une unité personnalisée, saisissez-la et sélectionnez la dernière Custom: xxx option dans la liste déroulante.
-
suffix:<suffix>pour une unité personnalisée qui doit suivre la valeur. -
time:<format>pour les formats de date/heure personnalisés ; par exemple,.time:YYYY-MM-DDPour la syntaxe et les options du format, voir Affichage. -
si:<base scale><unit characters>pour les unités SI personnalisées ; par exemple,si: mF. Cette option est un peu plus avancée car vous pouvez spécifier à la fois une unité et l'échelle des données source. Par exemple, si vos données source sont représentées sous forme de milli (milliers d'unités), préfixez l'unité avec ce caractère d'échelle SI. -
count:<unit>pour une unité de comptage personnalisée. -
currency:<unit>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
Amazon Managed Grafana peut parfois analyser des chaînes et les afficher sous forme de nombres. Pour qu'Amazon Managed Grafana affiche la chaîne d'origine, créez un champ de remplacement et ajoutez une propriété d'unité à l'unité. string
Schéma de couleurs
L'option de couleur des champs définit la façon dont Amazon Managed Grafana colore les séries ou les champs. Il existe ici plusieurs modes qui fonctionnent différemment, et leur utilité dépend largement de la visualisation actuellement sélectionnée.
Les modes couleur continus utilisent le pourcentage d'une valeur par rapport aux valeurs min et max pour interpoler une couleur.
-
Couleur unique : ensemble de couleurs spécifique à l'aide du sélecteur de couleurs. Cela est particulièrement utile lorsqu'il s'agit d'une règle de dérogation.
-
À partir des seuils : couleur dérivée du seuil correspondant. Cela est utile pour les visualisations de jauges, de statistiques et de tables.
Couleur par série
Amazon Managed Grafana inclut des combinaisons de couleurs qui définissent les couleurs par série. Cela est utile pour les graphiques et les diagrammes à secteurs, par exemple.
Couleur par valeur
Amazon Managed Grafana inclut également des combinaisons de couleurs continues (dégradées). Cela est utile pour les visualisations qui colorent des valeurs individuelles, par exemple les panneaux de statistiques et le panneau de tableau.
Seuils
Vous pouvez utiliser des seuils pour modifier la couleur d'un champ en fonction de la valeur. Pour en savoir plus et des instructions, consultez Seuils.
Cartographie des valeurs
Vous pouvez utiliser cette option pour définir des règles qui traduisent une valeur de champ ou une plage de valeurs en texte explicite. Vous pouvez ajouter plusieurs mappages de valeurs.
-
Type de mappage : choisissez une option.
-
Valeur — Entrez une valeur. Si la valeur du champ est supérieure ou égale à la valeur, le texte s'affiche.
-
De et vers : entrez une plage. Si la valeur du champ est comprise ou égale aux valeurs de la plage, le texte s'affiche.
-
-
Texte : texte affiché si les conditions sont remplies dans un champ. Ce champ accepte les variables.
