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.
| Campo | Cosa inserire |
|---|---|
| URL | L'indirizzo dell'istanza InfluxDB (ad es. http://localhost:8086). |
| API Token | Un token con permessi di lettura e scrittura. Usa il pulsante a forma di occhio per mostrarlo o nasconderlo. |
| Organization | Il nome dell'organizzazione nella tua istanza InfluxDB. |
| Bucket | Il 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.

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:
- Apri Devices, espandi il dispositivo e fai clic sul pulsante Edit Object (l'ingranaggio) dell'oggetto.
- Attiva Log historical values.
- 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.
- 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»).
- In Time Period, imposta Start e End, oppure usa una scorciatoia: Last 24h, Last 7 days, Last 30 days, Last year.
- In Format, scegli il Separator: Comma, Semicolon o Tab.
- Scegli la Timezone in cui vengono scritti i timestamp. Il campo si apre su
Europe/Parisqualunque sia il fuso orario del server, quindi verificalo. - Fai clic su Export CSV. Il pulsante mostra Generating... mentre il server prepara il file.
- 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.

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».