> 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
Visualizar los datos de combustible y telemática en Grafana conectándose a la API de Navixy. Configuración paso a paso de paneles para rastrear el consumo histórico.
## 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 de los parámetros relacionados. Este análisis puede implicar examinar el nivel de combustible, la velocidad, el voltaje o el estado de la Ignición durante períodos de tiempo específicos y áreas en el Mapa para identificar cualquier evento anormal. También puede ofrecer información sobre las configuraciones de los sensores, diagnosticar problemas y monitorear el rendimiento en tiempo real. En este artículo, exploraremos cómo integrar las API de Grafana y Navixy para recuperar y visualizar sin esfuerzo los datos de control de combustible.
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 computadora portátil. El proceso de instalación suele tardar unos 30 minutos.
## Conectar Navixy con Grafana
Siguiendo esta guía paso a paso, puede integrar sin problemas Navixy con Grafana, lo que le permitirá visualizar y analizar sus datos telemáticos de manera eficaz.
### Paso 1: obtener la llave API de Navixy
Comience iniciando sesión en su cuenta de Navixy y navegando a **Preferencias**. Localice la **Llaves API** sección y genere una llave API única. Esta llave, como `"8f6a4353bc5114d97e2068b4e398"`, se usará para autenticar la conexión entre Navixy y Grafana.
### Paso 2: iniciar Grafana
Grafana ofrece 2 tipos de acceso: en la nube o implementado. El acceso en la nube puede obtenerse en su sitio web oficial . A continuación, exploraremos cómo instalar el paquete en su propio servidor o computadora 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 que la instalación se haya completado, 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 vaya a [http://localhost:3000](http://localhost:3000/). Use 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 dashboards, utilizando diversas fuentes de datos para visualizar y analizar sus datos.
Para instalaciones en Linux/Mac o si prefiere usar 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: instalar el complemento de fuente de datos JSON API
Una vez que se inicie Grafana, vaya al **Conexiones** o **Complementos** menú de la interfaz de Grafana. Busque el **JSON API** complemento de Fuente de datos y selecciónelo. Instale el complemento siguiendo las instrucciones proporcionadas. Este complemento es fundamental para establecer la comunicación entre Grafana y la API de Navixy.
### Paso 4: configurar la conexión de la Fuente de datos JSON API
Después de instalar el **JSON API** plugin, su instancia de Grafana está lista para conectarse con la API de Navixy usando la llave API.
Siga estos pasos para configurar la conexión:
1. Vaya a **Conexiones** menú del lado izquierdo
2. Busque **JSON API** y elija esta fuente
3. Haga clic en **Cree una** Fuente de datos JSON API
4. Complete los siguientes campos:
* Nombre: Elija un nombre preferido para la Fuente de datos
* URL: Ingrese la URL de la API de Navixy. Según la ubicación de su plataforma, use una de las siguientes URL:
* `https://api.eu.navixy.com/v2/` para Europa
* `https://api.us.navixy.com/v2/` para Norteamérica
* `` para instalaciones autohospedadas (On-Premise). El formato predeterminado suele ser `http(s)://your_configured_domain/api/`
* Cadena de consulta: Use una cadena de consulta con 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 **Guardar y probar** para verificar la conexión.
### Paso 5: importar la plantilla del dashboard de Navixy
Para agilizar el proceso de configuración, importe la [plantilla del dashboard de Navixy](https://github.com/Navixy/bi-integrations/blob/main/grafana/navixy_fuel_dashboard_demo.json) en Grafana. Acceda a la sección de administración de dashboards de Grafana, cree un dashboard nuevo y seleccione la opción para importar el dashboard. Cargue el archivo de plantilla del dashboard de Navixy proporcionado. Revise la configuración de importación, incluida la Fuente de datos asignada, y complete el proceso de importación.
## Analizar datos telemáticos con Grafana
Grafana proporciona un conjunto completo de objetos y herramientas de visualización, lo que permite a los profesionales de la telemática analizar e interpretar sin esfuerzo datos telemáticos complejos. Profundicemos en los elementos principales del dashboard de demostración ofrecido por Navixy, que están marcados en azul.
### Dispositivos y sensores para analizar
Para comenzar, en el dashboard de demostración, seleccione el dispositivo deseado usando el **Dispositivo** selector. Una vez seleccionado, puede crear varios gráficos de líneas en el mismo lienzo eligiendo los sensores deseados en los selectores resultantes. Seleccione en **Datos brutos 1** / **Datos brutos 2** los menús desplegables si desea analizar los datos brutos de los sensores.
### Rango de tiempo
En la esquina superior derecha, encontrará la opción para seleccionar el rango de fechas de su análisis. Esto le brinda 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 específicas.
### Gráficos de líneas
Grafana ofrece una gama de potentes opciones de visualización y, entre ellas, destaca el gráfico de líneas. Este gráfico permite un análisis integral de las lecturas de los sensores a lo largo del tiempo, lo cual resulta invaluable para los profesionales de la telemática. Al graficar 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 el rendimiento de la Flota. Las funciones interactivas, como hacer zoom y desplazarse por la vista, permiten a los profesionales profundizar en períodos de tiempo específicos, extrayendo así información más profunda de los datos.
### Tablas
Las tablas del dashboard 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 integral de puntos de datos individuales, lo que permite un examen detallado y la obtención de información. El dashboard de demostración de Navixy tiene 2 tablas: Datos brutos de sensores por marcas de tiempo y Recorridos completados con detalles.
### Mapa
Las visualizaciones de mapa de Grafana facilitan el monitoreo de objetos y eventos en un mapa, proporcionando información valiosa sobre las ubicaciones de los vehículos y los recorridos dentro de un rango de tiempo seleccionado. Esta poderosa función ofrece una visualización integral 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 de la representación visual, una tabla adjunta presenta métricas precisas como la duración del recorrido y la velocidad promedio, lo que mejora el análisis general.
## Resultado y siguientes pasos
La integración de las API de Grafana y Navixy ofrece una solución poderosa 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, monitorear eventos anormales y solucionar problemas de manera eficaz.
### Personalización del dashboard
Como integrador, usted tiene la flexibilidad de personalizar los elementos del dashboard para adaptarlos a sus requisitos específicos. Grafana proporciona varios objetos de visualización que se pueden configurar para acceder a un conjunto integral de datos telemáticos 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 dashboards personalizables, los usuarios pueden crear visualizaciones personalizadas que se ajusten a sus necesidades específicas de análisis. Esto permite a los gerentes de la Flota y a las partes interesadas monitorear el rendimiento en tiempo real, diagnosticar problemas y tomar decisiones informadas con base 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 otras personas en Grafana es un proceso fluido. Al compartir dashboards personalizados con miembros del equipo, clientes o partes interesadas, se fortalecen 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 simplificada de uso compartido garantiza que todas las personas involucradas puedan acceder a las perspectivas y al análisis del dashboard 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 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/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 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.