Connexion à Grafana
Ce guide montre comment connecter Grafana à DataHub pour visualiser les données télématiques et de flotte. Grafana offre des capacités de visualisation avancées pour surveiller l'état des véhicules, les données des capteurs et autres métriques en temps réel.
Regardez une courte vidéo de présentation pour voir ce qui est possible avec la combinaison DataHub+Grafana (disponible en anglais et en espagnol) :
Fonctionnalités du tableau de bord
Visualisation des données des capteurs en temps réel
Analyse des séries temporelles avec plages temporelles personnalisables
Filtrage dynamique à l'aide de variables
Prise en charge de multiples sources de données
Graphiques et diagrammes interactifs
Création de requêtes personnalisées avec SQL
Exigences techniques
Grafana 9.3 ou version ultérieure
Plugin Source de données PostgreSQL (inclus par défaut)
Accès Internet pour la connexion à la base de données
Instance DataHub active avec identifiants de connexion
Installation et configuration
Grafana doit être installé sur votre système avant de pouvoir le connecter à DataHub.
Installer Grafana
Téléchargez et installez Grafana depuis le site officiel : https://grafana.com/grafana/download
Suivez les instructions d'installation correspondant à votre système d'exploitation.
Télécharger des modèles de tableaux de bord (facultatif)
Des modèles de tableaux de bord préconçus sont disponibles pour vous aider à démarrer rapidement sans créer de visualisations depuis zéro. Ces modèles sont maintenus dans le dépôt bi-intergrations sous le dossier grafana Vous pouvez cloner le dépôt pour accéder à des tableaux de bord prêts à l'emploi :
Vérifiez le dossier grafana dossier pour les fichiers JSON de tableaux de bord disponibles.
Connexion à la base de données
La section Connections dans Grafana est l'endroit où vous gérez toutes les intégrations de sources de données. DataHub fonctionne sur PostgreSQL, vous devrez donc ajouter une source de données PostgreSQL pour permettre à Grafana d'interroger vos données télématiques.
Ajouter une source de données PostgreSQL
Le plugin source de données PostgreSQL est préinstallé avec Grafana et offre un support natif pour la connexion aux bases de données PostgreSQL.
Pour ajouter la source de données :
Dans la section Connections, recherchez PostgreSQL
Cliquez Add new data source
La page de configuration PostgreSQL s'ouvrira
Configurer les paramètres de connexion
Les détails de connexion à votre DataHub contiennent toutes les informations nécessaires pour établir une connexion sécurisée. Ces paramètres sont uniques à votre instance et garantissent que Grafana peut accéder à vos données télématiques.
Localisez vos paramètres de connexion dans votre compte Navixy et dans l'e-mail de bienvenue DataHub.
Référence des paramètres de connexion
Host
Host
Adresse du serveur de base de données fournie dans les détails de connexion DataHub
Port
Port
Par défaut 5432 pour PostgreSQL
Database name
Database
Le nom de base de données qui vous a été attribué
Username
User
Votre nom d'utilisateur de base de données (appelé « database user » dans les détails de connexion)
Password
Password
Votre mot de passe de base de données sécurisé
SSL mode
SSL Mode
Définir sur require pour des connexions sécurisées
Version PostgreSQL
Version
Sélectionnez 9.3 (paramètre recommandé)
Configurer des paramètres supplémentaires
Au-delà des paramètres de connexion essentiels, Grafana propose des options de configuration supplémentaires. Pour la plupart des utilisateurs, les valeurs par défaut sont appropriées et fonctionneront correctement sans modification. Vous pouvez ajuster ces paramètres ultérieurement en fonction des exigences de sécurité de votre organisation, des contraintes d'infrastructure ou des besoins spécifiques de votre équipement.
Laissez tous les autres champs aux valeurs par défaut pour la configuration initiale. Vous n'avez pas besoin d'activer d'interrupteurs ou de bascules supplémentaires.
Tester la connexion
Tester la connexion avant l'enregistrement garantit que tous les paramètres sont corrects et que Grafana peut communiquer avec succès avec votre instance DataHub.
Pour vérifier et enregistrer :
Donnez un nom à votre connexion avec un identifiant descriptif (par exemple, « DataHub Production » ou « Fleet Analytics »)
Cliquez Save & Test pour vérifier votre connexion
Un message de succès vert indique que la connexion fonctionne correctement
Créer votre première visualisation
Créer votre première visualisation vous aide à comprendre comment Grafana interroge DataHub et affiche les données télématiques. Ce processus implique la création d'un tableau de bord, l'ajout d'un panneau, la configuration d'une requête et la sélection d'un format de visualisation approprié.
Créer un nouveau tableau de bord
Les tableaux de bord dans Grafana servent de conteneurs pour plusieurs visualisations. Créer un tableau de bord dédié vous aide à organiser les visualisations liées et fournit un emplacement central pour la surveillance d'aspects spécifiques de vos opérations de flotte.
Pour créer un tableau de bord :
Accédez à Dashboards dans la barre latérale gauche
Cliquez Create Dashboard
Sélectionnez Ajouter une visualisation
Choisissez la source de données PostgreSQL que vous venez de configurer
Configurer la requête
Grafana propose deux modes de requête : un Builder visuel et un éditeur de code. Pour les connexions DataHub, l'éditeur de code vous donne un contrôle total sur les requêtes SQL et est recommandé pour l'analyse des données télématiques.
Pour rédiger votre requête :
Dans l'éditeur de requête, passez de Builder à Code mode
Saisissez votre requête SQL directement
Exemple de requête pour la visualisation des données de capteur :
La requête inclut une composante temporelle (device_time AS time) qui est essentielle pour les visualisations en séries temporelles. La $__timeFilter() fonction est une macro Grafana qui applique automatiquement la plage temporelle sélectionnée du tableau de bord à votre requête.
Pour plus d'exemples de requêtes, référez-vous au SQL Recipe Book.
Définir le format de visualisation
Le format de visualisation détermine l'apparence de vos données sur le tableau de bord. Différents formats conviennent à différents types de données : les séries temporelles sont adaptées aux relevés de capteurs au fil du temps, tandis que les tables conviennent mieux aux enregistrements détaillés.
Pour configurer le format :
Cliquez Exécuter la requête pour vérifier que votre requête renvoie des données
Localisez le sélecteur de type de visualisation (généralement en haut à droite du panneau)
Changez le format de Table à Time series ou votre format préféré
Observez l'affichage des données pour vous assurer qu'elles apparaissent correctement
Les visualisations en séries temporelles nécessitent une colonne temporelle et des valeurs numériques pour fonctionner correctement. Votre requête doit renvoyer des données au format approprié pour le type de visualisation sélectionné.
Enregistrez votre visualisation
Enregistrer votre travail préserve la configuration de la visualisation et la rend disponible pour référence ultérieure. Sauvegarder régulièrement est important : Grafana n'enregistre pas automatiquement les modifications, vous pourriez donc perdre votre travail si vous quittez sans enregistrer.
Pour enregistrer une visualisation :
Cliquez Save
Fournissez un nom descriptif pour votre tableau de bord
Sélectionnez ou créez un dossier pour l'organisation
Confirmez l'opération d'enregistrement
Le tableau de bord est désormais disponible dans votre instance Grafana et peut être consulté via le menu Dashboards.
Travailler avec les variables
Les variables sont l'une des fonctionnalités les plus puissantes de Grafana pour créer des tableaux de bord dynamiques et interactifs. Plutôt que de coder en dur des valeurs spécifiques comme des noms de capteurs ou des ID d'appareil dans vos requêtes, les variables permettent aux utilisateurs de sélectionner différentes valeurs depuis des menus déroulants sans modifier le SQL sous-jacent. Cela rend les tableaux de bord plus flexibles et plus faciles à utiliser.
Accéder aux paramètres des variables
Les variables sont configurées au niveau du tableau de bord et s'appliquent à toutes les visualisations de ce tableau de bord. Vous devez accéder aux paramètres du tableau de bord pour créer et gérer les variables.
Pour commencer :
Ouvrez votre tableau de bord
Cliquez sur le Settings icône (icône d'engrenage) en haut à droite
Naviguez vers la section Variables dans le panneau de gauche
La section sera vide si aucune variable n'a encore été créée
Configurer une variable
Chaque variable nécessite un nom, une source de données et une requête qui renvoie les valeurs possibles que les utilisateurs peuvent sélectionner. Les valeurs des variables sont peuplées dynamiquement en interrogeant votre instance DataHub.
Pour créer une variable :
Cliquez Add variable
Configurez les paramètres suivants :
Paramètres généraux :
Name:
sensor_name(utilisez un identifiant clair et descriptif sans espaces)Label: Identique au nom pour la cohérence, c'est ce que voient les utilisateurs sur le tableau de bord
Type: Sélectionnez Query pour remplir les valeurs depuis la base de données
Options de requête :
Data source: Sélectionnez votre connexion PostgreSQL DataHub dans la liste déroulante
Query: Saisissez une requête SQL pour remplir les valeurs de la variable
Exemple de requête pour lister tous les capteurs d'un appareil spécifique :
Après avoir saisi la requête, Grafana l'exécute immédiatement et affiche un aperçu des valeurs renvoyées en bas de la page de configuration. Cela confirme que votre requête fonctionne correctement et montre quelles options seront disponibles dans le menu déroulant.
Appliquer les variables dans les requêtes
Une fois qu'une variable est créée, vous devez mettre à jour vos requêtes de visualisation pour la référencer. Les variables utilisent une syntaxe spéciale avec un préfixe dollar, et Grafana substitue automatiquement la valeur sélectionnée lors de l'exécution des requêtes.
Pour utiliser la variable :
Ouvrez la visualisation que vous souhaitez rendre dynamique
Modifiez la requête
Remplacez la valeur codée en dur par la référence à la variable
Exemple de requête mise à jour utilisant la variable :
Remarquez comment 'temperature' a été remplacé par '$sensor_name'. Les guillemets sont importants pour les valeurs de type chaîne en SQL.
Enregistrer et tester
Tester la variable garantit qu'elle fonctionne correctement et met à jour les visualisations comme prévu. Veillez à enregistrer votre travail à chaque étape pour éviter de perdre des modifications de configuration.
Pour terminer la configuration :
Cliquez Apply pour enregistrer la configuration de la variable
Cliquez Save dashboard pour préserver toutes les modifications
Revenir à la vue principale du tableau de bord
Localisez le menu déroulant de la variable en haut du tableau de bord
Sélectionnez différents noms de capteurs dans le menu déroulant
Observez que la visualisation se met à jour automatiquement avec les données du capteur sélectionné
Si la visualisation ne se met pas à jour lorsque vous changez la sélection de la variable, vérifiez que le nom de la variable dans votre requête correspond exactement au nom de la variable créé (les noms de variables sont sensibles à la casse).
Importer des tableaux de bord préconçus
Les tableaux de bord préconçus offrent un moyen rapide de commencer à visualiser vos données sans tout construire depuis zéro. Ces tableaux de bord sont conçus par des utilisateurs expérimentés et incluent des bonnes pratiques pour la visualisation, la mise en page et l'optimisation des requêtes. Cependant, ils nécessitent une configuration pour se connecter à votre instance DataHub spécifique.
Accéder à la fonction d'importation
La fonction d'importation de Grafana vous permet de charger des configurations de tableaux de bord depuis des fichiers JSON ou directement depuis Grafana.com en utilisant des ID de tableau de bord.
Accédez à Dashboards
Cliquez New → Import
Une fenêtre de téléchargement apparaîtra
Importer le tableau de bord
Le processus d'importation accepte des configurations de tableau de bord dans plusieurs formats, ce qui vous donne de la flexibilité dans la façon de charger des tableaux de bord préconçus.
Vous pouvez importer des tableaux de bord en utilisant :
ID du tableau de bord depuis Grafana.com
Fichier JSON téléchargé depuis le dépôt bi-intergrations
Modèle JSON collé directement
Si vous utilisez un fichier JSON :
Cliquez Téléverser le fichier JSON
Sélectionnez le fichier du tableau de bord
Fournissez un nom et sélectionnez le dossier de destination
Cliquez Import
Attendez que le modèle de tableau de bord ait fini de se télécharger. Une fois terminé, le tableau de bord apparaîtra, mais il n'affichera pas encore de données car il est toujours connecté à la source de données d'origine utilisée lors de la création du modèle.
Mettre à jour les connexions des sources de données
Ceci est une étape critique. Les tableaux de bord importés sont initialement connectés à des sources de données externes qui n'ont pas accès à vos données DataHub. Vous devez mettre à jour chaque visualisation pour utiliser votre connexion PostgreSQL DataHub.
Pour mettre à jour les visualisations :
Ouvrez le tableau de bord importé
Cliquez Edit sur le premier panneau de visualisation (recherchez l'icône d'édition ou le menu à trois points)
Dans l'éditeur de requête, localisez le sélecteur de source de données
Changez la source de données de la source d'origine du modèle vers votre connexion PostgreSQL DataHub
Cliquez Exécuter la requête pour vérifier que la visualisation récupère les données avec succès
Cliquez Save pour préserver les modifications
Répétez ce processus pour chaque panneau de visualisation du tableau de bord
Mettre à jour les variables du tableau de bord
De nombreux tableaux de bord préconçus utilisent des variables pour le filtrage et l'interactivité. Ces variables sont également connectées à la source de données d'origine et doivent être mises à jour pour interroger votre instance DataHub.
Pour mettre à jour les variables :
Ouvrez Settings → Variables
Vous verrez une liste de toutes les variables utilisées dans le tableau de bord
Cliquez Edit sur la première variable
Localisez le Data source menu déroulant dans la section Options de requête
Changez-le pour votre connexion PostgreSQL DataHub
Vérifiez que l'aperçu en bas affiche les valeurs attendues de votre base de données
Cliquez Apply pour confirmer les modifications
Répétez pour chaque variable de la liste
Après avoir mis à jour toutes les variables, enregistrez à nouveau le tableau de bord. Les variables devraient désormais se remplir avec des valeurs provenant de votre instance DataHub.
Vérifier le fonctionnement du tableau de bord
Une fois que vous avez mis à jour toutes les visualisations et variables, vérifiez que tout fonctionne correctement ensemble. Cette vérification finale garantit que le tableau de bord est entièrement fonctionnel et prêt à une utilisation régulière.
Pour vérifier :
Enregistrez le tableau de bord une dernière fois en utilisant Ctrl+S ou le Save bouton
Actualisez complètement la page du navigateur (ou utilisez F5)
Vérifiez que toutes les visualisations affichent correctement des données
Testez chaque menu déroulant de variable pour vous assurer qu'il se remplit avec des valeurs
Sélectionnez différentes valeurs de variables et confirmez que les visualisations se mettent à jour en conséquence
Essayez différentes plages temporelles à l'aide du sélecteur de temps
Si certaines visualisations restent vides ou affichent des erreurs, revenez en mode édition et vérifiez la source de données et la configuration des requêtes pour ces panneaux spécifiques.
Dépannage
Problèmes de connexion à la base de données
Erreur de connexion: Vérifiez que les identifiants et les paramètres de connexion correspondent exactement à vos informations DataHub. Vérifiez que l'hôte, le port, le nom de la base de données, le nom d'utilisateur et le mot de passe sont corrects.
Erreur de pare-feu: Assurez-vous que votre réseau autorise les connexions vers l'hôte et le port spécifiés. Contactez votre administrateur réseau si les tentatives de connexion sont bloquées.
Erreur SSL/TLS: Vérifiez que le mode SSL est défini sur require et que votre instance Grafana prend en charge les connexions SSL.
Problèmes de requête et de visualisation
Visualisation vide: Tout d'abord, vérifiez que la requête renvoie effectivement des données en vérifiant l'inspecteur de requête (cliquez sur le bouton "Query inspector" dans l'éditeur de panneau). Assurez-vous que la plage temporelle sélectionnée inclut des périodes où des données existent dans votre base. Confirmez que la source de données est correctement sélectionnée et connectée. Vérifiez que les noms de tables et de colonnes dans votre requête correspondent à la structure réelle du schéma.
Variable ne fonctionnant pas: Vérifiez que la requête de la variable renvoie des valeurs en vérifiant l'aperçu dans la page de configuration de la variable. Assurez-vous que la référence à la variable dans votre requête utilise la syntaxe correcte ($variable_name) sans fautes de frappe. Vérifiez que la variable est correctement enregistrée et appliquée au tableau de bord. Si le menu déroulant de la variable est vide, examinez la requête SQL de la variable pour détecter des erreurs.
Performances lentes des requêtes: Envisagez d'ajouter des index de base de données aux colonnes fréquemment interrogées telles que device_time et device_id. Limitez les plages de données en utilisant des filtres temporels de manière plus restrictive. Optimisez la structure des requêtes en sélectionnant uniquement les colonnes nécessaires au lieu d'utiliser SELECT *. Reportez-vous au SQL Recipe Book pour des exemples d'optimisation des performances et des modèles de requêtes éprouvés.
Incompatibilité de format: Assurez-vous que votre requête renvoie des données dans le format attendu par votre type de visualisation. Les panneaux de séries temporelles exigent une colonne aliasée en tant que time et des colonnes de valeurs numériques. Les panneaux Table acceptent n'importe quelle structure de colonnes. Les panneaux Graph nécessitent des données temporelles et numériques. Consultez la documentation Grafana pour les exigences spécifiques de chaque type de visualisation.
Problèmes d'importation
Données manquantes après importation: Vérifiez que les connexions aux sources de données sont mises à jour pour tous les panneaux et variables. Ne sautez aucun panneau lors du processus de mise à jour. Vérifiez que les noms de schéma (raw_business_data ou raw_telematics_data) spécifiés dans les requêtes sont corrects pour votre instance DataHub. Assurez-vous que les noms de tables et de colonnes correspondent à la structure réelle de votre base de données.
Le tableau de bord affiche des erreurs: Ouvrez l'éditeur de requête de chaque panneau et cliquez sur "Query inspector" pour voir les messages d'erreur détaillés. Examinez attentivement les messages d'erreur — ils indiquent souvent des problèmes spécifiques tels que des colonnes manquantes, des types de données incorrects ou des erreurs de syntaxe. Assurez-vous que les noms de champs dans les requêtes correspondent exactement à votre schéma DataHub (les noms de champs sont sensibles à la casse). Vérifiez que les types de données renvoyés par les requêtes sont compatibles avec le type de visualisation.
Variables ne se remplissant pas: Vérifiez que vous avez mis à jour la source de données pour chaque variable, pas uniquement pour les panneaux de visualisation. Vérifiez que les requêtes de variables sont syntaxiquement correctes et renvoient des données lorsqu'elles sont exécutées directement. Assurez-vous que le type de variable est défini sur "Query" plutôt que "Custom" ou d'autres types.
Étapes suivantes
Après avoir connecté avec succès Grafana à votre instance DataHub :
Explorez les schémas de données disponibles en consultant la Aperçu du schéma pour comprendre la structure des données, les relations entre les tables et les champs disponibles.
Commencez par des requêtes simples centrées sur des entités métier spécifiques avant de créer des tableaux de bord complexes ; cela vous aide à apprendre la structure des données et à éviter les problèmes de performances.
Consultez le SQL Recipe Book pour des modèles de requêtes éprouvés et des techniques d'optimisation, ainsi que des exemples de scénarios d'analyse télématique courants
Expérimentez différents types de visualisation (séries temporelles, tables, jauges, panneaux stat) pour trouver la meilleure représentation pour vos données et cas d'utilisation spécifiques
Envisagez de créer plusieurs tableaux de bord pour différents usages : surveillance en temps réel, analyse historique, résumés exécutifs et rapports opérationnels.
Support
Pour des questions techniques ou de l'aide concernant les connexions DataHub, contactez le support à [email protected].
Mis à jour
Ce contenu vous a-t-il été utile ?