> 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/expert-center/fr/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md).
# Analyse des données de carburant avec Grafana via l’intégration de l’API Navixy
## Introduction
Parfois, nos partenaires et intégrateurs rencontrent des situations où ils ont besoin d'une analyse plus approfondie des données brutes de carburant et des paramètres associés. Cette analyse peut impliquer l'examen du niveau de carburant, de la vitesse, de la tension ou de l'état du contact sur des plages horaires et des zones précises de la carte afin d'identifier d'éventuels événements anormaux. Elle peut également fournir des informations sur les configurations des capteurs, diagnostiquer des problèmes et surveiller les performances en temps réel. Dans cet article, nous allons voir comment intégrer Grafana et les API Navixy afin de récupérer et de visualiser facilement les données de contrôle du carburant.
Grafana est un outil de visualisation de données open source qui offre un large éventail d'options de visualisation personnalisables. Il peut être facilement installé et configuré même sur votre PC ou votre ordinateur portable. Le processus d'installation prend généralement environ 30 minutes.
## Connecter Navixy à Grafana
En suivant ce guide étape par étape, vous pouvez intégrer sans difficulté Navixy à Grafana, ce qui vous permet de visualiser et d'analyser efficacement vos données télématiques.
### Étape 1 : obtenir la clé API Navixy
Commencez par vous connecter à votre compte Navixy et accédez à **Paramètres du compte**. Repérez la **Clés API** section et générez une clé API unique. Cette clé, par exemple `"8f6a4353bc5114d97e2068b4e398"`, sera utilisée pour authentifier la connexion entre Navixy et Grafana.
### Étape 2 : lancer Grafana
Grafana propose 2 types d'accès : cloud ou déployé. L'accès cloud peut être obtenu sur leur site officiel . Ci-dessous, nous allons voir comment installer le paquet sur votre propre serveur ou sur un ordinateur local.
Pour déployer Grafana sur une machine Windows locale, suivez ces étapes simples :
1. Téléchargez le programme d'installation Grafana le plus récent pour Windows depuis la page de téléchargement officielle.
2. Exécutez le programme d'installation téléchargé (par exemple, grafana-xx.x.x.windows-amd64.msi, où xx.x.x est le numéro de version) et terminez l'installation en suivant les instructions à l'écran.
3. Une fois l'installation terminée, lancez Grafana en exécutant le fichier grafana-server.exe situé dans le dossier bin du répertoire d'installation (par exemple, C:\Program Files\GrafanaLabs\grafana\bin).
4. Ouvrez un navigateur Web et accédez à [http://localhost:3000](http://localhost:3000/). Utilisez les identifiants de connexion par défaut « admin » pour le nom d'utilisateur et le mot de passe.
5. Après vous être connecté, vous pouvez commencer immédiatement à créer et à personnaliser des tableaux de bord, en utilisant diverses sources de données pour visualiser et analyser vos données.
Pour les installations Linux/Mac ou si vous préférez utiliser la version Docker de Grafana, consultez la documentation officielle de Grafana pour obtenir des instructions détaillées adaptées à votre configuration spécifique.
### Étape 3 : installer le plugin de source de données JSON API
Une fois Grafana lancé, rendez-vous dans le **Connexions** ou **Plugins** menu de l'interface Grafana. Recherchez le **JSON API** module de source de données et sélectionnez-le. Installez le plugin en suivant les instructions fournies. Ce plugin est essentiel pour établir la communication entre Grafana et l'API Navixy.
### Étape 4 : configurer la connexion à la source de données JSON API
Après l'installation du **JSON API** plugin, votre instance Grafana est prête à se connecter à l'API Navixy à l'aide de la clé API.
Suivez ces étapes pour configurer la connexion :
1. Accédez au **Connexions** menu sur le côté gauche
2. Recherchez **JSON API** et choisissez cette source
3. Cliquez **Créer une source de données JSON API** source de données
4. Renseignez les champs suivants :
* Nom : choisissez un nom préféré pour la source de données
* URL : saisissez l'URL de l'API Navixy. Selon la région de votre plateforme, utilisez l'une des URL suivantes :
* `https://api.eu.navixy.com/v2/` pour l'Europe
* `https://api.us.navixy.com/v2/` pour l'Amérique du Nord
* `` pour les installations auto-hébergées (On-Premise). Le format par défaut est généralement `http(s)://your_configured_domain/api/`
* Chaîne de requête : utilisez une chaîne de requête au format `hash=[YOUR_API_KEY]&iso_datetime=true`. Par exemple : `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.
5. Personnalisez les paramètres supplémentaires selon vos besoins, puis cliquez sur **Enregistrer et tester** pour vérifier la connexion.
### Étape 5 : importer le modèle de tableau de bord Navixy
Pour accélérer le processus de configuration, importez le [modèle de tableau de bord](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) dans Grafana. Accédez à la section de gestion des tableaux de bord Grafana, créez un nouveau tableau de bord et sélectionnez l'option d'importation du tableau de bord. Importez le fichier modèle de tableau de bord Navixy fourni. Vérifiez les paramètres d'importation, y compris la source de données attribuée, puis terminez le processus d'importation.
## Analyse des données télématiques avec Grafana
Grafana fournit un ensemble complet d'objets et d'outils de visualisation, ce qui permet aux professionnels de la télématique d'analyser et d'interpréter sans effort des données télématiques complexes. Examinons les principaux éléments du tableau de bord de démonstration proposé par Navixy, mis en bleu.
### Appareils et capteurs à analyser
Pour commencer, sur le tableau de bord de démonstration, sélectionnez l'appareil souhaité à l'aide du **sélecteur Tracker** sélecteur. Une fois sélectionné, vous pouvez créer plusieurs graphiques linéaires sur le même canevas en choisissant les capteurs souhaités dans les sélecteurs correspondants. Sélectionnez les menus déroulants Données brutes 1 et Données brutes 2 si vous souhaitez analyser les données brutes des capteurs. **Données brutes 1** / **Données brutes 2** menus déroulants si vous souhaitez analyser les données brutes des capteurs.
### Plage de temps
Dans le coin supérieur droit, vous trouverez l'option permettant de sélectionner la plage de dates pour votre analyse. Cela vous offre une grande flexibilité dans le choix entre des plages rapides, qui fournissent des intervalles de temps prédéfinis, et une plage de temps absolue, où vous pouvez spécifier des dates de début et de fin précises.
### Graphiques linéaires
Grafana offre une gamme d'options de visualisation puissantes, et parmi elles, le graphique linéaire se distingue. Ce graphique permet d'analyser de façon approfondie les relevés des capteurs au fil du temps, ce qui s'avère précieux pour les professionnels de la télématique. En traçant des données télématiques comme le niveau de carburant, la vitesse du véhicule, etc. sur un graphique linéaire, les utilisateurs peuvent identifier des schémas, des tendances et des anomalies susceptibles d'avoir un impact sur les performances de la flotte. Les fonctionnalités interactives, telles que le zoom et le panoramique, permettent aux professionnels d'explorer des périodes de temps spécifiques afin d'extraire des informations plus approfondies à partir des données.
### Tableaux
Les tableaux du tableau de bord fournissent un format structuré et convivial pour explorer les données brutes des capteurs. Chaque valeur est accompagnée d'un horodatage, ce qui permet aux utilisateurs de suivre facilement le moment où les données ont été générées. Cette présentation organisée facilite une analyse complète des points de données individuels, permettant un examen détaillé et des informations. Le tableau de bord de démonstration Navixy comporte 2 tableaux : Données brutes des capteurs par horodatage et Trajets terminés avec détails.
### Carte
Les affichages de carte Grafana facilitent la surveillance des objets et des événements sur une carte, en fournissant des informations précieuses sur les emplacements des véhicules et les trajets sur une plage de temps sélectionnée. Cette fonctionnalité puissante offre une visualisation complète des mouvements précédents des véhicules, permettant aux utilisateurs d'analyser les données historiques et de développer une compréhension plus approfondie des opérations de la flotte. En complément de la représentation visuelle, un tableau associé présente des mesures précises telles que la longueur du trajet et la vitesse moyenne, améliorant ainsi l'analyse globale.
## Résultat et étapes suivantes
L'intégration des API Grafana et Navixy offre une solution puissante pour visualiser et analyser les données télématiques liées au contrôle du carburant. En tirant parti des capacités de visualisation de données open source de Grafana et de la vaste API de Navixy, les utilisateurs peuvent obtenir des informations précieuses sur la consommation de carburant de leur flotte, surveiller les événements anormaux et résoudre efficacement les problèmes.
### Personnalisation du tableau de bord
En tant qu'intégrateur, vous avez la flexibilité de personnaliser les éléments du tableau de bord pour répondre à vos besoins spécifiques. Grafana fournit divers objets de visualisation qui peuvent être configurés pour accéder à un ensemble complet de données télématiques à partir des API Navixy. Cela inclut la sélection et la configuration de diverses [visualisations Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) pour analyser les séries chronologiques et d'autres types de données, ce qui vous permet d'explorer les données de manière plus pertinente. En utilisant des tableaux de bord personnalisables, les utilisateurs peuvent créer des visualisations personnalisées adaptées à leurs besoins d'analyse spécifiques. Cela permet aux gestionnaires de flotte et aux parties prenantes de surveiller les performances en temps réel, de diagnostiquer les problèmes et de prendre des décisions éclairées sur la base des données analysées. La personnalisation du tableau de bord nécessite de l'expérience dans l'utilisation des API Navixy et dans le travail avec le format JSON.
### Partage des tableaux de bord Grafana
Partager votre tableau de bord personnalisé avec d'autres personnes dans Grafana est un processus sans difficulté. En partageant des tableaux de bord personnalisés avec les membres de l'équipe, les clients ou les parties prenantes, la collaboration et le partage des connaissances sont renforcés. Pour commencer, vous pouvez exporter votre tableau de bord sous forme de fichier JSON, qui inclut toutes les informations essentielles nécessaires pour reproduire le tableau de bord sur une autre instance Grafana. Cette fonctionnalité de partage rationalisée garantit que toutes les personnes concernées peuvent accéder aux informations et à l'analyse du tableau de bord et en tirer parti.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/expert-center/fr/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.