Metric Export

La página Exportación de datos exporta cualquier métrica de tus plantas como serie temporal: desde la inyección a red de todo un portfolio hasta un único sensor de irradiancia, un aerogenerador o una celda de batería. Eliges las plantas, las métricas, el periodo y el paso, compruebas la vista previa y descargas un archivo CSV. Cada exportación es además un enlace que puedes pasar a Excel o a un script.

Esta guía trata de la página en sí. Los parámetros que hay detrás de cada enlace de exportación se describen en la API de Metric Export.

Una sola colección de métricas

La exportación y los informes leen la misma colección de métricas. Una métrica tiene un nombre, una unidad y una definición, la encuentres donde la encuentres: en el selector de datos del informe, en un informe terminado y en un archivo exportado.

La colección contiene:

• las métricas que entrega Mirox, ordenadas por nivel: planta, inversor, caja de conexión, string, batería, aerogenerador, sensor, contador, meteorología, mercado y más. Los niveles se enumeran en Métricas disponibles;
• las métricas que tu organización ha definido en Métricas. En el selector se agrupan como Mis métricas.

Una métrica marcada como No validada en Mis métricas no se puede exportar hasta que su expresión valide.

Las tres pestañas

Exportar métricas

1. Elige las plantas

En Plantas, abre la lista de plantas y marca una o varias; la lista de portfolios de al lado añade portfolios enteros. Las listas son las mismas que en la navegación de la izquierda: cada fila lleva el tipo de la planta —solar, eólica o batería— y lo que eliges aparece como chips en el campo. Plantas y portfolios se pueden mezclar; una planta que además está en un portfolio elegido se exporta una sola vez. Puedes exportar como máximo 50 plantas en un archivo. Con más de una planta eliges además si las plantas se combinan en una columna por métrica o se muestran una junto a otra: consulta Varias plantas. Plantas en distintas zonas horarias ponen el archivo en UTC: consulta Hora local de la planta y UTC.

2. Añade métricas

En Métricas, escribe en el campo de búsqueda lo que buscas: un nombre, una palabra de la descripción, un componente o una unidad, por ejemplo inversor dc. Cada palabra que escribes tiene que aparecer en algún sitio de una métrica: en su nombre, su id, los ids que usaba la exportación anterior, su unidad, su nivel o su descripción. Las mejores coincidencias van primero: una métrica cuyo nombre empieza por tus palabras antes que una que solo las menciona en su descripción. Intro añade la primera coincidencia, las flechas mueven la selección y Ver todas las métricas abre la colección entera por nivel, con la misma búsqueda. energy_grid_daily encuentra Inyección a red, así que un id de un enlace antiguo también sirve.

Cada fila indica qué mide la métrica y con qué pasos se puede leer. Una fila que no puedes elegir nombra el motivo:

Una exportación lleva como máximo 20 métricas. Las métricas elegidas se enumeran bajo la búsqueda, en el orden de las columnas; arrastra una fila para cambiarlo. Explicaciones, encima de la lista, abre una descripción de cada métrica elegida: unidad, con qué frecuencia se mide, los pasos y valores que ofrece y cómo se combinan varias plantas. Descargar glosario (CSV) te da allí toda la colección como archivo.

Si la colección no tiene una métrica para lo que necesitas, Crear métrica abre el editor de métricas de la página Informes; Volver a la exportación de datos, en su parte superior, te devuelve con las plantas, métricas y periodo que tenías. Para una lectura puntual de la base de datos de series temporales, añade en su lugar una consulta MetricsQL.

3. Elige los componentes

Una métrica de un nivel de componente —inversor, caja de conexión, string, aerogenerador, sensor, contador, contenedor de baterías, rack, módulo, celda o convertidor— exporta una columna por componente. Sin selección obtienes todos los componentes de la planta, 50 por página. Para restringir la exportación, abre el botón de componentes de la métrica y elige los que necesites, hasta 100.

Así exportas cada sensor de irradiancia por separado, sin promediar: añade Irradiancia por sensor y deja vacía la selección de componentes.

Los componentes ocultos se omiten. Mostrar ocultos, en el diálogo de componentes, los enumera para que puedas elegir uno a propósito.

4. Fija el periodo

En Periodo y paso, elige un periodo predefinido o fija tu propio inicio y fin. Los periodos predefinidos son Hoy, Ayer, Últimos 7 días, Últimos 30 días, Esta semana, Semana anterior, Este mes, Mes anterior, Este trimestre, Trimestre anterior, Este año y Año anterior. Sin selección, la exportación cubre el mes anterior.

Un periodo puede empezar como muy pronto en 2020 y abarcar como máximo cinco años. Un periodo que llega al futuro termina ahora.

5. Elige el paso

El paso es la duración de una fila: 1 min, 5 min, 15 min, 1 h, día, semana, mes, trimestre o año. Si lo dejas en automático, Mirox elige un paso que ofrezcan todas las métricas elegidas y que encaje con el periodo: 15 minutos hasta dos días, una hora hasta dos meses, un día hasta tres años y un mes a partir de ahí.

No todas las métricas se pueden leer con todos los pasos: consulta Los pasos y sus límites. Una métrica que no ofrece el paso elegido se exporta igualmente, con su propio paso: consulta Métricas con distintos pasos. Solo un paso con el que una métrica no podría tener ninguna fila aparece atenuado y nombra esa métrica.

6. Elige los valores

Para una energía u otra magnitud contada, elige en Valores si cada fila muestra la cantidad Por intervalo o el Total acumulado desde el inicio del periodo. Todas las demás métricas se exportan Tal como se mide, y la lista indica cómo se forma cada fila: consulta Valores.

7. Elige la zona horaria

Hora local de la planta es el valor predeterminado; UTC es la alternativa. Consulta Hora local de la planta y UTC.

8. Comprueba la vista previa y descarga

La Vista previa muestra la exportación como gráfico o como tabla. Debajo del periodo, una línea indica el tamaño: filas, columnas, el tamaño aproximado del archivo y la duración. Las notas bajo la vista previa te dicen qué ha hecho Mirox por su cuenta, por ejemplo que un periodo se amplió a días completos.

En el gráfico:

• El ojo al principio de cada fila de métrica o de consulta oculta su serie en el gráfico y en la tabla, y la vuelve a mostrar. Una serie oculta sigue en la descarga y en el enlace; el ajuste forma parte de la dirección de la página, así que un enlace compartido muestra la misma vista.
• Hacer clic en un nombre de la leyenda hace lo mismo; Mayús+clic muestra solo esa serie. Leyenda y ojos siempre coinciden.
• Arrastra sobre el gráfico para ampliar un rango; un doble clic vuelve a reducir. El zoom solo cambia la vista.
• La información emergente enumera hasta diez series, el valor mayor primero, y dice cuántas más hay.
• Un periodo largo con un paso fino tiene más puntos de los que un navegador puede dibujar. El gráfico muestra entonces una resolución más gruesa y lo dice en una nota naranja —El gráfico muestra la resolución 1 h para seguir siendo legible; la tabla y la exportación mantienen 1 min— o, si no se ofrece un paso más grueso, agrupa varias filas en un punto. La tabla, la descarga y el enlace mantienen siempre el paso que elegiste.

En Opciones de exportación, elige el separador CSV, el separador decimal, el formato de la marca de tiempo, el idioma de los nombres de columna y los Encabezados de columna: Nombres (para personas) o IDs (para scripts). El formato de la marca de tiempo cambia también las fechas de la tabla, así que la vista previa muestra lo que llevará el archivo. Después:

• Descargar CSV guarda el archivo.
• Copiar URL de la API copia la misma exportación en forma de enlace. Probar prepara un token de API y ofrece comandos listos para el terminal y para Python.
• Guardar como plantilla conserva la selección como plantilla.

Consultas MetricsQL

Además de las métricas de la colección, la pestaña Métricas acepta consultas en bruto en MetricsQL, el lenguaje de consulta de la base de datos de series temporales de la plataforma: el lenguaje que usan las métricas de tu organización y Grafana. Una consulta sirve para lo que la colección no tiene métrica: una serie que guarda la base de datos, una combinación de series, una función sobre ellas.

1. Haz clic en MetricsQL, bajo las métricas, para abrir el campo de consulta.
2. Escribe la consulta, por ejemplo sum by (inverter_id) (powerplant_inverter_power_ac). Mientras escribes, el campo propone nombres de series, etiquetas y funciones; Tab acepta la propuesta. Intro ejecuta la consulta y la añade como fila; Mayús+Intro empieza una línea nueva dentro de la consulta.
3. La fila muestra el texto de la consulta sobre un fondo de código y el chip MetricsQL donde una métrica muestra su unidad. Las columnas de la fila son una por cada serie que responde la consulta, tal como se mide. El lápiz convierte el texto en un editor en el mismo sitio: Intro guarda, Esc cancela. Nada más cambia en la fila.

Qué hace una consulta y qué no:

• Mirox añade la planta elegida a cada selector de la consulta, así que la consulta nunca nombra una planta, un parque ni una organización. Una consulta con una etiqueta así se rechaza, y se nombra la etiqueta.
• Una consulta se lee con el paso que elegiste —cualquier paso, de 1 min a un año— como la leería un panel: muestras brutas con ese paso, sin modo de valor ni agregación. Por intervalo y Total acumulado no se le aplican.
• Con varias plantas, cada planta recibe sus propias columnas. Las consultas nunca se combinan entre plantas.
• Una consulta puede responder como máximo 500 series en una planta; agrégala, por ejemplo con sum by (…), si responde más. Una exportación lleva como máximo 5 consultas de hasta 4 000 caracteres cada una, y las series que responden cuentan para los límites de tamaño como cualquier otra columna.
• En el archivo, la columna lleva el encabezado MetricsQL seguido de la consulta y, cuando la consulta responde varias series, de las etiquetas de cada serie: MetricsQL sum by (inverter_id) (powerplant_inverter_power_ac) {inverter_id="INV1"}. Con IDs (para scripts) el encabezado es expr1, expr2, … con las mismas etiquetas. Así, un archivo con consultas se distingue de una exportación normal por su primera fila.
• Una consulta no se guarda en una plantilla. Quita las consultas para guardar las métricas como plantilla, o define la cifra una sola vez como métrica de tu organización: entonces está validada, tiene nombre y unidad, y también se ofrece a los informes.

Los pasos y sus límites

Los pasos que ofrece una métrica dependen de lo que es y de la frecuencia con que se mide:

Una métrica nunca se ofrece más fina de lo que se mide: un aerogenerador que reporta cada 10 minutos no tiene valores de 1 minuto.

El paso también limita el periodo, porque una columna contiene como máximo 180 000 valores:

Los pasos de un día o más cubren siempre días, semanas, meses, trimestres o años completos. Un periodo que empieza o termina dentro de uno de ellos se amplía al intervalo completo, y una nota lo indica. Las semanas empiezan el lunes.

Métricas con distintos pasos

No todas las métricas ofrecen todos los pasos, y algunas solo ofrecen pasos gruesos: el performance ratio empieza en el día, un valor de mercado existe una vez al mes. La pestaña Métricas las reúne igualmente en un archivo:

• Una métrica con un paso más grueso que el archivo conserva su propio paso. Su valor está en la primera fila de cada uno de sus intervalos —la cifra de un día en la fila de su medianoche, la de un mes en la fila de su primer día— y las filas intermedias quedan vacías. El gráfico dibuja esa métrica como puntos. Una nota naranja sobre la vista previa nombra estas métricas con sus pasos y ofrece Exportar por separado: un enlace por paso, cada métrica con su propia resolución.
• Una métrica que solo ofrece pasos más finos se lee con el más grueso de ellos y se combina en el paso del archivo según la regla de su magnitud: una energía se suma, una lectura se promedia, un ratio se recalcula a partir de sus dos mitades, un estado conserva su último código. Una nota bajo la vista previa lo indica.
• Dos casos siguen rechazándose: una cifra por mes, trimestre o año no tiene fila en un archivo por semana, y una cifra mensual como el Marktwert nunca se suma ni se promedia en un trimestre o un año, porque no sería esa cifra. Ese paso permanece atenuado y nombra la métrica.

Una plantilla lo decide por sí misma con Métricas de otro paso: Flexible se comporta como la pestaña Métricas, Estricto rechaza un enlace que nombra un paso que una de sus columnas no ofrece. Una plantilla guardada desde la pestaña Métricas o creada de nuevo es flexible; las plantillas anteriores a este ajuste son estrictas. Un enlace de exportación escrito a mano es estricto salvo que indique lo contrario: consulta el parámetro mismatch.

Valores: por intervalo, total acumulado, tal como se mide

Por intervalo se ofrece solo para energía. Una potencia, una temperatura o un ratio no tienen una «cantidad por intervalo», así que siempre se exportan tal como se miden.

El aviso por debajo de 15 minutos

Un contador cuenta la energía en escalones enteros, a menudo de 1 kWh. En un minuto una planta rara vez produce un escalón entero, así que una energía por intervalo a 1 o 5 minutos salta entre cero y un escalón en lugar de dibujar una curva. Mirox avisa cuando combinas ambas cosas y ofrece tres salidas:

• Cambiar a la métrica de potencia correspondiente, cuando la colección tiene una. La potencia es la magnitud adecuada para una curva fina.
• Usar 15 min, el paso más fino con el que una energía por intervalo se lee bien.
• Mantener, si lo que quieres ver son los escalones del contador.

Hora local de la planta y UTC

Las filas siguen la hora local de la planta, incluido el horario de verano. Un día es un día local, así que tiene 23 o 25 horas cuando cambia la hora, y un mes es un mes local.

• Con pasos más cortos que un día, una columna Desfase UTC acompaña a la hora. El día en que los relojes se atrasan, la hora entre las 02:00 y las 03:00 aparece dos veces; el desfase distingue una de otra.
• UTC como zona horaria pone todas las filas en el calendario UTC. Úsalo cuando el archivo va a un sistema que espera UTC.
• Las plantas en zonas horarias distintas comparten una sola columna de tiempo, así que una exportación de este tipo está siempre en UTC. La selección de zona horaria queda entonces bloqueada e indica el motivo.

Varias plantas: combinadas o por planta

Con más de una planta eliges entre una columna por métrica para todas las plantas juntas y una columna por planta.

Combinadas, cada métrica sigue su propia regla:

Las métricas de componentes se muestran siempre por planta. Una nota bajo la vista previa nombra cada métrica que se mostró por planta en lugar de combinada.

Plantillas

Una plantilla es una lista guardada de métricas con sus propios valores predeterminados: paso, periodo, valores, zona horaria, combinadas o por planta, y encabezados de columna. Cada columna puede llevar su propio texto de encabezado, de modo que el archivo conserva sus encabezados aunque una métrica cambie de nombre más adelante.

Plantillas del sistema

Mirox entrega ocho plantillas, marcadas como Sistema. No se pueden modificar ni eliminar.

Las cinco primeras suceden a las plantillas de la exportación anterior. Sus ids y columnas se enumeran en la guía de migración.

Tus propias plantillas

Guardar como plantilla en la pestaña Métricas, o Crear plantilla en la pestaña Plantillas, guarda tu selección para toda la organización. Una plantilla contiene hasta 40 métricas y ninguna consulta MetricsQL. Abrir en Métricas carga una plantilla en la pestaña Métricas. Métricas de otro paso decide qué hace un enlace de la plantilla con una columna que no ofrece el paso solicitado: consulta Métricas con distintos pasos.

Las plantillas las crea, modifica, convierte y elimina el rol de organización Administrador. Todos los miembros de la organización pueden usarlas.

Una métrica de tu organización que usa una plantilla no se puede eliminar ni recibir un id nuevo. Si una métrica de una plantilla deja de estar disponible —porque ha vuelto a No validada, por ejemplo—, su columna permanece en el archivo, vacía, para que las posiciones de las demás columnas no se muevan.

Plantillas heredadas y conversión

Una plantilla creada antes de Metric Export está marcada como Legado. Se basa en el conjunto de métricas anterior, y su enlace sigue funcionando sin cambios. Las plantillas nuevas se basan siempre en la colección de métricas.

Convertir en plantilla nueva crea una plantilla nueva a partir de una heredada. La plantilla heredada nunca se modifica, así que los archivos y enlaces que la usan quedan como están.

1. Mirox muestra qué columnas tienen equivalente, si las cifras son las mismas (exacta) o la misma magnitud leída de una forma mejor (aproximada), y qué columnas no tienen equivalente.
2. Das un nombre a la plantilla nueva y confirmas.
3. Se muestran los dos enlaces. Excel sigue usando el enlace antiguo hasta que lo sustituyas.

Una plantilla convertida exporta días, igual que su origen. Una columna cuya métrica no tiene valor diario —frecuencia o factor de potencia, por ejemplo— no se traslada; el diálogo nombra la métrica para que puedas exportarla en la pestaña Métricas.

Constructor de API

Elige una plantilla y las plantas, y ajusta el periodo, el paso y el formato de archivo si los valores predeterminados de la plantilla no encajan. La página muestra el enlace y una vista previa de los datos. Probar prepara un token de API y comandos listos para ese enlace. Para una plantilla heredada, el constructor muestra el enlace anterior y ofrece la conversión.

Un enlace con un periodo predefinido como Mes anterior entrega siempre el periodo completo más reciente, que es lo que necesita un libro de Excel que se actualiza solo. Consulta Excel con Power Query.

Cuando una exportación es demasiado grande

Mirox comprueba el tamaño de una exportación antes de leer ningún dato. Si la exportación es demasiado grande, no se exporta nada, y el mensaje ofrece lo que sí cabría: un paso más grueso o un periodo más corto, con el número de días indicado.

Para exportar más, divide la exportación:

• por tiempo: un archivo por mes o por trimestre en lugar de uno por año;
• por planta: un archivo por planta o por portfolio;
• por métrica: las métricas de componentes en un archivo propio, separadas de las métricas de planta;
• por página: en una planta con muchos componentes, exporta los componentes página a página.

Las métricas que Mirox tiene que calcular a partir de varias fuentes, como Producción (resuelta), cuestan más que una simple lectura de contador. Una plantilla que lleva una métrica así alcanza menos plantas y meses por archivo. La línea de tamaño bajo el periodo te lo indica antes de descargar.

Quién puede exportar qué

• Exportas las plantas cuyas mediciones puedes leer: los roles de trabajo Operador, Technical Manager, Asset Manager y Visualizador. Una planta que no puedes leer se omite, y una nota la nombra.
• Las métricas monetarias necesitan además el permiso de contabilidad, que tienen los roles de trabajo Operador y Asset Manager. Sin él, la columna queda vacía para esa planta.
• Las métricas de tu organización se exportan en todas las plantas que puedes leer, incluidas las plantas compartidas contigo mediante una cooperación. Se ofrecen a todos los roles de organización excepto Externo.
• Fuera del navegador, un token de API del grupo Metric Export lee todas las exportaciones. No puede cambiar nada.

Enlaces y marcadores antiguos

Los enlaces a la anterior pestaña Datos brutos y a la anterior pestaña Métricas siguen funcionando: abren la pestaña Métricas con las mismas plantas, métricas, periodo y paso. Cuando una métrica no tiene equivalente, un aviso lo indica y ofrece Copiar la URL original de la API, que sigue entregándola. Un enlace a una de las cinco plantillas del sistema anteriores abre su sucesora.

Las fórmulas ya no se editan en la aplicación. Consulta Fórmulas MiroxQL.

Funciones relacionadas

• API de Metric Export: todos los parámetros, errores y límites de los enlaces de exportación
• Migrar a Metric Export: los ids antiguos y sus métricas nuevas, y qué cambia
• API de exportación heredada: los enlaces de exportación anteriores, que siguen funcionando
• Metric Export para Excel: recetas y Power Query
• Preguntas frecuentes sobre la exportación de datos: respuestas breves a preguntas habituales
• Métricas: las métricas propias de tu organización
• Tokens de API: el token Metric Export