

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.

# Explorez dans la version 10 de Grafana
<a name="v10-explore"></a>

****  
**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)

L'interface utilisateur du tableau de bord de Grafana fournit des fonctionnalités permettant de créer des tableaux de bord à des fins de visualisation. *Explore* supprime les options du tableau de bord et du panneau afin que vous puissiez vous concentrer sur la requête. Il vous permet d'itérer jusqu'à obtenir une requête fonctionnelle, puis de créer un tableau de bord à partir de cette requête.

**Note**  
Si vous souhaitez simplement explorer vos données et ne souhaitez pas créer de tableau de bord, Explore vous facilite grandement la tâche. Si votre source de données prend en charge les données graphiques et tabulaires, Explore affiche les résultats sous forme de graphique et de tableau. Cela vous permet de voir les tendances des données et de voir plus de détails en même temps.

Cette page vous permettra de commencer à explorer vos données. Les rubriques suivantes fournissent des informations supplémentaires sur les fonctionnalités et utilisations spécifiques d'Explore.
+ [Gestion des requêtes dans Explore](v10-explore-manage.md)
+ [Se connecte Explore](v10-explore-logs.md)
+ [Traçage dans Explore](v10-explore-tracing.md)
+ [Éditeur de corrélations dans Explore](v10-explore-correlations.md)
+ [Inspector dans Explore](v10-explore-inspector.md)

## Commencez à explorer
<a name="v10-explore-start"></a>

**Note**  
Pour accéder à Explore, vous devez avoir un rôle d'éditeur ou d'administrateur.

**Pour accéder à Explore**

1. Dans votre espace de travail Grafana, choisissez l'élément de menu Explore dans la barre de menu de gauche.

   Un onglet Explore vide s'ouvre.

   Sinon, pour commencer avec une requête existante dans un panneau, choisissez l'option Explorer dans le menu Panneau. Cela ouvre un onglet Explore contenant la requête du panneau et vous permet de modifier ou d'itérer la requête en dehors de votre tableau de bord.

1. Choisissez votre source de données dans le menu déroulant en haut à gauche.

   Vous pouvez également choisir **Ouvrir le sélecteur de source de données avancé** pour voir d'autres options, notamment l'ajout d'une source de données (pour les administrateurs uniquement).

1. Rédigez la requête à l'aide de l'éditeur de requêtes fourni par la source de données sélectionnée.

   Pour plus de détails sur les requêtes, consultez[Interrogez et transformez les données](v10-panels-query-xform.md).

1. Exécutez la requête à l'aide du bouton situé dans le coin supérieur droit.

## Divisez et comparez
<a name="v10-explore-compare"></a>

La vue divisée permet de comparer facilement des visualisations side-by-side ou de consulter des données associées sur une seule page.

**Ouvrez la vue divisée en haut**

1. Dans la vue Explorer, cliquez sur le bouton **Diviser** pour dupliquer la requête en cours et diviser la page en deux side-by-side requêtes.
**Note**  
Il est possible de sélectionner une autre source de données pour la nouvelle requête, ce qui vous permet, par exemple, de comparer la même requête pour deux serveurs différents ou de comparer l'environnement de préparation à l'environnement de production.

   Dans la vue partagée, les sélecteurs des deux panneaux peuvent être liés (si vous modifiez l'un, l'autre sera également modifié) en sélectionnant un bouton de synchronisation horaire attaché à l'un des sélecteurs. La liaison de timepickers permet de synchroniser les heures de début et de fin des requêtes en vue partagée. Cela garantit que vous examinez le même intervalle de temps dans les deux panneaux divisés.

1. Pour fermer la requête nouvellement créée, cliquez sur le bouton **Fermer le partage**.

## Aperçu du contenu
<a name="v10-explore-outline"></a>

L'aperçu du contenu est une barre de navigation latérale qui permet de suivre les requêtes et les visualisations que vous avez créées dans Explore. Cela vous permet de naviguer rapidement entre eux.

L'aperçu du contenu fonctionne également dans une vue divisée. Lorsque vous êtes en mode partagé, le plan du contenu est généré pour chaque volet.

**Pour ouvrir le plan du contenu**

1. Sélectionnez le bouton **Plan** dans le coin supérieur gauche de l'écran d'**exploration**.

1. Sélectionnez n'importe quelle icône de panneau dans le plan du contenu pour accéder à ce panneau.

## Partagez et explorez URLs
<a name="v10-explore-shareurl"></a>

Lorsque vous utilisez Explore, l'URL de la barre d'adresse du navigateur est mise à jour à mesure que vous modifiez les requêtes. Vous pouvez partager ou ajouter cette URL à vos favoris.

**Note**  
L'exploration peut être relativement longue URLs. Vous pouvez également générer et partager un [lien abrégé](#v10-explore-share) si l'URL est trop longue pour vos outils.

**Génération d'Explore URLs à partir d'outils externes**

Explore URLs ayant une structure définie, vous pouvez créer une URL à partir d'outils externes et l'ouvrir dans Grafana. La structure de l'URL est la suivante :

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

où :
+ `org_id`est l'identifiant de l'organisation
+ `schema_version`est la version du schéma (doit être définie sur la dernière version, qui est`1`.
+ `panes`est un objet JSON de volets codé en URL, où chaque clé est l'ID du volet et chaque valeur est un objet correspondant au schéma suivant :

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**Note**  
Les `to` champs `from` et acceptent également les plages relatives, comme décrit dans la [Configuration de la plage horaire du tableau de bord](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) rubrique.

## Partager le lien raccourci
<a name="v10-explore-share"></a>

La fonctionnalité Partager des liens raccourcis vous permet de créer des liens plus petits et plus simples URLs au format /goto/:uid au lieu d'utiliser des paramètres de requête plus longs. URLs Pour créer un lien raccourci vers les résultats de la requête, sélectionnez l'option **Partager** dans la barre d'outils Explore. Un lien abrégé qui n'est jamais utilisé sera automatiquement supprimé au bout de sept (7) jours. Si un lien est utilisé au moins une fois, il ne sera pas supprimé.

**Partage de liens raccourcis en temps absolu**

Les liens courts ont deux options : conserver l'heure relative (par exemple, entre deux heures et l'heure actuelle) ou l'heure absolue (par exemple, entre 8 h et 10 h). Le partage d'un lien raccourci par défaut copiera la plage de temps sélectionnée, relative ou absolue. En cliquant sur le bouton déroulant situé à côté du bouton Partager le lien abrégé et en sélectionnant l'une des options sous **Synchronisation temporelle des liens URL**, vous pouvez créer un lien court avec l'heure absolue, ce qui signifie que toute personne recevant le lien verra les mêmes données que vous, même si elle ouvre le lien à un autre moment. Cette option n'affectera pas la plage de temps sélectionnée dans votre vue Explore.

# Gestion des requêtes dans Explore
<a name="v10-explore-manage"></a>

****  
**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 gérer les requêtes que vous avez créées dans Explore, y compris l'historique des requêtes que vous avez exécutées et des requêtes auxquelles vous avez ajouté des favoris.

## Historique des requêtes
<a name="v10-explore-manage-history"></a>

L'historique des requêtes est une liste des requêtes que vous avez utilisées dans Explore. L'historique est stocké dans la base de données Grafana et n'est pas partagé avec d'autres utilisateurs. La période de conservation des requêtes dans l'historique est de deux semaines. Les requêtes datant de plus de deux semaines sont automatiquement supprimées. Pour ouvrir votre historique et interagir avec celui-ci, sélectionnez le bouton **Historique des requêtes** dans Explore.

**Note**  
Les requêtes marquées d'un astérisque (mises en favoris) ne sont pas soumises à la période de conservation de deux semaines et ne sont pas supprimées.

## Afficher l'historique des requêtes
<a name="v10-explore-manage-history-view"></a>

L'historique des requêtes vous permet de consulter l'historique de vos requêtes. Pour chaque requête individuelle, vous pouvez :
+ Exécutez la requête.
+ Créez et and/or modifiez un commentaire.
+ Copiez une requête dans le presse-papiers.
+ Copiez un lien abrégé contenant la requête dans le presse-papiers.
+ Ajoutez une requête à la liste des favoris.

## Gérer les requêtes favorites
<a name="v10-explore-manage-history-favorites"></a>

Toutes les requêtes qui ont été marquées dans l'onglet Historique des requêtes sont affichées dans l'onglet Marqué. Cela vous permet d'accéder plus rapidement à vos requêtes préférées et de les réutiliser sans les taper à partir de zéro.

## Tri de l'historique des requêtes
<a name="v10-explore-manage-history-sort"></a>

Par défaut, l'historique des requêtes affiche les requêtes les plus récentes. Vous pouvez trier votre historique par date ou par nom de source de données par ordre croissant ou décroissant.

**Pour trier l'historique de vos requêtes**

1. Sélectionnez le champ **Trier les requêtes par**.

1. Sélectionnez l’une des options suivantes :
   + **Le plus récent en premier**
   + **Le plus vieux d'abord**

## Filtrer l'historique des requêtes
<a name="v10-explore-manage-history-filter"></a>

Vous pouvez filtrer l'historique de vos requêtes dans l'onglet Historique des requêtes et dans l'onglet Favoris en fonction d'une source de données spécifique.

**Pour filtrer l'historique vers une source de données**

1. Sélectionnez le champ **Filtrer les requêtes pour des sources de données spécifiques**.

1. Sélectionnez la source de données pour laquelle vous souhaitez filtrer votre historique. Vous pouvez sélectionner plusieurs sources de données.

**Note**  
Les requêtes exécutées à l'aide de la source de données mixte apparaîtront uniquement lors du filtrage pour le mode mixte, et non lors du filtrage en fonction de leurs sources de données individuelles.

Dans l'onglet **Historique des requêtes**, il est également possible de filtrer les requêtes par date à l'aide du curseur :
+ Utilisez le curseur vertical pour filtrer les requêtes par date.
+ Ajustez la date de début en faisant glisser la poignée inférieure.
+ Ajustez la date de fin en faisant glisser la poignée supérieure.

## Recherche dans l'historique des requêtes
<a name="v10-explore-manage-history-search"></a>

Vous pouvez effectuer des recherches dans votre historique parmi les requêtes et les commentaires. Il est possible de rechercher des requêtes dans l'onglet Historique des requêtes et dans l'onglet Started.

**Pour effectuer une recherche dans l'historique des requêtes**

1. Sélectionnez le champ **Requêtes de recherche**.

1. Entrez le terme que vous recherchez dans le champ de recherche.

## Paramètres de l'historique des requêtes
<a name="v10-explore-manage-history-settings"></a>

Vous pouvez personnaliser l'historique des requêtes dans l'onglet Paramètres. Les options sont décrites dans le tableau suivant.


| Paramètre | Valeur par défaut | 
| --- | --- | 
| Modifier l'onglet actif par défaut | Onglet Historique des requêtes | 

**Note**  
Les paramètres de l'historique des requêtes sont globaux et appliqués aux deux panneaux en mode partagé.

# Se connecte Explore
<a name="v10-explore-logs"></a>

****  
**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)

Explore vous permet d'examiner vos journaux dans différentes sources de données, notamment :
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Lors de la surveillance de l'infrastructure et de la réponse à un incident, vous pouvez approfondir les indicateurs et les journaux pour en trouver la cause. Explore vous permet également de corréler les journaux avec d'autres signaux de télémétrie tels que les métriques, les traces ou les profils, en les visualisant. side-by-side

Les résultats des requêtes de journal sont affichés sous forme de lignes de journal individuelles et sous forme de graphique indiquant le volume de journaux pour la période sélectionnée.

## Volume des journaux
<a name="v10-explore-logs-volume"></a>

Lorsque vous travaillez avec des sources de données qui prennent en charge un volume de journaux complet, Explore affiche automatiquement un graphique montrant la distribution des journaux pour toutes les requêtes de journal saisies. Cette fonctionnalité est actuellement prise en charge par OpenSearch les sources de données Loki.

**Note**  
Dans Loki, ce volume de log complet est rendu par une requête métrique qui peut être coûteuse en fonction de la plage de temps demandée. Cette requête peut être particulièrement difficile à traiter pour les petites installations Loki. Pour atténuer ce problème, vous pouvez utiliser un proxy tel que [nginx](https://www.nginx.com/) devant Loki pour définir un délai d'attente personnalisé (par exemple, 10 secondes) pour ces requêtes. Les requêtes d'histogramme de volume de journal peuvent être identifiées en recherchant les requêtes dont l'en-tête HTTP contient `X-Query-Tags` une valeur `Source=logvolhist` ; ces en-têtes sont ajoutés par Grafana à toutes les requêtes d'histogramme de volume de journal.

Si la source de données ne prend pas en charge le chargement du volume complet des journaux, le modèle de journaux calcule une série chronologique en comptant les lignes de journaux et en les organisant en compartiments sur la base d'un intervalle de temps calculé automatiquement. L'horodatage de la première ligne de log est utilisé pour ancrer le début du volume de logs dans les résultats. La fin de la série chronologique est ancrée dans la plage To du sélecteur **de** temps. Ainsi, vous pouvez toujours analyser et visualiser efficacement les données des journaux, même lorsque la source de données n'offre pas une prise en charge complète.

## Journaux
<a name="v10-explore-logs-overview"></a>

Dans les sections suivantes, vous trouverez des explications détaillées sur la manière de visualiser et d'interagir avec des journaux individuels dans Explore.

## Navigation dans les journaux
<a name="v10-explore-logs-navigation"></a>

La navigation dans les journaux, sur le côté droit des lignes de journal, peut être utilisée pour demander facilement des journaux supplémentaires. Vous pouvez le faire en cliquant sur le bouton **Anciens journaux** en bas de la navigation. Cela est particulièrement utile lorsque vous atteignez la limite de lignes et que vous souhaitez voir plus de journaux. Chaque demande exécutée à partir de la navigation est ensuite affichée dans la navigation sous forme de page distincte. Chaque page affiche `from` et `to` horodatage des lignes de journal entrantes. Vous pouvez consulter les résultats précédents en cliquant sur chaque page. Explore met en cache les cinq dernières requêtes exécutées depuis la navigation des journaux. Vous n'avez donc pas à réexécuter les mêmes requêtes lorsque vous cliquez sur les pages, ce qui permet d'économiser du temps et des ressources.

## Options de visualisation
<a name="v10-explore-log-visualization-options"></a>

 Vous pouvez personnaliser le mode d'affichage des journaux et sélectionner les colonnes à afficher. 


| Option | Description | 
| --- | --- | 
| Time (Période) | Affiche ou masque la colonne de temps. Il s'agit de l'horodatage associé à la ligne de journal tel qu'indiqué par la source de données. | 
| Étiquettes uniques | Affiche ou masque la colonne d'étiquettes uniques qui inclut uniquement les étiquettes non courantes. Toutes les étiquettes courantes sont affichées ci-dessus. | 
| Lignes d'enroulement | Définissez ce paramètre sur true si vous souhaitez que l'affichage utilise l'habillage de lignes. Si ce paramètre est défini surfalse, il en résultera un défilement horizontal. | 
| Embellissez le JSON |  Réglez ce paramètre sur true pour imprimer joliment tous les journaux JSON. Ce paramètre n'affecte pas les journaux dans un format autre que JSON. | 
| Déduplication | Les données de journal peuvent être très répétitives et Explore peut vous aider en masquant les lignes de journal dupliquées. Il existe différents algorithmes de déduplication que vous pouvez utiliser. Les correspondances exactes sont effectuées sur l'ensemble de la ligne, à l'exception des champs de date. Les correspondances de nombres sont effectuées sur la ligne après avoir retiré des nombres tels que les durées, les adresses IP, etc. La signature est la déduplication la plus agressive, car elle supprime toutes les lettres et tous les chiffres et fait correspondre les espaces blancs et les signes de ponctuation restants. | 
| Afficher l'ordre des résultats | Vous pouvez modifier l'ordre des journaux reçus de l'ordre décroissant par défaut (le plus récent en premier) à l'ordre croissant (le plus ancien en premier). | 

## Téléchargez les lignes de journal
<a name="v10-explore-download-log-lines"></a>

Pour télécharger les résultats du journal dans l'`txt`un ou l'autre `json` format, utilisez le bouton **Télécharger**. Cette fonctionnalité vous permet d'enregistrer les données du journal pour une analyse plus approfondie ou de les partager avec d'autres personnes dans un format pratique et accessible.

## Méta-informations sur les résultats du journal
<a name="v10-explore-log-result-meta-information"></a>

Au-dessus des lignes de journal reçues, vous trouverez des méta-informations essentielles, notamment :
+ **Nombre de journaux reçus** : indique le nombre total de journaux reçus pour la requête ou la période en cours.
+ **Erreur** — Affiche une erreur possible dans les résultats de votre journal.
+ **Étiquettes communes** : affiche les étiquettes communes.
+ **Nombre total d'octets traités** : représente la taille cumulée des données du journal traitées en octets.

**Note**  
La disponibilité de certaines méta-informations peut dépendre de la source de données et, par conséquent, il est possible que vous ne voyiez certains de ces détails que pour des sources de données spécifiques.

## Échapper aux nouvelles lignes
<a name="v10-explore-log-escaping-newlines"></a>

Explore détecte automatiquement certaines séquences échappées de manière incorrecte dans les lignes de journal, telles que les nouvelles lignes (`\n`,`\r`) ou les onglets (`\t`). Lorsqu'il détecte de telles séquences, Explore propose une option **Escape newlines**.

**Pour corriger automatiquement les séquences incorrectement échappées détectées par Explore**

1. Choisissez **Escape newlines** pour remplacer les séquences.

1. Vérifiez manuellement les remplacements pour confirmer leur exactitude.

Explore remplace ces séquences. Dans ce cas, l'option passe de **Échapper aux nouvelles lignes à Supprimer les lignes** **qui s'échappent**. Évaluez les modifications car l'analyse peut ne pas être précise en fonction des entrées reçues. Vous pouvez annuler les remplacements en sélectionnant **Supprimer** les échappements.

## Niveau de journalisation
<a name="v10-explore-log-level"></a>

Pour les journaux pour lesquels une `level` étiquette est spécifiée, nous utilisons la valeur de cette étiquette pour déterminer le niveau de journalisation et mettre à jour la couleur de chaque ligne de journal en conséquence. Si le journal n'a pas d'étiquette de niveau spécifiée, nous essayons de déterminer si son contenu correspond à l'une des expressions prises en charge (consultez le tableau suivant pour plus d'informations). Le niveau de journalisation est toujours déterminé par la première correspondance. Si Grafana n'est pas en mesure de déduire un champ de niveau de log, celui-ci sera visualisé avec un niveau de log inconnu.

**Note**  
Si vous utilisez une source de données Loki et que celle-ci `level` fait partie de votre ligne de journal, vous pouvez utiliser des analyseurs (JSON, logfmt, regex,..) pour extraire les informations de niveau dans une étiquette de niveau utilisée pour déterminer la valeur du niveau. Cela permettra à l'histogramme d'afficher les différents niveaux de log sous forme de barres distinctes.

**Niveaux de journalisation pris en charge et mappage des abréviations et expressions des niveaux de journalisation :** 


| Niveau de journalisation | Couleur | Expressions prises en charge | 
| --- | --- | --- | 
| critique | pourpre | émerge, fatal, alerte, critique, critique | 
| error | red | erreur, erreur, erreur | 
| warning | yellow | avertir, avertir | 
| info | green | info, information, information, avis | 
| debug | blue | dbug, debug | 
| trace | bleu clair | trace | 
| inconnu | gris | \$1 | 

## Surligner les mots recherchés
<a name="v10-explore-highlight-searched-words"></a>

Lorsque votre requête inclut des mots ou des expressions spécifiques à rechercher, Explore les met en évidence dans les lignes de journal pour une meilleure visibilité. Cette fonctionnalité de mise en évidence permet d'identifier plus facilement le contenu pertinent de vos journaux et de vous concentrer sur celui-ci.

**Note**  
La capacité à surligner les mots de recherche peut varier en fonction de la source de données. Pour certaines sources de données, le surlignage des mots de recherche peut ne pas être disponible.

## Affichage des détails du journal
<a name="v10-explore-log-details-view"></a>

Dans Explore, chaque ligne de journal comporte une section extensible appelée *Détails du journal* qui peut être ouverte en choisissant la ligne de journal. La vue des détails du journal fournit des informations supplémentaires et des options d'exploration sous la forme de *champs* et de *liens* attachés aux lignes de journal, permettant une interaction et une analyse plus robustes.

**Champs**

Dans la vue Détails du journal, vous pouvez filtrer les champs affichés de deux manières : un filtre positif (pour vous concentrer sur un champ spécifique) et un filtre négatif (pour exclure certains champs). Ces filtres mettront à jour la requête correspondante qui a produit la ligne de log, en ajoutant les expressions d'égalité et d'inégalité en conséquence. Si la source de données est compatible, comme c'est le cas pour Loki et Loki OpenSearch, les détails du journal vérifieront si le champ est déjà présent dans la requête en cours et s'affichera à l'état actif (pour les filtres positifs uniquement), ce qui vous permettra de le désactiver ou de faire passer l'expression du filtre de positive à négative.

Vous pouvez sélectionner un sous-ensemble de champs à visualiser dans la liste des journaux plutôt que dans la ligne complète du journal en cliquant sur l'icône en forme d'œil. Chaque champ possède une icône de statistiques pour afficher les statistiques relatives à tous les journaux affichés.

**Liens**

Grafana offre la fonctionnalité de liens ou de corrélations de données, vous permettant de convertir n'importe quelle partie d'un message de journal en lien interne ou externe. Ces liens peuvent être utilisés pour accéder à des données connexes ou à des ressources externes, offrant ainsi un moyen simple et pratique d'explorer de plus amples informations.

## Contexte du journal
<a name="v10-explore-log-context"></a>

Le contexte du journal affiche des lignes de contexte supplémentaires entourant une entrée de journal qui correspond à une requête de recherche particulière. Cela peut être utile pour comprendre le contexte de l'entrée du journal et est similaire au `-C` paramètre de la `grep` commande.

Vous pouvez rencontrer de longues lignes de texte qui compliquent la lecture et l'analyse du contexte de chaque entrée du journal. C'est là que le bouton **Wrap lines** peut s'avérer utile. En activant cette option, Grafana enroulera automatiquement de longues lignes de texte afin qu'elles correspondent à la largeur visible du lecteur. Cela peut faciliter la lecture et la compréhension des entrées du journal. 

 Le bouton **Ouvrir en mode partagé** vous permet d'exécuter la requête contextuelle pour une entrée de journal sur un écran partagé dans la vue Explore. Le fait de cliquer sur ce bouton ouvre un nouveau volet Explore dans lequel la requête contextuelle est affichée à côté de l'entrée du journal, ce qui facilite l'analyse et la compréhension du contexte environnant.

La requête contextuelle du journal peut également être ouverte dans un nouvel onglet du navigateur en appuyant sur la touche `Ctrl` (ou`Cmd`) tout en choisissant le bouton pour ouvrir le modal de contexte. Lorsqu'ils sont ouverts dans un nouvel onglet, les filtres précédemment sélectionnés sont également appliqués.

## Copier la ligne du journal
<a name="v10-explore-copy-log-line"></a>

Vous pouvez facilement copier le contenu d'une ligne de journal sélectionnée dans votre presse-papiers en cliquant sur le bouton **Copier la ligne de journal**.

## Copier le lien vers la ligne de journal
<a name="v10-explore-copy-link-to-log-line"></a>

La liaison des lignes de journal dans Grafana vous permet de naviguer rapidement vers des entrées de journal spécifiques pour une analyse précise. En cliquant sur le bouton **Copier le lien court** pour une ligne de journal, vous pouvez générer et copier une URL courte qui fournit un accès direct à l'entrée exacte du journal dans un intervalle de temps absolu. Lorsque vous ouvrez le lien, Grafana fait automatiquement défiler la page jusqu'à la ligne de journal correspondante et la met en évidence sur fond bleu, ce qui permet d'identifier facilement les informations pertinentes et de se concentrer sur celles-ci.

**Note**  
Cela n'est pris en charge que dans Loki et dans les autres sources de données qui fournissent un `id` champ.

## Tailing en direct
<a name="v10-explore-log-live-tailing"></a>

Pour consulter les journaux en temps réel des sources de données prises en charge, vous pouvez utiliser la fonctionnalité de suivi en direct d'Explore.

**Pour consulter les journaux en temps réel grâce au suivi en direct**

1. Cliquez sur le bouton **Live** dans la barre d'outils Explore pour passer à la vue Live tail.

1. En mode Live tail, les nouveaux journaux apparaîtront en bas de l'écran, avec un arrière-plan contrastant qui s'estompe, ce qui vous permettra de suivre facilement les nouveautés.

1. Si vous souhaitez suspendre le suivi en direct et explorer les journaux précédents sans interruption, vous pouvez le faire en cliquant sur le bouton **Pause** ou en faisant simplement défiler la vue des journaux.

1. Pour effacer l'affichage et supprimer tous les journaux de l'écran, cliquez sur le bouton **Effacer les journaux**. Cette action réinitialisera la vue du journal et vous permettra de faire table rase pour poursuivre l'analyse du journal.

1. Pour reprendre le suivi en direct et continuer à consulter les journaux en temps réel, cliquez sur le bouton **Reprendre**.

1. Si vous souhaitez quitter Live Tailing et revenir à la vue Explore standard, cliquez sur le bouton **Arrêter**.

Grâce à la fonction de suivi en direct, vous pouvez suivre de près les derniers journaux au fur et à mesure qu'ils arrivent, ce qui facilite le suivi des événements en temps réel et la détection rapide des problèmes.

**Exemple de journaux**

Si la source de données sélectionnée implémente un échantillon de journaux et prend en charge les requêtes de log et de métrique, alors pour les requêtes métriques, vous pourrez voir automatiquement des exemples de lignes de journal ayant contribué à la visualisation des métriques. Cette fonctionnalité est actuellement prise en charge par les sources de données Loki.

**Passez des métriques aux journaux**

 Si vous passez d'une source de données de métriques implémentée `DataSourceWithQueryExportSupport` (telle que Prometheus) à une source de données de journalisation `DataSourceWithQueryImportSupport` compatible (telle que Loki), elle conservera les étiquettes de votre requête qui existent dans les journaux et les utilisera pour interroger les flux de journaux.

Par exemple, la `grafana_alerting_active_alerts{job='grafana'}` requête Prometheus suivante, une fois passée à la source de données Loki, deviendra. `{job='grafana'}` Cela renverra une partie des journaux dans la plage de temps sélectionnée qui pourront être grepped/text recherchés.

# Traçage dans Explore
<a name="v10-explore-tracing"></a>

****  
**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 utiliser Explore pour visualiser des traces à partir de sources de données de suivi.

Les sources de données suivantes sont prises en charge :
+ [Tempo](tempo-data-source.md) (formats d'ingestion pris en charge : OpenTelemetry, Jaeger et Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Pour plus d'informations sur la configuration des requêtes pour les sources de données répertoriées ci-dessus, reportez-vous à la documentation de la source de données spécifique.

## Éditeur de requêtes
<a name="v10-explore-trace-queryeditor"></a>

Vous pouvez interroger et rechercher des données de suivi à l'aide de l'éditeur de requêtes d'une source de données.

Chaque source de données peut avoir son propre éditeur de requêtes. L'éditeur de requêtes pour la source de données Tempo est légèrement différent de l'éditeur de requêtes pour la source de données Jaeger.

Pour plus d'informations sur l'interrogation de chaque source de données, reportez-vous à leur documentation.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Explication de Trace View
<a name="v10-explore-trace-view"></a>

Cette section explique les éléments du tableau de bord Trace View.

**En-tête**

L'en-tête de la vue de trace comporte les éléments suivants :
+ Titre de l'en-tête — Affiche le nom de l'intervalle racine et l'ID de trace.
+ Rechercher : met en évidence les plages contenant le texte recherché.
+ Métadonnées : diverses métadonnées relatives à la trace.

**Mini-carte**

Affiche la vue condensée ou la chronologie du tracé. Faites glisser votre pointeur sur la mini-carte pour zoomer sur une plage de temps plus courte. Le zoom permet également de mettre à jour la chronologie principale, de sorte qu'il est facile de voir des plages plus courtes. Lorsque vous passez le curseur sur la minicarte, une fois zoomée, le bouton **Réinitialiser la sélection permet de réinitialiser** le zoom.

**Filtres Span**

À l'aide de filtres d'intervalle, vous pouvez filtrer vos intervalles dans l'afficheur de chronologie des traces. Plus vous ajoutez de filtres, plus les plages filtrées sont spécifiques.

Vous pouvez ajouter un ou plusieurs des filtres suivants :
+ Nom du service de ressources
+ Nom de l'Espagne
+ Duration
+ Balises (qui incluent les balises, les balises de processus et les champs de journal)

Pour afficher uniquement les intervalles auxquels vous avez fait correspondre, sélectionnez le bouton **Afficher les correspondances uniquement**.

**Chronologie**

Affiche la liste des intervalles contenus dans le tracé. Chaque ligne de span comprend les composants suivants :
+ Bouton Élargir les enfants : permet d'étendre ou de réduire toutes les tranches d'enfants de la période sélectionnée.
+ Nom du service : nom du service qui a enregistré l'intervalle.
+ Nom de l'opération : nom de l'opération représentée par cette plage.
+ Barre de durée de l'intervalle : représentation visuelle de la durée de l'opération dans le tracé.

**Détails de l'envergure**

Le choix de la ligne d'intervalle affiche les détails de l'intervalle, notamment les suivants.
+ Nom de l’opération
+ Métadonnées Span
+ Balises : toutes les balises associées à cette plage.
+ Métadonnées du processus : métadonnées relatives au processus qui a enregistré cette période.
+ Journaux : liste des journaux enregistrés par cette plage et des valeurs clés associées. Dans le cas des journaux Zipkin, la section affiche les annotations Zipkin.

**Trace vers les journaux**

Vous pouvez accéder directement à une plage dans une vue de trace aux journaux correspondant à cette période. Ceci est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation pertinente pour obtenir des instructions sur la façon de configurer chaque source de données.

Cliquez sur l'icône du document pour ouvrir une vue fractionnée dans Explore avec la source de données configurée et recherchez les journaux pertinents pour la période.

**Suivi des métriques**

**Note**  
Cette fonctionnalité est actuellement en version bêta

Vous pouvez passer d'une plage dans une vue de trace directement aux métriques pertinentes pour cette période. Cette fonctionnalité est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation appropriée pour plus de détails sur la configuration.

**Trace jusqu'aux profils**

En utilisant Trace to profiles, vous pouvez utiliser la capacité de Grafana à corréler différents signaux en ajoutant la fonctionnalité permettant de lier les traces aux profils.

## Graphe de nœuds
<a name="v10-explore-trace-node-graph"></a>

Vous pouvez éventuellement développer le graphe de nœuds pour le tracé affiché. En fonction de la source de données, cela peut afficher les étendues de la trace sous forme de nœuds dans le graphe ou ajouter du contexte supplémentaire, notamment le graphe de service basé sur la trace actuelle.

## Affichage du graphique des services
<a name="v10-explore-trace-graph"></a>

La vue Service Graph permet de visualiser les métriques de durée (trace les données relatives aux taux, aux taux d'erreur et aux durées (RED)) et les graphiques de service. Une fois les exigences définies, cette vue préconfigurée est immédiatement disponible.

Pour plus d'informations, consultez la page des sources de données [Tempo](tempo-data-source.md). Vous pouvez également consulter la [page d'affichage du graphique de service](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) dans la documentation *Tempo de Grafana Labs*.

## API de données
<a name="v10-explore-trace-dataapi"></a>

Cette visualisation nécessite une forme spécifique des données à renvoyer depuis la source de données afin de les afficher correctement.

La source de données doit renvoyer une trame de données et un ensemble`frame.meta.preferredVisualisationType = 'trace'`.

**Structure du bloc de données**

Les champs obligatoires ;


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| ID de trace | chaîne | Identifiant de l'ensemble de la trace. Il ne doit y avoir qu'une seule trace dans le bloc de données. | 
| ID d'Espagne | chaîne | Identifiant de la plage en cours. L'étendue IDs doit être unique par trace. | 
| Panid des parents | chaîne | SpanID de l'espace parent pour créer une relation enfant-parent dans la vue de trace. Peut être undefined pour Root Span sans parent. | 
| serviceName | chaîne | Nom du service dont fait partie cette période. | 
| Étiquettes de service | TraceKeyValuePair[] | Liste des balises pertinentes pour le service. | 
| startTime | number | Heure de début de la période en millisecondes. | 
| duration | number | Durée de l'intervalle en millisecondes. | 

 Champs facultatifs : 


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| journaux | TraceLog[] | Liste des journaux associés à la période en cours. | 
| tags | TraceKeyValuePair[] | Liste des balises associées à la plage en cours. | 
| warnings | chaîne [] | Liste des avertissements associés à la période en cours. | 
| Stack Traces | chaîne [] | Liste des traces de pile associées à l'intervalle actuel. | 
| errorIconColor | chaîne | Couleur de l'icône d'erreur au cas où span est marqué avecerror: true. | 

Pour plus de détails sur les types [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), voir, [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)et ainsi de [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)suite GitHub.

# Éditeur de corrélations dans Explore
<a name="v10-explore-correlations"></a>

****  
**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
<a name="v10-explore-corr-create-a-correlation"></a>

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
<a name="v10-explore-corr-transformations"></a>

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
<a name="v10-explore-corr-examples"></a>

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
<a name="v10-explore-corr-text-to-graph"></a>

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
<a name="v10-explore-corr-logs-to-table"></a>

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

# Inspector dans Explore
<a name="v10-explore-inspector"></a>

****  
**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)

L'inspecteur vous aide à comprendre vos requêtes et à les résoudre. Vous pouvez inspecter les données brutes, les exporter vers un fichier de valeurs séparées par des virgules (CSV), exporter les résultats du journal au format TXT et consulter les demandes de requête.

## Interface utilisateur de l'inspecteur
<a name="v10-explore-inspector-ui"></a>

L'inspecteur comporte les onglets suivants :
+ **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.
+ **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.
+ **Onglet JSON** — Vous permet de visualiser et de copier les données JSON et la structure du bloc de données JSON.
+ **Onglet Données** : affiche les données brutes renvoyées par la requête.
+ **Onglet Erreur** : affiche l'erreur. Visible uniquement lorsque la requête renvoie une erreur.

## Tâches de l'Inspecteur
<a name="v10-explore-inspector-tasks"></a>

Vous pouvez effectuer diverses tâches dans l'inspecteur Explore.

**Ouvrez l'Inspector**

Après avoir exécuté la requête que vous souhaitez inspecter, cliquez sur le bouton **Inspector**.

Le volet de l'inspecteur s'ouvre en bas de l'écran.

**Inspecter les résultats bruts des requêtes**

Vous pouvez afficher les résultats bruts de la requête, c'est-à-dire les données renvoyées par la requête dans une table.

Dans l'onglet **Inspector**, cliquez sur l'onglet **Data**.

Pour les requêtes multiples ou pour les requêtes impliquant plusieurs nœuds, des options supplémentaires sont disponibles.
+ **Afficher le bloc de données :** sélectionnez les données de l'ensemble de résultats que vous souhaitez afficher.
+ **Séries jointes par heure :** visualisez les données brutes de toutes vos requêtes en une seule fois, un ensemble de résultats par colonne. Vous pouvez cliquer sur l'en-tête d'une colonne pour trier les données.

**Télécharger les résultats bruts des requêtes au format CSV**

Grafana génère un fichier CSV dans l'emplacement de téléchargement par défaut de votre navigateur. Vous pouvez l'ouvrir dans le visualiseur de votre choix.

1. Dans l'onglet **Inspector**, obtenez les résultats bruts des requêtes en suivant les instructions ci-dessus.

1. Affinez les paramètres de requête jusqu'à ce que vous puissiez voir les données brutes que vous souhaitez exporter.

1. Choisissez **Télécharger le rapport CSV**.

Pour télécharger un fichier CSV spécialement formaté pour Excel, développez les **options de données**, puis activez le bouton **Télécharger pour Excel** avant de sélectionner l'option **Télécharger le CSV**.

**Télécharger les résultats du journal au format TXT**

Vous pouvez générer un fichier TXT contenant les journaux que vous êtes en train de consulter en sélectionnant **Download logs** dans l'onglet **Inspector**.

**Télécharger les résultats de suivi**

En fonction du type de source de données, Grafana génère un fichier JSON pour les résultats de suivi dans l'un des formats pris en charge : formats Jaeger, Zipkin ou OTLP.

1. Ouvrez l'Inspector.

1. Inspectez les résultats de la requête du journal. Affinez les résultats jusqu'à ce que vous voyiez les journaux bruts que vous souhaitez exporter.

1. Choisissez **Télécharger les journaux**.

**Inspectez les performances des requêtes**

L'onglet **Statistiques** affiche des statistiques qui indiquent la durée de votre requête, le nombre de requêtes que vous envoyez et le nombre de lignes renvoyées. Ces informations peuvent vous aider à résoudre vos requêtes, en particulier si l'un des chiffres est élevé ou faible de façon inattendue.

Les statistiques sont affichées en lecture seule.

**Afficher le modèle JSON**

Vous pouvez explorer et exporter des données ainsi que des modèles JSON de blocs de données.

**Pour afficher le modèle JSON**

1. Dans le panneau Inspector, cliquez sur l'onglet **JSON**.

1. **Dans le menu déroulant Sélectionner la source**, choisissez l'une des options suivantes :
   + **Données** — Affiche un objet JSON représentant les données renvoyées à Explore.
   + **DataFrame structure** — Affiche le jeu de résultats bruts.

1. Vous pouvez développer ou réduire des parties du JSON pour afficher des sections distinctes. Vous pouvez également sélectionner l'option **Copier dans le presse-papiers pour** copier le corps du fichier JSON et le coller dans une autre application.

**Afficher la demande brute et la réponse à la source de données**

Lorsque vous utilisez Explore et l'onglet Inspector, vous pouvez consulter les données brutes de demande et de réponse que vous générez avec une requête. Dans l'Inspector, sélectionnez l'onglet **Requête** et choisissez **Actualiser** pour afficher les données brutes.

Grafana envoie la requête au serveur et affiche le résultat. Vous pouvez accéder à des parties spécifiques de la requête, les développer ou les réduire toutes, ou copier les données dans le presse-papiers pour les utiliser dans d'autres applications.