Recopilación de métricas

Mirox reúne los datos de rendimiento de sus plantas de energía renovable en un único vocabulario de métricas estandarizado: la base de todas las capacidades de monitoreo, análisis, generación de informes y pronóstico de la plataforma. Esta página es el catálogo de referencia de lo que se mide y de cómo se organizan las mediciones.

La taxonomía completa abarca 458 nombres de métricas estandarizadas en doce familias: producción de la planta (powerplant), almacenamiento de batería, el sistema de alarma del emplazamiento, entradas meteorológicas, modelos derivados de la meteorología y varias familias operativas que describen la propia recopilación: monitoreo de red, los agentes, la flota de operadores, la accesibilidad básica de la red y las fuentes del scraper. Las tablas siguientes documentan las familias que graficará con más frecuencia; las familias operativas se resumen en las secciones Métricas de red y Métricas de agente.

Arquitectura del Data Scraper

En el núcleo de la recopilación de métricas se encuentra el Data Scraper, el componente de borde que recopila datos de series temporales de sus plantas. En lugar de un único motor de protocolo genérico, utiliza un adaptador dedicado por familia de dispositivos (data loggers, inversores, contadores, sistemas de batería), cada uno diseñado para la interfaz de ese fabricante. El Data Scraper puede operar en dos modos de despliegue:

Recopilación basada en la nube

Cuando se despliega en la nube:

Se conecta a los parques solares mediante conexiones seguras a Internet
Agrega datos de múltiples emplazamientos de forma centralizada
Gestiona la administración de conexiones y la lógica de reintentos
Optimiza el uso del ancho de banda mediante sondeo inteligente

Recopilación basada en el borde

Cuando se despliega en el borde (in situ):

Interactúa directamente con el equipo local para una latencia mínima
Opera con almacenamiento en búfer local para soportar cortes de Internet
Realiza una validación y filtrado preliminar de los datos
Se sincroniza con la nube cuando hay conectividad disponible

La arquitectura de doble modo garantiza una recopilación de datos fiable, independientemente de las condiciones de conectividad del emplazamiento o de la escala del sistema.

Métricas recopiladas

El sistema de recopilación de métricas reúne un conjunto integral de mediciones que proporcionan visibilidad completa del rendimiento de la planta de energía renovable. Las métricas se agrupan a lo largo de tres ejes ortogonales:

Las métricas del emplazamiento (Site) describen el emplazamiento físico en sí: su planta, su almacenamiento de batería, su sistema de alarma y la meteorología que lo rodea.
Las métricas de red (Network) describen la conectividad entre el emplazamiento y la nube.
Las métricas de agente (Agent) describen los propios agentes de recopilación de datos: las fuentes del scraper y los servicios de infraestructura de apoyo que se ejecutan en el dispositivo IoT.

Métricas del emplazamiento

Las métricas del emplazamiento son las mediciones brutas de series temporales recopiladas directamente del equipo instalado en un emplazamiento de energía renovable. Se dividen por dominio en la planta (inversores PV, conexión a la red, etc.), el sistema de almacenamiento de energía en batería (BESS), el sistema de alarma del emplazamiento y la meteorología (pronóstico y modelada).

Métricas de la planta

Métricas de red eléctrica

Nombre de la métrica	Tipo	Unidad
powerplant_energy_grid_total	Energía	Wh
powerplant_energy_grid_out_total	Energía	Wh
powerplant_grid_energy_total_reactive	Energía	VArh
powerplant_grid_energy_total_apparent	Energía	VAh
powerplant_power_grid	Potencia	W
powerplant_grid_power_reactive	Potencia	VAr
powerplant_grid_power_apparent	Potencia	VA

Nota sobre la convención de nombres

Las métricas powerplant_energy_grid_* y powerplant_power_grid no siguen el patrón de nomenclatura estándar (powerplant_grid_energy_* y powerplant_grid_power) por razones heredadas. Las demás métricas de red siguen el patrón estándar powerplant_grid_*. Estos nombres de métricas heredados se actualizarán para seguir el patrón estándar en una versión futura.

Métricas de inversor

Nombre de la métrica	Tipo	Unidad
powerplant_inverter_energy_ac_total	Energía	Wh
powerplant_inverter_energy_dc_total	Energía	Wh
powerplant_inverter_energy_consumed_total	Energía	Wh
powerplant_inverter_power_ac	Potencia	W
powerplant_inverter_power_dc	Potencia	W
powerplant_inverter_power_reactive	Potencia	VAr
powerplant_inverter_power_max	Potencia	W
powerplant_inverter_setpoint_power_active	Consigna	W
powerplant_inverter_setpoint_power_active_percent	Consigna	%
powerplant_inverter_setpoint_power_reactive	Consigna	VAr
powerplant_inverter_max_power	Apagado	%
powerplant_inverter_voltage_ac	Tensión	V
powerplant_inverter_current_ac	Corriente	A
powerplant_inverter_voltage_dc	Tensión	V
powerplant_inverter_current_dc	Corriente	A
powerplant_inverter_resistance_iso	Resistencia	Ohm
powerplant_inverter_vendor_status	Estado	código
powerplant_inverter_cos	Factor de potencia	-
powerplant_inverter_frequency	Frecuencia	Hz
powerplant_inverter_temperature	Temperatura	°C
powerplant_inverter_current_ac_phase	Corriente	A
powerplant_inverter_voltage_ac__phase__L1_L2	Tensión	V
powerplant_inverter_voltage_ac__phase__L2_L3	Tensión	V
powerplant_inverter_voltage_ac__phase__L3_L1	Tensión	V
powerplant_inverter_current_ac__phase__L1	Corriente	A
powerplant_inverter_current_ac__phase__L2	Corriente	A
powerplant_inverter_current_ac__phase__L3	Corriente	A

Métricas de caja de conexiones (GAK)

Nombre de la métrica	Tipo	Unidad
powerplant_gak_voltage	Tensión	V
powerplant_gak_current	Corriente	A
powerplant_gak_power	Potencia	W
powerplant_gak_energy_total	Energía	Wh
powerplant_gak_temperature	Temperatura	°C

Métricas de string

Nombre de la métrica	Tipo	Unidad
powerplant_string_voltage	Tensión	V
powerplant_string_current	Corriente	A
powerplant_string_power	Potencia	W
powerplant_string_energy_total	Energía	Wh

Métricas de control

Nombre de la métrica	Tipo	Unidad
powerplant_max_power_by_grid	Apagado	%
powerplant_max_power_by_external	Apagado	%
powerplant_max_power_by_external_w	Apagado	W
powerplant_max_power_by_local	Apagado	%
powerplant_battery_setpoint_external	Control	%
powerplant_battery_setpoint_local_w	Control	W
powerplant_control_connection_grid	Control	bool
powerplant_control_connection_external	Control	bool
powerplant_control_interface_ready	Control	bool
powerplant_power_max	Potencia	W
powerplant_max_power_source	Control	-

Métricas de irradiancia

Nombre de la métrica	Tipo	Unidad
powerplant_solar_radiation	Irradiancia	W/m²
powerplant_energy_irradiation_total	Energía	Wh
powerplant_solar_ghi_reference	Irradiancia	W/m²
powerplant_solar_ghi_reference_energy	Energía	Wh

Métricas ambientales

Nombre de la métrica	Tipo	Unidad
powerplant_humidity	Humedad	%
powerplant_ambient_temperature	Temperatura	°C
powerplant_module_temperature	Temperatura	°C
powerplant_wind_speed	Velocidad del viento	m/s
powerplant_wind_direction	Dirección del viento	°

Métricas de pérdidas

Nombre de la métrica	Tipo	Unidad
powerplant_energy_loss_total	Energía	Wh
powerplant_power_loss	Potencia	W

Métricas de informe

Nombre de la métrica	Tipo	Unidad
powerplant_power_report	Potencia	W
powerplant_energy_report_total	Energía	Wh
powerplant_energy_radiation_total	Energía	Wh

Métricas del gemelo digital

Nombre de la métrica	Tipo	Unidad
powerplant_grid_power_simulation	Potencia	W
powerplant_grid_energy_total_simulation	Energía	Wh
powerplant_grid_prrc	PRRC	-
powerplant_grid_sim_err	Error	-
powerplant_inverter_power_ac_simulation	Potencia	W
powerplant_inverter_energy_ac_total_simulation	Energía	Wh
powerplant_inverter_prrc	PRRC	-
powerplant_inverter_sim_err	Error	-
powerplant_gak_power_simulation	Potencia	W
powerplant_gak_energy_total_simulation	Energía	Wh
powerplant_gak_prrc	PRRC	-
powerplant_gak_sim_err	Error	-
powerplant_string_power_simulation	Potencia	W
powerplant_string_energy_total_simulation	Energía	Wh
powerplant_string_shadow_factor	Factor	-
powerplant_string_prrc	PRRC	-
powerplant_string_sim_err	Error	-

Métricas de analítica de borde

El Data Scraper calcula un conjunto de analíticas directamente en la planta y las publica como series graficables junto a las mediciones brutas. Estas son las series detrás de las funciones de performance ratio, curtailment y liquidación de la plataforma. La mayoría de las familias existen una vez por fuente de irradiancia — escrita <source> a continuación, una de pyranometer (sensores in situ), satellite (irradiancia derivada de satélite para el emplazamiento) o weather (irradiancia modelada a partir de datos meteorológicos) — de modo que cada fuente mantiene sus propias series independientes y una entrada con deriva nunca puede distorsionar silenciosamente a las demás.

Irradiancia y producción modelada

La irradiancia en el plano del generador que ve cada fuente, y la producción teórica (sin curtailment) de la planta modelada a partir de ella. Un conjunto por fuente — 13 series en total.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_`<source>`_radiation_power	Irradiancia	W/m²	Irradiancia en el plano del generador desde esta fuente — la luz solar que realmente incide sobre los módulos.
powerplant_`<source>`_radiation_energy_total	Energía	Wh/m²	Irradiación acumulada integrada a partir de la serie anterior.
powerplant_pyranometer_ghi_radiation_power	Irradiancia	W/m²	Irradiancia horizontal (GHI) media de la planta, depurada — solo presente cuando la planta tiene piranómetros horizontales.
powerplant_`<source>`_power	Potencia	W	Producción teórica de la planta modelada a partir de la irradiancia de esta fuente y las orientaciones de los módulos de la planta.
powerplant_`<source>`_energy_total	Energía	Wh	Energía modelada acumulada.

Performance ratio

La producción real comparada con la producción modelada — un carril de PR independiente por fuente de irradiancia, a nivel de planta. Consulte Potencia esperada y performance ratio para saber cómo funcionan los filtros.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_`<source>`_pr	Performance Ratio	-	Producción medida sobre producción modelada.
powerplant_`<source>`_pr_filter	Filtro	-	Desglose por filtro — qué filtro de calidad (poca luz, clipping, curtailment, helada/nieve/niebla, lagunas de datos) excluyó un instante del PR limpio.
powerplant_`<source>`_pr_validity	Validez	bool	1 cuando el instante superó todos los filtros y cuenta para el PR fiable.

Potencia y energía esperadas

La expectativa calibrada por PR — la producción modelada escalada por la eficiencia real de la planta. Esta es la línea base con la que el watchdog de salud de componentes contrasta la producción en vivo.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_`<source>`_expected_power	Potencia	W	Producción esperada de la planta en las condiciones actuales.
powerplant_`<source>`_expected_energy_total	Energía	Wh	Energía esperada acumulada.

Modelo y performance ratio por componente

El análogo a nivel de componente del modelo de toda la planta: producción teórica y PR de un solo inversor, caja de conexiones (GAK) o string, usando la orientación y la potencia pico propias de ese componente. Se emite para las fuentes weather y pyranometer; las series llevan las etiquetas de identidad del componente. <component> es uno de inverter, gak, string — 12 series en total, más el marcador de finalización diaria.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_`<source>`_`<component>`_power	Potencia	W	Producción modelada de un componente a partir de la irradiancia de esta fuente.
powerplant_`<source>`_`<component>`_pr	Performance Ratio	-	Performance ratio por componente (solo valores limpios y filtrados).
powerplant_simulation_day_complete	Marcador	-	Se estampa una vez por fuente y día cuando las series del modelo del día se verifican como completas.

Carriles de potencia en vivo y de pronóstico

Referencias de producción en tiempo real y a futuro.

Nombre de la métrica	Tipo	Unidad	Descripción
powerplant_pyranometer_live_power	Potencia	W	Potencia esperada ajustada por PR en tiempo real a partir de los sensores in situ.
powerplant_satellite_live_power	Potencia	W	Potencia esperada ajustada por PR en tiempo real a partir de la irradiancia satelital.
powerplant_pyranometer_live_energy_total	Energía	Wh	Energía acumulada del carril en vivo del piranómetro.
powerplant_satellite_live_energy_total	Energía	Wh	Energía acumulada del carril en vivo del satélite.
powerplant_clearsky_power	Potencia	W	Producción teórica en condiciones ideales (cielo despejado) — el techo físico de un día consolidado.
powerplant_clearsky_energy_total	Energía	Wh	Energía de cielo despejado acumulada.
powerplant_weather_forecast_power	Potencia	W	Pronóstico de producción para el día siguiente derivado de datos meteorológicos.
powerplant_weather_forecast_energy_total	Energía	Wh	Energía de pronóstico acumulada.
powerplant_clearsky_forecast_power	Potencia	W	Pronóstico de cielo despejado — el techo en condiciones ideales para el horizonte de pronóstico.
powerplant_clearsky_forecast_energy_total	Energía	Wh	Energía de pronóstico de cielo despejado acumulada.

Curtailment

Producción no generada atribuida a su causa — <party> es grid (una consigna del operador de red limita la producción) o marketer (el tope del comercializador directo limita la producción). Cada combinación se emite como potencia instantánea y energía acumulada, en dos variantes: la serie liquidada y una serie live calculada en tiempo real. 24 series en total.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_`<source>`curtailment`<party>`_power	Potencia	W	Pérdida por curtailment liquidada — producción no generada a causa del limitador vinculante.
powerplant_`<source>`curtailment`<party>`_energy_total	Energía	Wh	Energía de curtailment liquidada acumulada.
powerplant_`<source>`live_curtailment`<party>`_power	Potencia	W	La misma atribución calculada en vivo, con marcas de tiempo reales.
powerplant_`<source>`live_curtailment`<party>`_energy_total	Energía	Wh	Energía de curtailment en vivo acumulada.

Familias de liquidación

Series que respaldan la liquidación y la compensación del curtailment. La familia fixed (a tanto alzado) implementa el método de liquidación independiente de la fuente: la referencia es la potencia de red media medida durante los 15 minutos previos al inicio del curtailment, congelada durante toda la medida — sin necesidad de ninguna entrada de irradiancia. La familia Mischpreis valora la energía de curtailment con el precio mixto cuarto-horario del mercado alemán, dando un valor de ingresos en EUR por intervalo de 15 minutos.

Patrón del nombre de la métrica	Tipo	Unidad	Descripción
powerplant_fixed_curtailment_`<party>`_power	Potencia	W	Pérdida por curtailment a tanto alzado frente a la referencia congelada previa al curtailment.
powerplant_fixed_curtailment_`<party>`_energy_total	Energía	Wh	Energía de curtailment a tanto alzado acumulada.
powerplant_fixed_curtailment_reference_power	Potencia	W	La última potencia de referencia válida sin curtailment que el método a tanto alzado congela al inicio del curtailment.
powerplant_mischpreis_`<variant>`_`<party>`_revenue	Ingresos	EUR	Valor de mercado de la energía recortada por intervalo de 15 minutos. `<variant>` es uno de los carriles de curtailment anteriores: `pyranometer`, `satellite`, `weather`, sus equivalentes `_live`, o `fixed` — 14 series en total.

Métricas de batería

La familia battery_* es el vocabulario de métricas independiente del fabricante para cualquier sistema de almacenamiento de energía en batería (BESS). Sigue una jerarquía de componentes estricta en la que la identificación de la instancia reside en las etiquetas (labels), no en el nombre de la métrica:

battery_environment_*       sensores ambientales alrededor del BESS
battery_pcs_*               Power Conversion System conectado a la red, delante de la caja
battery_box_*               una caja / contenedor BESS — la batería de CC
└── battery_storage_*       un armario / rack dentro de la caja
    └── battery_module_*    un módulo dentro del armario
        └── battery_cell_*  una celda individual dentro del módulo

La jerarquía de la batería (caja → almacenamiento → módulo → celda) describe la batería de CC en sí. El PCS (battery_pcs_*) es el convertidor CA↔CC conectado a la red que se sitúa delante de la caja — posee el lado de CA del BESS además de su propia telemetría de convertidor, y se identifica por dispositivo mediante la etiqueta pcs. Modelarlo como un componente propio permite recopilar la batería y su convertidor como dos dispositivos independientes para el mismo contenedor sin que sus series colisionen.

Esta es una especificación solo de recopilación: los adaptadores publican los valores brutos exactamente como los expone el fabricante, sin agregaciones, derivaciones, modificadores _min / _max / _mean ni indicadores de estado o salud. Toda interpretación, consolidación y generación de alarmas son responsabilidades posteriores del gemelo digital.

Dos tipos distintos de "tensión"

La especificación separa deliberadamente dos magnitudes físicamente diferentes que ambas se miden en voltios:

Tensión de celda (*_cell_voltage): la tensión química de terminal producida por las celdas. A nivel de celda es la tensión de una sola celda (~3,2 V para una celda LFP). A niveles superiores es la suma de todas las tensiones de celda en el mismo string en serie. Cambia únicamente con el estado de carga.
Tensión de interfaz (*_voltage_dc, _dc_in, _dc_out): lo que se inyecta o se extrae de la batería en sus terminales eléctricos. Difiere de la tensión de celda por I·R durante la carga / descarga.

Las dos son físicamente el mismo número cuando la batería está en reposo; divergen en la caída IR en el momento en que circula cualquier corriente.

Variantes de CC sensibles a la dirección

Para cada magnitud de CC (voltage_dc, current_dc, power_dc) en los niveles de caja, almacenamiento y módulo existen tres variantes: *_dc (con signo, un único registro del fabricante), *_dc_in (siempre positiva — valor durante la carga) y *_dc_out (siempre positiva — valor durante la descarga). Los adaptadores publican la(s) variante(s) que el fabricante realmente expone.

Entorno

Sensores ambientales alrededor del BESS, distinguidos por la etiqueta sensor.

Nombre de la métrica	Tipo	Unidad
battery_environment_temperature	Temperatura	°C
battery_environment_humidity	Humedad	%

Nivel de PCS

El Power Conversion System conectado a la red: el convertidor CA↔CC delante de la caja de batería. Posee el lado de CA del BESS (que la batería de CC nunca mide), además de su propia lectura del bus de CC, el estado de batería que retransmite y la telemetría del lado del convertidor. Un PCS es un dispositivo distinto, identificado por la etiqueta pcs; phase distingue las magnitudes de CA por fase. Convención de signos: positivo = carga (red → batería); la dirección se resuelve a partir de los contadores de energía direccionales, nunca de un bit de estado.

Bus de CC

La visión propia del convertidor sobre el enlace de CC — el estado de CC autoritativo de la batería permanece a nivel de caja.

Nombre de la métrica	Tipo	Unidad	Descripción
battery_pcs_voltage_dc	Tensión	V	Tensión del bus de CC medida en el convertidor.
battery_pcs_current_dc	Corriente	A	Corriente de CC. Con signo (+ = carga).
battery_pcs_power_dc	Potencia	W	Potencia de CC. Con signo.

Lado de CA

Nombre de la métrica	Tipo	Unidad	Descripción
battery_pcs_voltage_ac	Tensión	V	Tensión de CA RMS entre líneas.
battery_pcs_voltage_ac__phase__L1_L2	Tensión	V	Tensión de CA por fase (entre líneas).
battery_pcs_voltage_ac__phase__L2_L3	Tensión	V	Tensión de CA por fase (entre líneas).
battery_pcs_voltage_ac__phase__L3_L1	Tensión	V	Tensión de CA por fase (entre líneas).
battery_pcs_current_ac	Corriente	A	Corriente de CA RMS.
battery_pcs_current_ac__phase__L1	Corriente	A	Corriente de CA por fase.
battery_pcs_current_ac__phase__L2	Corriente	A	Corriente de CA por fase.
battery_pcs_current_ac__phase__L3	Corriente	A	Corriente de CA por fase.
battery_pcs_frequency	Frecuencia	Hz	Frecuencia de CA.
battery_pcs_power_ac	Potencia	W	Potencia activa, lado de CA. Con signo.
battery_pcs_power_ac_in	Potencia	W	Potencia activa hacia la batería (carga desde la red). Siempre positiva.
battery_pcs_power_ac_out	Potencia	W	Potencia activa desde la batería (descarga hacia la red). Siempre positiva.
battery_pcs_power_ac_reactive	Potencia reactiva	VAr	Potencia reactiva, lado de CA. Con signo.
battery_pcs_power_factor	Factor de potencia	-	Factor de potencia (−1…1).

Consignas

Vista de solo lectura de los objetivos de despacho activos.

Nombre de la métrica	Tipo	Unidad	Descripción
battery_pcs_power_ac_setpoint	Consigna	W	Consigna de potencia activa. Con signo.
battery_pcs_power_ac_setpoint_reactive	Consigna	VAr	Consigna de potencia reactiva. Con signo.
battery_pcs_power_factor_setpoint	Consigna	-	Consigna de factor de potencia.

Contadores de energía

Se publican exactamente como los reportan los propios contadores de vida útil del dispositivo — contadores direccionales separados, por lo que no se necesita ninguna decisión de signo.

Nombre de la métrica	Tipo	Unidad	Descripción
battery_pcs_energy_ac_in_total	Energía	Wh	Energía de CA de toda la vida útil cargada en la batería.
battery_pcs_energy_ac_out_total	Energía	Wh	Energía de CA de toda la vida útil descargada de la batería.

Estado de batería retransmitido y límites del convertidor

El PCS retransmite un resumen del sistema de gestión de la batería e informa de sus propios límites operativos dinámicos. Donde el sistema de gestión de la batería se recopila directamente, battery_box_soc es la referencia autoritativa y el valor retransmitido es redundante; en un emplazamiento con solo PCS es el único estado de carga disponible.

Nombre de la métrica	Tipo	Unidad	Descripción
battery_pcs_soc	Estado de carga	%	Estado de carga retransmitido desde el sistema de gestión de la batería (0–100).
battery_pcs_current_limit_charge	Límite	A	Corriente de carga máxima permitida (dinámica).
battery_pcs_current_limit_discharge	Límite	A	Corriente de descarga máxima permitida.
battery_pcs_power_limit_charge	Límite	W	Potencia de carga máxima permitida.
battery_pcs_power_limit_discharge	Límite	W	Potencia de descarga máxima permitida.
battery_pcs_temperature	Temperatura	°C	Temperatura del convertidor — el estado térmico del convertidor, no una temperatura de celda de batería.

Nivel de caja

La cima del lado de la batería: una caja / contenedor BESS. Etiqueta obligatoria: box. Etiquetas opcionales: inverter, phase. Las métricas del lado de CA solo están presentes cuando la conversión CA↔CC se ubica físicamente a nivel de caja.

Flujo de energía del lado de CA

Nombre de la métrica	Tipo	Unidad
battery_box_voltage_ac	Tensión	V
battery_box_voltage_ac__phase__L1_L2	Tensión	V
battery_box_voltage_ac__phase__L2_L3	Tensión	V
battery_box_voltage_ac__phase__L3_L1	Tensión	V
battery_box_current_ac	Corriente	A
battery_box_current_ac__phase__L1	Corriente	A
battery_box_current_ac__phase__L2	Corriente	A
battery_box_current_ac__phase__L3	Corriente	A
battery_box_frequency	Frecuencia	Hz
battery_box_power_ac	Potencia	W
battery_box_power_ac_in	Potencia	W
battery_box_power_ac_out	Potencia	W
battery_box_power_ac_reactive	Potencia reactiva	VAr
battery_box_power_ac_setpoint	Consigna	W
battery_box_power_ac_setpoint_reactive	Consigna	VAr
battery_box_energy_ac_in_total	Energía	Wh
battery_box_energy_ac_out_total	Energía	Wh

Interfaz del lado de CC

Nombre de la métrica	Tipo	Unidad
battery_box_voltage_dc	Tensión	V
battery_box_voltage_dc_in	Tensión	V
battery_box_voltage_dc_out	Tensión	V
battery_box_current_dc	Corriente	A
battery_box_current_dc_in	Corriente	A
battery_box_current_dc_out	Corriente	A
battery_box_power_dc	Potencia	W
battery_box_power_dc_in	Potencia	W
battery_box_power_dc_out	Potencia	W
battery_box_energy_dc_in_total	Energía	Wh
battery_box_energy_dc_out_total	Energía	Wh

Química y estado

Nombre de la métrica	Tipo	Unidad	Descripción
battery_box_cell_voltage	Tensión (suma)	V	Suma de las tensiones de celda en el bus de CC de la caja.
battery_box_soc	Estado de carga	%	Estado de carga de toda la caja (0–100).
battery_box_soh	Estado de salud	%	Estado de salud de toda la caja (0–100).
battery_box_temperature	Temperatura	°C	Temperatura representativa a nivel de caja.
battery_box_energy_nominal	Energía	Wh	Energía nominal instalada en las celdas al inicio de la vida útil. Disminuye con el SoH.
battery_box_energy_usable	Energía	Wh	Energía utilizable máxima: la capacidad estática permitida por el BMS a la que corresponde un SoC = 100 % (normalmente 85–95 % de `_nominal`).
battery_box_energy_charged	Energía	Wh	Energía actualmente almacenada en la caja, derivada de `soc / 100 × energy_usable`.

Nivel de almacenamiento

Un armario / rack dentro de una caja. Etiquetas obligatorias: box, storage. Las métricas de CA son poco frecuentes en este nivel — solo están presentes cuando la conversión CA↔CC se ubica físicamente a nivel de almacenamiento.

Flujo de energía del lado de CA

El mismo vocabulario de CA que el nivel de caja, sin variantes por fase ni de consigna.

Nombre de la métrica	Tipo	Unidad
battery_storage_voltage_ac	Tensión	V
battery_storage_current_ac	Corriente	A
battery_storage_frequency	Frecuencia	Hz
battery_storage_power_ac	Potencia	W
battery_storage_power_ac_in	Potencia	W
battery_storage_power_ac_out	Potencia	W
battery_storage_power_ac_reactive	Potencia reactiva	VAr
battery_storage_energy_ac_in_total	Energía	Wh
battery_storage_energy_ac_out_total	Energía	Wh

Interfaz del lado de CC

Nombre de la métrica	Tipo	Unidad
battery_storage_voltage_dc	Tensión	V
battery_storage_voltage_dc_in	Tensión	V
battery_storage_voltage_dc_out	Tensión	V
battery_storage_current_dc	Corriente	A
battery_storage_current_dc_in	Corriente	A
battery_storage_current_dc_out	Corriente	A
battery_storage_power_dc	Potencia	W
battery_storage_power_dc_in	Potencia	W
battery_storage_power_dc_out	Potencia	W
battery_storage_energy_dc_in_total	Energía	Wh
battery_storage_energy_dc_out_total	Energía	Wh

Química y estado

Nombre de la métrica	Tipo	Unidad	Descripción
battery_storage_cell_voltage	Tensión (suma)	V	Suma de todas las tensiones de celda del string en serie del almacenamiento.
battery_storage_soc	Estado de carga	%	Estado de carga de este almacenamiento (0–100).
battery_storage_soh	Estado de salud	%	Estado de salud de este almacenamiento (0–100).
battery_storage_temperature	Temperatura	°C	Temperatura representativa a nivel de almacenamiento.
battery_storage_energy_nominal	Energía	Wh	Energía nominal instalada en las celdas de este almacenamiento (inicio de vida útil).
battery_storage_energy_usable	Energía	Wh	Energía utilizable máxima: la capacidad estática permitida por el BMS a la que corresponde un SoC = 100 % (normalmente 85–95 % de `_nominal`).
battery_storage_energy_charged	Energía	Wh	Energía actualmente almacenada, derivada de `soc / 100 × energy_usable`.
battery_storage_comm_quality	Calidad	%	Calidad del enlace de comunicación a nivel de almacenamiento (0–100).

Nivel de módulo

Un módulo dentro de un armario: la unidad más pequeña que tiene su propio chip BMS. Etiquetas obligatorias: box, storage, module. Las métricas de CA prácticamente nunca están presentes aquí.

Interfaz del lado de CC

Nombre de la métrica	Tipo	Unidad
battery_module_voltage_dc	Tensión	V
battery_module_voltage_dc_in	Tensión	V
battery_module_voltage_dc_out	Tensión	V
battery_module_current_dc	Corriente	A
battery_module_current_dc_in	Corriente	A
battery_module_current_dc_out	Corriente	A
battery_module_power_dc	Potencia	W
battery_module_power_dc_in	Potencia	W
battery_module_power_dc_out	Potencia	W
battery_module_energy_dc_in_total	Energía	Wh
battery_module_energy_dc_out_total	Energía	Wh

Química y estado

Nombre de la métrica	Tipo	Unidad	Descripción
battery_module_cell_voltage	Tensión (suma)	V	Suma de las tensiones de celda del string en serie de este módulo.
battery_module_soc	Estado de carga	%	Estado de carga del módulo (0–100).
battery_module_soh	Estado de salud	%	Estado de salud del módulo (0–100).
battery_module_temperature	Temperatura	°C	Temperatura representativa del módulo.
battery_module_energy_nominal	Energía	Wh	Energía máxima almacenable de este módulo.
battery_module_energy_usable	Energía	Wh	Energía utilizable máxima: la capacidad estática permitida por el BMS a la que corresponde un SoC = 100 %.
battery_module_energy_charged	Energía	Wh	Energía actualmente almacenada, derivada de `soc / 100 × energy_usable`.
battery_module_comm_quality	Calidad	%	Calidad de las comunicaciones del BMS entre este módulo y su controlador de almacenamiento (0–100).

Nivel de celda

La unidad física más pequeña. Las celdas están conectadas en serie dentro de un módulo y comparten la corriente del módulo, por lo que la corriente y la potencia por celda no son significativas. Etiquetas obligatorias: box, storage, module, cell.

Nombre de la métrica	Tipo	Unidad
battery_cell_voltage	Tensión	V
battery_cell_temperature	Temperatura	°C

Métricas de pronóstico meteorológico

Métricas meteorológicas diarias

Nombre de la métrica	Tipo	Unidad
weather_forecast_daily_shortwave_radiation_sum	Radiación	Wh/m²
weather_forecast_daily_precipitation_sum	Precipitación	mm
weather_forecast_daily_rain_sum	Lluvia	mm
weather_forecast_daily_showers_sum	Chubascos	mm
weather_forecast_daily_snowfall_sum	Nevada	cm
weather_forecast_daily_precipitation_hours	Duración	h
weather_forecast_daily_weather_code	Código	-
weather_forecast_daily_temperature_2m_max	Temperatura	°C
weather_forecast_daily_wind_speed_10m_max	Velocidad del viento	m/s
weather_forecast_daily_wind_gusts_10m_max	Ráfagas de viento	m/s
weather_forecast_daily_wind_direction_10m_dominant	Dirección del viento	°

Métricas meteorológicas de 15 minutos

Nombre de la métrica	Tipo	Unidad
weather_forecast_minutely_15_terrestrial_radiation	Radiación	W/m²
weather_forecast_minutely_15_shortwave_radiation	Radiación	W/m²
weather_forecast_minutely_15_diffuse_radiation	Radiación	W/m²
weather_forecast_minutely_15_direct_normal_irradiance	Irradiancia	W/m²
weather_forecast_minutely_15_lightning_potential	Potencial	-
weather_forecast_minutely_15_precipitation	Precipitación	mm
weather_forecast_minutely_15_snowfall	Nevada	cm
weather_forecast_minutely_15_rain	Lluvia	mm
weather_forecast_minutely_15_weather_code	Código	-
weather_forecast_minutely_15_relative_humidity_2m	Humedad	%
weather_forecast_minutely_15_dew_point_2m	Temperatura	°C
weather_forecast_minutely_15_apparent_temperature	Temperatura	°C
weather_forecast_minutely_15_cloud_cover	Cobertura de nubes	%
weather_forecast_minutely_15_temperature_2m	Temperatura	°C
weather_forecast_minutely_15_temperature_80m	Temperatura	°C
weather_forecast_minutely_15_temperature_120m	Temperatura	°C
weather_forecast_minutely_15_temperature_180m	Temperatura	°C
weather_forecast_minutely_15_wind_speed_10m	Velocidad del viento	m/s
weather_forecast_minutely_15_wind_speed_80m	Velocidad del viento	m/s
weather_forecast_minutely_15_wind_speed_120m	Velocidad del viento	m/s
weather_forecast_minutely_15_wind_speed_180m	Velocidad del viento	m/s
weather_forecast_minutely_15_wind_direction_10m	Dirección del viento	°
weather_forecast_minutely_15_wind_direction_80m	Dirección del viento	°
weather_forecast_minutely_15_wind_direction_120m	Dirección del viento	°
weather_forecast_minutely_15_wind_direction_180m	Dirección del viento	°
weather_forecast_minutely_15_wind_gusts_10m	Ráfagas de viento	m/s
weather_forecast_minutely_15_snow_depth	Espesor de nieve	m
weather_forecast_minutely_15_visibility	Visibilidad	m

Métricas de cálculo meteorológico

Nombre de la métrica	Tipo	Unidad
weather_forecast_minutely_15_gti	Irradiancia	W/m²
weather_forecast_minutely_15_gti_direct	Irradiancia	W/m²
weather_forecast_minutely_15_gti_clearsky	Irradiancia	W/m²
weather_forecast_minutely_15_ghi_direct	Irradiancia	W/m²
weather_forecast_minutely_15_ghi_direct_clearsky	Irradiancia	W/m²
weather_forecast_minutely_15_gti_direct_clearsky	Irradiancia	W/m²
weather_forecast_minutely_15_gti_energy	Energía	Wh

Métricas del modelo meteorológico

Métricas de potencia del modelo meteorológico

Nombre de la métrica	Tipo	Unidad
powerplant_power_model_dc	Potencia	W
powerplant_energy_model_dc_total	Energía	Wh
powerplant_power_model_ac	Potencia	W
powerplant_energy_model_ac_total	Energía	Wh
powerplant_power_model_grid	Potencia	W
powerplant_energy_model_grid_total	Energía	Wh
powerplant_energy_model_grid_in_total	Energía	Wh
powerplant_energy_model_grid_out_total	Energía	Wh

Métricas de potencia del modelo de cielo despejado (Clearsky)

Nombre de la métrica	Tipo	Unidad
powerplant_power_clearsky_dc	Potencia	W
powerplant_energy_clearsky_dc_total	Energía	Wh
powerplant_power_clearsky_ac	Potencia	W
powerplant_energy_clearsky_ac_total	Energía	Wh
powerplant_power_clearsky_grid	Potencia	W
powerplant_energy_clearsky_grid_total	Energía	Wh
powerplant_energy_clearsky_grid_in_total	Energía	Wh
powerplant_energy_clearsky_grid_out_total	Energía	Wh

Métricas del sistema de alarma

La familia alarm_* es la señalización de alarma del propio emplazamiento. Nada en ella se mide: cada valor es la posición de un contacto de relé leído a través de las entradas digitales de un controlador — las salidas de relé de una central de alarma antiintrusión, más los contactos de supervisión del armario de comunicaciones al que la central está cableada.

Cada serie es un indicador 0/1 normalizado de forma que 1 significa siempre «la condición está presente» (puerta abierta, alarma disparada, SAI en batería, magnetotérmico disparado) y 0 significa normal, sea cual sea la polaridad del contacto. La ausencia nunca es un cero: una señal que el dispositivo no ha servido en este ciclo no se publica en absoluto, y un contacto que el operador ha declarado sin cablear se retiene en lugar de quedarse permanentemente en alarma. La identificación de la instancia vive en la etiqueta alarm — el sistema de alarma al que pertenecen las señales — nunca en el nombre de la métrica.

Toda señal salvo alarm_door_open abre además un evento de parque del mismo nombre mientras está activa; una puerta abierta es rutina y se queda solo en serie. Consulta Sistema de alarma para ver la página que alimentan estas series.

Nombre de la métrica	Tipo	Unidad	Descripción
alarm_door_open	Estado	0/1	La central indica la puerta o el portón como abiertos. Solo serie — nunca un evento.
alarm_triggered	Estado	0/1	La central ha disparado una alarma.
alarm_fault	Estado	0/1	La central informa de una avería propia.
alarm_cabinet_ups_alarm	Estado	0/1	El SAI del armario de comunicaciones informa de un fallo.
alarm_cabinet_ups_on_battery	Estado	0/1	Se ha perdido la red — el SAI sostiene el armario.
alarm_cabinet_heating_breaker_tripped	Estado	0/1	Ha saltado el magnetotérmico de la calefacción del armario.
alarm_cabinet_main_switch_off	Estado	0/1	El interruptor general del armario está apagado.

Métricas de red

Las métricas de red describen la conectividad entre el dispositivo IoT y la nube, independientemente de cualquier scraper o servicio específico.

Nombre de la métrica	Tipo	Unidad
network_ping_latency_ms	Latencia	ms
network_ping_packet_loss_percent	Pérdida de paquetes	%
network_ping_success	Éxito	bool
network_connection_status	Estado	-

Métricas de agente

Las métricas de agente describen los propios agentes de recopilación de datos: tanto el estado por fuente de los adaptadores individuales del scraper, como la salud y el tráfico generales de los agentes y la conectividad de apoyo. Estas métricas permiten que sus paneles correlacionen las lagunas de datos con fallos de adaptador o de conectividad, en lugar de con el equipo bajo medición.

Métricas de fuente del scraper

El Data Scraper emite un conjunto de estas métricas por cada fuente de adaptador activa. Las series se distinguen mediante las etiquetas source, source_num y name, de modo que las lagunas de datos puedan correlacionarse directamente con la salud del adaptador en lugar de con el equipo que se mide.

Nombre de la métrica	Tipo	Unidad	Etiquetas
scraper_health_state	Estado	code	source, source_num, name
scraper_cycles_total	Contador	-	source, source_num, name
scraper_errors_total	Contador	-	source, source_num, name
scraper_last_success_timestamp	Marca de tiempo	s	source, source_num, name

scraper_health_state: Estado actual del adaptador, codificado como entero: 0 = inicializando, 1 = saludable, 2 = no saludable, 3 = reconectando, 4 = congelado (el logger devuelve valores obsoletos/atascados), 5 = en pausa.
scraper_cycles_total: Número de ciclos de recuperación que el adaptador ha ejecutado desde el inicio del proceso (se reinicia al reiniciar).
scraper_errors_total: Número de ciclos de recuperación que terminaron en una excepción desde el inicio del proceso (se reinicia al reiniciar).
scraper_last_success_timestamp: Segundos de la época Unix del último ciclo de recuperación exitoso. Solo se emite tras el primer éxito.

Métricas de servicio de agente

Estas métricas rastrean la salud y el uso de red de los servicios de agente individuales (Data Scraper, Digital Twin y servicios de apoyo) que se ejecutan en un dispositivo, para que pueda ver si una laguna de datos proviene del equipo o del propio agente.

Tráfico de red

Nombre de la métrica	Tipo	Unidad
agent_network_rx_bytes	Contador	bytes
agent_network_tx_bytes	Contador	bytes

Salud del agente

Nombre de la métrica	Tipo	Unidad
agent_health	Estado	bool
agent_uptime_seconds	Duración	s
agent_boottime	Marca de tiempo	s

VPN de la organización

Conectividad y tráfico del enlace VPN de toda la organización entre la planta y la nube.

Nombre de la métrica	Tipo	Unidad
agent_organization_vpn_connected	Estado	bool
agent_organization_vpn_rx_bytes	Contador	bytes
agent_organization_vpn_tx_bytes	Contador	bytes

VPN directa

Conectividad y tráfico de cada túnel VPN directo (por planta). Las series llevan una etiqueta vpn_name para que cada túnel se identifique individualmente.

Nombre de la métrica	Tipo	Unidad
agent_direct_vpn_connected	Estado	bool
agent_direct_vpn_rx_bytes	Contador	bytes
agent_direct_vpn_tx_bytes	Contador	bytes

VPN SaaS

Conectividad y tráfico del túnel integrado del agente a la nube que transporta el tráfico de acceso remoto de la plataforma hacia la planta.

Nombre de la métrica	Tipo	Unidad
agent_saas_vpn_connected	Estado	bool
agent_saas_vpn_rx_bytes	Contador	bytes
agent_saas_vpn_tx_bytes	Contador	bytes

Servidor VPN

Cuando el propio agente actúa como servidor VPN para conexiones entrantes, estas métricas informan del estado del servidor y de cada peer que se conecta. Las series por peer llevan las etiquetas interface, peer_uid y peer_kind, de modo que los paneles puedan distinguir las conexiones de usuarios de los enlaces entre emplazamientos.

Nombre de la métrica	Tipo	Unidad
agent_vpn_server_running	Estado	bool
agent_vpn_server_peer_connected	Estado	bool
agent_vpn_server_peer_rx_bytes	Contador	bytes
agent_vpn_server_peer_tx_bytes	Contador	bytes
agent_vpn_server_peer_last_handshake	Marca de tiempo	s

agent_vpn_server_peer_last_handshake: Segundos de la época Unix del último handshake completado del peer; 0 significa que el peer nunca completó ninguno. Para los peers OpenVPN, que no exponen ninguna marca de tiempo por handshake, se publica el tiempo de conexión (connected-since) bajo la misma métrica, de modo que una sola consulta cubra ambos protocolos.

Métricas del operador

La flota de operadores envía métricas de infraestructura para el monitoreo de túneles VPN y la salud del operador, lo que le permite ver el estado de la conectividad del lado de la nube que enlaza sus plantas con la plataforma.

Métricas de túnel VPN

Nombre de la métrica	Tipo	Unidad	Etiquetas
operator_vpn_connected	Estado	bool	vpn_service, organization, cluster, region
operator_vpn_rx_bytes	Tráfico	bytes	vpn_service, organization, cluster, region
operator_vpn_tx_bytes	Tráfico	bytes	vpn_service, organization, cluster, region

operator_vpn_connected: 1 si el túnel VPN tiene un handshake reciente (en los últimos 3 minutos), 0 en caso contrario
operator_vpn_rx_bytes: Total de bytes recibidos a través del túnel VPN (contador)
operator_vpn_tx_bytes: Total de bytes transmitidos a través del túnel VPN (contador)

Métricas de salud del operador

Nombre de la métrica	Tipo	Unidad	Etiquetas
operator_health	Estado	bool	operator, cluster, region
operator_uptime_seconds	Duración	s	operator, cluster, region
operator_cloud_response_age_seconds	Duración	s	operator, cluster, region

operator_health: 1 si el operador tiene una conexión activa con la nube, 0 si está en estado de timeout
operator_uptime_seconds: Segundos desde que se inició el proceso del operador
operator_cloud_response_age_seconds: Segundos desde la última respuesta exitosa de la API de la nube

Proceso de recopilación

El proceso de recopilación de datos sigue un flujo de trabajo estructurado:

Descubrimiento: El sistema identifica todos los componentes que deben monitorearse según la configuración del parque
Programación: Los calendarios de recopilación se optimizan según la importancia y la variabilidad de la métrica
Recuperación: El data scraper se conecta a los dispositivos y recopila las mediciones brutas
Validación: Los datos recopilados se validan en cuanto a precisión y cumplimiento de rango
Enriquecimiento: Se añade información contextual (marcas de tiempo, identificadores de componente, etc.)
Transmisión: Los datos se transmiten de forma segura a la base de datos de series temporales
Verificación: El sistema confirma el almacenamiento y la disponibilidad exitosos

Puntos de integración

El sistema de recopilación de métricas se integra con otros componentes de la plataforma:

Panel de monitoreo: Proporciona visualización de datos en tiempo real
Detección de eventos: Suministra datos para la identificación de anomalías e incidencias
Motor de informes: Aporta mediciones para los informes de rendimiento
Sistema de análisis: Alimenta los cálculos avanzados de rendimiento
Módulo de pronóstico: Proporciona datos históricos para los modelos de predicción

Seguridad de los datos

Todas las métricas recopiladas están protegidas mediante múltiples medidas de seguridad:

Cifrado: Los datos se cifran tanto en tránsito como en reposo
Control de acceso: Las métricas están sujetas al mismo modelo de permisos que el resto de recursos
Auditoría: Todo acceso a los datos de métricas se registra con fines de cumplimiento
Anonimización: Los datos agregados utilizados para benchmarking se anonimizan

Extensibilidad

El sistema de recopilación de métricas está diseñado para ser extensible:

Nuevas familias de dispositivos: Desarrollamos un adaptador dedicado para cada familia de dispositivos a petición; si su planta utiliza un logger, inversor, contador o sistema de batería que aún no soportamos, puede añadirse sin recurrir a un comodín genérico.
Métricas personalizadas: Soporte para mediciones específicas del emplazamiento o del equipo.
Fuentes de datos externas: Las series de meteorología y de irradiancia de referencia se incorporan junto con los datos de su planta para potenciar el análisis y el pronóstico.

Funciones relacionadas

Data Scraper — el agente de borde que recopila estas métricas con un adaptador dedicado por familia de dispositivos
Digital Twin — convierte las métricas brutas en producción simulada, performance ratio y hallazgos de pérdidas
API de exportación de métricas — consulte y descargue estas métricas para su propio uso
MiroxQL — el formato de consulta para el acceso programático y bruto a sus métricas recopiladas
Monitoreo en tiempo real — paneles en vivo construidos sobre las métricas recopiladas