Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Exemple : Configuration de Grafana en tant qu’outil de reporting

Présentation

Cette section décrit comment interroger les métriques dans Control Center à l’aide de Grafana.

Grafana est un outil logiciel de visualisation et d’analyse open source qui vous permet d’interroger, de visualiser, d’alerter et d’explorer les mesures stockées dans une base de données chronologique à l’aide de tableaux et de graphiques.

Remarque :

Ce chapitre nécessite une instance en cours d’exécution de Grafana. Vous pouvez le télécharger à partir de grafana.com/grafana/download et l’installer en suivant les instructions sur cette page.

Grafana vous permet de créer des tableaux de bord personnalisés avec plusieurs panneaux. Chaque panneau utilise une source de données et exécute une requête sur la source de données. La requête est définie à l’aide d’un éditeur de requête spécifique à la source de données sélectionnée ; De plus, l’éditeur de requête gère les options de visualisation du panneau.

Configuration de la source de données

Une fois Grafana exécuté, l’étape suivante consiste à définir une source de données pour TimescaleDB afin que Grafana puisse effectuer des requêtes sur les métriques. Dans le chapitre Préparatifs, la section Connexion à TimescaleDB vous demande de configurer le tunneling SSH en plus des paramètres de connexion à la base de données. Dans Grafana, la configuration du tunneling SSH et la connexion à la base de données se font en deux phases distinctes, comme décrit dans les sections suivantes.

Configuration du tunnel SSH

Compte tenu de ce qui suit :

  • <Control Center IP/FQDN>, l’adresse IP ou le nom de domaine complet du nœud sur lequel le centre de contrôle est exécuté, et
  • 7432, le port de la base de données que TimescaleDB écoute,

le tunnel SSH entre les serveurs Grafana et TimescaleDB peut être défini comme suit :

  • Ouvrez une fenêtre de terminal sur le serveur sur lequel Grafana est installé.
  • Installez le openssh-server package.
  • Copiez la clé publique du centre de contrôle, key.pub, sur <path_to_key_pub>le serveur Grafana.

  • Exécutez cette commande pour configurer la redirection de port SSH en arrière-plan :

    où <os_user> se trouve l’utilisateur du système d’exploitation dans le serveur TimescaleDB et <local_port> est le port du serveur Grafana qui transfère le trafic vers le port d’écoute TimescaleDB.

Le tunnel SSH est maintenant défini et il est possible de définir TimescaleDB comme source de données dans Grafana.

Définition de la source de données dans Grafana

Une fois le tunnel SSH actif, l’étape suivante consiste à définir une source de données pour TimescaleDB afin que Grafana puisse effectuer des requêtes sur les métriques.

  1. Ouvrez votre navigateur Web et accédez à http://<Grafana host IP/FQDN>:3000/. Ici, 3000 est le port HTTP que Grafana écoute par défaut, et <Grafana host IP/FQDN> fait référence à l’IP ou au nom de domaine complet du nœud où Grafana est installé.
  2. Sur la page de connexion, entrez les informations d’identification de l’utilisateur administrateur.
  3. Cliquez sur le symbole de configuration (roue dentée) à gauche. Dans l’onglet Sources de données , cliquez sur le bouton Ajouter une source de données . Recherchez « Postgres » et cliquez sur Sélectionner.

  4. Remplissez le formulaire de source de données PostgreSQL comme indiqué dans l’image ci-dessous. Dans ce cas, le nom de la source de données utilisé dans les étapes suivantes est « Base de données de métriques » et la valeur de <local_port> est 9432.

    Configuration screen for PostgreSQL data source setup with host 127.0.0.1:9432, database paa-metrics, user paaread, TLS/SSL mode disable, TimescaleDB enabled, and connection limits specified.

  5. Une fois que vous avez terminé, cliquez sur Enregistrer et tester.

Création d’un tableau de bord

  1. Dans la barre latérale, cliquez sur le signe plus, puis sur Tableau de bord et enfin sur Ajouter un panneau vide.
  2. Dans la vue Nouveau tableau de bord/Panneau Modifier , accédez à l’onglet Requête .
  3. Configurez votre requête en sélectionnant « Base de données de métriques » dans le sélecteur de source de données.
  4. Cliquez sur Modifier SQL pour fournir une requête en SQL brut.

  5. Dans le champ de texte qui s’affiche, entrez une requête au format similaire à celle ci-dessous pour un moniteur HTTP nommé « Stream 1 ». Notez comment les délimiteurs d’intervalle sont remplacés par les macros $__timeFrom() Grafana et $__timeTo(). (D’autres macros Grafana pour PostgreSQL sont disponibles ici : grafana.com/grafana/download)

  6. Cliquez sur le bouton Inspecteur de requête pour valider. Ensuite, dans le panneau de droite, dans l’onglet Requête , cliquez sur le bouton Actualiser . Les données seront visualisées dans le panneau et, au-dessus du graphique, vous pourrez ajuster l’intervalle de temps à analyser.
  7. Cliquez sur l’icône Enregistrer dans le coin supérieur droit de l’écran pour enregistrer le tableau de bord.
  8. Ajoutez un nom descriptif, puis cliquez sur Enregistrer.