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 l'API di esportazione metriche.
- Per interrogare o costruire le tue serie calcolate in modo programmatico, usa MiroxQL o l'API di esportazione.
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 le metriche di esportazione ripulite e aggregate su base giornaliera. È 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 Creare le proprie dashboard Grafana.
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.
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.
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 |
| MiroxQL | Le stesse metriche grezze, interrogate e combinate nelle tue serie calcolate | Query programmatiche o personalizzate sui tuoi dati |
| API di esportazione metriche | Metriche ripulite e aggregate su base giornaliera come CSV o JSON | 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
- API di esportazione metriche — metriche aggregate e pronte per l'esportazione per la reportistica
- Linguaggio di query MiroxQL — interroga i tuoi dati grezzi e definisci metriche calcolate personalizzate