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.
Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.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 8.x de Grafana, voir. Travailler dans la version 8 de Grafana
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 aux tâches de l'inspecteur du panneau : inspecter les performances des requêtes et inspecter les données des demandes et des réponses aux requêtes.
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 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
L'historique des requêtes vous permet de consulter l'historique de vos requêtes. Pour chaque requête individuelle, vous pouvez :
-
Exécuter une requête.
-
Créez et/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.
-
Ajoutez une requête à la liste des favoris.
Gérer les requêtes favorites
Toutes les requêtes qui ont été marquées dans l'onglet Historique des requêtes sont affichées dans la liste des requêtes marquées d'un favori. 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
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
-
Sélectionnez le champ Trier les requêtes par.
-
Sélectionnez l’une des options suivantes :
-
Le plus récent en premier
-
Le plus vieux d'abord
-
Filtrer l'historique des requêtes
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.
Filtrer l'historique vers une source de données
-
Sélectionnez le champ Filtrer les requêtes pour des sources de données spécifiques.
-
Sélectionnez la source de données pour laquelle vous souhaitez filtrer votre historique. Vous pouvez sélectionner plusieurs sources de données.
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 supérieure.
-
Ajustez la date de fin en faisant glisser la poignée supérieure.
Recherche dans l'historique des requêtes
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
-
Sélectionnez le champ Requêtes de recherche.
-
Entrez le terme que vous recherchez dans le champ de recherche.
Paramètres de l'historique des requêtes
Vous pouvez personnaliser l'historique des requêtes dans l'onglet Paramètres. Les options sont décrites dans le tableau ci-dessous.
| 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é.
Caractéristiques spécifiques à Prometheus
Explore propose une expérience de requête personnalisée pour Prometheus. Lorsqu'une requête est exécutée, elle 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. C'est un bon point de départ si vous souhaitez simplement découvrir quelles mesures sont disponibles.
Champ de requête
Le champ Query prend en charge la saisie semi-automatique pour les noms et les fonctions des métriques, comme dans l'éditeur de requêtes Prometheus standard. Vous pouvez appuyer sur la touche Entrée pour créer une nouvelle ligne et sur Shift+Enter pour exécuter une requête.
Le menu de saisie semi-automatique peut être déclenché 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 de requête. Sélectionnez-les pour mettre à jour votre requête avec les modifications suggérées.
-
Pour les compteurs (métriques augmentant de façon monotone), une fonction de taux sera suggérée.
-
Pour les buckets, une fonction d'histogramme sera suggérée.
-
Pour les règles d'enregistrement, il est possible d'étendre les règles.
Filtres de table
Sélectionnez le bouton de filtre dans la colonne d'étiquette d'un panneau 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.
