Configurazione dei data logger

I data logger sono il ponte tra le apparecchiature del tuo impianto e la piattaforma Mirox: una volta configurato un logger, il Mirox-Agent inizia a interrogare quel dispositivo secondo una pianificazione, normalizzando ogni lettura in un unico vocabolario di metriche e trasmettendola alla piattaforma. Questa guida ti accompagna nell'aggiunta di un logger, nell'associazione di un dispositivo rilevato a un adattatore, nella conferma che risponda tramite una sonda live, e nell'applicazione delle modifiche — oltre ai limiti di ciò che viene onboardato automaticamente.

Prima di iniziare

Un logger viene configurato su un dispositivo di rete che è già stato rilevato sulla rete dell'impianto. Se il dispositivo che desideri non è ancora presente, esegui prima una scansione di scoperta — vedi Gestione dei dispositivi di rete. È inoltre necessario che la connessione sicura all'impianto sia attiva; l'Agent raggiunge i dispositivi tramite il tunnel VPN.

Dove si trovano i data logger

Ogni impianto dispone di una pagina Flusso dati dove gestisci i suoi logger e osservi l'arrivo dei dati.

Apri in Mirox: Flusso dati — oppure apri I tuoi impianti, scegli un impianto e passa alla scheda Flusso dati.

L'intestazione della pagina mostra riquadri live per lo stato di salute dei logger (sani vs. totali), la disponibilità dell'Agent e il traffico di rete, così puoi vedere a colpo d'occhio se la raccolta funziona. La scheda Data Logger è il punto in cui aggiungi e gestisci i logger; il pulsante Applica modifiche in alto a destra invia la tua configurazione all'Agent.

Come vengono onboardati i data logger

L'aggiunta di un logger è un flusso guidato costruito attorno a una vera conversazione con il dispositivo. La piattaforma apre una connessione temporanea in sola lettura — una sonda — così puoi confermare che il dispositivo risponda e vedere le sue letture live prima di confermare qualsiasi cosa. Ci sono due modi per accedere al flusso:

Logger possibili (rilevati automaticamente) — quando il fornitore e il tipo di un dispositivo rilevato corrispondono a un adattatore noto, esso appare nella tabella Logger possibili con l'adattatore corrispondente già precompilato. Questo è il percorso rapido.
Aggiungi logger (manuale) — quando il rilevamento non riconosce o classifica erroneamente un dispositivo, il pulsante Aggiungi logger ti permette di scegliere autonomamente qualsiasi dispositivo di rete e un adattatore.

In entrambi i casi viene eseguita la stessa procedura guidata e la stessa sonda live conferma il dispositivo prima del salvataggio.

Aggiunta di un logger rilevato automaticamente

Apri in Mirox: Flusso dati (oppure scegli il tuo impianto in I tuoi impianti e apri la scheda Flusso dati).
Nella tabella Logger possibili, individua il dispositivo che desideri. Ogni riga mostra il nome del dispositivo, l'IP, il fornitore/tipo e l'adattatore a cui la piattaforma lo ha associato.
Fai clic sul pulsante + sulla riga. La procedura guidata di onboarding si apre con quel dispositivo e adattatore già associati.
Segui i passaggi della procedura guidata (sotto) e Salva il logger.

Aggiunta manuale di un logger

Nella pagina Flusso dati, fai clic su Aggiungi logger.
Nel passaggio Scegli dispositivo, cerca nell'elenco dei dispositivi di rete per nome, IP, fornitore, tipo, modello o descrizione, e seleziona il dispositivo.
Scegli l'adattatore da utilizzare, quindi fai clic su Continua.
Segui i passaggi rimanenti della procedura guidata e Salva il logger.

La procedura guidata di onboarding, passo dopo passo

La procedura guidata è un'unica finestra di dialogo con una barra laterale di passaggi e una striscia di log dell'agente live lungo il fondo, così puoi osservare l'Agent dialogare con il dispositivo per tutto il tempo. Un badge di connessione accanto al nome del dispositivo segnala lo stato della sonda (In connessione, Sondaggio, Inattivo, Errore, Completato). I passaggi visualizzati dipendono dall'adattatore:

Passaggio	Quando appare	Cosa fai
Scegli dispositivo	Solo aggiunta manuale	Scegli il dispositivo di rete e l'adattatore
Identità	Dispositivi che richiedono configurazione	Conferma che il dispositivo e l'adattatore siano corretti
Credenziali	Adattatori che richiedono l'accesso	Inserisci nome utente e password del dispositivo
Sonda	Dispositivi zero-config	Osserva le letture live esposte dal dispositivo
Mappa valori	Logger generici	Esplora ogni valore grezzo esposto dal dispositivo e associa ciascuno a una metrica nota
Test a vuoto	Logger generici	Rivedi le metriche esatte che la tua mappatura produrrebbe
Riepilogo	Dispositivi che richiedono configurazione	Rivedi e salva

Credenziali e il vault

Se l'adattatore deve accedere al dispositivo, il passaggio Credenziali richiede nome utente e password. Le credenziali che hai già memorizzato per quel dispositivo nel vault delle credenziali vengono proposte qui così non devi reinserirle, e ciò che inserisci può essere riutilizzato in seguito per l'accesso proxy.

Janitza non richiede credenziali

I contatori Janitza si onboardano senza alcuna credenziale. I controller Huawei SmartLogger e Phoenix Contact richiedono invece l'accesso al dispositivo, quindi il passaggio Credenziali appare per essi anche se per il resto sono zero-config.

Fronius può sostituire un contatore di immissione

I piccoli parchi Fronius spesso non dispongono di un contatore di immissione in rete dedicato. Durante l'onboarding di un logger Fronius, abilita l'opzione "Usa come contatore di immissione" per pubblicare la potenza combinata dell'intero dispositivo e l'energia totale come serie principale di immissione in rete del parco — senza bisogno di un contatore separato.

SMA Power Manager elenca da solo i propri dispositivi

SMA Power Manager (il controller di impianto SMA Data Manager / ennexOS) si onboarda zero-config: accedi con un account utente ennexOS e il manager segnala automaticamente ogni dispositivo che conosce — ID componente, nome, prodotto, numero di serie, indirizzo IP e firmware — così non c'è nessun elenco componenti da digitare. Tre interruttori controllano cosa viene raccolto: raccogli i totali di impianto (disattivalo dove un contatore di rete dedicato li misura già), raccogli le serie degli inverter e escludi i canali di limite. Un inverter già letto direttamente da un altro logger viene escluso automaticamente — il Power Manager continua a segnalarne il motivo di derating, ma non la telemetria, così nulla viene pubblicato due volte.

SMA Sunny Central mantiene la propria identità

Anche SMA Sunny Central (la classica interfaccia web per singolo inverter) si onboarda zero-config. Quando lo stesso impianto ha anche un SMA Power Manager configurato, la procedura guidata risolve automaticamente l'identità del Sunny Central dall'elenco dispositivi del Power Manager, così l'unità mantiene lo stesso componente e la stessa cronologia che già aveva.

Il monitoraggio delle stringhe di blue'Log è un campo della procedura guidata

Un blue'Log che gestisce hardware di monitoraggio delle stringhe riceve un passaggio monitoraggio stringhe: attiva o disattiva il tracciamento, scegli a quale inverter appartengono le stringhe e imposta ogni quanti cicli viene letto lo strato delle stringhe. Se il logger conosce già il proprio inverter, questo viene precompilato automaticamente; altrimenti lo scegli tra gli inverter dell'impianto.

Sungrow Logger si onboarda zero-config

Sungrow Logger accede con lo stesso nome utente e la stessa password dell'interfaccia web del logger stesso (il comportamento SSL e ping sono impostazioni avanzate opzionali). Oltre alle letture dei suoi inverter, raccoglie anche l'elenco dei guasti attivi del logger come allarmi e segnala automaticamente numero di serie, modello, firmware e potenza nominale di ciascun inverter.

Batterie INTILION: scegliere il tipo di apparecchio e abbinare l'identificativo

Un impianto INTILION mette due controllori diversi sullo stesso protocollo: un controllore d'impianto per l'intero sito e un controllore dell'unità di batteria per ogni unità di accumulo. Scegli quale stai integrando in Tipo di apparecchio: nessuno dei due riporta un numero di serie, quindi è l'unica indicazione che dice alla piattaforma che cosa sta leggendo, e una scelta errata viene rifiutata anziché pubblicata.

Per un controllore dell'unità di batteria, assegna all'unità un identificativo dell'unità di batteria e utilizza esattamente lo stesso identificativo sul relè di protezione della partenza di media tensione di quell'unità. Il relè misura il lato rete e il controllore il lato batteria; identificativi coincidenti ne fanno un'unica unità di accumulo invece di due misurate a metà.

Esecuzione della sonda live

Il passaggio Sonda apre un breve test a vuoto sul dispositivo. L'Agent legge ciò che il dispositivo espone e trasmette campioni live — si aggiornano ogni secondo, e la striscia di log in basso mostra lo scambio sottostante.

Attendi che appaiano i campioni. Il badge di connessione passa a Sondaggio e poi si stabilizza una volta che le letture fluiscono.
Se non arriva nulla, la procedura guidata riprova automaticamente alcune volte. Se ancora non riesce a raggiungere il dispositivo, riceverai un messaggio chiaro e un pulsante Riconnetti per riprovare.
Una sonda bloccata significa quasi sempre che il dispositivo non è raggiungibile dall'Agent — verifica che la scoperta lo veda ancora e che il tunnel VPN sia attivo.

La sonda è in sola lettura

La sonda non modifica mai il dispositivo né salva nulla da sé. Esiste affinché tu possa confermare che il dispositivo risponda e vedere i suoi valori reali prima di confermare il logger.

Associazione dei valori di un logger generico

Alcuni logger sono generici — espongono un lungo elenco di valori grezzi che la piattaforma non è in grado di interpretare da sola (un contatore di potenza, un piranometro e una dozzina di altri canali dietro un unico dispositivo, ciascuno denominato nel vocabolario proprio del dispositivo). Per questi, la procedura guidata esegue un flusso di mappatura interattivo invece di un'anteprima in sola lettura:

Nel passaggio Mappa valori l'Agent enumera ogni valore grezzo esposto dal dispositivo e li trasmette con il loro gruppo, nome, unità e un campione live. Ottieni una tabella ricercabile.
Per ciascun valore grezzo che ti interessa, scegli dal menu a discesa la metrica nota che rappresenta. Lascia gli altri non mappati. Dove necessario puoi invertire il segno per singolo valore; i prefissi di unità (kW, kWh, …) vengono riscalati automaticamente in unità SI di base.
Il passaggio Test a vuoto riesegue il dispositivo attraverso la tua mappatura e mostra le metriche esatte che verrebbero prodotte — il tuo punto di controllo per accettare o rifiutare.
Il Riepilogo conferma ciò che verrà salvato.

Impostazioni avanzate per valore

Ogni valore mappato dispone di un pannello Impostazioni avanzate, chiuso per impostazione predefinita: la maggior parte dei valori non ne ha bisogno. Aprilo quando il dispositivo riporta un valore che deve essere trasformato prima della pubblicazione:

Fattore — moltiplica la lettura (ad es. un contatore a impulsi in cui ogni impulso vale 200 Wh). Applicato sopra al riscalamento automatico delle unità.
Limite superiore / Limite inferiore — scarta le letture fuori da questo intervallo invece di pubblicarle. Utile per un dispositivo che emette un picco fuori scala quando il suo ingresso non viene letto.
Valori da ignorare — scarta del tutto letture grezze specifiche, separate da virgola (ad es. 0 per un contatore che riporta zero mentre il suo ingresso è scollegato).
Inverti segno — inverte la direzione prelievo/immissione.

Un campo lasciato vuoto non viene applicato affatto. Tutto ciò che imposti è mostrato come una breve etichetta (×200 · ≥-10000) sulla riga del valore e di nuovo nel passaggio Riepilogo, così puoi verificare l'intera mappatura prima di salvare.

Vengono raccolti solo i valori che mappi, e ogni valore grezzo viene associato a esattamente una metrica.

Associazione delle letture (adattatori con override manuale)

Per gli adattatori non generici che espongono comunque un passaggio di configurazione, il passaggio Configurazione mostra ogni lettura trovata dalla sonda e ti permette di scegliere quali raccogliere, impostare l'intervallo di polling e applicare correzioni per singola lettura (ad esempio, invertire un segno). Quando continui, la piattaforma riesegue la sonda con la tua configurazione così il passaggio Riepilogo mostra i valori esattamente come verranno memorizzati.

Salvataggio

Nel passaggio finale — Riepilogo per gli adattatori manuali, o il passaggio Sonda stesso per i dispositivi zero-config — fai clic su Salva logger (o Aggiungi per i dispositivi zero-config). Il logger viene salvato come modifica in sospeso. Nulla raggiunge ancora l'Agent.

Applicazione delle modifiche

I nuovi logger, le modifiche e le rimozioni rimangono in attesa finché non li pubblichi sull'Agent in un unico batch.

Effettua tutte le modifiche ai logger che desideri.
Fai clic su Applica modifiche in cima alla pagina Flusso dati (riporta Applica N modifica/e in sospeso quando ne hai accodate alcune in questa sessione).
L'Agent si ridistribuisce con la nuova configurazione e inizia la raccolta poco dopo.

Applicare è sempre sicuro

Puoi premere Applica modifiche in qualsiasi momento — se non c'è nulla di nuovo da pubblicare, non fa nulla. Dopo l'aggiornamento della pagina il contatore delle modifiche in sospeso si azzera, quindi usa Applica modifiche per assicurarti che la configurazione più recente sia attiva.

Gestione dei logger esistenti

La tabella Data Logger elenca tutto ciò che è configurato per l'impianto, con ricerca, ordinamento e stato di salute per ogni logger. Il menu azioni ⋮ su ogni riga ti permette di:

Modifica logger — regola la configurazione del logger.
Modifica dispositivo di rete — passa al dispositivo nella pagina Rete per cambiare il suo IP, le credenziali, le impostazioni SNMP o proxy (queste risiedono in un unico posto, non duplicate qui).
Pausa / Riprendi — interrompe temporaneamente la raccolta per una finestra scelta (da 15 minuti fino a 24 ore) e la riprende. Utile durante la manutenzione affinché un'interruzione nota non generi eventi.
Rimuovi logger — elimina un logger che hai aggiunto tramite la procedura guidata.

Anche la rimozione o la messa in pausa di un logger è una modifica in sospeso — ricorda di Applicare le modifiche dopo.

Cosa può essere onboardato tramite la procedura guidata

Tre tipi di dispositivi si onboardano tramite la procedura guidata:

Famiglie zero-config — l'adattatore conosce già l'intero set di letture del dispositivo, quindi devi solo confermare la sonda live e salvare. Oggi rientrano qui i contatori Janitza (nessuna credenziale necessaria), Huawei SmartLogger, i controller Phoenix Contact, SMA Sunny Central, SMA Power Manager e Sungrow Logger.
Logger generici — dispositivi che espongono valori grezzi arbitrari che la piattaforma non è in grado di interpretare da sola. Questi si onboardano tramite il flusso interattivo Mappa valori → Test a vuoto descritto sopra, in cui associ ciascun valore grezzo a una metrica nota. QReader e blue'Log si onboardano in questo modo.
Adattatori ad aggiunta manuale — una famiglia che la piattaforma legge per intero ma su cui non deve mai tirare a indovinare. Oggi è il PLC di allarme WAGO PFC200: legge i contatti del sistema di allarme di un sito in Modbus TCP in sola lettura e senza credenziali, ma una WAGO è un controllore vuoto che ogni integratore programma in modo diverso e nulla sul filo dice quale programma sia in esecuzione. Per questo non viene mai proposto in Logger possibili: usa Aggiungi logger, scegli l'adattatore e imposta il profilo dell'integratore (oggi abo_uegs), facoltativamente un identificativo del sistema di allarme e i contatti non cablati. La sonda live mostra poi lo stato di ciascun contatto prima del salvataggio.

Le famiglie di dispositivi al di fuori di tutti e tre i gruppi funzionano comunque, ma oggi non sono onboardabili tramite procedura guidata: richiedono una configurazione per singolo dispositivo che Mirox prepara e distribuisce con l'Agent. Considera l'automazione dell'onboarding come specifica per dispositivo, non universale.

Il tuo dispositivo non è elencato?

Se la tua apparecchiatura non è coperta da un adattatore esistente, Mirox ne crea uno — spesso anche per apparecchiature legacy o interfacce non documentate, purché il dispositivo esponga in qualche modo i suoi dati. Fai clic su Richiedi supporto per i logger sotto la tabella Logger possibili (il selettore di adattatori nella procedura guidata rimanda alla stessa richiesta); i dettagli dell'impianto e del dispositivo vengono allegati automaticamente, e il supporto per un nuovo dispositivo è di norma pronto entro un giorno.

Passo per passo: Richiedi un'integrazione.

Per capire come gli adattatori parlano il protocollo di ciascun dispositivo, normalizzano le unità e scoprono i componenti, vedi la pagina di architettura Data Scraper — questa guida deliberatamente non la ripete.

Migrazione di una configurazione scritta a mano

Un piccolo numero di impianti onboardati prima dell'esistenza della procedura guidata funziona ancora con una configurazione scritta a mano (un overlay legacy) invece della configurazione che la piattaforma genererebbe oggi dalle sue righe logger. Per questi, gli amministratori di sistema Mirox dispongono di una vista di migrazione nella scheda Flusso dati → Configurazione agente dell'impianto, che mostra come apparirebbe l'uscita dall'overlay prima che nulla cambi:

la configurazione che la piattaforma genererebbe senza l'overlay legacy,
un confronto (diff) rispetto all'overlay attualmente attivo sull'impianto, e
per ciascun logger, se il generatore è già in grado di produrre una voce per esso e cosa manca ancora (un'identità dell'inverter non risolta, un binding di monitoraggio stringhe mancante, un inventario non ancora acquisito, e così via).

Da qui, un amministratore può ri-sondare un singolo logger per completare ciò che manca, cancellare l'overlay e distribuire la configurazione generata — senza rinominare alcun componente né perderne la cronologia. Si tratta di uno strumento di migrazione interno, non di un'impostazione rivolta al cliente: esiste affinché gli ultimi impianti scritti a mano possano passare alla stessa configurazione generata già usata da ogni altro impianto.

Guide correlate

Gestione dei dispositivi di rete — scopri e classifica i dispositivi su cui viene configurato un logger
Configurazione dei componenti — associa le metriche raccolte a inverter, stringhe e quadri di campo
Data Scraper — come gli adattatori raccolgono, normalizzano e inoltrano i tuoi dati
Richiedi un'integrazione — chiedi a Mirox di aggiungere un adattatore per un dispositivo non supportato
Usare il proxy — apri l'interfaccia web del dispositivo nel browser utilizzando le credenziali memorizzate