Usare Grafana come piattaforma di lettura esterna
Mirox predispone un Grafana pronto all'uso per i tuoi dati e lo collega per te, così puoi aprire uno spazio di lavoro completo per i grafici di qualsiasi impianto con un solo clic — senza un login Grafana separato, senza installazione e senza configurazione della sorgente dati. Questa guida ti accompagna nel raggiungere Grafana e leggere i tuoi dati; per capire cosa fa l'embedding dietro le quinte, vedi Visualizzazione grafici.
Quando usare Grafana
Usa Grafana quando vuoi esplorare le misurazioni grezze dietro i numeri principali — curve di potenza, contatori di energia, input meteo e segnali a livello di componente — con qualsiasi intervallo temporale e risoluzione tu scelga.
- Per gli aggregati calcolati delle prestazioni (produzione, perdite, disponibilità, resa specifica), usa invece le viste KPI integrate nella piattaforma — Grafana traccia le serie grezze, non i KPI pre-aggregati.
- Per estrarre i dati come CSV o JSON per fogli di calcolo e report, usa il Metric Export.
- Per definire un valore calcolato tuo, crea una metrica della tua organizzazione. È scritta nel linguaggio di query con cui vengono lette le serie grezze in Grafana.
Legge le metriche grezze
Il Grafana predisposto opera sulle stesse metriche grezze raccolte che la piattaforma registra dai tuoi impianti — serie ad alta frequenza e multidimensionali — non sulle metriche della raccolta, che i report e il Metric Export leggono con una lettura definita. È proprio per questo che è lo strumento giusto per ispezionare un segnale in dettaglio.
I nomi non sono label
Le serie portano le identità dei componenti (inverter_id, gak_id, string_number), mai i nomi assegnati in Mirox: rinominare un componente in Mirox non cambia nulla in Grafana, né retroattivamente né per i nuovi dati. I nomi attuali arrivano in una legenda tramite le serie informative (powerplant_inverter_info …); lo schema è descritto in Mostrare i nomi attuali dei componenti.
Dove viene predisposto Grafana
Grafana viene predisposto per portfolio. Quando crei un portfolio, le sue dashboard vengono configurate automaticamente e diventano subito raggiungibili — non devi attendere una sincronizzazione in background e non devi configurare una sorgente dati.
Ogni impianto a cui hai accesso è raggiungibile attraverso la dashboard del suo portfolio, limitata a quell'impianto. Vedi solo i grafici degli impianti che il tuo ruolo ti consente; la visibilità segue le stesse regole di permesso del resto della piattaforma.
Questo include l'obbligo di autenticazione a due fattori di un'organizzazione. Se l'organizzazione proprietaria di un impianto richiede l'autenticazione a due fattori (2FA) e il tuo account non ha un secondo fattore, le sue dashboard non sono disponibili per te. Dopo che hai attivato la 2FA, Grafana si adegua entro circa un'ora. Vedi Criterio di sicurezza dell'organizzazione.
Disponibile in produzione
Il collegamento a Grafana è attivo nell'ambiente di produzione. Se stai lavorando in un ambiente non di produzione, il collegamento viene mostrato ma è disabilitato.
Aprire Grafana per un impianto
Grafana si apre dalla navigazione dell'impianto, limitato all'impianto che hai selezionato.
- Apri l'impianto di cui vuoi creare i grafici.
Apri in Mirox: service.mirox.io/#/monitor/solar/0/production - Nella sezione Site della barra laterale, clicca su Grafana.
- Grafana si apre in una nuova scheda del browser, già autenticato tramite la tua sessione Mirox e già mostrando la dashboard panoramica dell'impianto.
Nessun secondo login
La tua sessione Mirox viene trasferita a Grafana — non c'è alcun nome utente, password, URL del server o token separato da inserire prima di poter creare i grafici di un impianto.
Grafana segue il tuo accesso a Mirox
Grafana non ha un accesso proprio. Resta aperto finché dura il tuo accesso a Mirox, e si chiude con esso:
- Quando ti disconnetti da Mirox, o quando il tuo accesso termina, una dashboard aperta smette di caricare dati. I suoi pannelli mostrano errori finché non accedi di nuovo a Mirox e riapri la dashboard.
- Quanto dura un accesso lo stabilisce la tua organizzazione. Se la tua organizzazione ha impostato un intervallo di riverifica 2FA, a un account con 2FA (app di autenticazione o passkey) viene inoltre chiesto di accedere di nuovo a quell'intervallo. Vedi Criterio di sicurezza dell'organizzazione.
Display a parete
Una dashboard su un display a parete che funziona con un account personale viene disconnessa quando termina l'accesso di quell'account. A quel punto qualcuno deve accedere di nuovo sul display. Il Grafana fornito da Mirox non ha un account o un token separato per i display, quindi tienine conto quando predisponi uno schermo che deve funzionare senza presidio.
Leggere i tuoi dati
La dashboard si apre sulla vista panoramica dell'impianto e ti offre il toolkit standard di Grafana applicato alle metriche del tuo impianto:
- Scegli un intervallo temporale — scegli qualsiasi finestra, poi ingrandisci e scorri fino al momento di interesse.
- Regola la risoluzione — visualizza campioni grezzi a grana fine per una curva di potenza o aggregati più grossolani per le tendenze a lungo termine.
- Leggi i valori esatti — passa il mouse o clicca su una serie per leggere il valore in un determinato momento.
- Confronta i segnali — traccia insieme metriche con unità diverse (ad esempio potenza e irraggiamento).
La dashboard arriva già limitata all'impianto per cui l'hai aperta, quindi la produzione e i segnali chiave di quell'installazione sono già in vista.
Crea i tuoi dashboard — non modificare mai quello fornito
Portfolio Overview - <portafoglio> è gestito da Mirox e viene sostituito a ogni rollout di una nuova versione del template — qualsiasi pannello aggiunto o query modificata su di esso va perso. Per personalizzare, salva una copia (Edit → Save as copy) o crea un nuovo dashboard nell'organizzazione Grafana del portafoglio; le copie e i tuoi dashboard non vengono mai toccati. Come è strutturato Grafana per portafoglio, chi può modificare e come vanno lette le serie della piattaforma per ottenere numeri corretti è spiegato in Creare i propri dashboard Grafana. I dashboard forniti sono descritti in Visualizzazione grafici.
Distinzione dalle superfici correlate
È facile confondere i luoghi in cui i dati metrici compaiono in Mirox. Ognuno risponde a un'esigenza diversa:
| Superficie | Cosa mostra | Quando usarla |
|---|---|---|
| Grafana predisposto | Serie temporali grezze e aggregate in grafici interattivi, pre-collegate ai tuoi impianti | Indagare un segnale in dettaglio dentro Mirox, senza nulla da configurare |
| Metriche | I valori che la tua organizzazione definisce sulle serie a 15 minuti | Indicatori tuoi, nei report e nelle esportazioni |
| Metric Export | Le metriche della raccolta in CSV o JSON, con passi da 1 minuto a un anno | Estrarre i dati per fogli di calcolo, report o strumenti esterni |
Documentazione correlata
- Creare i propri dashboard Grafana — struttura per portafoglio, diritti di modifica, la regola "copiare, non modificare" e come leggere correttamente le serie
- Visualizzazione grafici — come funziona la superficie Grafana embedded e quali dashboard sono fornite
- Metric Export — esporta qualsiasi metrica come serie temporale
- Metriche — definisci valori calcolati tuoi
- Criterio di sicurezza dell'organizzazione — quanto dura un accesso e quando è richiesta la 2FA
- FAQ Sicurezza dell'account — perché sei stato disconnesso e perché possono mancare degli impianti