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.

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

1. Apri in Mirox: Flusso dati (oppure scegli il tuo impianto in I tuoi impianti e apri la scheda Flusso dati).
2. 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.
3. Fai clic sul pulsante + sulla riga. La procedura guidata di onboarding si apre con quel dispositivo e adattatore già associati.
4. Segui i passaggi della procedura guidata (sotto) e Salva il logger.

Aggiunta manuale di un logger

1. Nella pagina Flusso dati, fai clic su Aggiungi logger.
2. Nel passaggio Scegli dispositivo, cerca nell'elenco dei dispositivi di rete per nome, IP, fornitore, tipo, modello o descrizione, e seleziona il dispositivo.
3. Scegli l'adattatore da utilizzare, quindi fai clic su Continua.
4. 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:

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.

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.

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:

1. 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.
2. 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.
3. 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.
4. Il Riepilogo conferma ciò che verrà salvato.

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.

1. Effettua tutte le modifiche ai logger che desideri.
2. 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).
3. L'Agent si ridistribuisce con la nuova configurazione e inizia la raccolta poco dopo.

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

Due 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 queste sono i contatori Janitza (nessuna credenziale necessaria), Huawei SmartLogger e i controller Phoenix Contact.
• 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 è il primo logger generico supportato in questo modo.

Le famiglie di dispositivi al di fuori di entrambi 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.

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.

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