> 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
Visualisez les données de carburant et de télématique dans Grafana en vous connectant à l'API Navixy. Configuration pas à pas des tableaux de bord qui suivent la consommation historique.
## 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 spécifiques de la carte afin d'identifier tout événement anormal. Elle peut aussi 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 pour récupérer et visualiser facilement les données de contrôle du carburant.
Grafana est un outil open source de visualisation de données 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.
## Connexion de Navixy à Grafana
En suivant ce guide pas à pas, vous pouvez intégrer Navixy à Grafana de manière fluide, 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 aux **Paramètres du compte**. Localisez la **Clés API** section et générez une clé API unique. Cette clé, telle que `"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 votre ordinateur local.
Pour déployer Grafana sur une machine Windows locale, suivez ces étapes simples :
1. Téléchargez le dernier installateur Grafana pour Windows depuis la page de téléchargement officielle.
2. Exécutez l'installateur 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 invites.
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 la connexion, vous pouvez immédiatement commencer à 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 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é, accédez au **menu** ou **Connexions** Plugins **dans l'interface Grafana. Recherchez le** plugin de source de données JSON API 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 **dans l'interface Grafana. Recherchez le** 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 à **menu** menu sur le côté gauche
2. Recherchez **dans l'interface Grafana. Recherchez le** et choisissez cette source
3. Cliquez **Créer une source de données JSON API** 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 l'emplacement 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 les 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. Téléchargez le fichier de modèle de tableau de bord Navixy fourni. Passez en revue 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, permettant 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 **tracker** sélecteur. Une fois sélectionné, vous pouvez créer plusieurs graphiques linéaires sur la même zone de dessin en choisissant les capteurs souhaités dans les sélecteurs correspondants. Sélectionnez les données brutes dans les menus déroulants **Données brutes 1** / **Données brutes 2** si vous souhaitez analyser les données brutes des capteurs.
### Plage horaire
Dans le coin supérieur droit, vous trouverez l'option permettant de sélectionner la plage de dates pour votre analyse. Cela vous donne la flexibilité de choisir entre des plages rapides, qui fournissent des intervalles de temps prédéfinis, ou une plage horaire absolue, où vous pouvez spécifier des dates de début et de fin précises.
### Graphiques linéaires
Grafana propose une gamme d'options de visualisation puissantes, et parmi elles, le graphique linéaire se distingue. Ce graphique permet une analyse complète des 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 gagnent la capacité d'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 déplacement panoramique, permettent aux professionnels d'explorer des périodes spécifiques et d'en tirer des informations plus approfondies à partir des données.
### Tableaux
Les tableaux du tableau de bord offrent 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 pertinentes. 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 cartographiques de Grafana permettent de surveiller les objets et les événements sur une carte, offrant des informations précieuses sur les positions des véhicules et les trajets dans une plage horaire sélectionnée. Cette fonctionnalité puissante fournit une visualisation complète des mouvements antérieurs 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 métriques précises telles que la longueur du trajet et la vitesse moyenne, ce qui améliore l'analyse globale.
## Résultat et étapes suivantes
L'intégration de Grafana et des API 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 diagnostiquer 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 exigences 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 des séries temporelles et d'autres types de données, ce qui vous permet d'explorer les données de manière plus significative. En utilisant des tableaux de bord personnalisables, les utilisateurs peuvent créer des visualisations personnalisées qui répondent à 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 à partir des données analysées. La personnalisation du tableau de bord nécessite de l'expérience dans l'utilisation des API Navixy et 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 fluide. En partageant des tableaux de bord personnalisés avec des membres de l'équipe, des clients ou des 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 contient toutes les informations essentielles nécessaires pour reproduire le tableau de bord sur une autre instance Grafana. Cette fonctionnalité de partage simplifiée garantit que toutes les personnes concernées peuvent accéder aux informations et aux analyses du tableau de bord et en bénéficier.
---
# 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/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 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.