É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

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana

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, voirCorrélations dans Grafana version 10.

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.

2. Sélectionnez la source de données que vous souhaitez utiliser comme source pour une nouvelle corrélation.

3. Exécutez une requête produisant des données dans une visualisation prise en charge.

   Note

   Les visualisations prises en charge sont Logs et Table.

4. Choisissez + 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).

   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.

5. 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.

6. 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.

7. 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.

8. Créez une requête cible à l'aide de la syntaxe 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.

9. Fournissez une étiquette et une description (facultatif). Une étiquette sera utilisée comme nom du lien dans la visualisation et peut contenir des variables.

10. Fournissez des transformations (facultatif ; voir ci-dessous pour plus de détails).

11. 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, voirTransformations de corrélation.

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.

2. Sélectionnez le type de transformation. Consultez Transformations de corrélation les options et les paramètres appropriés.

3. 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.

4. 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 documentations 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.

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.

Pour créer une corrélation entre le texte et le graphique

1. Dans Grafana, accédez à Explore.

2. Sélectionnez la source de données de test dans le menu déroulant en haut à gauche de la page.

3. Choisissez + Ajouter dans le menu déroulant à droite, puis sélectionnez Ajouter une corrélation.

4. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.

5. Sélectionnez le scénario suivant dans le menu déroulant des scénarios : Fichier CSV.

6. Sélectionnez le fichier population_by_state.csv. Chaque cellule est un lien sur lequel vous pouvez cliquer pour commencer à créer une nouvelle corrélation.

7. 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électionnezCalifornia.

8. 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.

9. 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.

10. 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.

11. 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.

Pour créer une corrélation entre les journaux et les tables

1. Dans Grafana, accédez à Explore.

2. Sélectionnez la source de données de test dans le menu déroulant en haut à gauche de la page.

3. Choisissez + Ajouter dans le menu déroulant à droite, puis sélectionnez Ajouter une corrélation.

4. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.

5. Dans le menu Scénario, sélectionnez Logs.

6. Développez une ligne de journal pour voir les liens de corrélation. Sélectionnez Correlate with hostname.

7. 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.

8. Développez la section des transformations, puis cliquez sur Ajouter une transformation.

9. Dans le menu déroulant Champ, sélectionnez le message. La ligne du journal s'affiche à titre d'exemple de données.

10. Sous Type, sélectionnez Logfmt. Cela permet de remplir la liste des variables.

11. Choisissez Ajouter une transformation à la corrélation.

12. Choisissez à nouveau Ajouter une transformation et sous Champ, sélectionnez le nom d'hôte.

13. Sous Type, sélectionnez Expression régulière.

14. Sous Expression, entrez ce qui suit : -([0-9]\*) Cela permet de sélectionner n'importe quel chiffre situé à droite du tiret.

15. Sous Nom de la variable, entrez ce qui suit : hostNumber Cela permet de remplir la liste des variables.

16. Choisissez Ajouter une transformation à la corrélation pour l'ajouter aux autres variables.

17. Dans l'éditeur de source de données, ouvrez le menu déroulant Scénario et sélectionnez Contenu CSV.

18. 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 lehostname) et le status (extrait avec logfmt depuis la ligne du journal).