Naar de inhoud
Elausys

HyperVisu / Diensten & data

Geschiedenis en gegevensvastlegging

InfluxDB-instellingen, keuze van vastgelegde objecten en export van geschiedenis naar CSV.

elausys · 08 augustus 2026
Op deze pagina

HyperVisu slaat tijdreeksgeschiedenis op in de ingebouwde geschiedenisdatabase (InfluxDB). Dit hoofdstuk behandelt het verbinden ervan, het exporteren van meetgegevens als CSV, het bouwen van Grafana-panelen en het verplaatsen van volledige configuratietabellen naar en van de server als CSV-bestanden.

InfluxDB-verbinding

Geschiedenis vereist de InfluxDB-service. Open Services en controleer of de InfluxDB-rij is ingeschakeld. Als u deze nu inschakelt, verschijnt een banner Pending Changes: klik op Restart Server en wacht tot de server terugkomt.

De pagina InfluxDB Configuration (Services → InfluxDB → Configure) bevat een verbinding naar een geschiede nisdatabase naar keuze. Bij een standaardinstallatie kunnen de velden leeg zijn: de server schrijft en leest vervolgens de geschiedenis via zijn ingebouwde verbinding en u hoeft niets in te vullen.

VeldWat in te voeren
URLHet adres van de InfluxDB-instantie (bijv. http://localhost:8086).
API TokenEen token met lees-/schrijfmachtigingen. Gebruik de oogknop om het weer te geven of verbergen.
OrganizationDe organisatienaam in uw InfluxDB-instantie.
BucketDe bucket waar gegevens zijn opgeslagen.

Klik op Test Connection om de verbinding in het formulier te verifiëren en klik vervolgens op Save om deze op te slaan. De kaart Database Status verandert van Not Tested in Connected en geeft het Last tested moment weer. Test Connection vereist alle vier velden: wanneer de pagina leeg is, is hier niets te testen en controleert u het resultaat in plaats daarvan op een trendpagina in de app. Om veiligheidsredenen wordt een opgeslagen token nooit meer weergegeven; laat het veld leeg om het te behouden. Als de InfluxDB-service zelf is uitgeschakeld, geeft een waarschuwing op de pagina aan dat u deze eerst moet inschakelen via de pagina Services.

Nadat een verbinding is opgeslagen, toont de pagina ook de gebruikte opslag en een Data retention-instelling. Het verkorten van de retentieperiode verwijdert oudere gegevens permanent.

Desktopbrowser, InfluxDB-configuratiepagina met het ingevulde verbindingsformulier en de kaart Database Status met Connected.

Wat wordt vastgelegd. Vastlegging is een schakelaar op elk communicatieobject. De objecten van een meter en van een trend analoge ingang worden automatisch vastgelegd; voor elk ander object meldt u zich aan:

  1. Open Devices, vouw het apparaat uit en klik op de knop Edit Object (het tandwiel) van het object.
  2. Schakel Log historical values in.
  3. Klik op Save object. De objectrij toont nu een databasepictogram en een grafiekpictogram. Er is geen Apply changes nodig.

Elke waarde die het object ontvangt, wordt vanaf dat moment vastgelegd, ongeacht of deze is gewijzigd; niets uit het verleden wordt opnieuw opgebouwd (zie "Objectinstellingen, vastlegging en meldingen"). Vastgelegde objecten voeden de trendgrafieken en metergeschiedenis in de app, Grafana-dashboards, de KNX-busmonitorgrafieken en de CSV-export hieronder.

CSV-gegevensexport

De pagina CSV Data Export zet vastgelegde geschiedenis om in een spreadsheetvriendelijk bestand. Het heeft geen eigen invoer in de zijbalk: open Services en klik op Export in de InfluxDB-rij.

  1. In Object Selection vinkt u de objecten aan die u wilt exporteren. Deze zijn gegroepeerd per kamer; gebruik het zoekvak of Select all. Als de lijst leeg is, zijn nog geen objecten vastgelegd — schakel dit eerst in (zie "Objectinstellingen, vastlegging en meldingen").
  2. In Time Period stelt u Start en End in, of gebruikt u een snelkoppeling: Last 24h, Last 7 days, Last 30 days, Last year.
  3. In Format kiest u de Separator: Comma, Semicolon of Tab.
  4. Kies de Timezone waarin de tijdstempels zijn geschreven. Het veld opent op Europe/Paris ongeacht de eigen tijdzone van de server, dus controleer het.
  5. Klik op Export CSV. De knop leest Generating... terwijl de server het bestand voorbereidt.
  6. Wanneer File ready verschijnt, klikt u op Download file.

📘 Opmerking: De downloadlink is 1 uur geldig; daarna genereert u een nieuw export. Het bestand is UTF-8 met BOM, dus het wordt correct geopend in Excel.

Desktopbrowser, CSV-exportpagina.

Apparaatactiviteitenlogboek

Afzonderlijk van de geschiedenisdatabase onderhoudt de server ook een per-apparaat activiteitenlogboek: elke opdracht die naar een apparaat wordt verzonden en elke statuswijziging die het rapporteert, met de oorsprong ervan — de bewoner en de client die hij gebruikte, het scenario, de automatisering, Logic-functie, planning, groep, KNX-brug of webhook die het veroorzaakte — en of het apparaat de opdracht heeft bevestigd. Het opent via de knop Activity op elke apparaatrij en de instellingen voor registratie en retentie bevinden zich op de pagina Services → Device Activity Log. Beide worden beschreven in "Apparaatactiviteitenlogboek".

Veelgestelde vragen

Legt HyperVisu elk object automatisch vast?

Nee. Vastlegging is een schakelaar op elk communicatieobject: de objecten van een meter en van een trend analoge ingang worden automatisch vastgelegd, en u schakelt deze zelf in voor elk ander object. De InfluxDB-service moet ook zijn ingeschakeld.

Waarom is de CSV-exportobjectlijst leeg?

Geen objecten hebben vastlegging ingeschakeld. Schakel vastlegging in op de objecten die u wilt opnemen en exporteren.

Kan ik het CSV-scheidingsteken en de tijdzone kiezen?

Ja. CSV-gegevensexport biedt komma-, puntkomma- of tabulatorscheidingstekens en een selectie van tijdzone voor tijdstempels.

Hoe lang is een gegenereerde download beschikbaar?

De downloadlink duurt één uur. Daarna genereert u een nieuw export.

Wat is het verschil tussen het apparaatactiviteitenlogboek en de geschiedenis?

Geschiedenis slaat metingen op voor grafieken en exports. Het activiteitenlogboek registreert opdrachten en statuswijzigingen, hun oorsprong en apparaatbevestigingen.

Verder verkennen

Vind de andere handleidingen voor dit product in de documentatie.

Terug naar Diensten & data