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.
# Éditeur de corrélations dans Explore
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)
Les corrélations permettent aux utilisateurs d'établir un lien entre deux sources de données. Pour plus d'informations, y compris un aperçu des corrélations, voir[Corrélations dans Grafana version 10](v10-correlations.md).
## Création d'une corrélation
Vous pouvez créer des corrélations à partir de la page Explorer.
**Pour créer une corrélation**
1. Dans votre espace de travail Amazon Managed Grafana, accédez à la page Explore.
1. Sélectionnez la source de données que vous souhaitez utiliser comme source pour une nouvelle corrélation.
1. Exécutez une requête produisant des données dans une visualisation prise en charge.
**Note**
Les visualisations prises en charge sont [Logs](v10-panels-logs.md) et [Table.](v10-panels-table.md)
1. Choisissez **\$1 Ajouter** dans la barre d'outils supérieure, puis sélectionnez **Ajouter une corrélation** (vous pouvez également sélectionner l'**éditeur de corrélations** dans la [palette de commandes](v10-search.md#v10-search-palette)).
Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue et une barre supérieure. Vous pouvez quitter l'éditeur de corrélations en choisissant **Exit** dans la barre supérieure.
1. Vous pouvez désormais créer les nouvelles corrélations suivantes pour la visualisation à l'aide de liens attachés aux données que vous pouvez utiliser pour créer une nouvelle requête :
+ *Journaux* : les liens sont affichés à côté des valeurs des champs dans les détails du journal pour chaque ligne du journal.
+ *Tableau* : chaque cellule du tableau est un lien.
1. Choisissez un lien pour ajouter une nouvelle corrélation. Les liens sont associés à un champ utilisé comme champ de résultat d'une corrélation. Pour en savoir plus, consultez [Configuration de corrélation](v10-correlations-config.md).
1. Dans la vue divisée qui s'ouvre, utilisez le volet droit pour configurer la source de requête cible de la corrélation. Pour en savoir plus, consultez [Requête cible](v10-correlations-config.md#v10-correlations-config-target-query).
1. Créez une requête cible à l'aide de [la syntaxe](v10-dash-variable-syntax.md) des variables avec les variables de la liste fournie en haut du volet. La liste contient des exemples de valeurs provenant de la ligne de données sélectionnée.
1. Fournissez une étiquette et une description (facultatif). Une étiquette sera utilisée comme nom du lien dans la visualisation et peut contenir des variables.
1. Fournissez des transformations (facultatif ; voir ci-dessous pour plus de détails).
1. Choisissez **Enregistrer** dans la barre d'outils supérieure pour enregistrer la corrélation et quitter le mode Éditeur de corrélations. Le lien utilisé pour créer la corrélation est remplacé par un lien de données dans chaque ligne. Lorsque le lien est sélectionné, la requête que vous avez définie s'exécute dans un autre volet, les variables étant remplacées dynamiquement par les valeurs de la ligne sélectionnée.
## Transformations
Les transformations vous permettent d'extraire des valeurs qui existent dans un champ avec d'autres données. Par exemple, à l'aide d'une transformation, vous pouvez extraire une partie d'une ligne de log à utiliser dans une corrélation. Pour plus de détails sur les transformations des corrélations, voir[Transformations de corrélation](v10-correlations-config.md#v10-correlations-config-transformations).
Après avoir sélectionné l'un des liens générés en mode éditeur, vous pouvez ajouter des transformations en sélectionnant **Ajouter une transformation** dans le menu déroulant **Transformations**.
**Pour utiliser une transformation dans une corrélation**
1. Sélectionnez un champ auquel appliquer la transformation. Sélectionnez la partie du champ que vous souhaitez utiliser pour la transformation. Par exemple, une ligne de journal. Une fois sélectionnée, la valeur de ce champ sera utilisée pour vous aider à créer la transformation.
1. Sélectionnez le type de transformation. Consultez [Transformations de corrélation](v10-correlations-config.md#v10-correlations-config-transformations) les options et les paramètres appropriés.
1. En fonction de votre sélection, il se peut qu'une ou plusieurs variables soient renseignées ou que vous deviez fournir des spécifications supplémentaires dans les options affichées.
1. Sélectionnez **Ajouter une transformation à la corrélation** pour ajouter les variables spécifiées à la liste des variables disponibles.
**Note**
Pour les expressions régulières de cette boîte de dialogue, les expressions `mapValue` mentionnées dans d'autres documents sont appelées `Variable Name` ici. Grafana met en surbrillance tout texte correspondant à l'expression contenue dans la valeur du champ. Utilisez des groupes de capture d'expressions régulières pour sélectionner la partie de la correspondance à extraire. Lorsqu'une expression régulière valide est fournie, la variable et sa valeur apparaissent sous le `Variable Name` champ.
## Exemples de corrélations
Les exemples suivants montrent comment créer des corrélations à l'aide de l'éditeur de corrélations dans Explore. Si vous souhaitez suivre ces exemples, veillez à configurer une [source de données de test](testdata-data-source.md).
### Création d'une corrélation entre le texte et le graphique
Cet exemple montre comment créer une corrélation à l'aide de l'éditeur de corrélations dans Explore.
Les corrélations vous permettent d'utiliser les résultats d'une requête pour exécuter une nouvelle requête dans n'importe quelle source de données. Dans cet exemple, vous allez exécuter une requête qui affiche des données tabulaires. Les données seront utilisées pour exécuter une requête différente qui produira un résultat graphique.
Pour suivre cet exemple, assurez-vous d'avoir configuré une [source de données de test](testdata-data-source.md).
**Pour créer une corrélation entre le texte et le graphique**
1. **Dans Grafana, accédez à Explore.**
1. Sélectionnez la **source de données de test** dans le menu déroulant en haut à gauche de la page.
1. Choisissez **\$1 Ajouter** dans le menu déroulant à droite, puis sélectionnez **Ajouter une corrélation**.
1. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.
1. Sélectionnez le scénario suivant dans le menu déroulant des scénarios : **Fichier CSV**.
1. Sélectionnez le fichier **population\$1by\$1state.csv**. Chaque cellule est un lien sur lequel vous pouvez cliquer pour commencer à créer une nouvelle corrélation.
1. Cliquez sur n'importe quelle cellule de la `State` colonne pour créer une nouvelle corrélation qui associe un lien de données à cette entrée. Par exemple, sélectionnez`California`.
1. Dans la vue divisée, sélectionnez la même source de données que celle que vous avez sélectionnée dans le volet de gauche. L'assistant situé au-dessus de l'éditeur de requêtes contient toutes les variables disponibles que vous pouvez utiliser pour la requête cible. Les variables contiennent tous les champs de données (colonnes de table) de la ligne sélectionnée.
1. Dans le menu **Scénario**, sélectionnez **Valeurs métriques CSV**. Le `String Input` champ de l'éditeur de requête fournit des variables avec des valeurs de population pour chaque année :`${1980},${2000},${2020}`. Cela générera un graphique utilisant des valeurs variables.
1. Dans le champ **Alias** de l'éditeur de requêtes, entrez`${State}`.
Exécutez une requête pour vérifier qu'elle produit un graphique en utilisant des exemples de valeurs provenant des variables.
1. Choisissez **Enregistrer** pour enregistrer la corrélation et quitter l'éditeur de corrélations.
Une fois la corrélation enregistrée, Explore réexécute la requête dans le volet de gauche. En cliquant sur le nom d'un état, la requête de droite est réexécutée avec les valeurs de la ligne insérées dans le CSV, modifiant ainsi le graphique. La requête est réexécutée avec des valeurs mises à jour chaque fois que vous cliquez sur le nom d'un État.
Vous pouvez appliquer les mêmes étapes à n'importe quelle source de données. Les corrélations vous permettent de créer des liens dans les visualisations afin d'exécuter des requêtes dynamiques basées sur des données sélectionnées. Dans cet exemple, nous avons utilisé les données renvoyées par une requête pour créer une nouvelle requête générant une visualisation différente à partir de la même source de données. Vous pouvez toutefois créer des corrélations entre toutes les sources de données afin de créer des flux d'exploration personnalisés.
### Création d'une corrélation entre les journaux et les tables
Dans cet exemple, vous allez créer une corrélation pour montrer comment utiliser les transformations pour extraire des valeurs de la ligne du journal et d'un autre champ.
Pour suivre cet exemple, assurez-vous d'avoir configuré une [source de données de test](testdata-data-source.md).
**Pour créer une corrélation entre les journaux et les tables**
1. **Dans Grafana, accédez à Explore.**
1. Sélectionnez la **source de données de test** dans le menu déroulant en haut à gauche de la page.
1. Choisissez **\$1 Ajouter** dans le menu déroulant à droite, puis sélectionnez **Ajouter une corrélation**.
1. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.
1. Dans le menu **Scénario**, sélectionnez **Logs**.
1. Développez une ligne de journal pour voir les liens de corrélation. Sélectionnez `Correlate with hostname`.
1. Explore s'ouvre en mode partagé. Sélectionnez la même source de données que celle que vous avez sélectionnée dans le volet de gauche. L'assistant situé au-dessus de l'éditeur de requêtes contient toutes les variables disponibles que vous pouvez utiliser pour la requête cible.
1. Développez la section des transformations, puis cliquez sur **Ajouter une transformation**.
1. Dans le menu déroulant **Champ**, sélectionnez le **message**. La ligne du journal s'affiche à titre d'exemple de données.
1. Sous **Type**, sélectionnez **Logfmt**. Cela permet de remplir la liste des variables.
1. Choisissez **Ajouter une transformation à la corrélation**.
1. Choisissez à nouveau **Ajouter une transformation** et sous **Champ**, sélectionnez le **nom d'hôte**.
1. Sous **Type**, sélectionnez **Expression régulière**.
1. Sous **Expression**, entrez ce qui suit : `-([0-9]\*)` Cela permet de sélectionner n'importe quel chiffre situé à droite du tiret.
1. Sous **Nom de la variable**, entrez ce qui suit : `hostNumber` Cela permet de remplir la liste des variables.
1. Choisissez **Ajouter une transformation à la corrélation** pour l'ajouter aux autres variables.
1. Dans l'éditeur de source de données, ouvrez le menu déroulant **Scénario** et sélectionnez **Contenu CSV**.
1. Dans la zone de texte ci-dessous, saisissez les informations suivantes et enregistrez la corrélation :
```
time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}
```
Cela ferme la vue divisée et réexécute la requête de gauche. Développez n'importe quelle ligne du journal pour voir le bouton de corrélation. Le bouton de corrélation ouvre la vue divisée avec le `time` (un champ), `msg` (extrait avec *logfmt* de la ligne du journal), `host number` (extrait avec *regex* depuis le`hostname`) et le `status` (extrait avec *logfmt* depuis la ligne du journal).