Métricas

Métricas permite a tu organización definir sus propios indicadores. Describes, en una expresión breve, qué debe medirse en un único intervalo de 15 minutos. Del resto se ocupa la plataforma: aplica tu expresión a cada planta, durante el periodo que cubre un informe, y condensa los valores de 15 minutos en la cifra que quieres ver.

Una métrica se define una sola vez para toda la organización y queda disponible en todas las plantas: nunca escribes una métrica «para una planta».

Dónde encontrarlo

Abre la página Informes de cualquier planta y cambia a la tercera pestaña, Métricas. La lista que ves pertenece a tu organización; la planta es simplemente el lugar donde la consultas y la pruebas.

  • Los administradores de la organización crean, editan y eliminan métricas.
  • Todos los miembros ven las métricas y pueden utilizarlas en informes.

Definir una métrica

Una métrica se compone de unos campos descriptivos y de una a tres expresiones.

Nueva métrica crea la métrica en ese mismo momento y, a partir de ahí, cada cambio se guarda mientras escribes: un indicador de estado muestra Guardando y después Guardado, sin ningún paso aparte para confirmar. Mientras su expresión no valide, la métrica sigue siendo un Borrador: la tabla la marca con la etiqueta Borrador y un borrador nunca se ofrece como fuente de datos en un informe. En cuanto la expresión valida, la etiqueta desaparece y la métrica puede usarse en todas partes.

  • Nombre, descripción, unidad: cómo aparece la métrica en el selector de datos del informe y en el informe terminado.
  • Expresión: qué se mide en un intervalo de 15 minutos. Se escribe en MetricsQL, el lenguaje de consulta del almacén de series temporales de la plataforma. Escribes únicamente la parte correspondiente al intervalo: la plataforma añade la planta, la ventana temporal y la condensación. Nunca nombres una planta ni una organización en la expresión: se rechaza, porque la misma métrica debe funcionar en todas las plantas.
  • Condensación: cómo los valores de 15 minutos se convierten en una cifra:
    • media: el promedio de los valores de los intervalos
    • suma: el total de los valores de los intervalos
    • proporción: la parte de los intervalos esperados en los que la expresión valía 1
    • último: el valor al final del periodo
  • Esperado (opcional, para la condensación «proporción»): una segunda expresión que decide qué intervalos cuentan, por ejemplo «hay luz diurna». Un intervalo sin expectativa no cuenta; un intervalo esperado sin medición cuenta como no disponible; un periodo sin ningún intervalo esperado se muestra como un guion.
  • Peso (opcional): un valor fijo por componente, como su potencia pico, que se utiliza para combinar los valores de los componentes en un único valor de planta. Sin peso, todos los componentes cuentan por igual.
  • Presentar como: la forma en que responde la métrica. Valor de planta da una cifra por planta; si la expresión trabaja por componente, esa cifra es el valor de planta ponderado descrito arriba. Por componente da una columna por inversor, caja de conexión de generador, string o datalogger, además del valor de planta. Duplica una métrica si necesitas la misma cifra en ambas formas.
  • Resolución más fina — el paso más fino con el que un informe puede presentar la métrica: 15 minutos, horaria o diaria. Los pasos más gruesos están siempre disponibles; elige Día para una cifra que solo tiene sentido por día.

También eliges la resolución con la que se presenta la métrica: 15 minutos, horaria, diaria, mensual o un único valor para todo el periodo.

Mientras escribes, el editor valida en vivo: sintaxis, series desconocidas (con sugerencias de lo que probablemente querías decir), la regla de autolimitación, si las expresiones encajan con la condensación elegida y el tamaño. Después, una ejecución de prueba evalúa la métrica en la planta actual, y una vista previa muestra una tabla y un gráfico con cada inversor o componente y el valor de planta resultante para el mes, trimestre o año que elijas; una métrica presentada como valor de planta muestra solo esa cifra. Los mensajes de validación y de la prueba nombran la planta sobre la que se comprobaron.

Los bloques de construcción

El panel lateral del editor enumera todo aquello con lo que puedes construir, de modo que apenas tienes que recordar nombres:

  • Series: los mismos datos que la selección de datos de los informes: inyección y producción de la planta, producción esperada y series de referencia, retribución y limitación, inversores, cajas de conexión, strings, batería, meteorología e infraestructura, cada una con las etiquetas y los pasos que lleva. Puedes buscar por nombre y filtrar por nivel; una marca indica qué series aún no ha entregado la planta actual — la métrica funciona igualmente en toda la organización. Lo que un informe calcula en lugar de leer (performance ratio, recuentos de eventos, cifras de liquidación) aparece al final como no expresable, para que lo sepas antes de escribirlo.
  • Datos configurados: valores de la configuración de la planta, no mediciones: potencia pico CC de inversor, caja de conexión y string, potencia pico de la planta, capacidad de inversores de la planta y número de componentes. Se insertan en la consulta de cada planta al ejecutarse, por lo que una expresión usa el nombre como una serie constante: por ejemplo powerplant_inverter_peak_power para ponderar o fijar un umbral por inversor. En una planta en la que ningún componente tiene el valor configurado, la vista previa queda vacía; la métrica en sí funciona en todas las plantas que los tienen. Dos de ellos son válidos por periodo en lugar de constantes: el valor aplicable efectivo de la planta —el anzulegender Wert ponderado por capacidad de las bandas vigentes en cada momento— y el Marktwert frente al que se liquida la planta, mensual o anual según su configuración de mercado, ambos en EUR/MWh. Cambian con el tiempo y la plataforma inserta el valor vigente en cada slot de 15 minutos, por lo que no necesitan una ventana propia. Una prima de mercado calculada a partir de ambos —clamp_min(powerplant_park_eeg_value - market_marktwert, 0)— es una aproximación mezclada para ver la evolución: la liquidación prorratea cada banda por separado, así que nunca es la cifra liquidada.

Ejemplos incluidos

La tabla Métricas ya contiene cinco métricas que Mirox entrega a todas las organizaciones: Conectividad, Disponibilidad del datalogger, Disponibilidad de inversores con luz diurna, Horas de sol y Disponibilidad de los datos de inyección. Llevan un candado y la etiqueta Ejemplo: no pertenecen a ninguna organización, así que no pueden editarse ni eliminarse.

Lo que sí puedes hacer con ellas:

  • Abrir una y leer sus expresiones. Son ejemplos resueltos de todo lo anterior: el filtro de luz diurna, las dos formas de la condensación «proporción», la identidad por componente y una escala de unidad.
  • Ejecutar la vista previa en la planta en la que estás, para ver cada serie y el valor de planta que resulta de ellas.
  • Duplicar una. La copia pertenece a tu organización, es totalmente editable y es el punto de partida habitual para una métrica propia.

Los ejemplos son a propósito la versión sencilla y transparente de cada pregunta, y cada descripción indica qué no tiene en cuenta. Las cifras de disponibilidad propias del informe —que utilizan el inventario de dataloggers configurado de la planta y sus métodos de liquidación— siguen donde estaban, bajo Disponibilidad en el selector de datos del informe. Por eso los ejemplos no se ofrecen en el selector; un duplicado sí.

Límites

  • Una expresión puede tener hasta 4 000 caracteres; una vez que la plataforma añade la planta, el almacén rechaza cualquier consulta de más de 16 KB.
  • Una métrica puede devolver como máximo 500 series en una misma planta.
  • La ejecución de prueba sobre un día debe completarse en 5 segundos.
  • No se puede medir nada con una granularidad inferior a 15 minutos.

Si una métrica alcanza alguno de estos límites, el editor lo indica mientras escribes, y la métrica sigue siendo un borrador hasta que lo resuelves.

Un ejemplo resuelto

Disponibilidad de inversores (2 % del pico CC): la proporción de intervalos con luz diurna en los que un inversor produjo al menos el 2 % de su potencia pico CC, ponderada por la potencia pico y expresada en porcentaje con la condensación proporción.

Expresión:

max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * powerplant_inverter_peak_power

Esperado (qué intervalos cuentan: hay luz suficiente):

(avg(avg_over_time(powerplant_pyranometer_radiation_power{segment_id!~".+"}[900s])) or avg(avg_over_time(powerplant_weather_radiation_power{segment_id!~".+"}[900s]))) > bool 100

Peso (para que los inversores grandes pesen más en el valor de planta):

powerplant_inverter_peak_power

Crear una métrica con el asistente

No hace falta que escribas MetricsQL tú mismo. El asistente está dentro del editor de métricas: abre Nueva métrica —o cualquier métrica que puedas editar— y lo encontrarás como panel de chat arriba a la derecha. Permanece en silencio hasta que le escribes; antes no se envía nada.

Describe con tus palabras la cifra que quieres. El asistente ya conoce la planta en la que estás, lo que llevas rellenado (nombre, expresión, condensación…), el resultado de la última validación y las series que esa planta escribe realmente, así que rara vez tiene que preguntar lo básico. Propone la expresión, un nombre y una descripción, los valida y muestra una vista previa en la planta, y te avisa cuando la plataforma no dispone de los datos que pediste o cuando la consulta sería demasiado pesada.

La propuesta se vuelca en los campos en cuanto llega: el asistente edita contigo y cada cambio se guarda al hacerlo. Si prefieres conservar lo que tenías, Deshacer en la propuesta del chat devuelve los campos al estado anterior; la propuesta sigue en el chat y puede aplicarse de nuevo. El asistente termina solo: la propuesta se guarda en la métrica en cuanto se produce, así que puedes enviar tu petición, cerrar la página y encontrar la métrica terminada en la lista cuando vuelvas. A partir de ahí es una edición normal: cambias cualquier campo, vuelves a ejecutar la vista previa o pides algo distinto.

La conversación pertenece a la métrica, no a la pestaña del navegador. Cierra el editor y vuelve a abrir la métrica, o recarga la página: el mismo chat sigue ahí, junto a los campos que escribió.

El chat del editor solo admite texto. Las fotos y los documentos —la página con la fórmula de un contrato, por ejemplo— siguen siendo una función de la página de chat completa; Abrir en el chat lleva allí la conversación.

Usar una métrica en un informe

En el editor de informes, abre el selector de datos de un bloque y elige el nivel Métricas de la organización. Tus métricas aparecen ahí junto a los elementos propios de la plataforma y se comportan igual que ellos: las mismas resoluciones, las mismas tablas y gráficos. Como la métrica es de toda la organización, el mismo bloque funciona sin cambios en un informe de cualquier planta.

Lo que no se puede definir

Algunas cifras las calcula la propia plataforma y deben tomarse de los elementos existentes en lugar de reconstruirse:

  • Performance ratio y producción esperada: utiliza los elementos calculados por la plataforma, disponibles también como bloques de construcción.
  • Liquidación de las limitaciones de potencia: se deriva de tu configuración de mercado y tarifas.
  • Potencia nominal CA por inversor: no se almacena por inversor, por lo que no puede referenciarse.

Páginas relacionadas