Analyse des données de carburant avec Grafana via l'intégration 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 de l'allumage sur des plages temporelles spécifiques et des zones sur la carte afin d'identifier tout événement anormal. 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 expliquerons comment intégrer Grafana et les API Navixy pour récupérer et visualiser facilement les données de contrôle de carburant.
Grafana est un outil open source de visualisation de données qui offre une large gamme d'options de visualisation personnalisables. Il peut être installé et configuré facilement, même sur votre PC ou ordinateur portable. Le processus d'installation prend généralement environ 30 minutes.
Connexion de Navixy à Grafana
En suivant ce guide étape par étape, vous pouvez intégrer Navixy à Grafana de manière transparente, ce qui vous permet de visualiser et d'analyser efficacement vos données télématiques.
Étape 1 : Obtention de la clé API Navixy
Commencez par vous connecter à votre compte Navixy et rendez-vous dans les paramètres du compte. Dans les paramètres, localisez la section dédiée aux clés API 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 : Lancement de Grafana
Grafana propose 2 types d'accès : cloud ou déployé. L'accès cloud peut être obtenu sur leur site officiel https://grafana.com/. Ci‑dessous, nous allons expliquer comment installer le package sur votre propre serveur ou ordinateur local.
Pour déployer Grafana sur une machine Windows locale, suivez ces étapes simples :
Téléchargez le dernier installateur Grafana pour Windows depuis la page de téléchargement officielle.
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 instructions.
Une fois l'installation terminée, démarrez 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).
Ouvrez un navigateur web et accédez à http://localhost:3000. Utilisez les identifiants par défaut « admin » pour le nom d'utilisateur et le mot de passe.
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 sous Linux/Mac ou si vous préférez utiliser la version Docker de Grafana, référez-vous à la documentation officielle de Grafana pour des instructions détaillées adaptées à votre configuration spécifique.
Étape 3 : Installation du plugin de source de données JSON API
Une fois Grafana lancé, rendez-vous dans le menu « Connections » ou « Plugins » de 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 : Configuration de la connexion de la source de données JSON API
Après l'installation du plugin « JSON API », votre instance Grafana est prête à se connecter à l'API Navixy en utilisant la clé API.
Suivez ces étapes pour configurer la connexion :
Allez dans le menu « Connections » sur le côté gauche
Recherchez « JSON API » et choisissez cette source
Cliquez sur « Create a JSON API data source »
Remplissez les champs suivants :
Name : 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'Europehttps://api.us.navixy.com/v2/pour l'Amérique du Nord<your_configured_domain_api_url>pour les installations auto‑hébergées (On‑Premise). Le format par défaut est généralementhttp(s)://your_configured_domain/api/
Query string : Utilisez une chaîne de requête au format
hash=[YOUR_API_KEY]&iso_datetime=true. Par exemple :hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true.
Personnalisez les paramètres supplémentaires si nécessaire, puis cliquez sur « Save & Test » pour vérifier la connexion.
Étape 5 : Importation du modèle de tableau de bord Navixy
Pour accélérer le processus de configuration, importez le modèle de tableau de bord Navixy dans Grafana. Accédez à la section de gestion des tableaux de bord de Grafana, créez un nouveau tableau de bord et sélectionnez l'option d'importation. Téléversez le fichier du modèle de tableau de bord Navixy fourni. Passez en revue les paramètres d'importation, y compris la source de données assignée, et terminez le processus d'importation.
Analyse des données télématiques avec Grafana
Grafana fournit un ensemble complet d'objets de visualisation et d'outils, permettant aux professionnels de la télématique d'analyser et d'interpréter facilement des données télématiques complexes. Examinons les principaux éléments du tableau de bord de démonstration proposé par Navixy, qui sont marqués en bleu.
Traceurs et capteurs à analyser
Pour commencer, sur le tableau de bord de démonstration, sélectionnez l'appareil souhaité à l'aide du sélecteur « Tracker ». Une fois sélectionné, vous pouvez créer plusieurs graphiques linéaires sur la même toile en choisissant les capteurs souhaités dans les sélecteurs « Sensor 1 » et « Sensor 2 ». Sélectionnez « True » dans les menus déroulants « Raw Data 1 » / « Raw data 2 » si vous souhaitez analyser les données brutes des capteurs.
Plage temporelle
Dans le coin supérieur droit, vous trouverez l'option permettant de sélectionner la plage de dates pour votre analyse. Cela vous offre la flexibilité de choisir entre des plages rapides, qui fournissent des intervalles temporels prédéfinis, ou une plage temporelle 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, parmi lesquelles le graphique linéaire se distingue. Ce graphique permet une analyse approfondie des relevés de 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 telles que 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'affecter les performances de la flotte. Les fonctionnalités interactives, telles que le zoom et le panoramique, permettent aux professionnels d'explorer des périodes temporelles spécifiques et d'extraire ainsi des informations plus détaillées des données.
Tables
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, permettant 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 des examens détaillés et des observations. Le tableau de bord de démonstration Navixy comporte 2 tableaux : Données brutes des capteurs par horodatages et Tracks complétés avec détails.
Vue carte
Les affichages cartographiques de Grafana facilitent la surveillance des objets et des événements sur une carte, fournissant des informations précieuses sur les emplacements des véhicules et les trajets dans une plage temporelle sélectionnée. Cette fonctionnalité puissante offre une visualisation complète des mouvements antérieurs des véhicules, permettant aux utilisateurs d'analyser les données historiques et d'acquérir une compréhension approfondie des opérations de la flotte. Complétant la représentation visuelle, un tableau associé présente des métriques précises telles que la longueur du trajet et la vitesse moyenne, améliorant 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 open source de visualisation de données de Grafana et de l'API étendue 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 disposez de la flexibilité nécessaire pour personnaliser les éléments du tableau de bord afin de répondre à vos exigences spécifiques. Grafana propose divers objets de visualisation qui peuvent être configurés pour accéder à un ensemble complet de données télématiques provenant des API Navixy. Cela inclut la sélection et la configuration de divers visualisations Grafana pour analyser les séries temporelles et d'autres types de données, vous permettant 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 basées sur les 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 simple. 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 améliorés. Pour commencer, vous pouvez exporter votre tableau de bord au format 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 impliquées peuvent accéder et bénéficier des analyses et des informations fournies par le tableau de bord.
Mis à jour
Ce contenu vous a-t-il été utile ?