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. # Corrélations dans Grafana version 10 **** **Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.** Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md) Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md) Vous pouvez créer des liens interactifs pour les visualisations Explore afin d'exécuter des requêtes relatives aux données présentées en configurant des corrélations. Une corrélation définit la manière dont les données d'une source de données sont utilisées pour interroger les données d'une autre source de données. Voici quelques exemples : + Le nom d'une application renvoyé dans une source de données de journaux peut être utilisé pour interroger les métriques associées à cette application dans une source de données de métriques. + Un nom d'utilisateur renvoyé par une source de données SQL peut être utilisé pour interroger les journaux relatifs à cet utilisateur en particulier dans une source de données de journaux. Explore utilise des corrélations définies par l'utilisateur pour afficher des liens dans les visualisations. Vous pouvez cliquer sur un lien pour exécuter la requête correspondante et voir les résultats dans Explore Split View. Explorez les visualisations qui prennent actuellement en charge l'affichage de liens en fonction de corrélations : + [Journaux](v10-panels-logs.md) + [Table](v10-panels-table.md) [Vous pouvez configurer les corrélations à l'aide de la page **Administration > Plug-ins et données > Corrélations** dans Grafana ou directement dans Explore.](v10-explore-correlations.md) **Topics** + [Configuration de corrélation](v10-correlations-config.md) + [Création d'une nouvelle corrélation](v10-correlations-create.md) # Configuration de corrélation **** **Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.** Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md) Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md) 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](v10-correlations-create.md). ## 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](v10-dash-variable-syntax.md). Les variables sont remplies avec les valeurs issues des résultats source lorsque le lien est sélectionné. Vous pouvez utiliser deux types de variables : + [Variables de champ](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (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](v10-dash-variable-add.md#v10-dash-variable-add-global) 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.](https://brandur.org/logfmt) Chaque paire devient une variable, la clé étant le nom de la variable. 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 est`John Doe`. Diverses variables de sortie basées sur les options d'expression et de MapValue : | expression | Valeur de la carte | variables de sortie | comment | | --- | --- | --- | --- | | /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Aucune valeur MapValue n'a été fournie. La première correspondance est mappée à la variable de nom de champ existante (employee). | | /(\$1w\$1) (\$1w\$1)/ | name | name=John | La première correspondance est mappée à une nouvelle variable appeléename. | | /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Lorsque des groupes nommés sont utilisés, ils sont les noms des variables de sortie et MapValue est ignoré. | | /(?\$1w\$1) (?\$1w\$1)/ | name | firstName=John, lastName=Doe | Comme ci-dessus | # Création d'une nouvelle 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](using-grafana-v9.md) Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md) Vous pouvez créer des corrélations dans l'éditeur de corrélations Explore ou en utilisant la page d'**administration** de Grafana dans votre espace de travail Amazon Managed Grafana. **Conditions préalables** Vous devez être autorisé à ajouter de nouvelles corrélations. Seuls les utilisateurs autorisés à écrire sur les sources de données peuvent définir de nouvelles corrélations. ## Création d'une corrélation dans l'éditeur de corrélations d'Explore Vous pouvez créer une corrélation dans l'éditeur de corrélation Explore. Pour en savoir plus, consultez [Création d'une corrélation](v10-explore-correlations.md#v10-explore-corr-create-a-correlation). ## Création d'une corrélation dans la page Administration Vous pouvez utiliser la page d'**administration** de la console Grafana pour créer une corrélation. **Pour créer une corrélation dans la page Administration** 1. Accédez à la section **Administration** de Grafana. 1. Sous **Plugins et données**, ouvrez la page **Corrélations**. 1. Cliquez sur le bouton **Ajouter** dans le coin supérieur droit. 1. Fournissez une **étiquette** pour la corrélation. 1. (Facultatif) Fournissez une **description**. 1. Passez à la page suivante. 1. Fournissez une **source de données cible**. 1. Fournissez une **requête cible** à l'aide de variables. 1. Passez à la page suivante. 1. Fournissez **la source de données source**. 1. Fournissez un **champ de résultats**. 1. Ajoutez des transformations si vous avez besoin de variables autres que des champs dans la source de données source. 1. Choisissez **Ajouter** pour ajouter une nouvelle transformation. 1. Sélectionnez le type de transformation. 1. Configurez la transformation en fonction du type sélectionné. 1. Enregistrez la corrélation. Vous pouvez modifier une corrélation de la même manière, mais lors de la modification, vous ne pouvez pas modifier les sources de données sélectionnées.