Telemetrie sind die Werte, die Ihre Geräte über die Zeit messen und melden: Temperaturen, Füllstände, Zähler, Zustände. Dieser Bereich erklärt, was mit einem Messwert nach dem Eingang geschieht, wie lange jede Detailstufe aufbewahrt wird, wie Sie die Werte wieder abrufen (in der Konsole, auf Dashboards, über die API) und wie Messwerte auf Ihr Kontingent angerechnet werden.
Der Weg eines Messwerts
- Ein Gerät sendet eine Nachricht (MQTT, HTTP, LoRaWAN, ein Gateway oder ein Poller). Die Nachricht wird auf Ihr monatliches Nachrichtenkontingent angerechnet.
- Die Nachricht gelangt in Ihren Root-Flow, wird in Datensätze aufgeteilt (einer pro Zeitstempel) und Schlüssel und Werte werden anhand der Schlüsselregeln geprüft.
- Der Block Alarm rules wertet die Alarmregeln des Geräteprofils aus.
- Der Block Save telemetry schreibt den Datensatz. Nur dieser Block speichert Telemetrie: ein Zweig ohne ihn speichert nichts.
- Der Speicher behält die Nachricht, aktualisiert den neuesten Wert pro Schlüssel des Geräts, und der Minutenjob fasst die Zahlen zu 1-Minuten-Aggregaten zusammen; Stunden- und Tagesverdichtungen folgen.
- Dashboards, der Reiter Telemetry des Geräts, Flows und die API lesen je nach Zeitfenster aus den neuesten Werten, den Rohzeilen oder den Verdichtungen.
Siehe How readings are stored und Hosts, the root flow and profile root flows.
Wichtigste Fakten
| Thema | Fakt |
|---|---|
| Schlüssel | Bis zu 64 Zeichen aus A-Z a-z 0-9 _ . -, groß- und kleinschreibungsabhängig. Die Präfixe _, fw_, current_fw_ und cfg. sind reserviert. |
| Werte | Zahlen, true/false, Text bis 1.024 Zeichen, JSON-Objekte oder Arrays bis 4 KiB. Nur Zahlen werden in Diagrammen dargestellt und aggregiert. |
| Zeitstempel | Millisekunden seit der Epoche, UTC. Mehr als 10 Minuten in der Zukunft wird verworfen (anpassbar). |
| Duplikate | Dieselben Werte zur selben Zeit für dasselbe Gerät werden nur einmal gespeichert. |
| Neuester Wert | Wird nur auf einen strikt neueren Zeitstempel aktualisiert. |
| Aggregate | 1-Minuten-Summe, Anzahl, Minimum, Maximum und letzter Wert pro numerischem Schlüssel, danach Stunden- und Tagesverdichtungen. |
| Aufbewahrung | Eine Klasse von 7, 30, 90, 365 oder 1.095 Tagen aus Ihrem Tarif. Rohzeilen werden höchstens 90 Tage aufbewahrt. |
| Nachrichtenkontingent | Wird pro Monat gezählt. Eine Überschreitung stoppt Ihre Geräte nie. |
In diesem Bereich
| Seite | Was sie behandelt |
|---|---|
| Wie Messwerte gespeichert werden | Nachrichtenzeilen, das Schlüsselverzeichnis, neueste Werte, Verdichtungen |
| Telemetrie-Schlüssel | Schlüsselregeln, reservierte Präfixe, raw, die Schlüsselobergrenze, Schlüsseleinstellungen des Profils |
| Zeitstempel, verspätete und doppelte Messwerte | Gerätezeit und Empfangszeit, zukünftige und alte Messwerte, Duplikate, Ausfälle |
| Zahlen, Text und Wahrheitswerte | Was Diagramme lesen und wie Zustände gespeichert werden |
| Aggregate und Rollups | Zeitfenster, die sieben Aggregatfunktionen, increase für Zähler |
| Wie lange Daten aufbewahrt werden | Aufbewahrungsklassen und was jede Detailstufe behält |
| Der Telemetrie-Tab des Geräts | Neueste Werte und das Trenddiagramm auf der Geräteseite |
| Daten exportieren | CSV- und Excel-Downloads, die API, der Organisationsexport |
| Die History API | GET /api/telemetry/series und latest, mit Beispielen |
| Abgeleitete Werte | Berechnung und Speicherung neuer Schlüssel in einem Flow |
| Nachrichtenkontingent und Nutzung | Was als Nachricht zählt, Tarifkontingente, Warnungen |
Verwandte Bereiche
- Devices: Anbinden von Geräten und den Nutzlastformaten, die sie senden. Siehe MQTT topics and payload reference.
- Dashboards: Diagramme, Tabellen und Wertkarten. Siehe Data sources and parameters.
- Flows: der Root-Flow, der die Daten speichert, und Flows, die neue Werte berechnen.

