Conexión con Grafana
Esta guía demuestra cómo conectar Grafana a Consulta de IoT para visualizar datos de telemática y de flota. Grafana proporciona potentes capacidades de visualización para supervisar el estado de los vehículos, los datos de los sensores y otras métricas en tiempo real.
Esta guía forma parte de la Consulta de IoT suite de documentación y cubre específicamente la conexión de Power BI a su almacén de datos. Si aún está decidiendo qué herramienta de BI usar, consulte la Seleccionar herramientas de BI visión general.
Vea un breve video resumen para ver lo que es posible con Consulta de IoTcombinación +Grafana (disponible en inglés y español):
Funciones del panel
Visualización de datos de sensores en tiempo real
Análisis de series temporales con rangos de tiempo personalizables
Filtrado dinámico mediante variables
Compatibilidad con múltiples orígenes de datos
Gráficos e interacciones dinámicas
Creación de consultas personalizadas con SQL
Requisitos técnicos
Grafana 9.3 o posterior
Plugin de origen de datos PostgreSQL (incluido por defecto)
Acceso a Internet para la conexión a la base de datos
Instancia Consulta de IoT activa con credenciales de conexión
Instalación y configuración
Grafana debe estar instalado en su sistema antes de que pueda conectarse a Consulta de IoT.
Instalar Grafana
Descargue e instale Grafana desde el sitio web oficial: https://grafana.com/grafana/download
Siga las instrucciones de instalación para su sistema operativo.
Descargar plantillas de panel (opcional)
Hay plantillas de panel preconstruidas disponibles para ayudarle a comenzar rápidamente sin crear visualizaciones desde cero. Estas plantillas las mantiene el repositorio bi-intergrations en la carpeta grafana . Puede clonar el repositorio para acceder a paneles listos para usar:
Compruebe la carpeta grafana carpeta para los archivos JSON de panel disponibles.
Conexión a la base de datos
La sección Conexiones en Grafana es donde gestiona todas las integraciones de orígenes de datos.
Agregar origen de datos PostgreSQL
El plugin de origen de datos PostgreSQL viene preinstalado con Grafana y proporciona soporte nativo para la conexión a bases de datos PostgreSQL.
Para agregar el origen de datos:
En la sección Conexiones, busque PostgreSQL
Haga clic Agregar nuevo origen de datos
Se abrirá la página de configuración de PostgreSQL
Configurar parámetros de conexión
Su Consulta de IoT Los detalles de conexión contienen toda la información necesaria para establecer una conexión segura. Estos parámetros son únicos para su instancia y garantizan que Grafana pueda acceder a sus datos de telemática.
Localice sus parámetros de conexión en su cuenta Navixy y en el Consulta de IoT correo de bienvenida.
Referencia de parámetros de conexión
Host
Host
Dirección del servidor de base de datos proporcionada en sus Consulta de IoT detalles de conexión
Puerto
Puerto
El valor predeterminado es 5432 para PostgreSQL
Nombre de la base de datos
Base de datos
El nombre de base de datos asignado
Nombre de usuario
Usuario
Su nombre de usuario de la base de datos (denominado "usuario de base de datos" en los detalles de conexión)
Contraseña
Contraseña
Su contraseña segura de la base de datos
Modo SSL
Modo SSL
Establecer en require para conexiones seguras
Versión de PostgreSQL
Versión
Seleccione 9.3 (configuración recomendada)
Configurar ajustes adicionales
Además de los parámetros esenciales de conexión, 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 ajustes más adelante según 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 conmutadores adicionales.
Probar 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 Consulta de IoT instancia.
Para verificar y guardar:
Nombre su conexión con un identificador descriptivo (por ejemplo, "Consulta de IoT Producción" o "Analítica de Flota")
Haga clic Guardar y probar para verificar su conexión
Un mensaje de éxito verde indica que la conexión funciona correctamente
Crear su primera visualización
Crear su primera visualización le ayuda a comprender cómo Grafana consulta Consulta de IoT y muestra datos de telemática. Este proceso implica crear un panel (dashboard), añadir un panel de visualización, configurar una consulta y seleccionar un formato de visualización apropiado.
Crear un nuevo panel
Los paneles en Grafana sirven como contenedores para múltiples visualizaciones. Crear un panel dedicado le ayuda a organizar visualizaciones relacionadas y proporciona un lugar central para supervisar aspectos específicos de las operaciones de su flota.
Para crear un panel:
Navegue a Paneles en la barra lateral izquierda
Haga clic Crear panel
Seleccione Agregar visualización
Elija el origen de datos PostgreSQL que acaba de configurar
Configurar la consulta
Grafana ofrece dos modos de consulta: un Constructor visual y un editor de Código. Para Consulta de IoT conexiones, el editor de Código le da control total sobre las consultas SQL y se recomienda para el análisis de datos de telemática.
Para escribir su consulta:
En el editor de consultas, cambie de Constructor a Código modo
Ingrese su consulta SQL directamente
Ejemplo de consulta para la visualización de datos de sensores:
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 en el panel a su consulta.
Para más ejemplos de consultas, consulte el Libro de recetas SQL.
Configurar el formato de visualización
El formato de visualización determina cómo aparecen sus datos en el panel. Diferentes 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:
Haga clic Ejecutar consulta para verificar que su consulta devuelve datos
Localice el selector de tipo de visualización (generalmente en la esquina superior derecha del panel)
Cambie el formato de Tabla a Series temporales o su formato preferido
Observe la visualización de datos para asegurarse de que aparece 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 apropiado para el tipo de visualización seleccionado.
Guardar su visualización
Guardar su trabajo conserva la configuración de la visualización y la hace disponible para referencia futura. Guardar con regularidad es importante: Grafana no guarda automáticamente los cambios, por lo que podría perder su trabajo si navega fuera sin guardar.
Para guardar una visualización:
Haga clic Guarde
Proporcione un nombre descriptivo para su panel
Seleccione o cree una carpeta para organizar
Confirme la operación de guardado
El panel ahora está disponible en su instancia de Grafana y se puede acceder a él a través del menú Paneles.
Trabajar con variables
Las variables son una de las características más potentes de Grafana para crear paneles dinámicos e interactivos. En lugar de codificar valores específicos como nombres de sensores o IDs de dispositivos en sus consultas, las variables permiten a los usuarios seleccionar diferentes valores desde menús desplegables sin editar el SQL subyacente. Esto hace que los paneles sean más flexibles y fáciles de usar.
Acceder a la configuración de variables
Las variables se configuran a nivel de panel y se aplican a todas las visualizaciones dentro de ese panel. Debe acceder a la configuración del panel para crear y gestionar variables.
Para comenzar:
Abra su panel
Haga clic en la Configuración del panel (icono de engranaje) en la esquina superior derecha
Navegue hasta la Variables sección en el panel izquierdo
La sección estará vacía si no se han creado variables aún
Configurar una variable
Cada variable necesita un nombre, un origen de datos y una consulta que devuelva los valores posibles que los usuarios pueden seleccionar. Los valores de la variable se rellenan dinámicamente consultando su Consulta de IoT instancia.
Para crear una variable:
Haga clic Agregar variable
Configure los siguientes ajustes:
Ajustes generales:
Nombre:
sensor_name(use un identificador claro y descriptivo sin espacios)Etiqueta: Igual que el nombre para mantener consistencia; esto es lo que los usuarios ven en el panel
Tipo: Seleccione Consulta para rellenar valores desde la base de datos
Opciones de consulta:
Origen de datos: Seleccione su conexión PostgreSQL Consulta de IoT desde el menú desplegable
Consulta: Introduzca una consulta SQL para rellenar los valores de la variable
Ejemplo de consulta para listar todos los sensores de un dispositivo específico:
Después de introducir la consulta, Grafana la ejecuta inmediatamente 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 desplegable.
Aplicar variables en consultas
Una vez creada una variable, debe actualizar sus consultas de visualización para referenciarla. Las variables usan una sintaxis especial con prefijo de signo de dólar, y Grafana sustituye automáticamente el valor seleccionado al ejecutar las consultas.
Para usar la variable:
Abra la visualización que desea hacer dinámica
Edite la consulta
Reemplace el valor codificado por la referencia de la variable
Ejemplo de consulta actualizada usando la variable:
Observe cómo 'temperature' ha sido reemplazado por '$sensor_name'. Las comillas son importantes para los valores de tipo cadena en SQL.
Guardar y probar
Probar la variable garantiza que funciona correctamente y actualiza las visualizaciones según lo esperado. Asegúrese de guardar su trabajo en cada paso para evitar perder los cambios de configuración.
Para completar la configuración:
Haga clic Aplicar para guardar la configuración de la variable
Haga clic Guardar panel para conservar todos los cambios
Regresar a la vista principal del panel
Localice el desplegable de variables en la parte superior del panel
Seleccione diferentes nombres de sensores desde el desplegable
Observe que la visualización se actualiza automáticamente con datos del sensor seleccionado
Si la visualización no se actualiza al cambiar la selección de la variable, verifique que el nombre de la variable en su consulta coincide exactamente con el nombre de la variable que creó (los nombres de variables distinguen entre mayúsculas y minúsculas).
Importar paneles preconstruidos
Los paneles preconstruidos proporcionan una forma rápida de comenzar a visualizar sus datos sin construir todo desde cero. Estos paneles están diseñados por usuarios experimentados e incluyen buenas prácticas para visualización, diseño y optimización de consultas. Sin embargo, requieren configuración para conectarse a su Consulta de IoT instancia.
Importar el panel
El proceso de importación acepta configuraciones de panel en múltiples formatos, lo que le ofrece flexibilidad en cómo carga paneles preconstruidos.
Puede importar paneles usando:
ID de panel desde Grafana.com
Archivo JSON descargado desde el repositorio bi-intergrations
Modelo JSON pegado directamente
Si utiliza un archivo JSON:
Haga clic Subir archivo JSON
Seleccione el archivo del panel
Proporcione un nombre y seleccione la carpeta de destino
Haga clic Importar
Espere a que la plantilla del panel termine de subirse. Una vez completado, el panel aparecerá, pero no mostrará datos aún porque sigue conectado al origen de datos original usado cuando se creó la plantilla.
Actualizar conexiones de origen de datos
Este es un paso crítico. Los paneles importados están inicialmente conectados a orígenes de datos externos que no tienen acceso a sus Consulta de IoT datos. Debe actualizar cada visualización para usar su conexión PostgreSQL Consulta de IoT .
Para actualizar las visualizaciones:
Abra el panel importado
Haga clic Editar en el primer panel de visualización (busque el icono de editar o el menú de tres puntos)
En el editor de consultas, localice el selector de origen de datos
Cambie el origen de datos de la fuente original de la plantilla a su conexión PostgreSQL Consulta de IoT conexión
Haga clic Ejecutar consulta para verificar que la visualización recupera datos correctamente
Haga clic Guarde para conservar los cambios
Repita este proceso para cada panel de visualización en el panel
Guarde su trabajo con frecuencia durante este proceso. Puede tener múltiples visualizaciones para actualizar, y guardar después de cada una garantiza que no pierda progreso.
Actualizar variables del panel
Muchos paneles preconstruidos usan variables para filtrado e interactividad. Estas variables también están conectadas al origen de datos original y deben actualizarse para consultar su Consulta de IoT instancia.
Para actualizar variables:
Abra Configuración → Variables
Verá una lista de todas las variables utilizadas en el panel
Haga clic Editar en la primera variable
Localice el Origen de datos desplegable en la sección Opciones de consulta
Cámbielo a su conexión PostgreSQL Consulta de IoT conexión
Verifique que la vista previa en la parte inferior muestre los valores esperados desde su base de datos
Haga clic Aplicar para confirmar los cambios
Repita para cada variable en la lista
Después de actualizar todas las variables, guarde el panel nuevamente. Las variables ahora deberían rellenarse con valores de su Consulta de IoT instancia.
Verificar la funcionalidad del panel
Una vez que haya actualizado todas las visualizaciones y variables, verifique que todo funcione correctamente en conjunto. Esta comprobación final garantiza que el panel esté totalmente funcional y listo para uso regular.
Para verificar:
Guarde el panel una última vez usando Ctrl+S o el Guarde botón
Actualice completamente la página del navegador (o use F5)
Compruebe que todas las visualizaciones muestran datos correctamente
Pruebe cada desplegable de variables para asegurarse de que se rellena con valores
Seleccione diferentes valores de variable y confirme que las visualizaciones se actualizan en consecuencia
Pruebe diferentes rangos de tiempo usando el selector de tiempo
Si alguna visualización permanece vacía o muestra errores, vuelva al modo de edición y verifique la configuración del origen de datos y la consulta para esos paneles específicos.
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 sus Consulta de IoT detalles. Compruebe que el host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña sean correctos.
Error de firewall: Asegúrese de que su red permita conexiones al host y puerto especificados. Contacte con su administrador de red si los intentos de conexión son bloqueados.
Error SSL/TLS: Verifique que el modo SSL esté establecido en require y que su instancia de Grafana admita conexiones SSL.
Problemas de consulta y visualización
Visualización vacía: Primero, verifique que la consulta realmente devuelva datos comprobando el inspector de consultas (haga clic en el botón "Query inspector" en el editor de panel). Asegúrese de que el rango de tiempo seleccionado incluya períodos en los que existan datos en su base de datos. Confirme que el origen de datos esté seleccionado y conectado correctamente. Verifique que los nombres de tablas y columnas en su consulta coincidan con la estructura real del esquema.
Variable que no funciona: Verifique que la consulta de la variable devuelva valores comprobando la vista previa en la página de configuración de variables. Asegúrese de que la referencia de la variable en su consulta use la sintaxis correcta ($variable_name) sin errores tipográficos. Compruebe que la variable esté guardada y aplicada correctamente al panel. Si el desplegable de la variable está vacío, revise la consulta SQL de la variable en busca de errores.
Rendimiento de consulta lento: Considere añadir í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 el Libro de recetas SQL para ejemplos de optimización de rendimiento y patrones de consulta probados.
Desajuste 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 aliasada como time y columnas con valores numéricos. Los paneles de tabla aceptan cualquier estructura de columnas. Los paneles de gráficos necesitan datos de tiempo y numéricos. Consulte la documentación de Grafana para requisitos específicos de cada tipo de visualización.
Problemas de importación
Faltan datos después de la importación: Verifique que las conexiones de origen 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 Consulta de IoT instancia. Asegúrese de que los nombres de tablas y columnas coincidan con la estructura real de su base de datos.
El panel muestra errores: Abra el editor de consultas de cada panel y haga clic en "Query inspector" para ver mensajes de error detallados. Revise los mensajes de error cuidadosamente: a menudo indican problemas específicos como columnas faltantes, tipos de datos incorrectos o errores de sintaxis. Asegure que los nombres de campo en las consultas coincidan exactamente con su Consulta de IoT esquema (los nombres de campos distinguen entre mayúsculas y minúsculas). Verifique que los tipos de datos devueltos por las consultas sean compatibles con el tipo de visualización.
Variables que no se rellenan: Compruebe que ha actualizado el origen de datos para cada variable, no solo para los paneles de visualización. Verifique 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é establecido en "Query" en lugar de "Custom" u otros tipos.
Próximos pasos
Después de conectar con éxito Grafana a su Consulta de IoT instancia:
Explore los esquemas de datos disponibles revisando el Descripción del esquema para comprender la estructura de los datos, las relaciones entre tablas y los campos disponibles.
Comience con consultas simples centradas en entidades de negocio específicas antes de construir paneles complejos; esto le ayuda a aprender la estructura de los datos y a evitar problemas de rendimiento.
Revise el Libro de recetas SQL para patrones de consulta probados y técnicas de optimización, y ejemplos de escenarios comunes de análisis telemático
Experimente con diferentes tipos de visualización (series temporales, tablas, indicadores, paneles estatísticos) para encontrar la mejor representación para sus datos y casos de uso específicos
Considere crear múltiples paneles para diferentes propósitos: supervisión en tiempo real, análisis histórico, resúmenes ejecutivos e informes operativos.
Soporte
Para preguntas técnicas o asistencia con las conexiones de Consulta de IoT , contacte con el soporte en [email protected].
Última actualización
¿Te fue útil?