Vai al contenuto
Elausys

HyperVisu / Servizi & Dati

Storico e registrazione dei dati

Impostazioni di InfluxDB, scelta di cosa registrare ed esportazione dello storico in CSV.

elausys · 08 agosto 2026
In questa pagina

HyperVisu memorizza lo storico delle serie temporali nel database di storico integrato nell'apparecchio (InfluxDB). Questo capitolo spiega come collegarlo, esportare i dati di misura in CSV, creare pannelli Grafana e spostare intere tabelle di configurazione da e verso il server come file CSV.

Connessione a InfluxDB

Lo storico richiede il servizio InfluxDB. Apri Services e verifica che la riga InfluxDB sia attivata. Se lo attivi ora, compare un banner Pending Changes: fai clic su Restart Server e attendi che il server torni disponibile.

La pagina InfluxDB Configuration (Services → InfluxDB → Configure) contiene una connessione a un database di storico a tua scelta. In un'installazione standard i campi possono essere vuoti: il server scrive e legge allora lo storico tramite la propria connessione integrata e non c'è nulla da compilare.

CampoCosa inserire
URLL'indirizzo dell'istanza InfluxDB (ad es. http://localhost:8086).
API TokenUn token con permessi di lettura e scrittura. Usa il pulsante a forma di occhio per mostrarlo o nasconderlo.
OrganizationIl nome dell'organizzazione nella tua istanza InfluxDB.
BucketIl bucket in cui sono archiviati i dati.

Fai clic su Test Connection per verificare la connessione mostrata nel modulo, poi su Save per memorizzarla. La scheda Database Status passa da Not Tested a Connected e mostra l'ora di Last tested. Test Connection richiede i quattro campi: quando la pagina è vuota non c'è nulla da testare qui e il risultato si verifica in una pagina di andamento nell'app. Per sicurezza un token salvato non viene più mostrato; lascia il campo vuoto per conservarlo. Se il servizio InfluxDB stesso è disattivato, un avviso nella pagina indica di attivarlo prima dalla pagina Services.

Una volta salvata una connessione, la pagina mostra anche lo spazio utilizzato e un'impostazione Data retention. Ridurre il periodo di conservazione elimina definitivamente i dati più vecchi.

Browser desktop, pagina InfluxDB Configuration con il modulo di connessione compilato e la scheda Database Status che mostra Connected.

Cosa viene registrato. La registrazione è un interruttore su ogni oggetto di comunicazione. Gli oggetti di un contatore e di un ingresso analogico con andamento vengono registrati automaticamente; per qualsiasi altro oggetto devi attivarla tu:

  1. Apri Devices, espandi il dispositivo e fai clic sul pulsante Edit Object (l'ingranaggio) dell'oggetto.
  2. Attiva Log historical values.
  3. Fai clic su Save object. La riga dell'oggetto mostra ora un'icona di database e un'icona di grafico. Non serve Apply changes.

Ogni valore ricevuto dall'oggetto viene registrato da quel momento in poi, sia variato o meno; nulla di precedente viene ricostruito (vedi «Object Settings, Logging & Notifications»). Gli oggetti registrati alimentano i grafici di andamento e lo storico dei contatori nell'app, le dashboard Grafana, i grafici del monitor del bus KNX e l'esportazione CSV descritta di seguito.

Esportazione dati CSV

La pagina CSV Data Export trasforma lo storico registrato in un file adatto ai fogli di calcolo. Non ha una voce propria nella barra laterale: apri Services e fai clic su Export sulla riga InfluxDB.

  1. In Object Selection, spunta gli oggetti da esportare. Sono raggruppati per stanza; usa la casella di ricerca o Select all. Se l'elenco è vuoto, non ci sono ancora oggetti con la registrazione attivata — attivala prima (vedi «Object Settings, Logging & Notifications»).
  2. In Time Period, imposta Start e End, oppure usa una scorciatoia: Last 24h, Last 7 days, Last 30 days, Last year.
  3. In Format, scegli il Separator: Comma, Semicolon o Tab.
  4. Scegli la Timezone in cui vengono scritti i timestamp. Il campo si apre su Europe/Paris qualunque sia il fuso orario del server, quindi verificalo.
  5. Fai clic su Export CSV. Il pulsante mostra Generating... mentre il server prepara il file.
  6. Quando compare File ready, fai clic su Download file.

📘 Nota: Il link di download è valido per 1 ora; dopo, avvia una nuova esportazione. Il file è in UTF-8 con BOM, quindi si apre correttamente in Excel.

Browser desktop, pagina CSV Export.

Registro attività del dispositivo

Oltre al database di storico, il server conserva anche un activity log per dispositivo: ogni comando inviato a un dispositivo e ogni cambio di stato che esso segnala, con la sua origine — il residente e il client che ha usato, lo scenario, l'automazione, la funzione Logic, la pianificazione, il gruppo, il bridge KNX o il webhook che l'ha causato — e se il dispositivo ha confermato il comando. Si apre dal pulsante Activity su ogni riga di dispositivo, e le sue impostazioni di registrazione e conservazione si trovano nella pagina Services → Device Activity Log. Entrambi sono descritti in «Device Activity Log».

Domande frequenti

HyperVisu registra automaticamente ogni oggetto?

No. La registrazione è un interruttore su ogni oggetto di comunicazione: gli oggetti di un contatore e di un ingresso analogico con andamento vengono registrati automaticamente, e per qualsiasi altro oggetto la attivi tu. Anche il servizio InfluxDB deve essere attivato.

Perché l'elenco degli oggetti dell'esportazione CSV è vuoto?

Non ci sono ancora oggetti con la registrazione attivata. Attiva la registrazione sugli oggetti che vuoi memorizzare ed esportare.

Posso scegliere il separatore CSV e il fuso orario?

Sì. CSV Data Export offre separatori virgola, punto e virgola o tabulazione e la selezione del fuso orario per i timestamp.

Per quanto tempo è disponibile un download generato?

Il link di download dura un'ora. Dopo, genera una nuova esportazione.

In cosa il registro attività del dispositivo è diverso dallo storico?

Lo storico memorizza le misure per grafici ed esportazioni. Il registro attività registra comandi e cambi di stato, le loro origini e le conferme dei dispositivi.

Continua a esplorare

Trova le altre guide per questo prodotto nella documentazione.

Torna a Servizi & Dati