Configuración de data loggers

Los data loggers son el puente entre los equipos de tu planta y la plataforma Mirox: una vez configurado un logger, el Mirox-Agent empieza a consultar ese dispositivo según una programación, normalizando cada lectura en un único vocabulario de métricas y transmitiéndola a la plataforma. Esta guía te lleva paso a paso por añadir un logger, asignar un dispositivo detectado a un adaptador, confirmar que responde con una sonda en vivo y aplicar tus cambios — además de los límites de lo que se da de alta automáticamente.

Dónde viven los data loggers

Cada planta tiene una página de Flujo de datos donde gestionas sus loggers y observas la entrada de datos.

Abrir en Mirox: Flujo de datos — o abre Tus plantas, elige una planta y cambia a la pestaña Flujo de datos.

El encabezado de la página muestra mosaicos en vivo del estado de los loggers (sanos frente al total), la disponibilidad del Agent y el tráfico de red, para que veas de un vistazo si la recopilación funciona. La pestaña Data Loggers es donde añades y gestionas loggers; el botón Aplicar cambios en la parte superior derecha envía tu configuración al Agent.

Cómo se dan de alta los data loggers

Añadir un logger es un flujo guiado construido en torno a una conversación real con el dispositivo. La plataforma abre una conexión temporal de solo lectura — una sonda — para que puedas confirmar que el dispositivo responde y ver sus lecturas en vivo antes de comprometer nada. Hay dos formas de entrar al flujo:

• Loggers posibles (detectados automáticamente) — cuando el fabricante y el tipo de un dispositivo detectado coinciden con un adaptador conocido, aparece en la tabla Loggers posibles con el adaptador coincidente ya rellenado. Esta es la vía rápida.
• Añadir logger (manual) — cuando la detección falla o clasifica mal un dispositivo, el botón Añadir logger te permite elegir tú mismo cualquier dispositivo de red y un adaptador.

En cualquier caso, se ejecuta el mismo asistente y la misma sonda en vivo confirma el dispositivo antes de guardar.

Añadir un logger detectado automáticamente

1. Abrir en Mirox: Flujo de datos (o elige tu planta en Tus plantas y abre la pestaña Flujo de datos).
2. En la tabla Loggers posibles, encuentra el dispositivo que quieres. Cada fila muestra el nombre del dispositivo, la IP, el fabricante/tipo y el adaptador con el que la plataforma lo asoció.
3. Haz clic en el botón + de la fila. El asistente de alta se abre con ese dispositivo y adaptador ya vinculados.
4. Sigue los pasos del asistente (más abajo) y guarda el logger.

Añadir un logger manualmente

1. En la página Flujo de datos, haz clic en Añadir logger.
2. En el paso Elegir dispositivo, busca en la lista de dispositivos de red por nombre, IP, fabricante, tipo, modelo o descripción, y selecciona el dispositivo.
3. Elige el adaptador a usar y luego haz clic en Continuar.
4. Sigue los pasos restantes del asistente y guarda el logger.

El asistente de alta, paso a paso

El asistente es un único diálogo con una barra lateral de pasos y una tira de registro del agente en vivo a lo largo de la parte inferior, para que puedas observar al Agent hablar con el dispositivo todo el tiempo. Una insignia de conexión junto al nombre del dispositivo informa del estado de la sonda (Conectando, Sondeando, Inactivo, Error, Hecho). Los pasos que aparecen dependen del adaptador:

Credenciales y la bóveda

Si el adaptador necesita iniciar sesión en el dispositivo, el paso Credenciales pide un usuario y una contraseña. Las credenciales que ya hayas almacenado para ese dispositivo en la bóveda de credenciales se ofrecen aquí para que no las vuelvas a escribir, y lo que introduzcas se puede reutilizar más adelante para el acceso por proxy.

Ejecutar la sonda en vivo

El paso Sonda abre una prueba en seco de corta duración contra el dispositivo. El Agent lee lo que el dispositivo expone y transmite muestras en vivo de vuelta — se actualizan cada segundo, y la tira de registro inferior muestra el intercambio subyacente.

• Espera hasta que aparezcan muestras. La insignia de conexión pasa a Sondeando y luego se estabiliza una vez que las lecturas fluyen.
• Si no llega nada, el asistente reintenta automáticamente unas cuantas veces. Si aún así no puede alcanzar el dispositivo, recibirás un mensaje claro y un botón Reconectar para volver a intentarlo.
• Una sonda atascada casi siempre significa que el dispositivo no es alcanzable desde el Agent — comprueba que la detección aún lo ve y que el túnel VPN está activo.

Asignar los valores de un logger genérico

Algunos loggers son genéricos: exponen una larga lista de valores en bruto que la plataforma no puede interpretar por sí sola (un contador de potencia, un piranómetro y una docena de canales más detrás de un mismo dispositivo, cada uno nombrado en el vocabulario propio del dispositivo). Para estos, el asistente ejecuta un flujo de asignación interactivo en lugar de una vista previa de solo lectura:

1. En el paso Asignar valores, el Agent enumera cada valor en bruto que expone el dispositivo y los transmite de vuelta con su grupo, nombre, unidad y una muestra en vivo. Obtienes una tabla con búsqueda.
2. Para cada valor en bruto que te interese, elige en el desplegable la métrica conocida que representa. Deja el resto sin asignar. Puedes invertir el signo por valor donde haga falta; los prefijos de unidad (kW, kWh, …) se reescalan automáticamente a unidades base del SI.
3. El paso Prueba en seco vuelve a ejecutar el dispositivo a través de tu asignación y muestra las métricas exactas que se producirían — tu punto de control para aceptar o rechazar.
4. El Resumen confirma lo que se guardará.

Solo se recopilan los valores que asignas, y cada valor en bruto se asigna a exactamente una métrica.

Asignación de lecturas (adaptadores con anulación manual)

Para adaptadores no genéricos que aún así exponen un paso de configuración, el paso Configuración muestra cada lectura que encontró la sonda y te permite elegir cuáles recopilar, establecer el intervalo de sondeo y aplicar correcciones por lectura (por ejemplo, invertir un signo). Cuando continúas, la plataforma vuelve a sondear con tu configuración para que el paso Resumen muestre los valores exactamente como se almacenarán.

Guardar

En el paso final — Resumen para adaptadores manuales, o el propio paso Sonda para dispositivos sin configuración — haz clic en Guardar logger (o Añadir para los de sin configuración). El logger se guarda como un cambio pendiente. Todavía nada llega al Agent.

Aplicar tus cambios

Los nuevos loggers, las ediciones y las eliminaciones se preparan hasta que los publicas en el Agent en un único lote.

1. Realiza todos los cambios de logger que quieras.
2. Haz clic en Aplicar cambios en la parte superior de la página Flujo de datos (muestra Aplicar N cambio(s) pendiente(s) cuando has puesto algunos en cola en esta sesión).
3. El Agent se vuelve a desplegar con la nueva configuración y empieza a recopilar poco después.

Gestión de loggers existentes

La tabla Data Loggers lista todo lo configurado para la planta, con búsqueda, ordenación y estado por logger. El menú de acciones ⋮ de cada fila te permite:

• Editar logger — ajustar la configuración del logger.
• Editar dispositivo de red — saltar al dispositivo en la página de Redes para cambiar su IP, credenciales, SNMP o ajustes de proxy (estos viven en un solo lugar, no duplicados aquí).
• Pausar / Reanudar — detener temporalmente la recopilación durante una ventana elegida (de 15 minutos hasta 24 horas) y reanudarla. Útil durante el mantenimiento para que una interrupción conocida no genere eventos.
• Eliminar logger — borrar un logger que añadiste a través del asistente.

Eliminar o pausar un logger también es un cambio pendiente — recuerda Aplicar cambios después.

Qué se puede dar de alta a través del asistente

Hay tres tipos de dispositivo que se dan de alta a través del asistente:

• Familias sin configuración — el adaptador ya conoce el conjunto completo de lecturas del dispositivo, así que solo confirmas la sonda en vivo y guardas. Hoy incluyen los contadores Janitza (no se necesitan credenciales), Huawei SmartLogger, los controladores Phoenix Contact, SMA Sunny Central, SMA Power Manager y Sungrow Logger.
• Loggers genéricos — dispositivos que exponen valores en bruto arbitrarios que la plataforma no puede interpretar por sí sola. Estos se dan de alta a través del flujo interactivo Asignar valores → Prueba en seco descrito más arriba, en el que vinculas cada valor en bruto a una métrica conocida. QReader y blue'Log se dan de alta de esta forma.
• Adaptadores de alta manual — una familia que la plataforma lee por completo pero sobre la que nunca debe adivinar. Hoy es el PLC de alarma WAGO PFC200: lee los contactos del sistema de alarma de un emplazamiento por Modbus TCP de solo lectura y sin credenciales, pero una WAGO es un controlador en blanco que cada integrador programa de forma distinta y nada en el cable indica qué programa está corriendo. Por eso nunca se ofrece en Loggers posibles: usa Añadir logger, elige el adaptador y define el perfil de integrador (hoy abo_uegs), opcionalmente un identificador del sistema de alarma y los contactos que no estén cableados. La sonda en vivo muestra después el estado de cada contacto antes de guardar.

Las familias de dispositivos fuera de los tres grupos siguen funcionando, pero hoy no se pueden dar de alta mediante el asistente: necesitan una configuración por dispositivo que Mirox prepara y envía con el Agent. Trata la automatización del alta como específica del dispositivo, no universal.

Para entender cómo los adaptadores hablan el protocolo de cada dispositivo, normalizan unidades y descubren componentes, consulta la página de arquitectura Data Scraper — esta guía deliberadamente no lo repite.

Migrar una configuración escrita a mano

Un pequeño número de plantas dadas de alta antes de que existiera el asistente todavía funcionan con una configuración escrita a mano (una superposición heredada) en lugar de la configuración que la plataforma generaría hoy a partir de sus filas de logger. Para estas, los administradores de sistema de Mirox cuentan con una vista de migración en la pestaña Flujo de datos → Configuración del agente de la planta, que muestra cómo quedaría la salida de la superposición antes de que cambie nada:

• la configuración que la plataforma generaría sin la superposición heredada,
• una comparación (diff) frente a la superposición actualmente activa en la planta, y
• por logger, si el generador ya puede producir una entrada para él y qué falta todavía (una identidad de inversor sin resolver, una vinculación de monitorización de strings ausente, un inventario aún no capturado, etcétera).

Desde ahí, un administrador puede volver a sondear un logger concreto para completar lo que falte, borrar la superposición y desplegar la configuración generada — sin renombrar ningún componente ni perder su historial. Esta es una herramienta de migración interna, no un ajuste de cara al cliente: existe para que las últimas plantas escritas a mano puedan pasar a la misma configuración generada que ya usa cualquier otra planta.

Guías relacionadas

• Gestión de dispositivos de red — detecta y clasifica los dispositivos contra los que se configura un logger
• Configuración de componentes — asigna las métricas recopiladas a inversores, strings y cajas de conexiones
• Data Scraper — cómo los adaptadores recopilan, normalizan y reenvían tus datos
• Solicitar una integración — pide a Mirox que añada un adaptador para un dispositivo no soportado
• Uso del proxy — abre la propia interfaz web de un dispositivo en el navegador usando credenciales almacenadas