Saltar al contenido
Elausys

HyperVisu / Servicios y datos

Historial y registro de datos

Ajustes de InfluxDB, selección de lo que se registra y exportación del historial en CSV.

elausys · 08 agosto 2026
En esta página

HyperVisu almacena el historial de series temporales en la base de datos de historial integrada en el equipo (InfluxDB). Este capítulo explica cómo conectarla, exportar datos de medición en CSV, crear paneles de Grafana y mover tablas de configuración completas hacia y desde el servidor como archivos CSV.

Conexión a InfluxDB

El historial necesita el servicio InfluxDB. Abra Services y compruebe que la fila InfluxDB está activada. Si la activa ahora, aparece un banner Pending Changes: haga clic en Restart Server y espere a que el servidor vuelva a estar disponible.

La página InfluxDB Configuration (Services → InfluxDB → Configure) contiene una conexión a una base de datos de historial de su elección. En una instalación estándar los campos pueden estar vacíos: el servidor escribe y lee entonces el historial mediante su conexión integrada y no hay nada que rellenar.

CampoQué introducir
URLLa dirección de la instancia de InfluxDB (p. ej. http://localhost:8086).
API TokenUn token con permisos de lectura y escritura. Use el botón del ojo para mostrarlo u ocultarlo.
OrganizationEl nombre de la organización en su instancia de InfluxDB.
BucketEl bucket donde se almacenan los datos.

Haga clic en Test Connection para verificar la conexión indicada en el formulario y después en Save para guardarla. La tarjeta Database Status pasa de Not Tested a Connected y muestra la hora de Last tested. Test Connection necesita los cuatro campos: cuando la página está vacía no hay nada que probar aquí, y el resultado se comprueba en una página de tendencias de la aplicación. Por seguridad, un token guardado no se vuelve a mostrar; deje el campo vacío para conservarlo. Si el propio servicio InfluxDB está desactivado, una alerta en la página indica que debe activarlo primero desde la página Services.

Una vez guardada una conexión, la página muestra también el almacenamiento utilizado y un ajuste Data retention. Reducir el período de retención elimina de forma permanente los datos más antiguos.

Navegador de escritorio, página InfluxDB Configuration con el formulario de conexión completado y la tarjeta Database Status mostrando Connected.

Qué se registra. El registro es un interruptor en cada objeto de comunicación. Los objetos de un contador y de una entrada analógica con tendencia se registran automáticamente; para cualquier otro objeto debe activarlo usted:

  1. Abra Devices, despliegue el dispositivo y haga clic en el botón Edit Object (el engranaje) del objeto.
  2. Active Log historical values.
  3. Haga clic en Save object. La fila del objeto muestra ahora un icono de base de datos y un icono de gráfico. No hace falta Apply changes.

Cada valor que recibe el objeto se registra a partir de ese momento, haya cambiado o no; no se reconstruye nada anterior (véase «Object Settings, Logging & Notifications»). Los objetos registrados alimentan los gráficos de tendencia y el historial de contadores de la aplicación, los paneles de control de Grafana, los gráficos del monitor de bus KNX y la exportación CSV descrita a continuación.

Exportación de datos CSV

La página CSV Data Export convierte el historial registrado en un archivo apto para hojas de cálculo. No tiene entrada propia en la barra lateral: abra Services y haga clic en Export en la fila InfluxDB.

  1. En Object Selection, marque los objetos que desea exportar. Están agrupados por habitación; use el cuadro de búsqueda o Select all. Si la lista está vacía, aún no hay objetos con el registro activado — actívelo primero (véase «Object Settings, Logging & Notifications»).
  2. En Time Period, defina Start y End, o use un atajo: Last 24h, Last 7 days, Last 30 days, Last year.
  3. En Format, elija el Separator: Comma, Semicolon o Tab.
  4. Elija la Timezone en la que se escriben las marcas de tiempo. El campo se abre en Europe/Paris sea cual sea la zona horaria del propio servidor, así que compruébelo.
  5. Haga clic en Export CSV. El botón muestra Generating... mientras el servidor prepara el archivo.
  6. Cuando aparezca File ready, haga clic en Download file.

📘 Nota: El enlace de descarga es válido durante 1 hora; después, inicie una nueva exportación. El archivo está en UTF-8 con BOM, por lo que se abre correctamente en Excel.

Navegador de escritorio, página CSV Export.

Registro de actividad del dispositivo

Aparte de la base de datos de historial, el servidor mantiene también un activity log por dispositivo: cada comando enviado a un dispositivo y cada cambio de estado que este notifica, con su origen — el residente y el cliente que utilizó, la escena, la automatización, la función Logic, la programación, el grupo, el puente KNX o el webhook que lo provocó — y si el dispositivo confirmó el comando. Se abre desde el botón Activity de cada fila de dispositivo, y sus ajustes de grabación y retención se encuentran en la página Services → Device Activity Log. Ambos se describen en «Device Activity Log».

Preguntas frecuentes

¿HyperVisu registra todos los objetos automáticamente?

No. El registro es un interruptor en cada objeto de comunicación: los objetos de un contador y de una entrada analógica con tendencia se registran automáticamente, y usted lo activa para cualquier otro objeto. El servicio InfluxDB también debe estar activado.

¿Por qué está vacía la lista de objetos de la exportación CSV?

Todavía no hay objetos con el registro activado. Active el registro en los objetos que desea grabar y exportar.

¿Puedo elegir el separador CSV y la zona horaria?

Sí. CSV Data Export ofrece separadores de coma, punto y coma o tabulación y una selección de zona horaria para las marcas de tiempo.

¿Cuánto tiempo está disponible una descarga generada?

El enlace de descarga dura una hora. Después, genere una nueva exportación.

¿En qué se diferencia el registro de actividad del dispositivo del historial?

El historial almacena mediciones para gráficos y exportaciones. El registro de actividad recoge comandos y cambios de estado, sus orígenes y las confirmaciones de los dispositivos.

Seguir explorando

Encuentre las demás guías de este producto en la documentación.

Volver a Servicios y datos