Alle onderwerpen
Op deze pagina
Het bestand komt uit de historie van de gateway. Die bewaart per register hooguit één meting per minuut, ook als de gateway elke seconde uitleest. Iedereen die de gateway kan openen, kan downloaden, ook een teamlid dat alleen mag lezen.
Bestand downloaden
De uitleg wordt geladen.
Gatewaylijst openen
Open Gateways in het menu.
Gateway openen
Klik op de gateway waarvan je de metingen wilt hebben.
Menu openen
Open het menu met de drie puntjes rechtsboven op de gatewaypagina.
Downloadvenster openen
Kies Metingen downloaden. Het venster Metingen downloaden opent.
Periode kiezen
Kies bij Periode hoe ver je terug wilt. De keuzes zijn Laatste 7 dagen, Laatste 30 dagen, Laatste 12 maanden en Alles. Standaard staat er Laatste 30 dagen.
Detail kiezen
Kies bij Detail hoe fijn het bestand wordt. Elke meting geeft alle opgeslagen metingen. Per 15 minuten, Per uur en Per dag vatten de metingen per register samen. Standaard staat er Elke meting.
Bestandsformaat kiezen
Kies bij Bestandsformaat tussen CSV voor Excel en JSON. Standaard staat er CSV voor Excel.
Bestand opslaan
Klik op Downloaden. Zodra het bestand klaar is, slaat de browser het op en sluit het venster.
Op een telefoon of in een smal browservenster heeft de gatewaypagina geen menu met drie puntjes. Het downloadicoon (Metingen downloaden) in de balk bovenaan opent daar hetzelfde venster.
Alles neemt alle bewaarde metingen mee. Hoe lang metingen bewaard blijven, staat in Bewaartermijnen en je data meenemen.
Wat in het bestand staat
De bestandsnaam begint met de naam van de gateway, of met het serienummer als de gateway geen eigen naam heeft. Tijden in een CSV-bestand staan in de tijdzone van je organisatie. Dat is de Tijdzone bij Instellingen > Organisatie, standaard Europe/Amsterdam (CET/CEST), zie Organisatie en profiel instellen. De tijdzone in je profiel telt niet mee.
Waarden staan erin met de schaal al toegepast, net als in het portaal. Een register dat 2314 leest met schaal 0,1, staat erin als 231,4. Het bestand rekent met de schaal die nu op het register staat, ook voor oudere metingen. Een statusregister staat erin als getal, niet als de tekst die het portaal erbij toont. Waarden van het tabblad Variabelen staan niet in het bestand.
Elke meting als CSV
De eerste kolom geeft datum en tijd als JJJJ-MM-DD UU:MM:SS. Daarna krijgt elk register een eigen kolom, op volgorde van registeradres. De kop is de naam van het register met de eenheid, bijvoorbeeld Spanning L1 (V). De naam van het Modbus-apparaat staat er niet in.
Hangen er twee Modbus-apparaten van hetzelfde type aan de gateway, dan krijgen hun kolommen dezelfde koppen. Wil je ze uit elkaar houden, geef de registers van een van beide dan een andere naam, zoals in Registers instellen. Een bestand per 15 minuten, uur of dag heeft wel een kolom met de naam van het Modbus-apparaat.
Registers die op hetzelfde moment zijn uitgelezen, delen een rij. Een lege cel betekent dat het register op dat tijdstip geen meting heeft.
Per 15 minuten, uur of dag als CSV
Het bestand heeft dan één regel per vak per register. Een vak is een kwartier, een uur of een dag. De regels staan op volgorde van tijd en binnen een vak op registeradres. De koppen staan in de taal van het portaal.
| Kolom | Inhoud |
|---|---|
Begin, Einde | Begin en einde van het vak, in de tijdzone van je organisatie |
Modbus apparaat, Register, Eenheid | Naam van het Modbus-apparaat, naam van het register en de eenheid |
Aantal | Aantal metingen in het vak |
Gemiddelde, Minimum, Maximum | Over de metingen in het vak |
Eerste, Laatste | Eerste en laatste meting in het vak |
Verbruik | Alleen bij een teller, het verbruik in het vak |
Teller teruggezet | ja als de teller in het vak daalde. Verbruik is dan leeg |
Register-id | Het id van het register |
Een teller is een register met de soort Teller, zoals een kWh-meterstand. De soort staat in de kolom Soort, zie Automatische bewaking. Het verbruik is de laatste stand van het vak min de laatste stand van het vorige vak met metingen. Voor het eerste vak telt de laatste stand uit de 7 dagen ervoor.
Vakken van 15 minuten en een uur liggen op de klok. Een dag loopt van middernacht tot middernacht in de tijdzone van je organisatie. Het eerste vak is altijd heel, ook als de periode er middenin begint. Het laatste vak kan nog lopen, zoals vandaag bij Per dag.
JSON
JSON volgt het formaat modbuscloud.readings, versie 1. Bovenaan staan de gegevens van de export, zoals gateway, timezone, resolution, from en to. Daarna volgt registers, met per register onder meer id, name, unit, modbus_device, address, scale_factor en counter. Daarna volgen de waarden.
| Detail | Lijst | Velden per item |
|---|---|---|
| Elke meting | readings | ts, register_id, value |
| Per 15 minuten, Per uur, Per dag | buckets | start, end, register_id, count, avg, min, max, first, last, delta, delta_reset |
Tijden in JSON zijn UTC in ISO 8601. register_id verwijst naar id in registers. Waarden zijn al omgerekend met de schaal, daarom staat values_scaled op true. delta is het verbruik in het vak en delta_reset is true als de teller daalde, net als Verbruik en Teller teruggezet in de CSV. Bij een register dat geen teller is, zijn beide null.
Opmaak voor Excel
De opmaak van een CSV-bestand volgt de taal waarin je het portaal gebruikt. De tabel laat per taal zien hoe het bestand is opgemaakt. JSON is in elke taal hetzelfde.
| Taal van het portaal | Scheidingsteken | Decimaalteken | Tijdkolom bij Elke meting |
|---|---|---|---|
| Nederlands | ; | , | Tijdstip |
| Deutsch | ; | , | Zeitpunkt |
| English | , | . | Time |
Excel herkent het bestand als UTF-8, dus tekens als °C en ü komen goed door.
Te veel metingen voor één bestand
Een bestand bevat hooguit 500 000 metingen, als CSV en als JSON. Een meting is één waarde van één register. Bij 20 registers met een uitleesinterval van 300 seconden zit je na ongeveer 87 dagen aan die grens. Met een interval van 60 seconden of korter is dat na ongeveer 17 dagen.
Bevat de periode meer, dan krijg je de nieuwste metingen. De browser slaat het bestand wel op. Het venster blijft open met de melding Te veel metingen voor één bestand: dit bevat de nieuwste 500.000. Kies een kortere periode voor alles.
De eerste regel van zo'n CSV-bestand noemt het tijdstip vanaf wanneer het compleet is. De koppen staan dan op de tweede regel. In JSON staat truncated dan op true en noemt complete_from dat tijdstip. Wil je een periode volledig, kies dan een kortere periode. Past ook Laatste 7 dagen niet, of wil je de metingen van vóór dat tijdstip, gebruik dan de REST API.
Per 15 minuten, uur of dag geldt de grens voor de metingen die het portaal leest om de vakken te berekenen. Per 15 minuten leest alle metingen in de periode, dus daar zit je even snel aan de grens als bij Elke meting. Per uur en Per dag rekenen met de uurwaarden die het portaal sinds 19 augustus 2026 bijhoudt, zonder grens. Alleen voor de tijd daarvoor leest het portaal losse metingen, en daar telt de grens wel.
Leest het portaal meer metingen dan de grens, dan begint het bestand bij het eerste vak dat volledig is. Het venster blijft open met de melding Te veel metingen om in één keer samen te vatten. Het bestand begint daarom later dan gevraagd. Kies een kortere periode voor alles. De eerste regel van de CSV en complete_from in JSON noemen het begin van dat vak.
Metingen op een andere manier ophalen
De tabel zet de drie manieren naast elkaar.
| Wat | Metingen downloaden | CSV op Trends | REST API |
|---|---|---|---|
| Registers | Alle registers van de gateway | De registers in de grafiek | Alle registers of een keuze |
| Periode | Laatste 7 dagen, Laatste 30 dagen, Laatste 12 maanden of Alles | 1u, 6u, 24u, 7d of 30d | Zelf gekozen begin en eind, per verzoek hooguit 7 dagen (366 dagen voor één register) |
| Detail | Elke meting, Per 15 minuten, Per uur of Per dag | Losse metingen bij 1u en 6u, daarna gemiddelden | Elke opgeslagen meting |
| Opmaak | CSV voor Excel in de taal van het portaal, of JSON | CSV met komma's en een decimale punt | Pagina's van hooguit 1000 metingen |
Hoe de knop CSV werkt, staat in Waarden en grafieken bekijken. Voor de API heb je een API-sleutel nodig, zoals beschreven in REST API en webhooks.
Als eigenaar of beheerder exporteer je ook alle gateways tegelijk, met de instellingen erbij, onder Instellingen > Gegevens exporteren. Dat staat in Hele account exporteren, samen met de volledige opbouw van de CSV- en JSON-bestanden.
Bijgewerkt op 15 oktober 2026
Kom je er niet uit?
Mail of bel ons. Stuur het serienummer van de gateway mee, dan kunnen we direct meekijken.
Naar support






