Alle Themen
Auf dieser Seite
Die Datei stammt aus dem Verlauf des Gateways. Er speichert pro Register höchstens einen Messwert pro Minute, auch wenn das Gateway jede Sekunde ausliest. Jeder, der das Gateway öffnen kann, kann herunterladen, auch ein Teammitglied mit der Rolle Nur lesen.
Datei herunterladen
Die Anleitung wird geladen.
Gateway-Liste öffnen
Öffnen Sie im Menü Gateways.
Gateway öffnen
Klicken Sie auf das Gateway, dessen Messwerte Sie brauchen.
Menü öffnen
Öffnen Sie das Menü mit den drei Punkten oben rechts auf der Gateway-Seite.
Download-Fenster öffnen
Wählen Sie Messwerte herunterladen. Das Fenster Messwerte herunterladen öffnet sich.
Zeitraum wählen
Wählen Sie bei Zeitraum, wie weit Sie zurückgehen wollen. Zur Wahl stehen Letzte 7 Tage, Letzte 30 Tage, Letzte 12 Monate und Alles. Voreingestellt ist Letzte 30 Tage.
Detail wählen
Wählen Sie bei Detail, wie fein die Datei wird. Jeder Messwert liefert alle gespeicherten Messwerte. Pro 15 Minuten, Pro Stunde und Pro Tag fassen die Messwerte pro Register zusammen. Voreingestellt ist Jeder Messwert.
Dateiformat wählen
Wählen Sie bei Dateiformat zwischen CSV für Excel und JSON. Voreingestellt ist CSV für Excel.
Datei speichern
Klicken Sie auf Herunterladen. Sobald die Datei fertig ist, speichert der Browser sie und das Fenster schließt sich.
Auf einem Telefon oder in einem schmalen Browserfenster hat die Gateway-Seite kein Menü mit drei Punkten. Das Download-Symbol (Messwerte herunterladen) in der Leiste oben öffnet dort dasselbe Fenster.
Alles enthält alle gespeicherten Messwerte. Wie lange Messwerte gespeichert bleiben, steht in Aufbewahrungsfristen und Export Ihrer Daten.
Inhalt der Datei
Der Dateiname beginnt mit dem Namen des Gateways, oder mit der Seriennummer, wenn das Gateway keinen eigenen Namen hat. Zeiten in einer CSV-Datei stehen in der Zeitzone Ihrer Organisation. Das ist die Zeitzone unter Einstellungen > Organisation, voreingestellt Europe/Amsterdam (CET/CEST), siehe Organisation und Profil einrichten. Die Zeitzone in Ihrem Profil zählt nicht.
Die Werte stehen mit bereits angewendeter Skalierung in der Datei, wie im Portal. Ein Register, das 2314 liest, steht bei Skalierung 0,1 als 231,4 darin. Die Datei rechnet mit der Skalierung, die jetzt am Register eingestellt ist, auch bei älteren Messwerten. Ein Statusregister steht als Zahl darin, nicht als der Text, den das Portal dazu zeigt. Werte aus dem Tab Variablen stehen nicht in der Datei.
Jeder Messwert als CSV
Die erste Spalte zeigt Datum und Uhrzeit als JJJJ-MM-TT hh:mm:ss. Danach hat jedes Register eine eigene Spalte, sortiert nach Registeradresse. Die Überschrift ist der Name des Registers mit der Einheit, zum Beispiel Spannung L1 (V). Der Name des Modbus-Geräts steht nicht darin.
Hängen zwei Modbus-Geräte desselben Typs am Gateway, tragen ihre Spalten dieselben Überschriften. Wollen Sie sie auseinanderhalten, geben Sie den Registern eines der beiden Geräte einen anderen Namen, wie in Register einrichten. Eine Datei pro 15 Minuten, Stunde oder Tag hat dagegen eine Spalte mit dem Namen des Modbus-Geräts.
Register, die zum selben Zeitpunkt ausgelesen wurden, teilen sich eine Zeile. Eine leere Zelle bedeutet, dass das Register zu diesem Zeitpunkt keinen Messwert hat.
Pro 15 Minuten, Stunde oder Tag als CSV
Die Datei hat dann eine Zeile pro Zeitfenster pro Register. Ein Zeitfenster ist eine Viertelstunde, eine Stunde oder ein Tag. Die Zeilen sind nach Zeit sortiert und innerhalb eines Zeitfensters nach Registeradresse. Die Überschriften stehen in der Sprache des Portals.
| Spalte | Inhalt |
|---|---|
Beginn, Ende | Beginn und Ende des Zeitfensters, in der Zeitzone Ihrer Organisation |
Modbus-Gerät, Register, Einheit | Name des Modbus-Geräts, Name des Registers und die Einheit |
Anzahl | Anzahl der Messwerte im Zeitfenster |
Mittelwert, Minimum, Maximum | Über die Messwerte im Zeitfenster |
Erster Wert, Letzter Wert | Erster und letzter Messwert im Zeitfenster |
Verbrauch | Nur bei einem Zähler, der Verbrauch im Zeitfenster |
Zähler zurückgesetzt | ja, wenn der Zähler im Zeitfenster gesunken ist. Verbrauch ist dann leer |
Register-ID | Die ID des Registers |
Ein Zähler ist ein Register mit der Art Zähler, etwa ein kWh-Zählerstand. Die Art steht in der Spalte Art, siehe Automatische Überwachung. Der Verbrauch ist der letzte Stand des Zeitfensters minus der letzte Stand des vorigen Zeitfensters mit Messwerten. Für das erste Zeitfenster zählt der letzte Stand aus den 7 Tagen davor.
Zeitfenster von 15 Minuten und einer Stunde folgen der Uhr. Ein Tag läuft von Mitternacht bis Mitternacht in der Zeitzone Ihrer Organisation. Das erste Zeitfenster ist immer vollständig, auch wenn der Zeitraum mittendrin beginnt. Das letzte Zeitfenster kann noch laufen, etwa heute bei Pro Tag.
JSON
JSON folgt dem Format modbuscloud.readings, Version 1. Oben stehen die Angaben zum Export, etwa gateway, timezone, resolution, from und to. Danach folgt registers, mit je Register unter anderem id, name, unit, modbus_device, address, scale_factor und counter. Danach folgen die Werte.
| Detail | Liste | Felder je Eintrag |
|---|---|---|
| Jeder Messwert | readings | ts, register_id, value |
| Pro 15 Minuten, Pro Stunde, Pro Tag | buckets | start, end, register_id, count, avg, min, max, first, last, delta, delta_reset |
Zeiten in JSON sind UTC nach ISO 8601. register_id verweist auf id in registers. Werte sind bereits mit der Skalierung umgerechnet, deshalb steht values_scaled auf true. delta ist der Verbrauch im Zeitfenster und delta_reset ist true, wenn der Zähler gesunken ist, wie Verbrauch und Zähler zurückgesetzt in der CSV. Bei einem Register, das kein Zähler ist, sind beide null.
Formatierung für Excel
Die Formatierung einer CSV-Datei richtet sich nach der Sprache, in der Sie das Portal verwenden. Die Tabelle zeigt, wie die Datei je Sprache formatiert ist. JSON ist in jeder Sprache gleich.
| Sprache des Portals | Trennzeichen | Dezimalzeichen | Zeitspalte bei Jeder Messwert |
|---|---|---|---|
| Nederlands | ; | , | Tijdstip |
| Deutsch | ; | , | Zeitpunkt |
| English | , | . | Time |
Excel erkennt die Datei als UTF-8, daher kommen Zeichen wie °C und ü richtig an.
Zu viele Messwerte für eine Datei
Eine Datei enthält höchstens 500 000 Messwerte, als CSV und als JSON. Ein Messwert ist ein Wert eines Registers. Bei 20 Registern mit einem Abfrageintervall von 300 Sekunden erreichen Sie diese Grenze nach etwa 87 Tagen. Bei einem Intervall von 60 Sekunden oder kürzer sind es etwa 17 Tage.
Enthält der Zeitraum mehr, erhalten Sie die neuesten Messwerte. Der Browser speichert die Datei trotzdem. Das Fenster bleibt offen mit der Meldung Zu viele Messwerte für eine Datei: sie enthält die neuesten 500.000. Wählen Sie einen kürzeren Zeitraum für alles.
Die erste Zeile einer solchen CSV-Datei nennt den Zeitpunkt, ab dem sie vollständig ist. Die Überschriften stehen dann in der zweiten Zeile. In JSON steht truncated dann auf true und complete_from nennt diesen Zeitpunkt. Wollen Sie einen Zeitraum vollständig, wählen Sie einen kürzeren Zeitraum. Passt auch Letzte 7 Tage nicht, oder wollen Sie die Messwerte vor diesem Zeitpunkt, nutzen Sie die REST-API.
Pro 15 Minuten, Stunde oder Tag gilt die Grenze für die Messwerte, die das Portal liest, um die Zeitfenster zu berechnen. Pro 15 Minuten liest alle Messwerte im Zeitraum, Sie erreichen die Grenze also genauso schnell wie bei Jeder Messwert. Pro Stunde und Pro Tag rechnen mit den Stundenwerten, die das Portal seit dem 19. August 2026 führt, ohne Grenze. Nur für die Zeit davor liest das Portal einzelne Messwerte, und dort gilt die Grenze.
Liest das Portal mehr Messwerte als die Grenze, beginnt die Datei beim ersten vollständigen Zeitfenster. Das Fenster bleibt offen mit der Meldung Zu viele Messwerte für eine Zusammenfassung in einem Durchgang. Die Datei beginnt deshalb später als gewünscht. Wählen Sie einen kürzeren Zeitraum für alles. Die erste Zeile der CSV und complete_from in JSON nennen den Beginn dieses Zeitfensters.
Messwerte auf anderem Weg abrufen
Die Tabelle stellt die drei Wege nebeneinander.
| Was | Messwerte herunterladen | CSV bei Trends | REST-API |
|---|---|---|---|
| Register | Alle Register des Gateways | Die Register im Diagramm | Alle Register oder eine Auswahl |
| Zeitraum | Letzte 7 Tage, Letzte 30 Tage, Letzte 12 Monate oder Alles | 1h, 6h, 24h, 7T oder 30T | Selbst gewählter Beginn und Ende, pro Anfrage höchstens 7 Tage (366 Tage für ein einzelnes Register) |
| Detail | Jeder Messwert, Pro 15 Minuten, Pro Stunde oder Pro Tag | Einzelne Messwerte bei 1h und 6h, danach Mittelwerte | Jeder gespeicherte Messwert |
| Format | CSV für Excel in der Sprache des Portals, oder JSON | CSV mit Kommas und einem Dezimalpunkt | Seiten mit höchstens 1000 Messwerten |
Wie die Schaltfläche CSV funktioniert, steht in Werte und Diagramme anzeigen. Für die API brauchen Sie einen API-Schlüssel, wie in REST-API und Webhooks beschrieben.
Als Eigentümer oder Administrator exportieren Sie auch alle Gateways auf einmal, mit den Einstellungen, unter Einstellungen > Datenexport. Das steht in Gesamtes Konto exportieren, zusammen mit dem vollständigen Aufbau der CSV- und JSON-Dateien.
Aktualisiert am 15. Oktober 2026
Kommen Sie nicht weiter?
Schreiben Sie uns oder rufen Sie an. Nennen Sie die Seriennummer des Gateways, dann können wir direkt nachsehen.
Zum Support






