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.
Interrogez et transformez les données
Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge 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
Grafana prend en charge de nombreux types de sources de données. Les requêtes de source de données renvoient des données que Grafana peut transformer et visualiser. Chaque source de données utilise son propre langage de requête, et les plug-ins de source de données implémentent chacun une interface utilisateur de création de requêtes appelée éditeur de requêtes.
À propos des requêtes
Les panneaux Grafana communiquent avec les sources de données via des requêtes, qui récupèrent les données pour la visualisation. Une requête est une question rédigée dans le langage de requête utilisé par la source de données.
Vous pouvez configurer la fréquence des requêtes et les limites de collecte de données dans les options de source de données du panneau. Grafana prend en charge jusqu'à 26 requêtes par panel.
Vous trouverez plus d'informations sur le langage de requête de chaque source de données dans la section Sources de données.
Éditeurs de requêtes
L'éditeur de requêtes de chaque source de données fournit une interface utilisateur personnalisée qui vous permet de rédiger des requêtes qui tirent parti de ses fonctionnalités uniques.
En raison des différences entre les langages de requête, chaque éditeur de requêtes de source de données présente une apparence et un fonctionnement différents. En fonction de votre source de données, l'éditeur de requêtes peut fournir des fonctionnalités de saisie automatique, des noms de métriques, des suggestions de variables ou une interface visuelle de création de requêtes.
Pour plus de détails sur les fonctionnalités uniques de l'éditeur de requêtes d'une source de données spécifique, consultez sa documentation :
-
Pour les sources de données incluses dans Grafana, voir Sources de données intégrées.
-
Pour les sources de données incluses dans l'édition Grafana Enterprise, voir. Connectez-vous aux sources de données de l'entreprise
Syntaxe de requête
Les sources de données utilisent différents langages de requête pour demander des données. Pour plus de détails sur le langage de requête unique d'une source de données spécifique, reportez-vous à sa documentation.
Exemple de PostgreSQL :
SELECT hostname FROM host WHERE region IN($region)
Exemple de ProMQL :
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Sources de données spéciales
Grafana inclut également trois sources de données spéciales : Grafana, Mixed et Dashboard. Pour plus de détails, reportez-vous à la section Sources de données
Naviguez dans l'onglet de requête
L'onglet Requête d'un panneau comprend les éléments suivants :
-
Sélecteur de source de données : sélectionne la source de données à interroger.
-
Options de requête : — Définit les paramètres maximaux de récupération des données et les intervalles d'exécution des requêtes.
-
Bouton de l'inspecteur de requêtes : — Ouvre le panneau de l'inspecteur de requêtes, dans lequel vous pouvez visualiser et optimiser votre requête.
-
Liste de l'éditeur de requêtes : — Répertorie les requêtes que vous avez écrites.
-
Expressions : — Utilise le générateur d'expressions pour créer des expressions d'alerte. Pour plus d’informations sur les expressions, consultez Écrire des requêtes d'expression.
Ajouter une requête
Une requête renvoie des données que Grafana visualise dans les panneaux du tableau de bord. Lorsque vous créez un panneau, Grafana sélectionne automatiquement la source de données par défaut.
Pour ajouter une requête
-
Modifiez le panneau dans lequel vous ajoutez une requête.
-
Choisissez l'onglet Query (Requête).
-
Choisissez le menu déroulant Source de données et sélectionnez une source de données.
-
Choisissez les options de requête pour configurer le nombre maximum de points de données dont vous avez besoin. Pour plus d'informations sur les options de requête, consultezOptions de requête.
-
Rédigez la requête à l'aide de l'éditeur de requêtes.
-
Choisissez Appliquer.
Grafana interroge la source de données et visualise les données.
Gérer les requêtes
Grafana organise les requêtes en lignes de requêtes pliables. Chaque ligne de requête contient un éditeur de requêtes et est identifiée par une lettre (A, B, C, etc.).
Pour gérer vos requêtes, vous pouvez copier des requêtes, masquer des requêtes, supprimer une requête, réorganiser les requêtes et activer l'aide de l'éditeur de requêtes.
Options de requête
Choisissez Options de requête à côté du sélecteur de source de données pour voir les paramètres de la source de données sélectionnée. Les modifications que vous apportez ici concernent uniquement les requêtes effectuées dans ce panneau.
Grafana définit les valeurs par défaut qui sont affichées en texte gris foncé. Les modifications sont affichées en blanc. Pour rétablir les paramètres par défaut d'un champ, supprimez le texte blanc du champ.
Les options de requête de source de données du panneau incluent :
-
Nombre maximal de points de données : si la source de données le prend en charge, cela définit le nombre maximum de points de données pour chaque série renvoyée. Si la requête renvoie plus de points de données que le paramètre maximum de points de données, la source de données réduit le nombre de points renvoyés en les agrégeant par moyenne, par maximum ou par une autre fonction.
Vous pouvez limiter le nombre de points pour améliorer les performances des requêtes ou lisser la ligne visualisée. La valeur par défaut est la largeur (ou le nombre de pixels) du graphique, car vous ne pouvez visualiser que le nombre de points de données que le panneau du graphique peut afficher.
Pour les données en streaming, Grafana utilise la valeur maximale de points de données pour la mémoire tampon mobile. Le streaming est un flux continu de données, et la mise en mémoire tampon divise le flux en plusieurs parties. Par exemple, Loki diffuse des données en mode Live Tailing.
-
Intervalle minimum : définit une limite minimale pour l'intervalle calculé automatiquement, qui est généralement l'intervalle de capture minimum. Si un point de données est enregistré toutes les 15 secondes, vous n'avez aucun avantage à avoir un intervalle inférieur à ce chiffre. Vous pouvez également définir ce paramètre sur un minimum supérieur à l'intervalle de capture pour récupérer des requêtes plus grossières et plus performantes.
-
Intervalle — Définit un intervalle de temps que vous pouvez utiliser pour agréger ou regrouper des points de données par temps.
Grafana calcule automatiquement un intervalle approprié que vous pouvez utiliser comme variable dans les requêtes modélisées. La variable est mesurée en secondes (
$__interval) ou en millisecondes ().$__interval_msLes intervalles sont généralement utilisés dans les fonctions d'agrégation telles que la somme ou la moyenne. Par exemple, il s'agit d'une requête Prometheus qui utilise la variable d'intervalle :.
rate(http_requests_total[$__interval])Cet intervalle automatique est calculé en fonction de la largeur du graphique. Lorsque l'utilisateur effectue un zoom arrière sur une visualisation, l'intervalle augmente, ce qui donne lieu à une agrégation plus grossière. De même, si l'utilisateur zoome, l'intervalle diminue, ce qui permet une agrégation plus fine.
Pour plus d’informations, consultez Variables globales.
-
Temps relatif : remplace la plage de temps relative des différents panneaux, ce qui les rend différents de ceux sélectionnés dans le sélecteur de temps du tableau de bord situé dans le coin supérieur droit du tableau de bord. Vous pouvez l'utiliser pour afficher les statistiques de différentes périodes ou de différents jours sur le même tableau de bord.
Note
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.
Exemple Champ temporel relatif Les 5 dernières minutes
now-5mJusqu'à présent
now/dLes 5 derniers jours
now-5d/dJusqu'à présent cette semaine
now/wLes 2 dernières années
now-2y/y -
Décalage horaire : remplace la plage de temps de chaque panneau en décalant son début et sa fin par rapport au sélecteur de temps. Par exemple, vous pouvez modifier la plage horaire du panneau pour qu'elle soit deux heures plus tôt que celle du sélecteur d'heure du tableau de bord.
Note
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.
Exemple Champ de décalage horaire Toute la semaine dernière
1w/wIl y a deux semaines entières
2w/wTout le mois dernier
1M/MToute cette année
1d/yToute l'année dernière
1y/y -
Délai d'expiration du cache — (visible uniquement s'il est disponible dans la source de données) Remplace le délai d'expiration du cache par défaut si votre magasin de séries chronologiques possède un cache de requêtes. Spécifiez cette valeur sous forme de valeur numérique en secondes.
