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 461 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. Así es como el Data Scraper recopila los datos:
Recopilación a través del túnel de la planta
Cada planta tiene su propio agente, que se ejecuta en la Mirox-Cloud y se conecta a la planta a través de un túnel VPN dedicado:
- Interactúa con los equipos de la planta a través del túnel mediante los adaptadores específicos de cada dispositivo
- Gestiona la administración de conexiones y la lógica de reintentos por dispositivo
- Realiza la validación y el filtrado de los datos antes de almacenar nada
- Optimiza el uso del ancho de banda mediante sondeo inteligente
- Detecta huecos y reconstruye los periodos ausentes mediante relleno cuando el dispositivo conserva un historial
Como cada planta tiene un agente dedicado, la recopilación escala por planta y la conectividad de una planta nunca afecta a otra.
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 |
| powerplant_energy_consumed_total | Energía | Wh |
| powerplant_grid_energy_total_reactive_capacitive | Energía | VArh |
| powerplant_grid_energy_total_reactive_inductive | Energía | VArh |
| powerplant_grid_power | Potencia | W |
| powerplant_grid_energy_total | Energía | Wh |
powerplant_grid_power es la interpolación alineada al minuto de powerplant_power_grid, sumada sobre todos los contadores, y powerplant_grid_energy_total el contador de energía propio de la plataforma (consciente de los reinicios) integrado a partir de ella — la única serie monótona de producción del emplazamiento que leen las analíticas (un parque con varios contadores tiene varios powerplant_energy_grid_total brutos). Ambas llevan la etiqueta boot_time; leer el contador con sum(increase(…)).
Nota sobre la convención de nombres
Las métricas brutas de contador powerplant_energy_grid_* y powerplant_power_grid no siguen el patrón de nomenclatura estándar (powerplant_grid_*) por razones heredadas y conservan sus nombres por compatibilidad. No lea powerplant_grid_power / powerplant_grid_energy_total como sus gemelas renombradas: son las series calculadas al minuto por la plataforma descritas arriba — una serie de planta sumada, no una por contador.
Contadores de alimentador FV y batería
Un parque con una batería (u otro productor) detrás del mismo punto de conexión a red mide cada alimentador por separado. La familia de red anterior es el punto de conexión, sumado a nivel de parque; el alimentador FV publica la familia powerplant_pv_* y el de batería la familia powerplant_battery_* — las mismas magnitudes con la misma convención de signos (producción / descarga positivas). Los dos contadores de batería se nombran por lo que hizo la unidad: _energy_discharge_total es lo que entregó, _energy_charge_total lo que absorbió. No confundir con las familias battery_* de abajo, que son la vista del propio controlador de batería sobre sus niveles de caja, almacenamiento, módulo y celda.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_pv_power | Potencia | W |
| powerplant_pv_power_apparent | Potencia | VA |
| powerplant_pv_power_reactive | Potencia reactiva | VAr |
| powerplant_pv_energy_total | Energía | Wh |
| powerplant_pv_energy_consumed_total | Energía | Wh |
| powerplant_pv_energy_total_reactive | Energía | VArh |
| powerplant_pv_energy_total_reactive_capacitive | Energía | VArh |
| powerplant_pv_energy_total_reactive_inductive | Energía | VArh |
| powerplant_battery_power | Potencia | W |
| powerplant_battery_power_apparent | Potencia | VA |
| powerplant_battery_power_reactive | Potencia reactiva | VAr |
| powerplant_battery_energy_discharge_total | Energía | Wh |
| powerplant_battery_energy_charge_total | Energía | Wh |
| powerplant_battery_energy_total_reactive | Energía | VArh |
| powerplant_battery_energy_total_reactive_capacitive | Energía | VArh |
| powerplant_battery_energy_total_reactive_inductive | Energía | VArh |
Totales CA de la planta
Totales CA a nivel de planta publicados por registradores que reportan la planta como una sola unidad CA (nomenclatura heredada, energy/power antes de ac).
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_energy_ac_total | Energía | Wh |
| powerplant_energy_ac_reactive_total | Energía | VArh |
| powerplant_power_ac | Potencia | W |
| powerplant_power_ac_reactive | Potencia reactiva | VAr |
| powerplant_power_ac_apparent | Potencia | VA |
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 |
| powerplant_inverter_power | Potencia | W |
| powerplant_inverter_energy_total | Energía | Wh |
| powerplant_inverter_data_complete | Validez | bool |
| powerplant_inverter_derating_reason | Motivo | code |
| powerplant_inverter_operating_state | Estado | code |
powerplant_inverter_power / powerplant_inverter_energy_total son los equivalentes alineados al minuto y sumados sobre los inversores del par de red anterior (una serie de planta con etiqueta boot_time, no una por inversor). powerplant_inverter_data_complete es el veredicto por minuto sobre esa suma: 1 cuando cada inversor esperado contribuyó, 0 en caso contrario, ausente cuando no fue posible un veredicto. powerplant_inverter_operating_state es el estado operativo estándar de la plataforma derivado del código de estado del fabricante (0 desconocido, 1 en reposo, 2 produciendo, 3 produciendo limitado, 4 autolimitación, 5 parado por comando, 6 parado por protección, 7 inalcanzable, 8 fallo — numerado para que max dé el peor estado), mientras que powerplant_inverter_derating_reason es el código de motivo propio del fabricante para una limitación.
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 aerogenerador
Un aerogenerador es un componente plano de la planta como un inversor, identificado por la etiqueta turbine_id (con turbine_name y turbine_vendor). Los valores son las medias de 10 minutos que registra el controlador de la turbina. powerplant_turbine_blade_pitch_angle lleva una etiqueta blade (A/B/C) y powerplant_turbine_temperature una etiqueta sensor (multiplicadora, generador, transformador, góndola, …). Las series time_* son segundos por intervalo de 10 minutos en cada estado — disponibilidad medida, no inferida de huecos. Las series de restricción y pérdida son la diferencia medida entre potencia posible y real, atribuida a una parte por el código de estado del controlador (grid = operador de red, marketer = consigna del comercializador / controlador de planta, environment = paradas por sombra / murciélagos / hielo / meteorología, command = paradas manuales o de servicio, fault = alarma de la turbina); sus contadores _energy_total son totales acumulados que mantiene la plataforma.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_turbine_power_ac | Potencia | W |
| powerplant_turbine_power_ac_possible | Potencia | W |
| powerplant_turbine_power_ac_reactive | Potencia reactiva | VAr |
| powerplant_turbine_energy_ac_total | Energía | Wh |
| powerplant_turbine_energy_consumed_total | Energía | Wh |
| powerplant_turbine_voltage_ac__phase__L1 | Tensión | V |
| powerplant_turbine_voltage_ac__phase__L2 | Tensión | V |
| powerplant_turbine_voltage_ac__phase__L3 | Tensión | V |
| powerplant_turbine_current_ac__phase__L1 | Corriente | A |
| powerplant_turbine_current_ac__phase__L2 | Corriente | A |
| powerplant_turbine_current_ac__phase__L3 | Corriente | A |
| powerplant_turbine_frequency | Frecuencia | Hz |
| powerplant_turbine_power_factor | Factor de potencia | - |
| powerplant_turbine_wind_speed | Velocidad del viento | m/s |
| powerplant_turbine_wind_direction | Dirección del viento | ° |
| powerplant_turbine_nacelle_direction | Dirección | ° |
| powerplant_turbine_rotor_speed | Velocidad | rpm |
| powerplant_turbine_generator_speed | Velocidad | rpm |
| powerplant_turbine_blade_pitch_angle | Ángulo | ° |
| powerplant_turbine_temperature | Temperatura | °C |
| powerplant_turbine_temperature_ambient | Temperatura | °C |
| powerplant_turbine_time_running | Duración | s |
| powerplant_turbine_time_ok | Duración | s |
| powerplant_turbine_time_alarm | Duración | s |
| powerplant_turbine_time_wind_ok | Duración | s |
| powerplant_turbine_time_grid_ok | Duración | s |
| powerplant_turbine_time_service | Duración | s |
| powerplant_turbine_time_derate_remote | Duración | s |
| powerplant_turbine_time_derate_internal | Duración | s |
| powerplant_turbine_vendor_status | Estado | code |
| powerplant_turbine_pause_reason | Motivo | code |
| powerplant_turbine_operating_state | Estado | code |
| powerplant_turbine_setpoint_power_active | Consigna | W |
| powerplant_turbine_stop_command | Comando | bool |
| powerplant_turbine_curtailment_grid_power | Potencia | W |
| powerplant_turbine_curtailment_marketer_power | Potencia | W |
| powerplant_turbine_curtailment_environment_power | Potencia | W |
| powerplant_turbine_curtailment_command_power | Potencia | W |
| powerplant_turbine_loss_fault_power | Potencia | W |
| powerplant_turbine_curtailment_grid_energy_total | Energía | Wh |
| powerplant_turbine_curtailment_marketer_energy_total | Energía | Wh |
| powerplant_turbine_curtailment_environment_energy_total | Energía | Wh |
| powerplant_turbine_curtailment_command_energy_total | Energía | Wh |
| powerplant_turbine_loss_fault_energy_total | Energía | Wh |
Métricas de seguidores solares
Un seguidor solar de un eje es un componente plano de la planta como un inversor, identificado por la etiqueta tracker_id — el número de serie de su controlador de fila, nunca su posición en el campo (campo, fila y posición son información del componente y se muestran a través de la serie de información). tracker_vendor solo lo lleva la serie de estado del fabricante y selecciona la tabla de decodificación del fabricante. El estado operativo usa la escala estándar (0 desconocido … 8 fallo): siguiendo al sol = produciendo (2), en posición de seguridad ordenada por el controlador del campo por viento, nieve o poca luz = produciendo limitado (3), una anulación manual, una limpieza o una parada de emergencia = parado por comando (5), palabra de error activa = fallo (8); un seguidor que no entrega ningún registro no publica nada — un hueco, nunca un estado. Los indicadores de condición empaquetan las condiciones 0/1 del seguidor en una sola palabra con posiciones de bit fijas: emergency_stop = 0, offline = 1, battery_absent = 2, battery_low = 3, rf_weak = 4, misaligned = 5; un bit se decodifica con floor(x / 2^bit) % 2. El primer sistema en servicio actualiza todo el campo aproximadamente cada 5 minutos. Consulte Seguidores solares y controladores de planta.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_tracker_angle | Ángulo | ° |
| powerplant_tracker_angle_setpoint | Ángulo | ° |
| powerplant_tracker_motor_current | Corriente | A |
| powerplant_tracker_battery_soc | Estado de carga | % |
| powerplant_tracker_battery_voltage | Tensión | V |
| powerplant_tracker_temperature | Temperatura | °C |
| powerplant_tracker_vendor_status | Estado | code |
| powerplant_tracker_operating_state | Estado | code |
| powerplant_tracker_condition_flags | Indicadores | bitmask |
Series de información de componentes
Los nombres que un operador dio a los componentes, publicados como series propias para que los dashboards muestren los nombres actuales sin que la telemetría los lleve como etiquetas (un cambio de etiqueta bifurcaría una serie). Una serie por componente, indexada exactamente como su telemetría (inverter_id; gak_id; string_number, con gak_id solo detrás de una caja de conexiones; id para un contador de inyección; turbine_id; tracker_id; plant_controller_kind para un controlador de planta) más la etiqueta de nombre (inverter_name, gak_name, string_name, meter_name, turbine_name, tracker_name, plant_controller_name). El valor es la hora de emisión; la serie se renueva en cada sincronización del árbol, por lo que un cambio de nombre aparece en la siguiente sincronización. Nunca grafique, sume ni alerte sobre estas series — únalas a la telemetría como se muestra en Crear sus propios dashboards de Grafana.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_inverter_info | Info | - |
| powerplant_gak_info | Info | - |
| powerplant_string_info | Info | - |
| powerplant_feedin_info | Info | - |
| powerplant_turbine_info | Info | - |
| powerplant_tracker_info | Info | - |
| plant_controller_info | Info | - |
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_max_power_import_by_grid | Límite | % |
| powerplant_battery_setpoint_external_w | Consigna | W |
| powerplant_battery_setpoint_applied | Consigna | % |
| powerplant_battery_setpoint_applied_w | Consigna | W |
| powerplant_battery_max_power_charge_by_grid | Límite | % |
| powerplant_battery_max_power_charge_by_grid_w | Límite | W |
| powerplant_battery_max_power_discharge_by_grid | Límite | % |
| powerplant_battery_max_power_discharge_by_grid_w | Límite | 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 | - |
Las consignas de batería llevan signo (positivo = descarga, negativo = carga): _external / _external_w es la orden del comercializador, _local_w la entrada manual del operador, _applied / _applied_w lo que el controlador de planta realmente ordena al almacenamiento tras fusionar cada orden y cada límite en un solo número. Los límites son magnitudes positivas: powerplant_max_power_import_by_grid es el límite del operador de red sobre lo que la planta puede consumir (100 = sin reducción), y los pares battery_max_power_charge/discharge_by_grid los límites del operador de red sobre el almacenamiento dentro de una planta mayor, una vía por sentido. Cada dispositivo publica la vía que expresa de forma nativa (porcentaje o vatios); la plataforma nunca convierte entre ellas.
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 | - |
| powerplant_grid_power_loss | Potencia | W |
| powerplant_grid_energy_total_loss | Energía | Wh |
| powerplant_inverter_power_loss | Potencia | W |
| powerplant_inverter_energy_total_loss | Energía | Wh |
| powerplant_gak_power_loss | Potencia | W |
| powerplant_gak_energy_total_loss | Energía | Wh |
| powerplant_string_power_loss | Potencia | W |
| powerplant_string_energy_total_loss | Energía | Wh |
Métricas de estado
El veredicto diario de producción de la plataforma por componente: 1 cuando el componente produjo con normalidad, 0 en caso contrario, con el estado detallado en la etiqueta status. No confundir con powerplant_inverter_operating_state, que es lo que reporta el propio dispositivo en cada sondeo.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_string_status | Estado | bool |
| powerplant_gak_status | Estado | bool |
| powerplant_inverter_status | Estado | bool |
| powerplant_grid_status | Estado | bool |
Valores configurados
Las potencias pico, el límite de inversores de la planta, los recuentos de componentes y los dos valores monetarios de la configuración de la planta no son series temporales. No se escriben en la base de datos de series temporales, por lo que el acceso directo a la base de datos no puede leerlos: ni una consulta MetricsQL directa ni, por ejemplo, sus propios dashboards de Grafana. Solo existen dentro de Métricas, con los nombres park. de abajo: Mirox los lee de la configuración de la planta cada vez que se calcula una métrica e inserta el valor de esa planta.
| Nombre en Métricas | Nombre anterior | Tipo | Unidad |
|---|---|---|---|
| park.inverter.peak_power | powerplant_inverter_peak_power | Potencia | W |
| park.gak.peak_power | powerplant_gak_peak_power | Potencia | W |
| park.string.peak_power | powerplant_string_peak_power | Potencia | W |
| park.peak_power | powerplant_park_peak_power | Potencia | W |
| park.inverter_limit | powerplant_park_limit_inverter | Potencia | W |
| park.inverter_count | powerplant_park_inverter_count | Recuento | - |
| park.string_count | powerplant_park_string_count | Recuento | - |
| park.eeg_value | powerplant_park_eeg_value | Dinero | EUR/MWh |
| park.marktwert | market_marktwert | Dinero | EUR/MWh |
Métricas obsoletas
Se mantienen solo para dashboards que ya las usan — los nuevos dashboards deben usar powerplant_solar_radiation y powerplant_inverter_frequency.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| powerplant_power_radiation | Potencia | W |
| powerplant_frequency_grid | Frecuencia | Hz |
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. |
| powerplant_weather_forecast_radiation_power | Irradiancia | W/m² | Irradiancia en el plano de los módulos, ponderada por capacidad, a partir de la cual se calcula la potencia del pronóstico meteorológico — la propia entrada del pronóstico, como indicador. |
| powerplant_weather_forecast_hub_wind_speed | Velocidad del viento | m/s | Solo plantas eólicas: velocidad del viento prevista a la altura del buje (antes de la corrección por densidad del aire) a partir de la cual se calcula la potencia del pronóstico eólico. Por aerogenerador con una etiqueta turbine_id; la serie de planta es la media ponderada por potencia nominal. |
En las plantas eólicas, el pronóstico meteorológico y las series esperadas basadas en el tiempo (powerplant_weather_forecast_power, powerplant_weather_forecast_energy_total, powerplant_weather_expected_power, powerplant_weather_expected_energy_total) se calculan a partir de la curva de potencia de cada aerogenerador con el viento a la altura del buje corregido por densidad, en lugar de a partir de la irradiancia. Solo llevan la línea sin calibrar pr="none"; la suma de la planta existe como clipping="ignored" (suma simple de aerogeneradores) y clipping="considered" (limitada al límite de la conexión a red). Igual que en las familias de liquidación eólica, los puntos por aerogenerador llevan una etiqueta turbine_id y la suma de la planta no lleva ninguna: lee la planta con turbine_id!~".+", ya que un sum(...) sin más sobre ambas cuenta dos veces. Para la eólica no existen series de cielo despejado.
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. |
Familias de liquidación eólica
La eólica terrestre liquida la restricción por turbina y suma a una vía de parque: los puntos por turbina llevan una etiqueta turbine_id, la suma del parque no lleva ninguna — sepárelos con turbine_id!~".+", ya que un simple sum(...) sobre ambos cuenta doble. Tres métodos comparten las mismas matemáticas y etiquetas: nacelle (el anemómetro propio de la turbina alimenta la curva de potencia certificada), windref (el predeterminado — la velocidad del viento de una turbina de referencia o de un servicio meteorológico) y windfixed (tarifa plana: la última potencia medida sin restricción, congelada durante toda la medida). La inyección Marktprämie es la inyección a red medida con cada cuarto de hora de precio negativo puesto a cero, una copia por negative_price_rule. <party> es grid o marketer.
| Patrón del nombre de la métrica | Tipo | Unidad | Descripción |
|---|---|---|---|
powerplant_nacelle_curtailment_<party>_power | Potencia | W | Pérdida por restricción, método del anemómetro de góndola. |
powerplant_nacelle_curtailment_<party>_energy_total | Energía | Wh | Energía de restricción acumulada, método góndola. |
powerplant_windref_curtailment_<party>_power | Potencia | W | Pérdida por restricción, método de viento de referencia (predeterminado). |
powerplant_windref_curtailment_<party>_energy_total | Energía | Wh | Energía de restricción acumulada, método de viento de referencia. |
powerplant_windfixed_curtailment_<party>_power | Potencia | W | Pérdida por restricción, método eólico de tarifa plana. |
powerplant_windfixed_curtailment_<party>_energy_total | Energía | Wh | Energía de restricción acumulada, método eólico de tarifa plana. |
| powerplant_marktpraemie_feedin_power | Potencia | W | Inyección elegible para la Marktprämie como media de cuarto de hora. |
| powerplant_marktpraemie_feedin_energy_total | Energía | Wh | Energía de inyección elegible para la Marktprämie acumulada, por mes de entrega (etiqueta period). |
powerplant_mischpreis_<wind method>_grid_revenue | Ingresos | EUR | Valor de mercado de la energía restringida por la red por intervalo de 15 minutos; <wind method> es nacelle, windref o windfixed. Solo suma de parque, solo parte de red. |
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. |
| battery_pcs_vendor_status | Estado | code | El estado operativo propio del convertidor en el vocabulario del fabricante (la etiqueta battery_vendor selecciona la tabla de decodificación). Un hueco significa «no leído»; nunca sumar ni promediar. |
| battery_pcs_operating_state | Estado | code | El estado de funcionamiento estándar del convertidor en la plataforma (0 desconocido … 8 avería, como las series del inversor y del aerogenerador), derivado de la palabra de estado del fabricante y escrito junto a ella con las mismas etiquetas. Un hueco significa «no leído»; nunca sumar ni promediar. |
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. |
| battery_box_cell_voltage_min | Tensión | V | Tensión de celda más baja de la caja, según la reporta el BMS. |
| battery_box_cell_voltage_max | Tensión | V | Tensión de celda más alta de la caja. |
| battery_box_cell_temperature_min | Temperatura | °C | Temperatura de celda más baja de la caja. |
| battery_box_cell_temperature_max | Temperatura | °C | Temperatura de celda más alta de la caja. |
| battery_box_power_limit_charge | Límite | W | Lo que el BMS permite actualmente absorber a la caja. Magnitud positiva; una caja limitada queda por debajo de su valor nominal. |
| battery_box_power_limit_discharge | Límite | W | Lo que el BMS permite actualmente entregar a la caja. |
| battery_box_power_auxiliary | Potencia | W | Lo que consumen los propios sistemas de la caja para funcionar (climatización, electrónica, bombas). Consumo positivo, nunca integrado en las vías de carga/descarga. |
| battery_box_energy_auxiliary_total | Energía | Wh | Contador acumulado del consumo auxiliar. |
| battery_box_vendor_status | Estado | code | La palabra de estado propia del contenedor en el vocabulario del fabricante (etiqueta battery_vendor). Un hueco significa «no leído»; nunca sumar ni promediar. |
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). |
| battery_storage_power_limit_charge | Límite | W | Techo de carga por almacenamiento que el BMS permite actualmente. Magnitud positiva. |
| battery_storage_power_limit_discharge | Límite | W | Techo de descarga por almacenamiento que el BMS permite actualmente. |
| battery_storage_cycle_count | Recuento | - | Equivalentes de ciclo completo según los cuenta el BMS desde la puesta en marcha. |
| battery_storage_vendor_status | Estado | code | El estado operativo propio del rack en el vocabulario del fabricante (etiqueta battery_vendor). Nunca sumar ni promediar. |
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 |
| battery_cell_soc | Estado de carga | % |
| battery_cell_soh | Estado de salud | % |
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. |
Señales definidas por el operador. Las señales definidas con el lector Modbus genérico no reciben un nombre de métrica propio. Comparten tres series y se distinguen por etiquetas: alarm nombra el sistema de alarma y signal la señal. La etiqueta signal es una clave permanente, no el nombre visible, así que renombrar una señal conserva su histórico; un sistema de alarma lleva como máximo 64 señales.
| Nombre de la métrica | Tipo | Unidad | Descripción |
|---|---|---|---|
| alarm_signal_state | Estado | 0/1 | 1 = la condición de la señal está presente, 0 = normal. Solo se publica para señales con condición, y solo cuando la condición pudo decidirse a partir de una lectura reciente. |
| alarm_signal_value | Valor | definida por señal | El valor decodificado y escalado de una señal numérica, o el 0/1 en bruto de un contacto sin condición. |
| alarm_reader_signals_read | Recuento | – | Cuántas señales leyó el lector en su última consulta, por sistema de alarma. Una consulta a la que el dispositivo no respondió no publica nada. |
Se aplica la misma regla que arriba: la ausencia nunca es un cero. Una señal que no se leyó no publica ni estado ni valor, y una señal en modo Apagada no se lee en absoluto. Que una señal abra un evento de parque, y con qué nivel, lo decide el operador por señal y no forma parte de la serie.
Métricas de controladores de planta
La familia plant_controller_* es el controlador central opcional de una tecnología de la planta — tipo tracker (campo de seguidores), battery (planta de baterías), pv (planta fotovoltaica) o wind (parque eólico), en la etiqueta plant_controller_kind. Solo los sistemas centralizados tienen uno; una planta descentralizada no publica ninguna de estas series. Un controlador se identifica por la planta y su tipo, más segment_id para un controlador que sirve a un segmento — no hay un identificador por dispositivo. plant_controller_vendor solo lo lleva la serie de estado del fabricante. La familia tiene exactamente cuatro series, exponga lo que exponga el fabricante:
| Nombre de la métrica | Tipo | Unidad | Descripción |
|---|---|---|---|
| plant_controller_vendor_status | Estado | code | La palabra de estado propia del fabricante, en bruto. Un hueco significa «no leído»; nunca sumar ni promediar. |
| plant_controller_operating_state | Estado | code | El estado operativo estándar de la plataforma (0 desconocido … 8 fallo), como las series del inversor, del aerogenerador y del convertidor. |
| plant_controller_condition_flags | Indicadores | bitmask | Las condiciones del controlador en una sola palabra con posiciones de bit comunes a toda la flota: running = 0, standby = 1, night_mode = 2, starting = 3, stopping = 4, stopped = 5, alarm = 6, fault = 7, stow_wind = 8, stow_snow = 9, stow_irradiation = 10, override = 11, cleaning = 12, soc_high = 13, soc_low = 14, switchgear_open = 15, comm_degraded = 16, manual_mode = 17. Un bit se decodifica con floor(x / 2^bit) % 2. |
| plant_controller_measurement | Valor | según la magnitud | Los valores analógicos propios del controlador, una serie por etiqueta quantity (abajo). |
quantity | Unidad | Significado |
|---|---|---|
| soc, soe, soh | % | Estado de carga, estado de energía y estado de salud del almacenamiento |
| power_available_charge_w, power_available_discharge_w | W | Potencia que el almacenamiento puede absorber o entregar ahora (positiva) |
| count_units_connected, count_units_running | – | Unidades (convertidores o filas de seguidores) conectadas / en funcionamiento |
| count_storage_connected | – | Unidades de almacenamiento (racks o contenedores) conectadas |
| energy_aux_daily_wh | Wh | El contador diario propio del controlador de la energía auxiliar, tal como se lee |
| availability_converter_pct, availability_storage_pct | % | Disponibilidad de convertidores y de almacenamiento tal como la notifica el controlador |
| wind_speed_ms | m/s | La velocidad del viento con la que decide el controlador del campo |
| irradiation_wm2 | W/m² | La irradiación con la que decide el controlador del campo |
| temperature_c | °C | La temperatura con la que decide el controlador del campo |
| precipitation_intensity_mmh | mm/h | La intensidad de precipitación con la que decide el controlador del campo |
| lock_remaining_s | s | Tiempo restante de un bloqueo en posición de seguridad |
| comm_error_rate_pct | % | Tasa de errores de comunicación del peor subcontrolador |
Un controlador publica las magnitudes de las que dispone. Consulte Seguidores solares y controladores de planta.
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 monitorización de red
Las comprobaciones activas propias del agente (ICMP, TCP, HTTP) contra los dispositivos de la red de la planta. Las series por dispositivo llevan device_ip, device_name, device_type y device_vendor; las comprobaciones TCP añaden el puerto, las HTTP el endpoint. netmon_park_network_up es una serie resumen por planta.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| netmon_park_network_up | Estado | bool |
| netmon_device_up | Estado | bool |
| netmon_device_ping_latency_ms | Latencia | ms |
| netmon_device_ping_packet_loss_percent | Pérdida de paquetes | % |
| netmon_tcp_port_open | Estado | bool |
| netmon_tcp_port_response_ms | Tiempo de respuesta | ms |
| netmon_http_status_code | Estado HTTP | code |
| netmon_http_response_ms | Tiempo de respuesta | ms |
| netmon_http_up | Estado | bool |
| netmon_discovered_devices_total | Recuento | - |
| netmon_snmp_devices_total | Recuento | - |
| netmon_discovery_duration_seconds | Duración | s |
Métricas SNMP
Leídas de dispositivos con SNMP en la red de la planta (switches, routers, gateways). Las series de dispositivo llevan las mismas etiquetas que arriba; las series de interfaz añaden if_index, if_name e if_type.
| Nombre de la métrica | Tipo | Unidad |
|---|---|---|
| snmp_device_uptime_seconds | Duración | s |
| snmp_device_available | Disponibilidad | bool |
| snmp_device_cpu_usage_percent | Uso | % |
| snmp_device_memory_usage_percent | Uso | % |
| snmp_device_memory_used_bytes | Memoria | bytes |
| snmp_device_memory_total_bytes | Memoria | bytes |
| snmp_device_temperature_celsius | Temperatura | °C |
| snmp_interface_status | Estado | code |
| snmp_interface_admin_status | Estado | code |
| snmp_interface_speed_bps | Velocidad | bit/s |
| snmp_interface_in_bytes_total | Tráfico | bytes |
| snmp_interface_out_bytes_total | Tráfico | bytes |
| snmp_interface_in_errors_total | Errores | - |
| snmp_interface_out_errors_total | Errores | - |
| snmp_interface_in_discards_total | Descartes | - |
| snmp_interface_out_discards_total | Descartes | - |
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;
0significa 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:
1si el túnel VPN tiene un handshake reciente (en los últimos 3 minutos),0en 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_cloud_liveness_age_seconds | Duración | s | operator, cluster, region |
- operator_health:
1si el operador tiene una conexión activa con la nube,0si 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
- operator_cloud_liveness_age_seconds: Segundos desde la última confirmación de que el proceso en la nube está vivo (endpoint de salud) — se mantiene actualizado incluso mientras la API principal devuelve errores, por lo que es la puerta de seguridad
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 en tránsito
- Control de acceso: Las métricas están sujetas al mismo modelo de permisos que el resto de recursos
- 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
- Metric Export — exporte métricas como series temporales para su propio uso
- Métricas — defina cifras propias sobre las series recopiladas
- Monitoreo en tiempo real — paneles en vivo construidos sobre las métricas recopiladas