Explorez

Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.

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

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

Dans un espace de travail Grafana, l'interface utilisateur du tableau de bord fournit des outils permettant de créer des tableaux de bord à des fins de visualisation. Explore supprime toutes les options du tableau de bord et du panneau afin que vous puissiez vous concentrer sur la requête. Effectuez une itération jusqu'à obtenir une requête fonctionnelle, puis planifiez et créez un tableau de bord.

Pour la surveillance de l'infrastructure et la réponse aux incidents, vous n'avez plus besoin de passer à d'autres outils pour corriger les problèmes. Vous pouvez utiliser Explore pour approfondir vos statistiques et vos journaux afin d'en trouver la cause.

Explore facilite l'affichage de vos données sans créer de tableau de bord. 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 d'obtenir plus de détails en même temps.

Commencez à explorer

Note

Par défaut, les utilisateurs dotés du rôle Viewer ne peuvent pas modifier et n'ont pas accès à Explore.

L'icône Explorer dans le menu de gauche ouvre un onglet Explore vide.

Pour commencer avec une requête existante dans un panneau, choisissez l'option Explorer dans le menu Panneau. Cela ouvre un onglet Explore qui contient la requête du panneau. Vous pouvez ensuite modifier ou itérer la requête en dehors de votre tableau de bord.

Choisissez votre source de données dans la liste déroulante en haut à gauche. Prometheus dispose d'une implémentation Explore personnalisée. Les autres sources de données utilisent leur éditeur de requêtes standard.

Dans le champ de requête, vous pouvez écrire votre requête et explorer vos données. Trois boutons se trouvent à côté du champ de requête : un bouton effacer (X), un bouton d'ajout de requête (+) et un bouton de suppression de requête (-). Comme dans l'éditeur de requêtes du panneau, vous pouvez ajouter et supprimer plusieurs requêtes.

Diviser et comparer

La fonction d'affichage partagé permet de comparer des graphiques et des tableaux side-by-side ou d'examiner les données associées ensemble sur une seule page. Choisissez Split pour dupliquer la requête en cours et diviser la page en deux side-by-side requêtes. Vous avez la possibilité de sélectionner une autre source de données pour la nouvelle requête. Cela vous permet de comparer la même requête pour deux serveurs différents ou de comparer l'environnement de préparation à l'environnement de production.

En mode partagé, les sélecteurs temporels des deux panneaux peuvent être liés (si vous modifiez l'un, l'autre sera également modifié) en choisissant l'un des boutons de synchronisation horaire attachés aux sélecteurs de temps. L'association des sélecteurs temporels permet de synchroniser les heures de début et de fin des requêtes de vue fractionnée, de sorte que vous puissiez consulter le même intervalle de temps dans les deux panneaux divisés.

Vous pouvez fermer la requête nouvellement créée en choisissant Fermer le partage.

Partage d'un lien raccourci

Utilisez la fonctionnalité Partager des liens raccourcis pour créer des URL plus petites et plus simples /goto/:uid au format au lieu de partager des URL plus longues contenant des paramètres de requête complexes. Vous pouvez créer un lien raccourci en choisissant l'option Partager dans la barre d'outils Explore. Tous les liens abrégés qui ne sont jamais utilisés sont automatiquement supprimés au bout de 7 jours.

Historique des requêtes

L'historique des requêtes est une liste des requêtes que vous avez utilisées dans Explore. L'historique est local à votre navigateur et n'est pas partagé. Pour ouvrir votre historique et interagir avec celui-ci, choisissez Historique des requêtes dans Explore.

Afficher l'historique des requêtes

Dans l'historique des requêtes, vous pouvez effectuer les opérations suivantes :

• Exécuter une requête.

• Créez ou modifiez un commentaire.

• Copiez une requête dans le presse-papiers.

• Copiez un lien abrégé contenant la requête dans le presse-papiers.

• Lancez une requête.

Gestion des requêtes favorites

Toutes les requêtes qui ont été marquées dans l'onglet Historique des requêtes sont affichées dans l'onglet Marqué. Vous pouvez accéder plus rapidement à vos requêtes préférées et les réutiliser sans avoir à les retaper depuis.

Trier l'historique des requêtes

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.

Sur le côté droit de l'historique des requêtes, dans la liste déroulante, choisissez l'une des options suivantes : champ.

• Le plus récent en premier

• Le plus vieux d'abord

• Source de données de A à Z

• Source de données Z-A

Note

Si vous êtes en mode affichage partagé, le mode de tri s'applique uniquement au panneau actif.

Filtrer l'historique des requêtes

Dans les onglets Historique des requêtes et Favoris, vous pouvez filtrer l'historique des requêtes par nom de source de données.

1. Choisissez Filtrer les requêtes pour des sources de données spécifiques.

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

Dans l'onglet Historique des requêtes, vous pouvez utiliser le curseur vertical pour filtrer les requêtes par date :

• Faites glisser la poignée inférieure pour ajuster la date de début.

• Faites glisser la poignée supérieure pour ajuster la date de fin.

Note

Si vous êtes en mode affichage partagé, les filtres ne sont appliqués qu'au panneau actif.

Recherche dans l'historique des requêtes

Vous pouvez effectuer des recherches dans votre historique parmi les requêtes et les commentaires. La recherche est possible pour les requêtes dans les onglets Historique des requêtes et Favoris.

1. Choisissez le champ Requêtes de recherche.

2. Dans le champ de recherche, saisissez votre terme de recherche.

Paramètres de l'historique des requêtes

Vous pouvez personnaliser l'historique des requêtes dans l'onglet Paramètres. Le tableau suivant répertorie les options disponibles.

Paramètre	Valeur par défaut
Spécifiez la durée pendant laquelle Grafana enregistrera l'historique de vos requêtes.	1 semaine
Modifiez l'onglet actif par défaut.	onglet Historique des requêtes
Afficher les requêtes uniquement pour la source de données actuellement active dans Explore.	True
Efface l'historique des requêtes.	(Choisissez Effacer l'historique des requêtes pour supprimer définitivement toutes les requêtes enregistrées.)

Note

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

Caractéristiques spécifiques à Prometheus

La première version d'Explore propose une expérience de requête personnalisée pour Prometheus. Lorsque vous exécutez une requête, Grafana exécute en fait deux requêtes : une requête Prometheus normale pour le graphique et une requête instantanée pour la table. Une requête instantanée renvoie la dernière valeur pour chaque série chronologique, qui présente un bon résumé des données affichées dans le graphique.

Explorateur de métriques

Sur le côté gauche du champ de requête, choisissez Metrics pour ouvrir l'explorateur de métriques. Cela montre un menu hiérarchique avec des métriques groupées par leur préfixe. Par exemple, toutes les métriques d'Alertmanager sont regroupées sous le alertmanager préfixe. Il s'agit d'un bon point de départ pour explorer les indicateurs disponibles.

Champ de requête

Le champ Query prend en charge la saisie automatique des noms et des fonctions des métriques et fonctionne essentiellement de la même manière que l'éditeur de requêtes Prometheus standard. Appuyez sur Entrée pour exécuter une requête.

Le menu Autocomplete est accessible en appuyant sur Ctrl+Espace. Le menu Autocomplete contient une nouvelle section Historique avec une liste des requêtes récemment exécutées.

Des suggestions peuvent apparaître sous le champ Requête. Choisissez une suggestion pour mettre à jour votre requête avec la modification suggérée.

• Pour les compteurs (métriques augmentant de façon monotone), une fonction de débit est suggérée.

• Pour les buckets, une fonction d'histogramme est suggérée.

• Pour les règles d'enregistrement, il est possible d'étendre les règles.

Filtres de table

Cliquez sur le bouton Filtrer dans la colonne d'étiquette d'un panneau de tableau pour ajouter des filtres à l'expression de requête. Vous pouvez également ajouter des filtres pour plusieurs requêtes. Le filtre est ajouté pour toutes les requêtes.

Intégration des journaux

Vous pouvez également utiliser Explore pour examiner vos journaux à l'aide des sources de données suivantes :

• InfluxDB

• Elasticsearch

Visualisation des journaux

Les résultats des requêtes de journal sont présentés sous forme d'histogrammes dans le graphique, et les journaux individuels sont affichés ci-dessous. Si la source de données n'envoie pas de données d'histogramme pour la plage de temps demandée, le modèle de journaux calcule une série chronologique en fonction du nombre de lignes de journal regroupées par intervalles de temps calculés automatiquement. Le début de l'histogramme est ensuite ancré par l'horodatage de la première ligne du journal à partir du résultat. La fin de la série chronologique est ancrée dans la plage To du sélecteur de temps.

Niveau de journalisation

Pour les journaux où une étiquette de niveau est spécifiée, Grafana utilise la valeur de l'étiquette pour déterminer le niveau de journalisation et mettre à jour la couleur en conséquence. Si aucune étiquette de niveau n'est spécifiée pour le journal, Grafana analyse le journal pour savoir si son contenu correspond à l'une des expressions prises en charge. Le niveau de journalisation est toujours déterminé par la première correspondance. Si Grafana n'est pas en mesure de déterminer un niveau de journalisation, celui-ci sera visualisé avec le niveau de journalisation inconnu. Le tableau suivant répertorie les niveaux de journalisation et le mappage des abréviations et expressions des niveaux de journalisation.

Expressions prises en charge	Niveau de journalisation	Couleur
émerger	critique	pourpre
fatal	critique	pourpre
alerte	critique	pourpre
critique	critique	pourpre
critique	critique	pourpre
err	error	red
erreur	error	red
error	error	red
prévenir	warning	yellow
warning	warning	yellow
info	info	green
Informations	info	green
remarquer	info	green
dbug	debug	blue
debug	debug	blue
tracer	tracer	bleu clair
*	inconnu	gris

Options de visualisation

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

Heure

Cette option 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

Cette option affiche ou masque la colonne des étiquettes uniques, qui inclut uniquement les étiquettes non courantes. Toutes les étiquettes courantes sont affichées ci-dessus.

Lignes d'emballage

Pour utiliser l'habillage des lignes à l'écran, définissez ce paramètre sur True. La définition de cette option sur False entraîne un défilement horizontal.

Déduplication

Les données du journal peuvent être très répétitives. Explore peut vous aider en masquant les lignes de journal dupliquées. Vous pouvez choisir parmi différents algorithmes de déduplication :

• Exact — Les correspondances exactes sont effectuées sur l'ensemble de la ligne, à l'exception des champs de date.

• Chiffres — Les correspondances sont effectuées sur la ligne après avoir retiré des nombres tels que les durées, les adresses IP, etc.

• Signature — La déduplication la plus agressive consiste à supprimer toutes les lettres et tous les chiffres. Les correspondances sont effectuées sur les espaces blancs et les signes de ponctuation restants.

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

Libellés et champs détectés

Chaque ligne de journal possède une zone extensible avec ses étiquettes et ses champs détectés, pour une interaction plus robuste. Pour toutes les étiquettes, vous pouvez filtrer (filtre positif) et filtrer (filtre négatif) les étiquettes sélectionnées. Chaque champ ou étiquette possède également une icône de statistiques pour afficher des statistiques ponctuelles relatives à tous les journaux affichés.

Activer/désactiver les champs détectés

Si vos journaux sont structurés en JSON ou logfmt, vous pouvez afficher ou masquer les champs détectés. Développez une ligne de journal, puis cliquez sur l'icône en forme d'œil pour afficher ou masquer les champs.

{{< docs-imagebox img= » /img/docs/explore/parsed-fields-7-2.gif "max-width="800px » caption="Modification des champs détectés dans Explore » >}}

Intégration du traçage

Vous pouvez visualiser des traces à partir de sources de données de suivi dans Explore. Sources de données actuellement prises en charge :

• Connectez-vous à une source de données Jaeger

• Connectez-vous à une source de données Tempo

• Se connecter à une source AWS X-Ray de données

• Connect à une source de données Zipkin

Pour plus d'informations sur l'utilisation de l'éditeur de requêtes, consultez la documentation de la source de données spécifique.

En-tête

L'en-tête inclut les éléments suivants :

• Titre de l'en-tête, qui indique le nom de l'intervalle racine et l'ID de trace

• Recherche, qui met en évidence les plages contenant le texte recherché

• Métadonnées relatives à la trace

Mini-carte

La minicarte montre une vue condensée ou la chronologie du tracé. Faites glisser votre souris 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. Si vous faites une pause sur la mini-carte, lorsque vous zoomez, vous pouvez voir le bouton Réinitialiser la sélection, qui réinitialise le zoom.

Chronologie

La chronologie affiche une liste des intervalles de la trace. Chaque ligne d'espacement comprend les composants suivants :

• Bouton Élargir les enfants : élargit ou réduit toutes les tranches pour enfants de la période sélectionnée

• Nom du service : nom du service qui a enregistré le span

• Nom de l'opération : nom de l'opération que cette plage représente

• Barre de durée de l'intervalle : représentation visuelle de la durée de l'opération dans le tracé

Si vous choisissez n'importe où sur la ligne d'intervalle, les détails de l'intervalle s'affichent.

Détails de l'envergure

Les détails de l'intervalle incluent les éléments suivants :

• Nom de l'opération

• Métadonnées Span

• Tags (tous les tags associés à 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.

Navigation entre Explore et un tableau de bord

Pour accélérer les flux de travail qui impliquent de passer régulièrement d'Explore à un tableau de bord et vice-versa, nous avons ajouté la possibilité de revenir au tableau de bord d'origine après avoir accédé à Explore dans le menu déroulant du panneau.

Après avoir accédé à Explore, vous devriez remarquer un bouton « Retour » dans la barre d'outils Explore.

Le simple fait de choisir le bouton vous ramènera au tableau de bord d'origine ou, si vous souhaitez réintégrer les modifications que vous apportez dans Explore dans le tableau de bord, il vous suffit de cliquer sur la flèche à côté du bouton pour afficher un élément de menu « Retourner au panneau avec les modifications ».

Inspecteur de requêtes

Pour faciliter le débogage des requêtes, Explore vous permet d'étudier les demandes et les réponses aux requêtes, ainsi que les statistiques des requêtes, via l'inspecteur de requêtes. Cette fonctionnalité est similaire à l'onglet Statistiques et à l'onglet Requête de l'inspecteur du panneau. Pour plus d'informations, consultez Inspectez les performances des requêtes et Afficher la demande brute et la réponse à la source de données.