> 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/analytics/es/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md).

# Conectar Grafana

Conecte Grafana a IoT Query a través de la fuente de datos PostgreSQL. Cree gráficas de series de tiempo y paneles para el monitoreo en vivo e histórico de la telemática

Esta guía demuestra cómo conectar Grafana con **IoT Query** para visualizar datos de telemática y de flota. Grafana ofrece potentes capacidades de visualización para monitorear el estado del vehículo, los Datos del sensor y otras métricas en tiempo real.

{% hint style="info" %}
Esta guía forma parte de la **IoT Query** suite de documentación y, en particular, cubre la conexión de Power BI a su almacén de datos. Si aún está decidiendo qué herramienta de BI usar, consulte la [Selección de herramientas de BI](https://www.navixy.com/docs/analytics/iot-query/connection-setup/selecting-bi-tools) visión general.
{% endhint %}

Vea una breve visión general en video para ver lo que es posible con **IoT Query**la combinación +Grafana (disponible en inglés y español):

{% tabs %}
{% tab title="Inglés" %}
{% embed url="<https://youtu.be/jGO3hIAjPCo?si=7bzWO4XrTwGnTq3c>" %}
**IoT Query** + tutorial de visión general y configuración de Grafana.
{% endembed %}
{% endtab %}

{% tab title="Español" %}
{% embed url="<https://youtu.be/jEf7i_mAWPE?si=pru7QyYHzyoqK79Q>" %}
Descripción general y tutorial de configuración de **IoT Query** + Grafana.
{% endembed %}
{% endtab %}
{% endtabs %}

## Características del tablero

* Visualización en tiempo real de Datos del sensor
* Análisis de series temporales con rangos de tiempo personalizables
* Filtrado dinámico mediante variables
* Compatibilidad con múltiples fuentes de datos
* Gráficas y gráficos interactivos
* Creación de consultas personalizadas con SQL

## Requisitos técnicos

* Grafana 9.3 o posterior
* Complemento de Fuente de datos de PostgreSQL (incluido de forma predeterminada)
* Acceso a Internet para la conexión a la base de datos
* Activo **IoT Query** instancia con credenciales de conexión

## Instalación y configuración

Grafana debe instalarse en su sistema antes de que pueda conectarse a **IoT Query**.

{% stepper %}
{% step %}

#### Instale Grafana

1. Descargue e instale Grafana desde el sitio web oficial:\
   <https://grafana.com/grafana/download>
2. Siga las instrucciones de instalación de su sistema operativo.
   {% endstep %}

{% step %}

#### Descargar plantillas de tableros (opcional)

Hay plantillas de tablero preconstruidas disponibles para ayudarle a empezar rápidamente sin crear visualizaciones desde cero. Estas plantillas se mantienen en el [repositorio bi-intergrations](https://github.com/Navixy/bi-integrations) dentro de la `grafana` carpeta. Puede clonar el repositorio para acceder a tableros listos para usar:

```bash
git clone https://github.com/Navixy/bi-integrations.git
```

Consulte la `grafana` carpeta para ver los archivos JSON de tableros disponibles.
{% endstep %}
{% endstepper %}

## Conexión a la base de datos

La sección Conexiones en Grafana es donde administra todas las integraciones de fuentes de datos.

{% stepper %}
{% step %}

#### Acceda a la pestaña Conexiones

Abra Grafana y vaya a **Conexiones** en la barra lateral izquierda. **IoT Query** se ejecuta en PostgreSQL, por lo que necesita agregar una Fuente de datos de PostgreSQL para permitir que Grafana consulte sus datos telemáticos.
{% endstep %}

{% step %}

#### Agregar fuente de datos de PostgreSQL

El complemento de fuente de datos de PostgreSQL viene preinstalado con Grafana y ofrece compatibilidad nativa para conectarse a bases de datos PostgreSQL.

Para agregar la fuente de datos:

1. En la sección Conexiones, busque **PostgreSQL**
2. Haga clic en **Agregar nueva fuente de datos**
3. Se abrirá la página de configuración de PostgreSQL
   {% endstep %}

{% step %}

#### Configure los parámetros de conexión

Sus **IoT Query** datos de conexión contienen toda la información necesaria para establecer una conexión segura. Estos parámetros son únicos para su instancia y aseguran que Grafana pueda acceder a sus datos telemáticos.

Ubique los parámetros de conexión en su cuenta de Navixy y en el **IoT Query** correo electrónico de bienvenid&#x61;**.**

**Referencia de parámetros de conexión**

| Parámetro                  | Campo de configuración | Descripción                                                                                                |
| -------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| Host                       | `Host`                 | Servidor de base de datos proporcionado en sus **IoT Query** datos de conexión                             |
| Puerto                     | `Puerto`               | El valor predeterminado es 5432 para PostgreSQL                                                            |
| Nombre de la base de datos | `Base de datos`        | El nombre de la base de datos asignado                                                                     |
| Nombre de usuario          | `Usuario`              | Su nombre de usuario de base de datos (se indica como "usuario de base de datos" en los datos de conexión) |
| Contraseña                 | `Contraseña`           | Su contraseña segura de base de datos                                                                      |
| Modo SSL                   | `Modo SSL`             | Establézcalo en `require` para conexiones seguras                                                          |
| Versión de PostgreSQL      | `Versión`              | Seleccione **9.3** (configuración recomendada)                                                             |
| {% endstep %}              |                        |                                                                                                            |

{% step %}

#### Configure ajustes adicionales

Además de los parámetros de conexión esenciales, Grafana ofrece opciones de configuración adicionales. Para la mayoría de los usuarios, los valores predeterminados son adecuados y funcionarán correctamente sin modificaciones. Puede ajustar estos parámetros más adelante en función de los requisitos de seguridad de su organización, las limitaciones de infraestructura o las necesidades específicas del equipo.

Deje todos los demás campos con sus valores predeterminados para la configuración inicial. No necesita activar ningún interruptor o conmutador adicional.
{% endstep %}

{% step %}

#### Pruebe la conexión

Probar la conexión antes de guardar garantiza que todos los parámetros sean correctos y que Grafana pueda comunicarse correctamente con su **IoT Query** instancia.

Para verificar y guardar:

1. Asigne un nombre descriptivo a su conexión (por ejemplo, «**IoT Query** Producción» o «Analítica de flota»)
2. Haga clic en **Guardar y probar** para verificar su conexión
3. Un mensaje verde de éxito indica que la conexión funciona correctamente
   {% endstep %}
   {% endstepper %}

## Crear su primera visualización

Crear su primera visualización le ayuda a entender cómo Grafana consulta **IoT Query** y muestra los datos telemáticos. Este proceso implica crear un tablero, agregar un panel, configurar una consulta y seleccionar un formato de visualización adecuado.

{% stepper %}
{% step %}
**Crear un tablero nuevo**

Los tableros en Grafana sirven como contenedores para múltiples visualizaciones. Crear un tablero dedicado le ayuda a organizar visualizaciones relacionadas y proporciona un lugar central para monitorear aspectos específicos de las operaciones de su flota.

Para crear un tablero:

1. Vaya a **Tableros** en la barra lateral izquierda
2. Haga clic en **Crear tablero**
3. Seleccione **Agregar visualización**
4. Elija la fuente de datos de PostgreSQL que acaba de configurar
   {% endstep %}

{% step %}
**Configure la consulta**

Grafana ofrece dos modos de consulta: un constructor visual y un editor de código. Para **IoT Query** las conexiones, el editor de código le brinda control total sobre las consultas SQL y se recomienda para el análisis de datos telemáticos.

Para escribir su consulta:

1. En el editor de consultas, cambie de **Constructor** a **Código** modo
2. Escriba su consulta SQL directamente

Ejemplo de consulta para la visualización de Datos del sensor:

```sql
SELECT 
    device_time AS time,
    value::numeric AS value,
    sensor_name
FROM raw_telematics_data.inputs
WHERE sensor_name = 'temperature'
    AND device_id = 12345
    AND $__timeFilter(device_time)
ORDER BY device_time
```

La consulta incluye un componente de tiempo (`device_time AS time`) que es esencial para las visualizaciones de series temporales. La `$__timeFilter()` función es una macro de Grafana que aplica automáticamente el rango de tiempo seleccionado del tablero a su consulta.

Para ver más ejemplos de consultas, consulte el [Libro de recetas SQL](https://www.navixy.com/docs/analytics/example-queries).
{% endstep %}

{% step %}
**Establecer el formato de visualización**

El formato de visualización determina cómo se muestran sus datos en el tablero. Distintos formatos se adaptan a distintos tipos de datos: las series temporales funcionan bien para lecturas de sensores a lo largo del tiempo, mientras que las tablas son mejores para registros detallados.

Para configurar el formato:

1. Haga clic en **Ejecutar consulta** para verificar que su consulta devuelva datos
2. Ubique el selector de tipo de visualización (normalmente en la esquina superior derecha del panel)
3. Cambie el formato de **Tabla** a **Series temporales** o al formato que prefiera
4. Observe la visualización de los datos para asegurarse de que se muestre correctamente

Las visualizaciones de series temporales requieren una columna de tiempo y valores numéricos para funcionar correctamente. Su consulta debe devolver datos en el formato adecuado para el tipo de visualización seleccionado.
{% endstep %}

{% step %}
**Guarde su visualización**

Guardar su trabajo conserva la configuración de la visualización y la deja disponible para referencia futura. Guardar con regularidad es importante: Grafana no guarda los cambios automáticamente, por lo que podría perder su trabajo si sale de la página sin guardar.

Para guardar una visualización:

1. Haga clic en **Guardar**
2. Proporcione un nombre descriptivo para su tablero
3. Seleccione o cree una carpeta para organizarlo
4. Confirme la operación de guardado

El tablero ahora está disponible en su instancia de Grafana y puede accederse a él desde el menú Tableros.
{% endstep %}
{% endstepper %}

### Trabajar con variables

Las variables son una de las funciones más poderosas de Grafana para crear tableros dinámicos e interactivos. En lugar de codificar valores específicos como nombres de sensores o IDs de dispositivo en sus consultas, las variables permiten a los usuarios seleccionar distintos valores desde menús desplegables sin editar el SQL subyacente. Esto hace que los tableros sean más flexibles y fáciles de usar.

{% stepper %}
{% step %}
**Acceda a la configuración de variables**

Las variables se configuran a nivel de tablero y se aplican a todas las visualizaciones dentro de ese tablero. Debe acceder a la configuración del tablero para crear y administrar variables.

Para comenzar:

1. Abra su tablero
2. Haga clic en el tablero **Configuración** icono (icono de engranaje) en la esquina superior derecha
3. Vaya a la **Variables** sección en el panel izquierdo
4. La sección estará vacía si aún no se han creado variables
   {% endstep %}

{% step %}
**Configure una variable**

Cada variable necesita un nombre, una fuente de datos y una consulta que devuelva los posibles valores que los usuarios pueden seleccionar. Los valores de la variable se rellenan dinámicamente consultando su **IoT Query** instancia.

Para crear una variable:

1. Haga clic en **Agregar variable**
2. Configure los siguientes ajustes:
   1. **Ajustes generales:**
      1. **Nombre**: `sensor_name` (use un identificador claro y descriptivo sin espacios)
      2. **Etiqueta**: igual que el nombre para mantener la coherencia; esto es lo que los usuarios ven en el tablero
      3. **Tipo**: seleccione **Consulta** para poblar valores desde la base de datos
   2. **Opciones de consulta:**
      1. **Fuente de datos**: seleccione su PostgreSQL **IoT Query** conexión del menú desplegable
      2. **Consulta**: escriba una consulta SQL para poblar los valores de la variable

Ejemplo de consulta para listar todos los sensores de un dispositivo específico:

```sql
SELECT DISTINCT sensor_name
FROM raw_telematics_data.inputs
WHERE device_id = 12345
ORDER BY sensor_name
```

Después de escribir la consulta, Grafana la ejecuta de inmediato y muestra una vista previa de los valores devueltos en la parte inferior de la página de configuración. Esto confirma que su consulta funciona correctamente y muestra qué opciones estarán disponibles en el menú desplegable.
{% endstep %}

{% step %}
**Aplicar variables en las consultas**

Una vez que se crea una variable, debe actualizar sus consultas de visualización para hacer referencia a ella. Las variables usan una sintaxis especial con un prefijo de signo de dólar, y Grafana sustituye automáticamente el valor seleccionado al ejecutar las consultas.

Para usar la variable:

1. Abra la visualización que desea hacer dinámica
2. Edite la consulta
3. Reemplace el valor fijo con la referencia de la variable

Ejemplo de consulta actualizada usando la variable:

```sql
SELECT 
    device_time AS time,
    value::numeric AS value,
    sensor_name
FROM raw_telematics_data.inputs
WHERE sensor_name = '$sensor_name'
    AND device_id = 12345
    AND $__timeFilter(device_time)
ORDER BY device_time
```

Observe cómo `'temperature'` se ha reemplazado por `'$sensor_name'`. Las comillas son importantes para los valores de texto en SQL.
{% endstep %}

{% step %}
**Guarde y pruebe**

Probar la variable garantiza que funcione correctamente y actualice las visualizaciones como se espera. Asegúrese de guardar su trabajo en cada paso para evitar perder cambios de configuración.

Para completar la configuración:

1. Haga clic en **Aplicar** para guardar la configuración de la variable
2. Haga clic en **Guardar tablero** para conservar todos los cambios
3. Regrese a la vista principal del tablero
4. Ubique el menú desplegable de la variable en la parte superior del tablero
5. Seleccione distintos nombres de sensores del menú desplegable
6. Observe que la visualización se actualiza automáticamente con datos del sensor seleccionado

Si la visualización no se actualiza cuando cambia la selección de la variable, verifique que el nombre de la variable en su consulta coincida exactamente con el nombre de la variable que creó (los nombres de las variables distinguen mayúsculas y minúsculas).
{% endstep %}
{% endstepper %}

### Importar tableros preconstruidos

Los tableros preconstruidos ofrecen una forma rápida de comenzar a visualizar sus datos sin construir todo desde cero. Estos tableros están diseñados por usuarios experimentados e incluyen buenas prácticas para la visualización, el diseño y la optimización de consultas. Sin embargo, requieren configuración para conectarse a su **IoT Query** instancia.

{% stepper %}
{% step %}
**Acceda a la función de importación**

La función de importación de Grafana le permite cargar configuraciones de tablero desde archivos JSON o directamente desde Grafana.com usando identificadores de tablero.

1. Vaya a **Tableros**
2. Haga clic en **Nuevo** → **Importar**
3. Aparecerá una ventana de carga
   {% endstep %}

{% step %}
**Importe el tablero**

El proceso de importación acepta configuraciones de tablero en múltiples formatos, lo que le brinda flexibilidad en la forma en que carga tableros preconstruidos.

Puede importar tableros mediante:

* **ID del tablero** desde Grafana.com
* **archivo JSON** descargado del repositorio bi-intergrations
* **modelo JSON** pegado directamente

Si usa un archivo JSON:

1. Haga clic en **Cargue el archivo JSON**
2. Seleccione el archivo del tablero
3. Proporcione un nombre y seleccione la carpeta de destino
4. Haga clic en **Importar**

Espere a que la plantilla del tablero termine de cargarse. Una vez completado, el tablero aparecerá, pero aún no mostrará datos porque sigue conectado a la fuente de datos original que se usó cuando se creó la plantilla.
{% endstep %}

{% step %}
**Actualizar conexiones de fuentes de datos**

Este es un paso crítico. Los tableros importados están conectados inicialmente a fuentes de datos externas que no tienen acceso a sus **IoT Query** datos. Debe actualizar cada visualización para que use su PostgreSQL **IoT Query** conexión.

Para actualizar las visualizaciones:

1. Abra el tablero importado
2. Haga clic en **Editar** en el primer panel de visualización (busque el icono de edición o el menú de tres puntos)
3. En el editor de consultas, ubique el selector de fuente de datos
4. Cambie la fuente de datos de la fuente original de la plantilla a su PostgreSQL **IoT Query** conexión
5. Haga clic en **Ejecutar consulta** para verificar que la visualización recupere datos correctamente
6. Haga clic en **Guardar** para conservar los cambios
7. Repita este proceso para cada panel de visualización del tablero

{% hint style="info" %}
Guarde su trabajo con frecuencia durante este proceso. Es posible que tenga varias visualizaciones que actualizar, y guardar después de cada una garantiza que no perderá el progreso.
{% endhint %}
{% endstep %}

{% step %}
**Actualizar variables del tablero**

Muchos tableros preconstruidos usan variables para el filtrado y la interactividad. Estas variables también están conectadas a la fuente de datos original y deben actualizarse para consultar su **IoT Query** instancia.

Para actualizar las variables:

1. Abra **Configuración** → **Variables**
2. Verá una lista de todas las variables usadas en el tablero
3. Haga clic en **Editar** en la primera variable
4. Ubique el **Fuente de datos** menú desplegable en la sección Opciones de consulta
5. Cámbielo a su PostgreSQL **IoT Query** conexión
6. Verifique que la vista previa en la parte inferior muestre los valores esperados de su base de datos
7. Haga clic en **Aplicar** para confirmar los cambios
8. Repita esto para cada variable de la lista

Después de actualizar todas las variables, guarde el tablero nuevamente. Las variables ahora deberían poblarse con valores de su **IoT Query** instancia.
{% endstep %}

{% step %}
**Verificar la funcionalidad del tablero**

Una vez que haya actualizado todas las visualizaciones y variables, verifique que todo funcione correctamente en conjunto. Esta revisión final garantiza que el tablero esté completamente funcional y listo para su uso regular.

Para verificar:

1. Guarde el tablero una vez más usando **Ctrl+S** o el **Guardar** botón
2. Actualice por completo la página del navegador (o use **F5**)
3. Compruebe que todas las visualizaciones muestren datos correctamente
4. Pruebe cada menú desplegable de variables para asegurarse de que se llene con valores
5. Seleccione distintos valores de variables y confirme que las visualizaciones se actualicen en consecuencia
6. Pruebe distintos rangos de tiempo usando el selector de tiempo

Si alguna visualización permanece vacía o muestra errores, regrese al modo de edición y verifique la configuración de la fuente de datos y de la consulta para esos paneles específicos.
{% endstep %}
{% endstepper %}

## Solución de problemas

### Problemas de conexión a la base de datos

**Error de conexión**: verifique que las credenciales y los parámetros de conexión coincidan exactamente con los de su **IoT Query** información. Verifique que el host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña sean correctos.

**Error del firewall**: asegúrese de que su red permita conexiones al host y al puerto especificados. Comuníquese con su administrador de red si los intentos de conexión están bloqueados.

**Error de SSL/TLS**: verifique que el modo SSL esté configurado en `require` y que su instancia de Grafana admita conexiones SSL.

### Problemas de consultas y visualización

**Visualización vacía**: primero, verifique que la consulta realmente devuelva datos revisando el inspector de consultas (haga clic en el botón «Inspector de consultas» en el editor del panel). Asegúrese de que el rango de tiempo seleccionado incluya períodos en los que haya datos en su base de datos. Confirme que la fuente de datos esté seleccionada y conectada correctamente. Verifique que los nombres de tablas y columnas de su consulta coincidan con la estructura real del esquema.

**La variable no funciona**: verifique que la consulta de la variable devuelva valores revisando la vista previa en la página de configuración de la variable. Asegúrese de que la referencia de la variable en su consulta use la sintaxis correcta («`$variable_name`) sin errores tipográficos. Verifique que la variable esté guardada correctamente y aplicada al dashboard. Si el menú desplegable de la variable está vacío, revise la consulta SQL de la variable en busca de errores.

**Rendimiento lento de las consultas**: Considere agregar índices de base de datos a columnas consultadas con frecuencia como `device_time` y `device_id`. Limite los rangos de datos usando filtros de tiempo de forma más restrictiva. Optimice la estructura de la consulta seleccionando solo las columnas necesarias en lugar de usar `SELECT *`. Consulte la [Libro de recetas SQL](https://www.navixy.com/docs/analytics/example-queries) para ver ejemplos de optimización del rendimiento y patrones de consulta probados.

**Incompatibilidad de formato**: Asegúrese de que su consulta devuelva datos en el formato esperado por su tipo de visualización. Los paneles de series temporales requieren una columna con el alias de `time` y columnas de valores numéricos. Los paneles de tabla aceptan cualquier estructura de columnas. Los paneles de gráfico necesitan datos de tiempo y numéricos. Consulte la documentación de Grafana para conocer los requisitos específicos de cada tipo de visualización.

### Problemas de importación

**Datos faltantes después de la importación**: Verifique que las conexiones de la fuente de datos estén actualizadas para todos los paneles y variables. No omita ningún panel durante el proceso de actualización. Compruebe que los nombres de esquema (`raw_business_data` o `raw_telematics_data`) especificados en las consultas sean correctos para su **IoT Query** instancia. Asegúrese de que los nombres de tabla y de columna coincidan con la estructura real de su base de datos.

**El dashboard muestra errores**: Abra el editor de consultas de cada panel y haga clic en «Query inspector» para ver mensajes de error detallados. Revise cuidadosamente los mensajes de error: a menudo indican problemas específicos como columnas faltantes, tipos de datos incorrectos o errores de sintaxis. Asegúrese de que los nombres de campo en las consultas coincidan exactamente con su **IoT Query** esquema exactamente (los nombres de campo distinguen mayúsculas y minúsculas). Verifique que los tipos de datos devueltos por las consultas sean compatibles con el tipo de visualización.

**Las variables no se cargan**: Verifique que haya actualizado la fuente de datos de cada variable, no solo los paneles de visualización. Compruebe que las consultas de las variables sean sintácticamente correctas y devuelvan datos cuando se ejecutan directamente. Asegúrese de que el tipo de variable esté configurado como «Query» en lugar de «Custom» u otros tipos.

## Siguientes pasos

Después de conectar correctamente Grafana a su **IoT Query** instancia:

* Explore los esquemas de datos disponibles revisando la [Visión general del esquema](/docs/analytics/es/iot-query/schema-overview.md) para comprender la estructura de datos, las relaciones entre tablas y los campos disponibles.
* Empiece con consultas simples centradas en entidades de negocio específicas antes de crear dashboards complejos; esto le ayudará a aprender la estructura de datos y a evitar problemas de rendimiento.
* Revise la [Libro de recetas SQL](/docs/analytics/es/example-queries.md) para patrones de consulta comprobados y técnicas de optimización, y ejemplos de escenarios comunes de analítica telemática
* Experimente con distintos tipos de visualización (series temporales, tablas, medidores, paneles de estadística) para encontrar la mejor representación para sus datos específicos y casos de uso
* Considere crear varios dashboards para distintos fines: monitoreo en tiempo real, análisis histórico, resúmenes ejecutivos y reportes operativos.

### Soporte

Para preguntas técnicas o asistencia con **IoT Query** las conexiones, póngase en contacto con soporte en <support@navixy.com>.


---

# 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/analytics/es/iot-query/connection-setup/selecting-bi-tools/connecting-grafana.md?ask=<question>&goal=<user_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.