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 376 nombres de métricas estandarizadas en once familias: producción de la planta (powerplant), almacenamiento de batería, 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 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) 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_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_local	Apagado	%
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 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_box_*               una caja / contenedor BESS — la cima del lado de la batería
└── 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

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 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.

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 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

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