Recopilación de métricas

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

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

Arquitectura del Data Scraper

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

Recopilación basada en la nube

Cuando se despliega en la nube:

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

Recopilación basada en el borde

Cuando se despliega en el borde (in situ):

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

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

Métricas recopiladas

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

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

Métricas del emplazamiento

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

Métricas de la planta

Métricas de red eléctrica

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(…)).

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.

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

Métricas de inversor

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)

Métricas de string

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.

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) más la etiqueta de nombre (inverter_name, gak_name, string_name, meter_name, turbine_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.

Métricas de 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

Métricas ambientales

Métricas de pérdidas

Métricas de informe

Métricas del gemelo digital

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.

Datos configurados

Publicados una vez por día local del parque por la plataforma a partir de la configuración de la planta, nunca medidos: la potencia pico de cada componente y del parque, el límite de inversores del parque y los recuentos de componentes. Los componentes ocultos se excluyen y un valor no configurado no escribe ninguna muestra, de modo que «no configurado» sigue siendo distinguible de «configurado como cero». Léalos como cualquier serie, p. ej. last_over_time(powerplant_inverter_peak_power[1d]).

Métricas obsoletas

Se mantienen solo para dashboards que ya las usan — los nuevos dashboards deben usar powerplant_solar_radiation y powerplant_inverter_frequency.

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.

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.

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.

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.

Carriles de potencia en vivo y de pronóstico

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

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.

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.

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.

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.

Entorno

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

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.

Lado de CA

Consignas

Vista de solo lectura de los objetivos de despacho activos.

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.

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.

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

Interfaz del lado de CC

Química y estado

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.

Interfaz del lado de CC

Química y estado

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

Química y estado

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.

Métricas de pronóstico meteorológico

Métricas meteorológicas diarias

Métricas meteorológicas de 15 minutos

Métricas de cálculo meteorológico

Métricas del modelo meteorológico

Métricas de potencia del modelo meteorológico

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

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.

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.

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.

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.

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.

• 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

Salud del agente

VPN de la organización

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

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.

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.

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.

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

Métricas del operador

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

Métricas de túnel VPN

• 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

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

1. Descubrimiento: El sistema identifica todos los componentes que deben monitorearse según la configuración del parque
2. Programación: Los calendarios de recopilación se optimizan según la importancia y la variabilidad de la métrica
3. Recuperación: El data scraper se conecta a los dispositivos y recopila las mediciones brutas
4. Validación: Los datos recopilados se validan en cuanto a precisión y cumplimiento de rango
5. Enriquecimiento: Se añade información contextual (marcas de tiempo, identificadores de componente, etc.)
6. Transmisión: Los datos se transmiten de forma segura a la base de datos de series temporales
7. 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