> 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/es/vehicle-telematics-technology/fuel-management/fuel-control-in-navixy/fuel-data-analysis-with-grafana-via-navixy-api-integration.md).
# Análisis de datos de combustible con Grafana mediante la integración de la 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 brutos de combustible y los parámetros relacionados. Este análisis puede implicar la revisión del nivel de combustible, la velocidad, el voltaje o el estado del encendido en intervalos de tiempo específicos y áreas del mapa para identificar cualquier evento anómalo. También puede proporcionar información sobre las configuraciones de los sensores, diagnosticar problemas y supervisar el rendimiento en tiempo real. En este artículo, exploraremos cómo integrar las API de Grafana y Navixy para recuperar y visualizar datos de control de combustible sin esfuerzo.
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 unos 30 minutos.
## Conexión de Navixy con Grafana
Siguiendo esta guía paso a paso, podrá integrar Navixy con Grafana sin problemas, lo que le permitirá visualizar y analizar sus datos telemáticos de forma eficaz.
### Paso 1: Obtención de la clave API de Navixy
Empiece iniciando sesión en su cuenta de Navixy y accediendo 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: Inicio de Grafana
Grafana ofrece 2 tipos de acceso: en la nube o desplegado. El acceso en la nube puede obtenerse en su sitio web oficial . A continuación, veremos cómo instalar el paquete en su propio servidor o en un ordenador local.
Para implementar 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 completada 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 acceda a [http://localhost:3000](http://localhost:3000/). Utilice las credenciales de inicio de sesión predeterminadas "admin" tanto para el nombre de usuario como para la contraseña.
5. Después de iniciar sesión, puede 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 utilizar la versión de Grafana para Docker, consulte la documentación oficial de Grafana para obtener instrucciones detalladas adaptadas a su configuración específica.
### Paso 3: Instalación del complemento de fuente de datos JSON API
Una vez iniciado Grafana, vaya al menú "Connections" o "Plugins" en la interfaz de Grafana. Busque el complemento de fuente de datos "JSON API" y selecciónelo. Instale el complemento siguiendo las instrucciones proporcionadas. Este complemento 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
Después de instalar el complemento "JSON API", su instancia de Grafana estará lista para conectarse con la API de Navixy utilizando 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. Complete los siguientes campos:
* Name: Elija un nombre preferido para la fuente de datos
* URL: Introduzca la URL de la API de Navixy. Según 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 América del Norte
* `` para instalaciones autohospedadas (On-Premise). El formato predeterminado suele ser `http(s)://your_configured_domain/api/`
* Query string: Utilice 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, a continuación, haga clic en "Save & Test" para verificar la conexión.
### Paso 5: Importación de la plantilla del panel de Navixy
Para agilizar el proceso de configuración, importe la [plantilla del panel](https://github.com/SquareGPS/bi-intergrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) de Navixy en Grafana. Acceda a la sección de administración de paneles de Grafana, cree un nuevo panel y seleccione la opción para importar el panel. Cargue el archivo de plantilla del panel de Navixy proporcionado. Revise la configuración 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, lo que permite a los profesionales de telemática analizar e interpretar sin esfuerzo datos telemáticos complejos. Profundicemos en los elementos principales del panel de demostración ofrecido por Navixy, marcados en azul.
### Rastreadores y sensores para analizar
Para comenzar, en el panel de demostración, seleccione el dispositivo deseado utilizando el selector "Tracker". Una vez seleccionado, puede crear varios 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 brutos de los sensores.
### Intervalo de tiempo
En la esquina superior derecha, encontrará la opción para seleccionar el intervalo de fechas para su análisis. Esto le ofrece flexibilidad para elegir entre intervalos rápidos, que proporcionan intervalos de tiempo predefinidos, o un intervalo de tiempo absoluto, donde puede especificar fechas concretas de inicio y fin.
### 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 especialmente. Este gráfico permite un análisis exhaustivo de las lecturas de los sensores a lo largo del tiempo, lo cual resulta inestimable para los profesionales de telemática. Al representar datos telemáticos como el nivel de combustible, la 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 al rendimiento de la flota. Las funciones interactivas, como el zoom y el desplazamiento, permiten a los profesionales profundizar en periodos de tiempo específicos y extraer así información más detallada de los datos.
### Tablas
Las tablas del panel proporcionan un formato estructurado y fácil de usar para explorar los datos brutos de los sensores. Cada valor va acompañado de una marca de tiempo, lo que permite a los usuarios rastrear fácilmente cuándo se generaron los datos. Esta presentación organizada facilita un análisis exhaustivo de los puntos de datos individuales, permitiendo un examen detallado y la obtención de información. El panel de demostración de Navixy tiene 2 tablas: datos brutos de sensores por marcas de tiempo y rutas completadas con detalles.
### Vista de mapa
Las visualizaciones de mapa de Grafana facilitan la supervisión de objetos y eventos en un mapa, proporcionando información valiosa sobre las ubicaciones y los trayectos de los vehículos dentro de un intervalo de tiempo seleccionado. Esta potente función ofrece una visualización completa de los movimientos anteriores de los vehículos, lo que permite a los usuarios analizar datos históricos y desarrollar una comprensión más profunda de las operaciones de la flota. Como complemento a la representación visual, una tabla adjunta presenta métricas precisas como la longitud del trayecto y la velocidad media, mejorando el análisis general.
## Resultado y siguientes pasos
La integración de las API de Grafana y 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 amplia API de Navixy, los usuarios pueden obtener información valiosa sobre el consumo de combustible de su flota, supervisar eventos anómalos y solucionar problemas de forma eficaz.
### Personalización del panel
Como integrador, tiene la flexibilidad de personalizar los elementos del panel para adaptarlos a sus requisitos específicos. Grafana ofrece varios objetos de visualización que pueden configurarse para acceder a un conjunto completo de datos telemáticos procedentes de las API de Navixy. Esto incluye seleccionar y configurar diversas [visualizaciones de Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/) para analizar series temporales y otros tipos de datos, lo que le permite explorar los datos de una manera más significativa. Al utilizar paneles personalizables, los usuarios pueden crear visualizaciones personalizadas que se adapten a sus necesidades específicas de análisis. Esto permite a los gestores de flotas y a las partes interesadas supervisar el rendimiento en tiempo real, diagnosticar problemas y tomar decisiones informadas basadas en los datos analizados. La personalización del panel requiere experiencia en el uso de las API de Navixy y en el trabajo con el formato JSON.
### Compartir paneles de Grafana
Compartir su panel personalizado con otras personas en Grafana es un proceso sencillo. Al compartir paneles personalizados con miembros del equipo, clientes o partes interesadas, se mejora la colaboración y el intercambio de conocimientos. Para comenzar, puede exportar su panel como un archivo JSON, que incluye toda la información esencial necesaria para replicar el panel en otra instancia de Grafana. Esta función optimizada para compartir garantiza que todas las personas implicadas puedan acceder a la información y el análisis del panel y beneficiarse de ellos.
---
# 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/es/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.