Requêtes - Amazon Managed Grafana
Éditeurs de requêtesSyntaxe de requêteInterface utilisateur de l'onglet RequêtePartage des résultats de requêtes entre les panneaux

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.

Requêtes

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

Les panneaux de l'espace de travail Grafana utilisent des requêtes pour communiquer avec les sources de données afin d'obtenir des données pour la visualisation. Une requête est une question écrite dans le langage de requête utilisé par la source de données. Si la requête est correctement formée, la source de données répond. Dans les options de source de données du panneau, vous pouvez ajuster la fréquence à laquelle la requête est envoyée à la source de données et le nombre de points de données collectés.

Les espaces de travail Grafana prennent en charge jusqu'à 26 requêtes par panneau.

Éditeurs de requêtes

Les éditeurs de requêtes sont des formulaires qui vous aident à rédiger des requêtes. En fonction de votre source de données, l'éditeur de requêtes peut fournir une complétion automatique, des noms de métriques ou des suggestions de variables.

En raison des différences entre les langages de requête, les sources de données peuvent avoir des éditeurs de requêtes d'apparence différente.

Syntaxe de requête

Les sources de données utilisent des langages de requête et des syntaxes différents pour demander les données. Voici deux exemples de requêtes.

PostgreSQL 


SELECT hostname FROM host WHERE region IN($region)

ProMQL 


query_result(max_over_time(<metric>[${__range_s}s]) != <state>)

Pour plus d'informations sur la rédaction d'une requête pour votre source de données, consultez la documentation de cette source de données. Les sources de données sont répertoriées dansConnexion aux sources de données.

Interface utilisateur de l'onglet Requête

L'onglet Requête comprend les éléments suivants :

  • Sélecteur de source de données

  • Options de requête

  • Bouton de l'inspecteur de requêtes

  • Liste de l'éditeur de requêtes

Sélecteur de source de données

Le sélecteur de source de données est une liste déroulante. Sélectionnez-le pour sélectionner une source de données que vous avez ajoutée. Lorsque vous créez un panneau, Amazon Managed Grafana sélectionne automatiquement votre source de données par défaut. Pour plus d'informations sur les sources de données, consultezConnexion aux sources de données.

Outre les sources de données que vous avez configurées dans votre espace de travail Grafana, trois sources de données spéciales sont disponibles.

  • TestDataDB — Source de données intégrée qui génère des données de marche aléatoires. La source de données Grafana est utile pour tester des visualisations et exécuter des expériences.

  • Mixte : source de données permettant d'interroger plusieurs sources de données dans le même panneau. Lorsque cette source de données est sélectionnée, vous pouvez sélectionner une source de données pour chaque nouvelle requête que vous ajoutez.

    • La première requête utilisera la source de données sélectionnée avant que vous ne sélectionniez Mixed.

    • Vous ne pouvez pas modifier une requête existante pour utiliser la source de données mixte.

  • Tableau de bord : source de données permettant d'utiliser un ensemble de résultats provenant d'un autre panneau du même tableau de bord.

Options de requête

Pour voir les paramètres de la source de données sélectionnée, choisissez Options de requête à côté du sélecteur de source de données. Les modifications que vous apportez ici concernent uniquement les requêtes effectuées dans ce panneau.

Amazon Managed Grafana définit les valeurs par défaut qui sont affichées en 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.

Vous pouvez utiliser les options de requête de source de données du panneau suivantes :

  • Nombre maximal de points de données : si la source de données le prend en charge, définit le nombre maximal 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 les consolide (réduit le nombre de points renvoyés en les agrégeant par moyenne, maximum ou autre fonction).

    Deux raisons principales justifient de limiter le nombre de points : les performances et le lissage de la ligne. La valeur par défaut est la largeur (ou le nombre de pixels) du graphique, ce qui permet d'éviter d'avoir plus de points de données que ce que le panneau graphique peut afficher.

    Dans le cas des données en streaming, la valeur maximale des points de données est utilisée pour la mémoire tampon mobile. (Le streaming est un flux continu de données, et la mise en mémoire tampon est un moyen de diviser le flux en morceaux).

  • Intervalle minimum — Définit une limite minimale pour l'intervalle calculé automatiquement, généralement l'intervalle de capture minimum. Si un point de données est enregistré toutes les 15 secondes, il n'est pas nécessaire d'avoir un intervalle inférieur à cet intervalle. Un autre cas d'utilisation consiste à le définir sur un minimum supérieur à l'intervalle de capture pour obtenir des requêtes plus grossières et plus efficaces.

  • Intervalle : intervalle de temps que vous pouvez utiliser pour agréger ou regrouper des points de données par temps.

    Amazon Managed Grafana calcule automatiquement un intervalle approprié qui peut être utilisé comme variable dans les requêtes modélisées. La variable est soit en secondes : $__interval ; soit en millisecondes :. $__interval_ms Il est généralement utilisé dans des fonctions d'agrégation telles que sum ouaverage. Par exemple, il s'agit d'une requête Prometheus utilisant la variable d'intervalle :. rate(http_requests_total[$__interval])

    Cet intervalle automatique est calculé en fonction de la largeur du graphique. Si l'utilisateur effectue un zoom arrière important, l'intervalle augmente, ce qui donne une agrégation plus grossière. 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 pour les différents panneaux, ce qui les rend différents de ce qui est sélectionné dans le sélecteur de temps du tableau de bord situé dans le coin supérieur droit du tableau de bord. Cela vous permet d'afficher les statistiques de différentes périodes ou de différents jours sur le même tableau de bord.

  • Décalage horaire — Fournit un autre moyen de modifier la plage de temps pour les panneaux individuels. Cette fonction fonctionne uniquement avec des plages de temps relatives, et vous pouvez ajuster la plage de temps.

    Par exemple, vous pouvez modifier la plage horaire du panneau de manière à ce qu'elle soit 2 heures plus tôt que le sélecteur d'heure du tableau de bord. Pour plus d’informations, consultez Contrôles de plage de temps.

  • Délai d'expiration du cache — (Ce champ n'est visible que s'il est disponible dans votre 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. Elle est spécifiée sous forme de valeur numérique en secondes.

Bouton de l'inspecteur de requêtes

Vous pouvez choisir l'inspecteur de requêtes pour ouvrir l'onglet Requête de l'inspecteur du panneau. Dans l'onglet Requête, vous pouvez voir la demande de requête envoyée par le panneau et la réponse.

Choisissez Actualiser pour voir le texte intégral de la demande envoyée par ce panneau au serveur.

Note

Vous devez ajouter au moins une requête avant que l'inspecteur de requêtes puisse renvoyer des résultats.

Pour plus d'informations sur l'inspecteur de panneau, voirInspecter un panneau.

Liste de l'éditeur de requêtes

Dans l'interface utilisateur, les requêtes sont organisées 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.).

Partage des résultats de requêtes entre les panneaux

Avec Amazon Managed Grafana, vous pouvez utiliser le résultat de la requête d'un panneau pour n'importe quel autre panneau du tableau de bord. Le partage des résultats des requêtes entre les panneaux réduit le nombre de requêtes adressées à votre source de données, ce qui peut améliorer les performances de votre tableau de bord.

La source de données du tableau de bord vous permet de sélectionner un panneau de votre tableau de bord contenant les requêtes pour lesquelles vous souhaitez partager les résultats. Au lieu d'envoyer une requête distincte pour chaque panneau, Amazon Managed Grafana envoie une requête, et les autres panneaux utilisent les résultats de la requête pour créer des visualisations.

Cette stratégie permet de réduire considérablement le nombre de requêtes effectuées lorsque, par exemple, plusieurs panneaux visualisent les mêmes données.

Pour partager des requêtes de source de données avec un autre panneau

  1. Créez un tableau de bord. Pour plus d’informations, consultez Créer un tableau de bord.

  2. Ajoutez un panneau. Pour plus d’informations, consultez Ajouter un panneau.

  3. Changez le titre enSource panel. Vous allez utiliser ce panneau comme source pour les autres panneaux. Définissez la ou les requêtes qui seront partagées. Si aucune source de données n'est disponible pour le moment, vous pouvez utiliser la source de données Grafana, qui renvoie une série chronologique aléatoire que vous pouvez utiliser pour les tests.

  4. Ajoutez un deuxième panneau, puis sélectionnez la source de données du tableau de bord dans l'éditeur de requêtes.

  5. Dans Utiliser les résultats de la liste des panneaux, sélectionnez le premier panneau que vous avez créé.

Toutes les requêtes définies dans le panneau source sont désormais disponibles dans le nouveau panneau. Les requêtes effectuées dans le panneau source peuvent être partagées avec plusieurs panneaux.

Pour accéder à un panneau dans lequel une requête est définie, sélectionnez cette requête.