Conectar Grafana
Esta guía muestra cómo conectar Grafana a DataHub 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 sensores y otras métricas en tiempo real.
Vea un breve video de descripción general para conocer lo posible con la combinación DataHub+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 fuentes de datos
Gráficos e informes interactivos
Creación de consultas personalizadas con SQL
Requisitos técnicos
Grafana 9.3 o posterior
Complemento de fuente de datos PostgreSQL (incluido por defecto)
Acceso a Internet para la conexión a la base de datos
Instancia activa de DataHub con credenciales de conexión
Instalación y configuración
Grafana debe estar instalado en su sistema antes de poder conectarse a DataHub.
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 tener que crear visualizaciones desde cero. Estas plantillas se mantienen en el repositorio bi-intergrations dentro de la carpeta grafana Puede clonar el repositorio para acceder a paneles listos para usar:
Revise la grafana carpeta para archivos JSON de panel disponibles.
Conexión a la base de datos
La sección Connections en Grafana es donde gestiona todas las integraciones de fuentes de datos. DataHub se ejecuta en PostgreSQL, por lo que deberá agregar una fuente de datos PostgreSQL para permitir que Grafana consulte sus datos de telemática.
Agregar fuente de datos PostgreSQL
El complemento de fuente de datos PostgreSQL viene preinstalado con Grafana y proporciona compatibilidad nativa para conectarse a bases de datos PostgreSQL.
Para agregar la fuente de datos:
En la sección Connections, busque PostgreSQL
Haga clic en Add new data source
Se abrirá la página de configuración de PostgreSQL
Configurar parámetros de conexión
Los detalles de su conexión de DataHub 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.
Ubique sus parámetros de conexión en su cuenta de Navixy y en el correo electrónico de bienvenida de DataHub.
Referencia de parámetros de conexión
Host
Host
Dirección del servidor de base de datos proporcionada en los detalles de su conexión de DataHub
Puerto
Puerto
El valor predeterminado es 5432 para PostgreSQL
Nombre de la base de datos
Database
Su nombre de base de datos asignado
Nombre de usuario
User
Su nombre de usuario de base de datos (denominado «database user» en los detalles de conexión)
Contraseña
Contraseña
Su contraseña segura de base de datos
Modo SSL
SSL Mode
Establecer en require para conexiones seguras
Versión de PostgreSQL
Version
Seleccione 9.3 (configuración recomendada)
Configurar ajustes adicionales
Más allá 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 de equipos específicas.
Deje todos los demás campos con sus valores predeterminados para la configuración inicial. No necesita habilitar interruptores o 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 instancia de DataHub.
Para verificar y guardar:
Asigne a su conexión un identificador descriptivo (por ejemplo, «DataHub Producción» o «Análisis de Flota»)
Haga clic en Save & Test para verificar su conexión
Un mensaje verde de éxito indica que la conexión funciona correctamente
Creación de su primera visualización
Crear su primera visualización le ayuda a entender cómo Grafana consulta DataHub y muestra datos de telemática. Este proceso implica crear un panel, agregar un panel visual, configurar una consulta y seleccionar un formato de visualización apropiado.
Crear un panel nuevo
Los paneles en Grafana sirven como contenedores para múltiples visualizaciones. Crear un panel dedicado le ayuda a organizar visualizaciones relacionadas y proporciona una ubicación central para supervisar aspectos específicos de sus operaciones de flota.
Para crear un panel:
Navegue a Dashboards en la barra lateral izquierda
Haga clic en Create Dashboard
Seleccione Agregar visualización
Elija la fuente de datos PostgreSQL que acaba de configurar
Configurar la consulta
Grafana ofrece dos modos de consulta: un constructor visual (Builder) y un editor de código. Para conexiones con DataHub, el editor Code le brinda control total sobre las consultas SQL y es el recomendado para el análisis de datos de telemática.
Para escribir su consulta:
En el editor de consultas, cambie de Builder a Code mode
Ingrese su consulta SQL directamente
Ejemplo de consulta para 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() es una macro de Grafana que aplica automáticamente el rango de tiempo seleccionado del panel a su consulta.
Para más ejemplos de consultas, consulte el Libro de recetas SQL.
Establecer 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 en Run query para verificar que su consulta devuelve datos
Ubique el selector de tipo de visualización (generalmente en la esquina superior derecha del panel)
Cambie el formato de Table a Time series o el formato de su preferencia
Observe la visualización de los datos para asegurarse de que aparezcan 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.
Guardar su visualización
Guardar su trabajo preserva 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 puede perder su trabajo si navega fuera sin guardar.
Para guardar una visualización:
Haga clic en Save
Proporcione un nombre descriptivo para su panel
Seleccione o cree una carpeta para su organización
Confirme la operación de guardado
El panel ahora está disponible en su instancia de Grafana y se puede acceder a él desde el menú Dashboards.
Trabajo con variables
Las variables son una de las funciones 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 el Settings del panel (ícono de engranaje) en la esquina superior derecha
Navegue a la sección Variables en el panel izquierdo
La sección estará vacía si aún no se han creado variables
Configurar 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 instancia de DataHub.
Para crear una variable:
Haga clic en Add variable
Configure los siguientes ajustes:
Configuración general:
Nombre:
sensor_name(use un identificador claro y descriptivo sin espacios)Etiqueta: Igual que el nombre para mantener coherencia; esto es lo que los usuarios ven en el panel
Tipo: Seleccione Query : para completar valores desde la base de datos
Opciones de consulta:
Fuente de datos: Seleccione su conexión PostgreSQL de DataHub en la lista desplegable
Query: Ingrese una consulta SQL para completar los valores de la variable
Ejemplo de consulta para listar todos los sensores de un dispositivo específico:
Tras ingresar 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.
Aplicar variables en consultas
Una vez creada una variable, debe actualizar las consultas de sus visualizaciones 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:
Abra la visualización que desea hacer dinámica
Edite la consulta
Reemplace el valor codificado por la referencia a la variable
Ejemplo de consulta actualizada usando la variable:
Observe cómo 'temperature' ha sido reemplazado por '$sensor_name'. Las comillas son importantes para valores de tipo cadena en SQL.
Guardar y probar
Probar la variable garantiza que funcione correctamente y que 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:
Haga clic en Apply para guardar la configuración de la variable
Haga clic en Save dashboard para preservar todos los cambios
Regrese a la vista principal del panel
Ubique el menú desplegable de variables en la parte superior del panel
Seleccione diferentes nombres de sensores en el menú desplegable
Observe que la visualización se actualiza automáticamente con los 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 variables distinguen entre mayúsculas y minúsculas).
Importación de paneles preconstruidos
Los paneles preconstruidos proporcionan una forma rápida de comenzar a visualizar sus datos sin crear todo desde cero. Estos paneles están diseñados por usuarios experimentados e incluyen prácticas recomendadas para visualización, diseño y optimización de consultas. Sin embargo, requieren configuración para conectarse a su instancia específica de DataHub.
Importar el panel
El proceso de importación acepta configuraciones de panel en múltiples formatos, brindándole flexibilidad en cómo cargar paneles preconstruidos.
Puede importar paneles usando:
Dashboard ID desde Grafana.com
Archivo JSON descargado del repositorio bi-intergrations
Modelo JSON pegado directamente
Si utiliza un archivo JSON:
Haga clic en Upload JSON file
Seleccione el archivo del panel
Proporcione un nombre y seleccione la carpeta de destino
Haga clic en Import
Espere a que la plantilla del panel termine de cargarse. Una vez completado, el panel aparecerá, pero aún no mostrará datos porque sigue conectado a la fuente de datos original usada cuando se creó la plantilla.
Actualizar conexiones de fuentes de datos
Este es un paso crítico. Los paneles importados inicialmente están conectados a fuentes de datos externas que no tienen acceso a sus datos de DataHub. Debe actualizar cada visualización para usar su conexión PostgreSQL de DataHub.
Para actualizar las visualizaciones:
Abra el panel importado
Haga clic en Edit en el primer panel de visualización (busque el ícono de edición o el menú de tres puntos)
En el editor de consultas, localice el selector de fuente de datos
Cambie la fuente de datos de la fuente original de la plantilla a su conexión PostgreSQL de DataHub
Haga clic en Run query para verificar que la visualización recupere datos correctamente
Haga clic en Save para preservar los cambios
Repita este proceso para cada panel de visualización del tablero
Actualizar variables del panel
Muchos paneles preconstruidos usan variables para filtrado e interactividad. Estas variables también están conectadas a la fuente de datos original y deben actualizarse para consultar su instancia de DataHub.
Para actualizar variables:
Abra Settings → Variables
Verá una lista de todas las variables usadas en el panel
Haga clic en Edit en la primera variable
Localice el menú Fuente de datos desplegable en la sección Query options
Cámbielo a su conexión PostgreSQL de DataHub
Verifique que la vista previa en la parte inferior muestre los valores esperados de su base de datos
Haga clic en Apply para confirmar los cambios
Repita para cada variable de la lista
Después de actualizar todas las variables, guarde el panel nuevamente. Las variables ahora deberían completarse con valores de su instancia de DataHub.
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 asegura que el panel esté completamente funcional y listo para uso regular.
Para verificar:
Guarde el panel por última vez usando Ctrl+S o el Save botón
Actualice completamente la página del navegador (o use F5)
Compruebe que todas las visualizaciones muestren los datos correctamente
Pruebe cada menú desplegable de variables para asegurar que se complete con valores
Seleccione diferentes valores de variables 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, regrese al modo de edición y verifique la fuente de datos y la configuración de 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 los detalles de su DataHub. Compruebe que host, puerto, nombre de base de datos, nombre de usuario y contraseña sean correctos.
Error de firewall: Asegúrese de que su red permita conexiones al host y puerto especificados. Póngase en contacto con su administrador de red si los intentos de conexión se bloquean.
Error de 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 revisando el inspector de consultas (haga clic en el botón «Query inspector» en el editor del panel). Asegúrese de que el rango de tiempo seleccionado incluya periodos en los que existan datos en su base de datos. Confirme que la fuente de datos esté correctamente seleccionada y conectada. Compruebe que los nombres de tablas y columnas en su consulta coincidan con la estructura real del esquema.
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 a la variable en su consulta use la sintaxis correcta ($variable_name) sin errores tipográficos. Compruebe que la variable esté correctamente guardada y aplicada al panel. Si el menú desplegable de la variable está vacío, revise la consulta SQL de la variable en busca de errores.
Rendimiento lento de 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 más restrictivos. 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 del rendimiento y patrones de consulta comprobados.
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 con alias 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 los 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 fuentes de datos se hayan actualizado 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 instancia de DataHub. 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 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 campos en las consultas coincidan exactamente con su esquema de DataHub (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.
Las variables no se rellenan: Compruebe que haya actualizado la fuente de datos de cada variable, no solo de los paneles de visualización. Verifique que las consultas de 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 correctamente Grafana a su instancia de DataHub:
Explore los esquemas de datos disponibles revisando la Descripción general del esquema para comprender la estructura de 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 datos y evitar problemas de rendimiento.
Revise el Libro de recetas SQL para patrones de consulta comprobados y técnicas de optimización, y ejemplos de escenarios comunes de análisis de telemática
Experimente con distintos tipos de visualización (series temporales, tablas, indicadores, paneles de estadísticas) para encontrar la mejor representación para sus datos y casos de uso específicos
Considere crear múltiples paneles para diferentes propósitos: monitoreo en tiempo real, análisis histórico, resúmenes ejecutivos e informes operativos.
Soporte
Para preguntas técnicas o asistencia con conexiones a DataHub, contacte al soporte en [email protected].
Última actualización
¿Te fue útil?