> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/fr/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md). # Connexion à Grafana Connectez Grafana à IoT Query via la Source de données PostgreSQL. Créez des graphiques de séries temporelles et des tableaux de bord pour la surveillance en direct et historique de la télématique Ce guide montre comment connecter Grafana à **IoT Query** pour visualiser les données télématiques et de flotte. Grafana offre de puissantes capacités de visualisation pour surveiller l'état du véhicule, Données du capteur et d'autres métriques en temps réel. {% hint style="info" %} Ce guide fait partie de la **IoT Query** suite de documentation et traite plus précisément de 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/iot-query/connection-setup/selecting-bi-tools) Vue d'ensemble. {% endhint %} Regardez une courte vidéo de Vue d'ensemble pour voir ce qu'il est possible de faire avec **IoT Query**la combinaison +Grafana (disponible en anglais et en espagnol) : {% tabs %} {% tab title="Anglais" %} {% embed url="" %} **IoT Query** tutoriel de présentation et de configuration de + Grafana. {% endembed %} {% endtab %} {% tab title="Espagnol" %} {% embed url="" %} Présentation générale et tutoriel de configuration de **IoT Query** + Grafana. {% endembed %} {% endtab %} {% endtabs %} ## Fonctionnalités du tableau de bord * Visualisation des Données du capteur en temps réel * Analyse de séries temporelles avec des plages temporelles 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 ultérieur * Plugin de Source de données PostgreSQL (inclus par défaut) * Accès à Internet pour la connexion à la base de données * Active **IoT Query** instance avec des identifiants de connexion ## Installation et configuration Grafana doit être installé sur votre système avant de pouvoir vous connecter à **IoT Query**. {% stepper %} {% step %} #### Installer Grafana 1. Téléchargez et installez Grafana depuis le site officiel :\ 2. Suivez les instructions d'installation pour votre système d'exploitation. {% endstep %} {% step %} #### Télécharger les modèles de tableau de bord (facultatif) Des modèles de tableau de bord prédéfinis sont disponibles pour vous aider à démarrer rapidement sans créer les visualisations de zéro. Ces modèles sont maintenus dans le [dépôt bi-intergrations](https://github.com/Navixy/bi-integrations) dans le `dossier grafana. Vous pouvez cloner le dépôt pour accéder à des tableaux de bord prêts à l'emploi :` git clone ```bash Consultez le ``` dossier pour les fichiers JSON de tableaux de bord disponibles. `dossier grafana. Vous pouvez cloner le dépôt pour accéder à des tableaux de bord prêts à l'emploi :` Connexion à la base de données {% endstep %} {% endstepper %} ## Connexion à la base de données La section Connexions de Grafana est l'endroit où vous gérez toutes les intégrations de Source de données. {% stepper %} {% step %} #### Accédez à l'onglet Connexions Ouvrez Grafana et accédez à **Connexions** dans la barre latérale gauche. **IoT Query** fonctionne sur PostgreSQL, vous devez donc ajouter une Source de données PostgreSQL pour 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 Connexions, recherchez **PostgreSQL** 2. Cliquez sur **Ajouter une nouvelle source de données** 3. La page de configuration PostgreSQL s'ouvrira {% endstep %} {% step %} #### Configurer les paramètres de connexion Vos **IoT Query** 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. Trouvez vos paramètres de connexion dans votre compte Navixy et l'e-mail de **IoT Query** 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 **IoT Query** 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 base de données qui vous a été attribué | | Nom d'utilisateur | `Utilisateur` | Votre nom d'utilisateur de base de données (appelé "utilisateur de la base de données" dans les détails de connexion) | | Mot de passe | `Mot de passe` | Votre mot de passe de base de données sécurisé | | Mode SSL | `Mode SSL` | Définissez 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 offre des options de configuration supplémentaires. Pour la plupart des utilisateurs, les valeurs par défaut conviennent et fonctionneront correctement sans modification. Vous pourrez ajuster ces paramètres plus tard en fonction des exigences de Sécurité de votre organisation, des contraintes de votre infrastructure ou des besoins spécifiques de votre équipement. Laissez tous les autres champs à leurs valeurs par défaut lors de la configuration initiale. Vous n'avez pas besoin d'activer d'autres interrupteurs ou bascules. {% endstep %} {% step %} #### Tester la connexion Tester la connexion avant l'enregistrement permet de vérifier que tous les paramètres sont corrects et que Grafana peut communiquer avec succès avec votre **IoT Query** instance. Pour vérifier et enregistrer : 1. Attribuez à votre connexion un nom descriptif (par exemple, "**IoT Query** Production" ou "Analyse de la Flotte") 2. Cliquez sur **Enregistrer et tester** pour vérifier votre connexion 3. Un message de réussite 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 **IoT Query** 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é. {% 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 liées et fournit un emplacement central pour surveiller des aspects spécifiques de vos opérations de flotte. Pour créer un tableau de bord : 1. Accédez à **Tableaux de bord** dans la barre latérale gauche 2. Cliquez sur **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 générateur visuel et un éditeur de code. Pour **IoT Query** 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 du capteur : ```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 un composant temporel (`device_time AS time`) qui est essentiel pour les visualisations de séries temporelles. La `$__timeFilter()` fonction est une macro Grafana qui applique automatiquement à votre requête la plage temporelle sélectionnée du tableau de bord. Pour plus d'exemples de requêtes, consultez le [Livre de recettes SQL](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 sont bien adaptées aux 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 sur **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. Passez du format **Tableau** à **Séries temporelles** ou à votre format préféré 4. Observez l'affichage des données pour vous assurer qu'il apparaît 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** Enregistrer votre travail préserve la configuration de la visualisation et la rend disponible pour une référence 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 sur **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 Tableaux de bord. {% endstep %} {% endstepper %} ### Utiliser 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 d'appareil 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 des variables. Pour commencer : 1. Ouvrez votre tableau de bord 2. Cliquez sur le tableau de bord **Paramètres** icône (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 de la variable sont renseignées dynamiquement en interrogeant votre **IoT Query** instance. Pour créer une variable : 1. Cliquez sur **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électionnez **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 **IoT Query** connexion dans le menu déroulant 2. **Requête**: Saisissez une requête SQL pour renseigner les valeurs de la variable Exemple de requête pour lister tous les capteurs d'un appareil 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 le menu déroulant. {% endstep %} {% step %} **Appliquer des 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 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 de la variable Exemple de requête mise à jour à l'aide de 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 chaîne en SQL. {% endstep %} {% step %} **Enregistrer et tester** Tester la variable garantit qu'elle fonctionne correctement et met à jour les visualisations comme prévu. Assurez-vous d'enregistrer votre travail à chaque étape pour éviter de perdre les modifications de configuration. Pour terminer la configuration : 1. Cliquez sur **Appliquer** pour enregistrer la configuration de la variable 2. Cliquez sur **Enregistrer le tableau de bord** pour conserver toutes les modifications 3. Retournez à la vue principale du tableau de bord 4. Repérez le menu déroulant de la variable en haut du tableau de bord 5. Sélectionnez différents noms de capteurs dans le menu déroulant 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 changez la sélection de variable, vérifiez que le nom de variable dans votre requête correspond exactement au nom de variable que vous avez créé (les noms de variable sont sensibles à la casse). {% endstep %} {% endstepper %} ### Importer des tableaux de bord prédéfinis Les tableaux de bord prédéfinis offrent un moyen rapide de commencer à visualiser vos données sans tout construire de zéro. Ces tableaux de bord sont conçus par des utilisateurs expérimentés et incluent les bonnes pratiques en matière de visualisation, de mise en page et d'optimisation des requêtes. Cependant, ils nécessitent une configuration pour se connecter à votre source de données spécifique. **IoT Query** instance. {% stepper %} {% step %} **Accéder à la fonction d'importation** La fonctionnalité 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 sur **Nouveau** → **Importer** 3. Une fenêtre de téléversement apparaîtra {% endstep %} {% step %} **Importer le tableau de bord** Le processus d'importation accepte les configurations de tableau de bord dans plusieurs formats, ce qui vous offre une grande flexibilité pour charger des tableaux de bord prédéfinis. Vous pouvez importer des tableaux de bord à l'aide de : * **ID du tableau de bord** de 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 sur **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 sur **Importer** Attendez que le modèle de tableau de bord ait fini de se téléverser. 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** C'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 **IoT Query** données. Vous devez mettre à jour chaque visualisation pour utiliser votre PostgreSQL **IoT Query** connexion. Pour mettre à jour les visualisations : 1. Ouvrez le tableau de bord importé 2. Cliquez sur **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 du source d'origine du modèle pour votre PostgreSQL **IoT Query** connexion 5. Cliquez sur **Exécuter la requête** pour vérifier que la visualisation récupère les données avec succès 6. Cliquez sur **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 l'enregistrement 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édéfinis 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 **IoT Query** instance. Pour mettre à jour les variables : 1. Ouvrez **Paramètres** → **section Variables** 2. Vous verrez la liste de toutes les variables utilisées dans le tableau de bord 3. Cliquez sur **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 **IoT Query** connexion 6. Vérifiez que l'aperçu en bas affiche les valeurs attendues de votre base de données 7. Cliquez sur **Appliquer** pour confirmer les modifications 8. Répétez pour chaque variable de la liste Après avoir mis à jour toutes les variables, enregistrez de nouveau le tableau de bord. Les variables devraient maintenant se renseigner avec les valeurs de votre **IoT Query** instance. {% 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 à être utilisé régulièrement. Pour vérifier : 1. Enregistrez le tableau de bord une dernière fois à l'aide de **Ctrl+S** ou du **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 menu déroulant de variable pour vous assurer qu'il 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 temporelles à l'aide du sélecteur de temps Si certaines visualisations restent vides ou affichent des erreurs, revenez au mode de modification et vérifiez la source de données ainsi que la configuration de la requête 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 **IoT Query** 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**: Vérifiez d'abord que la requête renvoie bien des données en consultant l'inspecteur de requêtes (cliquez sur le bouton "Query inspector" dans l'éditeur du panneau). Assurez-vous que la plage temporelle 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 de votre requête correspondent à la structure réelle du schéma. **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 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, vérifiez la requête SQL de la variable pour y détecter des erreurs. **Lenteur 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 les filtres temporels de manière plus restrictive. Optimisez la structure de la requête en sélectionnant uniquement les colonnes nécessaires plutôt qu'en utilisant `SELECT *`. Référez-vous à la [Livre de recettes SQL](https://www.navixy.com/docs/analytics/example-queries) pour des exemples d'optimisation des performances et des modèles de requête éprouvés. **Format incompatible**: 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 nommée time et des colonnes de valeurs numériques. Les panneaux de tableau acceptent n'importe quelle structure de colonnes. Les panneaux de graphique ont besoin de données temporelles et numériques. Consultez la documentation Grafana pour connaître les exigences spécifiques de chaque type de visualisation. `time` et des colonnes de valeurs numériques. Les panneaux de tableau acceptent n'importe quelle structure de colonnes. Les panneaux de graphique ont besoin de 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 **Données manquantes après l'importation**: Vérifiez que les connexions à la source de données sont mises à jour pour tous les panneaux et toutes les variables. Ne sautez 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 **IoT Query** 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êtes de chaque panneau et cliquez sur "inspecteur de requêtes" 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 **IoT Query** schéma exactement (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 remplissent 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 sur d'autres types. ## Prochaines étapes Après avoir connecté Grafana avec succès à votre **IoT Query** 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 centrées sur des entités métier spécifiques avant de construire des tableaux de bord complexes ; cela vous aidera à comprendre la structure des données et à éviter les problèmes de performance. * Consultez les [Livre de recettes SQL](/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 d'analyse télématique courants * et 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 pour des objectifs différents : surveillance en temps réel, analyse historique, résumés pour la direction et rapports opérationnels. ### Assistance Pour toute question technique ou assistance concernant les **IoT Query** connexions, contactez l'assistance à . --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/fr/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.