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.
Configuration de corrélation
Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana
Chaque corrélation est configurée avec les options suivantes :
- Étiquette
-
Libellé du lien, affiché dans la visualisation.
- Description
-
Description facultative.
- Source de données source
-
Source des résultats dont les liens sont affichés.
- Champ de résultats
-
Définit l'endroit où le lien est affiché dans une visualisation.
- Requête cible
-
La requête cible est exécutée lorsqu'un lien est cliqué.
- Transformations
-
Manipulations facultatives des données source incluses transmises à la requête cible.
Pour plus de détails sur la création d'une corrélation, voir Création d'une corrélation.
Source de données source et champ de résultat
Les liens apparaissent dans les visualisations Explore pour les résultats issus de la source de données source de la corrélation. Un lien est attribué à l'un des champs à partir du résultat fourni dans la configuration de corrélation (le champ des résultats). Chaque visualisation affiche les champs avec des liens d'une manière différente.
Requête cible
La requête cible est exécutée lorsqu'un lien est cliqué dans la visualisation. Vous pouvez utiliser l'éditeur de requêtes de la source de données cible sélectionnée pour spécifier la requête cible. Les résultats des données source sont accessibles dans la requête cible à l'aide de variables.
Variables de corrélation
Vous pouvez utiliser des variables dans la requête cible pour accéder aux données source associées à la requête. Les corrélations utilisent la syntaxe des variables Grafana. Les variables sont remplies avec les valeurs issues des résultats source lorsque le lien est sélectionné. Il existe deux types de variables que vous pouvez utiliser :
-
Variables de champ (pour accéder aux valeurs et aux étiquettes des champs).
-
Variables de corrélation (pour accéder aux valeurs des champs et aux transformations).
Exemple : Si les résultats de la source contiennent un champ appeléemployee, la valeur du champ est accessible avec :
-
Une variable de champ
${__data.fields.employee}. -
Variable de corrélation qui fait correspondre la valeur du champ ci-dessus à
${employee}.
Outre le mappage des valeurs de champ avec des noms de variables plus courts, il est possible de créer davantage de variables de corrélation en appliquant des transformations aux champs existants.
La corrélation crée un lien de données uniquement si toutes les variables ont des valeurs dans la ligne de données sélectionnée. Les variables globales font exception à cette règle et il n'est pas nécessaire de les renseigner à partir des données renvoyées. Ces variables sont interpolées automatiquement par les sources de données.
Transformations de corrélation
Les transformations permettent d'extraire davantage de variables des valeurs de champ. Le résultat des transformations est un ensemble de nouvelles variables accessibles comme n'importe quelle autre variable.
Il existe deux types de transformations : logfmt et expression régulière.
Chaque transformation utilise une valeur de champ sélectionnée comme entrée. Le résultat d'une transformation est un ensemble de nouvelles variables basées sur le type et les options de la transformation.
Transformation de Logfmt
La transformation logfmt déconstruit une valeur de champ contenant du texte formaté avec des paires clé/valeur logfmt.
La transformation logfmt nécessite uniquement de spécifier le nom du champ de saisie si vous souhaitez que la transformation s'applique à un champ différent du champ de résultats. Exemples de variables de sortie pour field = "host=srv001 endpoint=/test
app=foo" :
| name | value |
|---|---|
| hôte | srv001 |
| point de terminaison | /tester |
| app | foo |
Transformation d'expressions régulières
La transformation de l'expression régulière déconstruit une valeur de champ en fonction de l'expression régulière fournie.
Options de transformation des expressions régulières :
- champ
Nom du champ de saisie
- expression
-
Expression régulière. Les groupes de capture nommés sont mappés aux variables correspondant au nom du groupe. Si des groupes correspondants non nommés sont utilisés, une variable est créée à partir de la première correspondance. La valeur remplace la variable correspondant au champ de saisie ou une nouvelle variable est créée si MapValue est fourni (voir les exemples dans le tableau suivant).
- Valeur de la carte
-
Utilisé avec des groupes regex simples sans groupes correspondants nommés. Par défaut, la première correspondance remplace la variable par le nom du champ utilisé comme entrée. Pour modifier ce comportement par défaut, vous pouvez spécifier la propriété MapValue. Le nom fourni est utilisé pour créer une nouvelle variable. Cela peut être utile si votre requête cible nécessite à la fois la valeur exacte et une partie de la valeur extraite avec la transformation.
Exemple : en supposant que le nom du champ sélectionné est employee et que la valeur du champ estJohn Doe.
Diverses variables de sortie basées sur les options d'expression et de MapValue :
| expression | Valeur de la carte | variables de sortie | comment |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
Aucune valeur MapValue n'a été fournie. La première correspondance est mappée à la variable de nom de champ existante (employee). |
/(\w+) (\w+)/ |
name | name=John |
La première correspondance est mappée à une nouvelle variable appeléename. |
/(?\w+) (?\w+)/ |
- | firstName=John, lastName=Doe |
Lorsque des groupes nommés sont utilisés, ils sont les noms des variables de sortie et MapValue est ignoré. |
/(?\w+) (?\w+)/ |
name | firstName=John, lastName=Doe |
Identique à ci-dessus |
