Usar Grafana como plataforma externa de lectura
Mirox aprovisiona un Grafana listo para usar para tus datos y lo conecta por ti, de modo que puedas abrir un espacio de trabajo de gráficos completo para cualquier planta con un solo clic — sin un inicio de sesión, instalación o configuración de fuente de datos de Grafana aparte. Esta guía te muestra cómo acceder a Grafana y leer tus datos; para saber qué hace la integración entre bastidores, consulta Visualización de gráficos.
Cuándo usar Grafana
Usa Grafana cuando quieras explorar las mediciones brutas que hay detrás de las cifras principales — curvas de potencia, contadores de energía, entradas meteorológicas y señales a nivel de componente — en el rango temporal y la resolución que elijas.
- Para los agregados de rendimiento calculados (producción, pérdidas, disponibilidad, rendimiento específico), usa en su lugar las vistas de KPI integradas en la plataforma — Grafana representa las series brutas, no los KPI preagregados.
- Para extraer datos en formato CSV o JSON para hojas de cálculo e informes, usa Metric Export.
- Para definir una cifra calculada propia, crea una métrica de tu organización. Se escribe en el lenguaje de consulta con el que se leen las series brutas en Grafana.
Lee las métricas brutas
El Grafana aprovisionado se ejecuta sobre las mismas métricas brutas recopiladas que la plataforma registra de tus plantas — series de alta frecuencia y multidimensionales — no sobre las métricas de la colección, que los informes y Metric Export leen con una lectura definida. Por eso es precisamente la herramienta adecuada para inspeccionar una señal en detalle.
Los nombres no son etiquetas
Las series llevan las identidades de los componentes (inverter_id, gak_id, string_number), nunca los nombres asignados en Mirox: renombrar un componente en Mirox no cambia nada en Grafana, ni retroactivamente ni para los datos nuevos. Los nombres actuales llegan a una leyenda a través de las series de información (powerplant_inverter_info …); el patrón está en Crear tus propios paneles de Grafana.
Dónde se aprovisiona Grafana
Grafana se aprovisiona por portfolio. Cuando creas un portfolio, sus paneles se configuran automáticamente y quedan accesibles de inmediato — no tienes que esperar a una sincronización en segundo plano ni configurar una fuente de datos.
Cada planta a la que tengas acceso es accesible a través del panel de su portfolio, acotado a esa planta. Solo verás los gráficos de las plantas que tu rol te permita; la visibilidad sigue las mismas reglas de permisos que el resto de la plataforma.
Eso incluye la exigencia de dos factores de una organización. Si la organización propietaria de una planta exige la autenticación de dos factores (2FA) y tu cuenta no tiene segundo factor, sus paneles no están disponibles para ti. Después de activar la 2FA, Grafana se actualiza en aproximadamente una hora. Consulta Política de seguridad de la organización.
Disponible en producción
El enlace a Grafana está activo en el entorno de producción. Si trabajas en un entorno que no sea de producción, el enlace se muestra pero está deshabilitado.
Abrir Grafana para una planta
Grafana se abre desde la navegación de la planta, acotado a la planta que hayas seleccionado.
- Abre la planta que quieras graficar.
Abrir en Mirox: service.mirox.io/#/monitor/solar/0/production - En la sección Site de la barra lateral, haz clic en Grafana.
- Grafana se abre en una nueva pestaña del navegador, ya con la sesión iniciada a través de tu sesión de Mirox y mostrando ya el panel de resumen de la planta.
Sin segundo inicio de sesión
Tu sesión de Mirox se transfiere a Grafana — no hay un nombre de usuario, contraseña, URL de servidor ni token aparte que introducir antes de poder graficar una planta.
Grafana sigue tu inicio de sesión en Mirox
Grafana no tiene un inicio de sesión propio. Está abierto mientras lo esté tu inicio de sesión en Mirox, y se cierra con él:
- Cuando cierras sesión en Mirox, o tu inicio de sesión termina, un panel abierto deja de cargar datos. Sus gráficos muestran errores hasta que vuelves a iniciar sesión en Mirox y abres de nuevo el panel.
- Cuánto dura un inicio de sesión lo fija tu organización. Si tu organización ha fijado un intervalo de reverificación 2FA, a una cuenta con 2FA (aplicación de autenticación o passkey) se le pide además que vuelva a iniciar sesión con ese intervalo. Consulta Política de seguridad de la organización.
Pantallas de pared
Un panel en una pantalla de pared que funciona con una cuenta personal se queda sin sesión cuando termina el inicio de sesión de esa cuenta. Alguien tiene que volver a iniciar sesión en la pantalla. El Grafana que proporciona Mirox no tiene una cuenta ni un token aparte para pantallas, así que tenlo en cuenta cuando prepares una pantalla que deba funcionar sin supervisión.
Leer tus datos
El panel se abre en la vista de resumen de la planta y te ofrece el conjunto de herramientas estándar de Grafana aplicado a las métricas de tu planta:
- Elige un rango temporal — escoge cualquier ventana, y luego acerca y desplázate hasta el momento que te interese.
- Ajusta la resolución — visualiza muestras brutas de grano fino para una curva de potencia o agregados más gruesos para tendencias a largo plazo.
- Lee valores exactos — pasa el cursor o haz clic en una serie para leer el valor en un momento dado.
- Compara señales — representa juntas métricas con distintas unidades (por ejemplo, potencia frente a irradiancia).
El panel llega ya acotado a la planta para la que lo abriste, de modo que la producción y las señales clave de esa instalación ya están a la vista.
Crea tus propios dashboards — nunca edites el proporcionado
Portfolio Overview - <portafolio> está gestionado por Mirox y se reemplaza cada vez que se despliega una nueva versión de la plantilla — cualquier panel que añadas o consulta que cambies en él se pierde. Para personalizar, guarda una copia (Edit → Save as copy) o crea un dashboard nuevo en la organización de Grafana del portafolio; las copias y tus propios dashboards nunca se tocan. Cómo está estructurado Grafana por portafolio, quién puede editar y cómo deben leerse las series de la plataforma para obtener cifras correctas se explica en Crear sus propios dashboards de Grafana. Los dashboards proporcionados en sí se describen en Visualización de gráficos.
Diferencia con superficies relacionadas
Es fácil confundir los lugares donde aparecen los datos de métricas en Mirox. Cada uno responde a una necesidad distinta:
| Superficie | Qué muestra | Cuándo usarla |
|---|---|---|
| Grafana aprovisionado | Series temporales brutas y agregadas en gráficos interactivos, preconectadas a tus plantas | Investigar una señal en detalle dentro de Mirox, sin nada que configurar |
| Métricas | Cifras que tu organización define sobre las series de 15 minutos | Indicadores propios, en informes y exportaciones |
| Metric Export | Las métricas de la colección en CSV o JSON, con pasos de 1 minuto a un año | Extraer datos para hojas de cálculo, informes o herramientas externas |
Documentación relacionada
- Crear sus propios dashboards de Grafana — estructura por portafolio, derechos de edición, la regla «copiar, no editar» y cómo leer correctamente las series
- Visualización de gráficos — cómo funciona la superficie de Grafana integrada y qué paneles se proporcionan
- Metric Export — exporta cualquier métrica como serie temporal
- Métricas — define cifras calculadas propias
- Política de seguridad de la organización — cuánto dura un inicio de sesión y cuándo se exige 2FA
- Preguntas frecuentes sobre la seguridad de la cuenta — por qué se cerró tu sesión y por qué pueden faltar plantas