# Análisis de datos de combustible con Grafana mediante integración API de Navixy

## Introducción

A veces nuestros socios e integradores se encuentran con situaciones en las que requieren un análisis más profundo de los datos crudos de combustible y parámetros relacionados. Este análisis puede implicar examinar el nivel de combustible, la velocidad, el voltaje o el estado de ignición durante marcos temporales y áreas específicas del mapa para identificar cualquier evento anómalo. También puede aportar información sobre las configuraciones de los sensores, diagnosticar problemas y monitorizar el rendimiento en tiempo real. En este artículo exploraremos cómo integrar Grafana y las API de Navixy para recuperar y visualizar datos de control de combustible sin complicaciones.

Grafana es una herramienta de visualización de datos de código abierto que ofrece una amplia gama de opciones de visualización personalizables. Puede instalarse y configurarse fácilmente incluso en su PC o portátil. El proceso de instalación suele tardar aproximadamente 30 minutos.

## Conectar Navixy con Grafana

Siguiendo esta guía paso a paso, podrá integrar sin problemas Navixy con Grafana, lo que le permitirá visualizar y analizar sus datos telemáticos de manera eficaz.

### Paso 1: Obtención de la clave API de Navixy

Comience iniciando sesión en su cuenta de Navixy y vaya a la Configuración de la cuenta. Dentro de la configuración, localice la sección de claves API y genere una clave API única. Esta clave, como `"8f6a4353bc5114d97e2068b4e398"`, se utilizará para autenticar la conexión entre Navixy y Grafana.

### Paso 2: Iniciar Grafana

Grafana ofrece 2 tipos de acceso: en la nube o desplegado. El acceso en la nube puede obtenerse en su sitio web oficial <https://grafana.com/>. A continuación vamos a explorar cómo instalar el paquete en su propio servidor o equipo local.

Para desplegar Grafana en una máquina Windows local, siga estos sencillos pasos:

1. Descargue el instalador más reciente de Grafana para Windows desde la página oficial de descargas.
2. Ejecute el instalador descargado (por ejemplo, grafana-xx.x.x.windows-amd64.msi, donde xx.x.x es el número de versión) y complete la instalación siguiendo las indicaciones.
3. Una vez finalizada la instalación, inicie Grafana ejecutando el archivo grafana-server.exe ubicado en la carpeta bin del directorio de instalación (por ejemplo, C:\Program Files\GrafanaLabs\grafana\bin).
4. Abra un navegador web y navegue a [http://localhost:3000](http://localhost:3000/). Use las credenciales de acceso por defecto "admin" tanto para el nombre de usuario como para la contraseña.
5. Después de iniciar sesión, podrá comenzar de inmediato a crear y personalizar paneles, utilizando diversas fuentes de datos para visualizar y analizar sus datos.

Para instalaciones en Linux/Mac o si prefiere usar la versión Docker de Grafana, consulte la documentación oficial de Grafana para obtener instrucciones detalladas adaptadas a su configuración específica.

### Paso 3: Instalación del plugin de fuente de datos JSON API

Una vez que Grafana esté en marcha, vaya al menú "Connections" o "Plugins" en la interfaz de Grafana. Busque el plugin de fuente de datos "JSON API" y selecciónelo. Instale el plugin siguiendo las instrucciones proporcionadas. Este plugin es crucial para establecer la comunicación entre Grafana y la API de Navixy.

### Paso 4: Configuración de la conexión de la fuente de datos JSON API

Tras instalar el plugin "JSON API", su instancia de Grafana estará lista para conectarse con la API de Navixy usando la clave API.

Siga estos pasos para configurar la conexión:

1. Vaya al menú "Connections" en el lado izquierdo
2. Busque "JSON API" y elija esta fuente
3. Haga clic en "Create a JSON API data source"
4. Rellene los siguientes campos:

* Name: Elija un nombre preferido para la fuente de datos
* URL: Introduzca la URL de la API de Navixy. Dependiendo de la ubicación de su plataforma, utilice una de las siguientes URLs:
  * `https://api.eu.navixy.com/v2/` para Europa
  * `https://api.us.navixy.com/v2/` para Norteamérica
  * `<your_configured_domain_api_url>` para instalaciones autoalojadas (On-Premise). El formato por defecto suele ser `http(s)://your_configured_domain/api/`
* Query string: Use una cadena de consulta en el formato `hash=[YOUR_API_KEY]&iso_datetime=true`. Por ejemplo: `hash=8f6a4353bc5114d977e2068b4e398&iso_datetime=true`.

5. Personalice cualquier configuración adicional según sea necesario y luego haga clic en "Save & Test" para verificar la conexión.

![Grafana y Navixy API - elección de la fuente de datos](https://2148007315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-221627e84bfc36d7ad4c9a32dc1fd899de80f956%2Fimage-20231017-075916.png?alt=media)

![Grafana y Navixy API - configuración de la fuente de datos](https://2148007315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-754d84661ef8e5cb10b8d1318ebd4a474a4ca9bf%2Fimage-20231017-080330.png?alt=media)

### Paso 5: Importación de la plantilla de dashboard de Navixy

Para agilizar el proceso de configuración, importe la [plantilla de dashboard](https://github.com/SquareGPS/bi-intergrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) de Navixy en Grafana. Acceda a la sección de gestión de dashboards de Grafana, cree un nuevo dashboard y seleccione la opción para importar el dashboard. Suba el archivo de plantilla de dashboard de Navixy proporcionado. Revise los ajustes de importación, incluida la fuente de datos asignada, y complete el proceso de importación.

## Análisis de datos telemáticos con Grafana

Grafana proporciona un conjunto completo de objetos y herramientas de visualización, permitiendo a los profesionales de telemática analizar e interpretar datos telemáticos complejos sin esfuerzo. Profundicemos en los elementos principales del dashboard demo ofrecido por Navixy que están marcados en azul.

![](https://2148007315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-4dad2c18d89bcb81bd5c8af37a72b60cd6e4a654%2Fimage-20231017-083157.png?alt=media)

### Rastreadores y sensores para analizar

Para comenzar, en el dashboard demo seleccione el dispositivo deseado usando el selector "Tracker". Una vez seleccionado, puede crear múltiples gráficos de líneas en el mismo lienzo eligiendo los sensores deseados en los selectores "Sensor 1" y "Sensor 2". Seleccione “True” en los menús desplegables “Raw Data 1” / “Raw data 2” si desea analizar los datos crudos de los sensores.

### Rango de tiempo

En la esquina superior derecha encontrará la opción para seleccionar el rango de fechas para su análisis. Esto le da flexibilidad para elegir entre rangos rápidos, que proporcionan intervalos de tiempo predefinidos, o un rango de tiempo absoluto, donde puede especificar fechas de inicio y fin concretas.

### Gráficos de líneas

Grafana ofrece una gama de potentes opciones de visualización y, entre ellas, el gráfico de líneas destaca. Este gráfico permite un análisis exhaustivo de las lecturas de los sensores a lo largo del tiempo, lo cual resulta invaluable para los profesionales de telemática. Al trazar datos telemáticos como nivel de combustible, velocidad del vehículo, etc., en un gráfico de líneas, los usuarios obtienen la capacidad de identificar patrones, tendencias y anomalías que podrían afectar el rendimiento de la flota. Las funciones interactivas, como el zoom y el paneo, permiten a los profesionales profundizar en periodos de tiempo específicos, extrayendo así conocimientos más detallados de los datos.

### Tablas

Las tablas del dashboard proporcionan un formato estructurado y fácil de usar para explorar los datos crudos de los sensores. Cada valor va acompañado de una marca temporal, lo que permite a los usuarios seguir fácilmente cuándo se generaron los datos. Esta presentación organizada facilita un análisis exhaustivo de puntos de datos individuales, permitiendo un examen detallado y la obtención de conclusiones. El dashboard demo de Navixy tiene 2 tablas: Datos crudos del sensor por marcas temporales y Tracks completados con detalles.

### Vista de mapa

Las vistas de mapa de Grafana facilitan la monitorización de objetos y eventos en un mapa, proporcionando valiosos datos sobre las ubicaciones de los vehículos y los viajes dentro de un rango de tiempo seleccionado. Esta potente función ofrece una visualización completa de los movimientos previos de los vehículos, permitiendo a los usuarios analizar datos históricos y desarrollar una comprensión más profunda de las operaciones de la flota. Complementando la representación visual, una tabla asociada presenta métricas precisas como la longitud del viaje y la velocidad media, mejorando el análisis general.

## Resultado y siguientes pasos

La integración de Grafana y las API de Navixy ofrece una solución potente para visualizar y analizar datos telemáticos relacionados con el control de combustible. Al aprovechar las capacidades de visualización de datos de código abierto de Grafana y la extensa API de Navixy, los usuarios pueden obtener valiosos conocimientos sobre el consumo de combustible de su flota, monitorizar eventos anormales y solucionar problemas de manera eficaz.

### Personalización del dashboard

Como integrador, tiene la flexibilidad de personalizar los elementos del dashboard para adaptarlos a sus requisitos específicos. Grafana proporciona varios objetos de visualización que pueden configurarse para acceder a un conjunto completo de datos telemáticos desde las API de Navixy. Esto incluye la selección y configuración de diversas [visualizaciones de Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) para analizar series temporales y otros tipos de datos, permitiéndole explorar los datos de una manera más significativa. Al utilizar dashboards personalizables, los usuarios pueden crear visualizaciones personalizadas que se adapten a sus necesidades de análisis específicas. Esto capacita a los gestores de flota y a las partes interesadas para monitorizar el rendimiento en tiempo real, diagnosticar problemas y tomar decisiones informadas basadas en los datos analizados. La personalización del dashboard requiere experiencia en el uso de las API de Navixy y en el trabajo con el formato JSON.

### Compartir dashboards de Grafana

Compartir su dashboard personalizado con otros en Grafana es un proceso sencillo. Al compartir dashboards personalizados con miembros del equipo, clientes o partes interesadas, se mejora la colaboración y el intercambio de conocimientos. Para comenzar, puede exportar su dashboard como un archivo JSON, que incluye toda la información esencial necesaria para replicar el dashboard en otra instancia de Grafana. Esta función de compartición optimizada asegura que todos los involucrados puedan acceder y beneficiarse de los conocimientos y análisis del dashboard.
