Creare i propri dashboard Grafana

Il Grafana fornito non è di sola lettura. Ogni portafoglio ha il proprio spazio di lavoro Grafana in cui puoi costruire dashboard sulle stesse serie temporali grezze che la piattaforma registra — a patto di rispettare una regola: il dashboard di panoramica fornito da Mirox è gestito e viene sostituito a ogni rollout di versione, quindi costruisci i tuoi dashboard come copie, mai modificandolo. Questa guida spiega come è strutturato Grafana, cosa puoi cambiare e come vanno lette le serie temporali della piattaforma per ottenere numeri corretti.

Se vuoi solo aprire il dashboard fornito, vedi Usare Grafana come piattaforma di lettura esterna. Per il catalogo delle metriche, vedi Raccolta di metriche.

Come è strutturato Grafana

Un'organizzazione Grafana per portafoglio

Mirox fornisce un'organizzazione Grafana per portafoglio, chiamata <organizzazione> - <portafoglio>. Tutto ciò che contiene è condiviso dai membri del portafoglio:

• Una sorgente dati (<organizzazione> - <portafoglio>), limitata agli impianti di quel portafoglio. Ogni query che scrivi viene eseguita su questa sorgente dati e può vedere solo gli impianti del portafoglio — niente da configurare, niente che possa trapelare.
• Un dashboard gestito, Portfolio Overview - <portafoglio>, fornito da Mirox (vedi sotto).
• I tuoi dashboard e le tue cartelle, visibili a chiunque possa vedere il portafoglio.

Poiché il portafoglio è l'unità di condivisione delle risorse, un impianto che appartiene a più portafogli è raggiungibile da ciascuna delle loro organizzazioni Grafana, e un dashboard costruito in un portafoglio non compare in un altro. Colloca un dashboard dove sono membri le persone che ne hanno bisogno.

Chi può vedere e chi può modificare

L'appartenenza a Grafana segue i permessi della piattaforma e viene aggiornata automaticamente ogni volta che cambiano — non esiste una gestione utenti Grafana separata:

Appartenenze e ruoli vengono sincronizzati quando un permesso viene concesso o revocato; una sessione Grafana aperta viene aggiornata, così un editor appena promosso non deve disconnettersi e riconnettersi.

Il dashboard di panoramica gestito

Portfolio Overview - <portafoglio> è generato da Mirox a partire da una versione di template pubblicata. I tag del dashboard portano la versione (mirox-template-v<N>) e la descrizione indica l'esatto contenuto pubblicato. Gli amministratori Mirox distribuiscono le nuove versioni dall'area di amministrazione della piattaforma, e un rollout elimina e ricrea il dashboard — è ciò che mantiene ogni portafoglio su un template noto e testato.

Cosa fare invece:

1. Apri il dashboard gestito, poi usa Edit → Save as copy (oppure Export → Export as JSON e Import) per creare una tua copia con un nuovo nome. Mettila in una cartella tua.
2. Costruisci sulla copia: aggiungi pannelli, cambia query, aggiungi variabili. La copia è tua — nessun rollout la tocca.
3. Dopo il rollout di una nuova versione del template, apri una volta il dashboard gestito per vedere se ha acquisito pannelli che vuoi riportare nella tua copia.

Lo stesso vale per ogni dashboard che crei da zero: tutto ciò che non è la panoramica gestita viene lasciato intatto dalla piattaforma.

Leggere correttamente le serie temporali

Grafana mostra ciò che una query restituisce, quindi una lettura sbagliata appare esattamente come una giusta. Le regole qui sotto sono quelle che la piattaforma stessa segue nei suoi report; un dashboard personalizzato che le rispetta mostra gli stessi numeri delle pagine dei report.

Etichette: cos'è una serie

Ogni serie è identificata dal suo nome di metrica più le sue etichette. Le etichette su cui filtrerai e raggrupperai:

Due cose deliberatamente non sono etichette: i nomi dei componenti (vedi la sezione successiva) e le unità — ogni valore è memorizzato in unità SI base: W, Wh, V, A, Hz, °C, W/m², Wh/m². Imposta l'unità Grafana su watt / watt-hour e lascia che Grafana scali a kW / MWh; non dividere mai nella query.

Mostrare i nomi attuali dei componenti

La telemetria porta identificativi di componenti, non nomi: una rinomina in Mirox non deve spezzare una serie in "prima" e "dopo". I nomi attuali sono pubblicati come serie informative a sé stanti — powerplant_inverter_info, powerplant_gak_info, powerplant_string_info, powerplant_feedin_info, powerplant_turbine_info — indicizzate esattamente come la telemetria e con il nome come etichetta (inverter_name, gak_name, string_name, meter_name, turbine_name). Uniscile alla telemetria con il seguente schema (è ciò che fa il dashboard gestito):

sum by (inverter_id, inverter_name) (
  (
    powerplant_inverter_power_ac{park="${park}"}
    * on (park, inverter_id) group_left(inverter_name)
    sgn(topk_last(1, last_over_time(powerplant_inverter_info{park="${park}"}[7d] @ (now()))) by (park, inverter_id))
  )
  or on (park, inverter_id) powerplant_inverter_power_ac{park="${park}"}
)

Come funziona: last_over_time(...[7d] @ (now())) prende per ogni componente il punto informativo più recente all'istante attuale, così una rinomina si riflette su qualsiasi intervallo temporale; sgn() lo trasforma in un 1 che la moltiplicazione conserva; group_left(inverter_name) copia il nome sulla telemetria; e il ramo or on (...) mantiene visibile un componente (tramite il suo identificativo) se non ha ancora una serie informativa. Per una cassetta di parallelo unisci su (park, inverter_id, gak_id) con gak_name; per una stringa su (park, inverter_id, gak_id, string_number) — la serie informativa porta gak_id solo quando la stringa si trova dietro una cassetta di parallelo, come la telemetria. Mai tracciare, sommare o creare allarmi su una serie informativa in sé.

Le quattro forme di una serie

Il motore dei report legge ogni serie in uno di quattro modi. Usa la stessa lettura e il tuo dashboard concorderà con le pagine dei report.

Totali di impianto e componenti

Le serie analitiche derivate da una sorgente (modelli, potenza attesa, performance ratio, limitazione) esistono a livello di impianto e una volta per segmento. Seleziona la serie a livello di impianto con segment_id!~".+", altrimenti un impianto segmentato viene letto N + 1 volte. Lo stesso vale per il conguaglio eolico onshore: i punti per turbina portano turbine_id, la somma di parco no — usa turbine_id!~".+" per la corsia di parco.

Per i pannelli per componente raggruppa per le etichette di identità e, dove vuoi i nomi, unisci le serie informative come mostrato sopra. Potenza modellata e PR per componente (powerplant_<source>_inverter_power, powerplant_<source>_inverter_pr e i gemelli gak / string) esistono per le sorgenti pyranometer e weather.

Codici di stato e stati

powerplant_inverter_vendor_status, powerplant_turbine_vendor_status, battery_*_vendor_status sono i codici propri del produttore: un buco significa "non letto", e il valore è un codice, mai una grandezza — non sommarli né mediarli. powerplant_inverter_operating_state e powerplant_turbine_operating_state sono gli stati standard della piattaforma (0 sconosciuto … 8 guasto), numerati in modo che max by (inverter_id) si legga come "lo stato peggiore nell'intervallo". Mostrali con un value mapping di Grafana anziché come linea.

Errori comuni

• last_over_time(...[30y]) per ottenere "l'ultimo valore" scansiona l'intera retention a ogni aggiornamento. Usa una finestra adeguata alla cadenza della serie — [1h] per una misura al minuto, [1d] per un valore giornaliero, [7d] per le serie informative.
• Filtrare sui nomi (inverter_name="WR 01") smette di funzionare dopo una rinomina. Filtra su inverter_id e mostra il nome tramite l'unione con le serie informative.
• Mescolare le corsie: powerplant_pyranometer_power senza fissare clipping / pr restituisce più corsie della stessa grandezza. Fissa la corsia che intendi — la tabella sotto indica le etichette fissate usate dai report.
• Impianti con più contatori: powerplant_power_grid è una serie per contatore. Fai la sum(...), oppure leggi powerplant_grid_power, che è già la serie di impianto sommata e allineata al minuto.
• Fuso orario: le serie sono memorizzate in UTC e Grafana le mostra nel fuso orario del browser. I valori giornalieri (dati configurati, verdetti giornalieri) sono marcati alla mezzanotte locale dell'impianto; imposta il fuso orario del dashboard su quello dell'impianto quando confronti i giorni.

Il catalogo delle serie dei report

Le pagine di report ed esportazione della piattaforma sono costruite a partire da un catalogo fisso di serie, ciascuna con una lettura definita. La tabella elenca ogni elemento con la metrica letta, la forma in cui viene letta (vedi sopra), le etichette fissate applicate dai report e il livello (impianto, per inverter, per cassetta di parallelo, per stringa, per segmento). Gli elementi contrassegnati solare vengono emessi solo per gli impianti solari; l'unità del report è quella mostrata dalle pagine dei report — la serie memorizzata è sempre in unità base (Wh, W, Wh/m²). Un'etichetta fissata period="<YYYY-MM>" seleziona il mese di consegna di una corsia conguagliata.

Contatori e registri di produzione

Potenza dell'impianto

Irraggiamento nel piano dei moduli

Produzione modellata, attesa e a cielo sereno

Performance ratio

Sensori in sito

Limiti di potenza

Limitazione conguagliata

Inverter

Cassette di parallelo

Stringhe

Batteria

Meteo

Prezzi di mercato

Infrastruttura

Documentazione correlata

• Usare Grafana come piattaforma di lettura esterna — raggiungere il Grafana fornito e il dashboard gestito
• Raccolta di metriche — il catalogo completo delle metriche con unità ed etichette
• Linguaggio di query MiroxQL — le stesse serie, interrogate dalla piattaforma e trasformate in metriche personalizzate per i report
• API di esportazione metriche — metriche pulite e aggregate in CSV o JSON