# Connexion à Grafana Ce guide montre comment connecter Grafana à **Requête IoT** pour visualiser les données télématiques et de flotte. Grafana offre de puissantes capacités de visualisation pour surveiller l'état des véhicules, les données des capteurs et d'autres indicateurs en temps réel. {% hint style="info" %} Ce guide fait partie de la **Requête IoT** suite de documentation et couvre spécifiquement la connexion de Power BI à votre entrepôt de données. Si vous hésitez encore sur l’outil BI à utiliser, consultez la [Sélection des outils BI](https://www.navixy.com/docs/analytics/datahub/connection-setup/selecting-bi-tools) vue d’ensemble. {% endhint %} Regardez une courte vidéo de présentation pour voir ce qui est possible avec **Requête IoT**et Grafana (disponible en anglais et en espagnol) : {% tabs %} {% tab title="Anglais" %} {% embed url="" %} **Requête IoT** + tutoriel de présentation et de configuration de Grafana. {% endembed %} {% endtab %} {% tab title="Espagnol" %} {% embed url="" %} Descripción general y tutorial de configuración de **Requête IoT** + Grafana. {% endembed %} {% endtab %} {% endtabs %} ## Fonctionnalités du tableau de bord * Visualisation des données des capteurs en temps réel * Analyse de séries temporelles avec plages horaires personnalisables * Filtrage dynamique à l'aide de variables * Prise en charge de plusieurs 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 de source de données PostgreSQL (inclus par défaut) * Accès Internet pour la connexion à la base de données * Actif **Requête IoT** instance avec des identifiants de connexion ## Installation et configuration Grafana doit être installé sur votre système avant que vous puissiez vous connecter à **Requête IoT**. {% stepper %} {% step %} #### Installer Grafana 1. Téléchargez et installez Grafana depuis le site officiel :\ 2. Suivez les instructions d'installation correspondant à votre système d'exploitation. {% endstep %} {% step %} #### Télécharger des modèles de tableau de bord (facultatif) Des modèles de tableau de bord préconfigurés sont disponibles pour vous aider à démarrer rapidement sans créer les visualisations à partir de zéro. Ces modèles sont maintenus dans le [dépôt bi-intergrations](https://github.com/SquareGPS/bi-intergrations) dans le dossier `grafana` . Vous pouvez cloner le dépôt pour accéder à des tableaux de bord prêts à l'emploi : ```bash git clone https://github.com/SquareGPS/bi-intergrations.git ``` Consultez le `grafana` dossier pour les fichiers JSON de tableau de bord disponibles. {% endstep %} {% endstepper %} ## 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. {% stepper %} {% step %} #### Accéder à l'onglet Connections Ouvrez Grafana et accédez à **Connections** dans la barre latérale gauche. **Requête IoT** fonctionne sur PostgreSQL, vous devez donc ajouter une source de données PostgreSQL afin de permettre à Grafana d'interroger vos données télématiques. {% endstep %} {% step %} #### Ajouter une source de données PostgreSQL Le plugin de source de données PostgreSQL est préinstallé avec Grafana et offre une prise en charge native de la connexion aux bases de données PostgreSQL. Pour ajouter la source de données : 1. Dans la section Connections, recherchez **PostgreSQL** 2. Cliquez **Ajouter une nouvelle source de données** 3. La page de configuration PostgreSQL s'ouvrira {% endstep %} {% step %} #### Configurer les paramètres de connexion Votre **Requête IoT** Les détails de connexion contiennent toutes les informations nécessaires pour établir une connexion sécurisée. Ces paramètres sont propres à votre instance et garantissent que Grafana peut accéder à vos données télématiques. Repérez vos paramètres de connexion dans votre compte Navixy et dans l' **Requête IoT** e-mail de bienvenue**.** **Référence des paramètres de connexion** | Paramètre | Champ de configuration | Description | | ------------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------- | | Hôte | `Hôte` | Adresse du serveur de base de données fournie dans vos **Requête IoT** détails de connexion | | Port | `Port` | La valeur par défaut est 5432 pour PostgreSQL | | Nom de la base de données | `Base de données` | Le nom de votre base de données attribué | | Nom d’utilisateur | `Utilisateur` | Votre nom d'utilisateur de base de données (appelé « utilisateur de base de données » dans les détails de connexion) | | Mot de passe | `Mot de passe` | Votre mot de passe sécurisé de base de données | | Mode SSL | `Mode SSL` | Définir sur `require` pour des connexions sécurisées | | Version de PostgreSQL | `Version` | Sélectionnez **9.3** (paramètre recommandé) | | {% endstep %} | | | {% step %} #### Configurer les 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 plus tard en fonction des exigences de sécurité de votre organisation, des contraintes d'infrastructure ou des besoins spécifiques de l'équipement. Laissez tous les autres champs à leurs valeurs par défaut pour la configuration initiale. Vous n'avez pas besoin d'activer des commutateurs ou interrupteurs supplémentaires. {% endstep %} {% step %} #### 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 **Requête IoT** de votre organisation. Pour vérifier et enregistrer : 1. Donnez un nom descriptif à votre connexion (par exemple, «**Requête IoT** Production » ou « Fleet Analytics ») 2. Cliquez **Save & Test** pour vérifier votre connexion 3. Un message de succès vert indique que la connexion fonctionne correctement {% endstep %} {% endstepper %} ## Créer votre première visualisation Créer votre première visualisation vous aide à comprendre comment Grafana interroge **Requête IoT** et affiche les données télématiques. Ce processus consiste à créer un tableau de bord, ajouter un panneau, configurer une requête et sélectionner un format de visualisation approprié. {% stepper %} {% step %} **Créer un nouveau tableau de bord** Les tableaux de bord dans Grafana servent de conteneurs pour plusieurs visualisations. La création d'un tableau de bord dédié vous aide à organiser les visualisations associées et fournit un emplacement central pour surveiller des aspects spécifiques des opérations de votre flotte. Pour créer un tableau de bord : 1. Accédez à **Tableaux de bord** dans la barre latérale gauche 2. Cliquez **Créer un tableau de bord** 3. Sélectionnez **Ajouter une visualisation** 4. Choisissez la source de données PostgreSQL que vous venez de configurer {% endstep %} {% step %} **Configurer la requête** Grafana propose deux modes de requête : un Builder visuel et un éditeur de Code. Pour **Requête IoT** les connexions, 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 écrire votre requête : 1. Dans l'éditeur de requête, passez de **Builder** à **Code** mode 2. Saisissez directement votre requête SQL Exemple de requête pour la visualisation des données des capteurs : ```sql SELECT device_time AS time, value::numeric AS value, sensor_name FROM raw_telematics_data.inputs WHERE sensor_name = 'temperature' AND device_id = 12345 AND $__timeFilter(device_time) ORDER BY device_time ``` La requête inclut une composante temporelle (`device_time AS time`) qui est essentielle pour les visualisations de séries temporelles. La `$__timeFilter()` fonction est une macro Grafana qui applique automatiquement à votre requête la plage horaire sélectionnée dans le tableau de bord. Pour plus d'exemples de requêtes, consultez le [SQL Recipe Book](https://www.navixy.com/docs/analytics/example-queries). {% endstep %} {% step %} **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 fonctionnent bien pour les relevés de capteurs au fil du temps, tandis que les tableaux conviennent mieux aux enregistrements détaillés. Pour configurer le format : 1. Cliquez **Exécuter la requête** pour vérifier que votre requête renvoie des données 2. Repérez le sélecteur de type de visualisation (généralement en haut à droite du panneau) 3. Changez le format de **Tableau** à **Time series** ou le format que vous préférez 4. Observez l'affichage des données pour vous assurer qu'elles apparaissent correctement Les visualisations de séries temporelles nécessitent une colonne temporelle et des valeurs numériques pour fonctionner correctement. Votre requête doit renvoyer des données dans le format approprié pour le type de visualisation sélectionné. {% endstep %} {% step %} **Enregistrer votre visualisation** L'enregistrement de votre travail préserve la configuration de la visualisation et la rend disponible pour consultation ultérieure. Des enregistrements réguliers sont importants : Grafana n'enregistre pas automatiquement les modifications, vous pourriez donc perdre votre travail si vous quittez la page sans enregistrer. Pour enregistrer une visualisation : 1. Cliquez **Enregistrer** 2. Attribuez un nom descriptif à votre tableau de bord 3. Sélectionnez ou créez un dossier pour l'organisation 4. Confirmez l'opération d'enregistrement Le tableau de bord est maintenant disponible dans votre instance Grafana et peut être consulté via le menu Dashboards. {% endstep %} {% endstepper %} ### Travailler avec des variables Les variables sont l'une des fonctionnalités les plus puissantes de Grafana pour créer des tableaux de bord dynamiques et interactifs. Au lieu de coder en dur des valeurs spécifiques comme les noms de capteurs ou les ID de dispositifs dans vos requêtes, les variables permettent aux utilisateurs de sélectionner différentes valeurs dans des menus déroulants sans modifier le SQL sous-jacent. Cela rend les tableaux de bord plus flexibles et plus faciles à utiliser. {% stepper %} {% step %} **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 : 1. Ouvrez votre tableau de bord 2. Cliquez sur l'icône **Paramètres** du tableau de bord (icône d'engrenage) dans le coin supérieur droit 3. Accédez à la section **Variables** dans le panneau de gauche 4. La section sera vide si aucune variable n'a encore été créée {% endstep %} {% step %} **Configurer une variable** Chaque variable a besoin d'un nom, d'une source de données et d'une requête qui renvoie les valeurs possibles que les utilisateurs peuvent sélectionner. Les valeurs des variables sont renseignées dynamiquement par interrogation de votre **Requête IoT** de votre organisation. Pour créer une variable : 1. Cliquez **Ajouter une variable** 2. Configurez les paramètres suivants : 1. **Paramètres généraux :** 1. **Nom**: `sensor_name` (utilisez un identifiant clair et descriptif, sans espaces) 2. **Libellé**: identique au nom pour plus de cohérence ; c'est ce que les utilisateurs voient sur le tableau de bord 3. **Type**: Sélectionner **Requête** pour renseigner les valeurs depuis la base de données 2. **Options de requête :** 1. **Source de données**: Sélectionnez votre PostgreSQL **Requête IoT** connexion dans la liste déroulante 2. **Requête**: Saisissez une requête SQL pour renseigner les valeurs des variables Exemple de requête pour lister tous les capteurs d'un dispositif spécifique : ```sql SELECT DISTINCT sensor_name FROM raw_telematics_data.inputs WHERE device_id = 12345 ORDER BY sensor_name ``` 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 la liste déroulante. {% endstep %} {% step %} **Appliquer les variables dans les requêtes** Une fois une variable créée, vous devez mettre à jour vos requêtes de visualisation pour y faire référence. Les variables utilisent une syntaxe spéciale avec un préfixe dollar, et Grafana remplace automatiquement la valeur sélectionnée lors de l'exécution des requêtes. Pour utiliser la variable : 1. Ouvrez la visualisation que vous souhaitez rendre dynamique 2. Modifiez la requête 3. Remplacez la valeur codée en dur par la référence à la variable Exemple de requête mise à jour utilisant la variable : ```sql SELECT device_time AS time, value::numeric AS value, sensor_name FROM raw_telematics_data.inputs WHERE sensor_name = '$sensor_name' AND device_id = 12345 AND $__timeFilter(device_time) ORDER BY device_time ``` Remarquez comment `'temperature'` a été remplacé par `'$sensor_name'`. Les guillemets sont importants pour les valeurs de type chaîne dans SQL. {% endstep %} {% step %} **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 les modifications de configuration. Pour terminer la configuration : 1. Cliquez **Appliquer** pour enregistrer la configuration de la variable 2. Cliquez **Enregistrer le tableau de bord** pour conserver toutes les modifications 3. Revenez à l'affichage principal du tableau de bord 4. Repérez la liste déroulante de la variable en haut du tableau de bord 5. Sélectionnez différents noms de capteurs dans la liste déroulante 6. 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 modifiez 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 que vous avez créée (les noms de variables sont sensibles à la casse). {% endstep %} {% endstepper %} ### Importer des tableaux de bord préconfigurés Les tableaux de bord préconfigurés offrent un moyen rapide de commencer à visualiser vos données sans tout créer à partir de zéro. Ces tableaux de bord sont conçus par des utilisateurs expérimentés et incluent les meilleures pratiques en matière de visualisation, de disposition et d'optimisation des requêtes. Cependant, ils nécessitent une configuration pour se connecter à votre **Requête IoT** de votre organisation. {% stepper %} {% step %} **Accéder à la fonction d'importation** La fonction d'importation de Grafana vous permet de charger des configurations de tableau de bord à partir de fichiers JSON ou directement depuis Grafana.com à l'aide d'identifiants de tableau de bord. 1. Accédez à **Tableaux de bord** 2. Cliquez **Nouveau** → **Import** 3. Une fenêtre de téléchargement apparaîtra {% endstep %} {% step %} **Importer le tableau de bord** Le processus d'importation accepte des configurations de tableau de bord dans plusieurs formats, ce qui vous offre une flexibilité dans la manière de charger les tableaux de bord préconfigurés. Vous pouvez importer des tableaux de bord en utilisant : * **ID de 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 : 1. Cliquez **Téléverser le fichier JSON** 2. Sélectionnez le fichier du tableau de bord 3. Attribuez un nom et sélectionnez le dossier de destination 4. Cliquez **Import** Attendez la fin du téléversement du modèle de tableau de bord. 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. {% endstep %} {% step %} **Mettre à jour les connexions aux sources de données** Il s'agit d'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 **Requête IoT** données. Vous devez mettre à jour chaque visualisation pour utiliser votre PostgreSQL **Requête IoT** connexion. Pour mettre à jour les visualisations : 1. Ouvrez le tableau de bord importé 2. Cliquez **Modifier** sur le premier panneau de visualisation (recherchez l'icône de modification ou le menu à trois points) 3. Dans l'éditeur de requête, repérez le sélecteur de source de données 4. Changez la source de données de la source d'origine du modèle vers votre PostgreSQL **Requête IoT** connexion 5. Cliquez **Exécuter la requête** pour vérifier que la visualisation récupère bien les données 6. Cliquez **Enregistrer** pour conserver les modifications 7. Répétez ce processus pour chaque panneau de visualisation du tableau de bord {% hint style="info" %} Enregistrez votre travail fréquemment pendant ce processus. Vous pouvez avoir plusieurs visualisations à mettre à jour, et enregistrer après chacune d'elles garantit que vous ne perdez pas votre progression. {% endhint %} {% endstep %} {% step %} **Mettre à jour les variables du tableau de bord** De nombreux tableaux de bord préconfigurés 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 **Requête IoT** de votre organisation. Pour mettre à jour les variables : 1. Ouvrez **Paramètres** → **Variables** 2. Vous verrez une liste de toutes les variables utilisées dans le tableau de bord 3. Cliquez **Modifier** sur la première variable 4. Repérez le **Source de données** menu déroulant dans la section Options de requête 5. Changez-le pour votre PostgreSQL **Requête IoT** connexion 6. Vérifiez que l'aperçu en bas affiche les valeurs attendues de votre base de données 7. Cliquez **Appliquer** pour confirmer les modifications 8. 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 doivent maintenant se renseigner avec les valeurs de votre **Requête IoT** de votre organisation. {% endstep %} {% step %} **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 pleinement opérationnel et prêt pour une utilisation régulière. Pour vérifier : 1. Enregistrez le tableau de bord une dernière fois en utilisant **Ctrl+S** ou le **Enregistrer** bouton 2. Actualisez complètement la page du navigateur (ou utilisez **F5**) 3. Vérifiez que toutes les visualisations affichent correctement les données 4. Testez chaque liste déroulante de variable pour vérifier qu'elle se remplit de valeurs 5. Sélectionnez différentes valeurs de variable et confirmez que les visualisations se mettent à jour en conséquence 6. Essayez différentes plages horaires à 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 ainsi que la configuration des requêtes pour ces panneaux spécifiques. {% endstep %} {% endstepper %} ## 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 **Requête IoT** détails. 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 bien des données en consultant l'inspecteur de requête (cliquez sur le bouton « Query inspector » dans l'éditeur du panneau). Assurez-vous que la plage horaire sélectionnée inclut des périodes où des données existent dans votre base de données. Confirmez que la source de données est correctement sélectionnée et connectée. Vérifiez que les noms de table et de colonne dans votre requête correspondent à la structure réelle du schéma. **La variable ne fonctionne pas**: Vérifiez que la requête de la variable renvoie des valeurs en consultant l'aperçu sur la page de configuration de la variable. Assurez-vous que la référence de variable dans votre requête utilise la syntaxe correcte (`$variable_name`) sans faute de frappe. Vérifiez que la variable est correctement enregistrée et appliquée au tableau de bord. Si la liste déroulante de la variable est vide, examinez la requête SQL de la variable pour détecter d'éventuelles erreurs. **Performances de requête lentes**: Pensez à 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 les filtres temporels de manière plus restrictive. Optimisez la structure de la requête en sélectionnant uniquement les colonnes nécessaires au lieu d'utiliser `SELECT *`. Consultez le [SQL Recipe Book](https://www.navixy.com/docs/analytics/example-queries) 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 nécessitent une colonne aliasée en `time` et des colonnes de valeurs numériques. Les panneaux de tableau acceptent toute structure de colonnes. Les panneaux de graphique nécessitent des données temporelles et numériques. Consultez la documentation Grafana pour connaître les exigences spécifiques de chaque type de visualisation. ### Problèmes d'importation **Absence de données après l'importation**: Vérifiez que les connexions aux sources de données sont mises à jour pour tous les panneaux et variables. N'omettez aucun panneau pendant le 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 **Requête IoT** instance. Assurez-vous que les noms de table et de colonne 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 précis comme 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 **Requête IoT** schéma (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. **Les variables ne se renseignent pas**: Vérifiez que vous avez mis à jour la source de données pour chaque variable, et pas seulement pour les panneaux de visualisation. Vérifiez que les requêtes des 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 sur « Custom » ou d'autres types. ## Étapes suivantes Après avoir connecté avec succès Grafana à votre **Requête IoT** instance : * Explorez les schémas de données disponibles en consultant la [Vue d’ensemble du schéma](/docs/analytics/fr/iot-query/schema-overview.md) pour comprendre la structure des données, les relations entre les tables et les champs disponibles. * Commencez par des requêtes simples axées sur des entités métier spécifiques avant de construire des tableaux de bord complexes ; cela vous aide à apprendre la structure des données et à éviter des problèmes de performance. * Consultez le [SQL Recipe Book](/docs/analytics/fr/example-queries.md) pour des modèles de requêtes éprouvés et des techniques d'optimisation, ainsi que des exemples de scénarios courants d'analyse télématique * Expérimentez différents types de visualisation (séries temporelles, tableaux, jauges, panneaux de statistiques) pour trouver la meilleure représentation pour vos données et cas d'utilisation spécifiques * Envisagez de créer plusieurs tableaux de bord à des fins différentes : surveillance en temps réel, analyse historique, résumés exécutifs et rapports opérationnels. ### Assistance Pour toute question technique ou aide concernant les connexions **Requête IoT** contactez le support à . --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://navixy.com/docs/analytics/fr/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.