Telemetrie sind die Messwerte, die Ihre Geräte über die Zeit erfassen und melden: Temperaturen, Füllstände, Zähler, Zustände. Dieser Abschnitt 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 und wird in Datensätze aufgeteilt (einer pro Zeitstempel), wobei Schlüssel und Werte anhand der Schlüsselregeln geprüft werden.
- 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 und aktualisiert den letzten Wert pro Schlüssel des Geräts; der Minutenjob fasst die Zahlen zu 1-Minuten-Aggregaten zusammen, danach folgen Stunden- und Tagesrollups.
- Dashboards, der Reiter Telemetry des Geräts, Flows und die API lesen je nach Zeitfenster die letzten Werte, die Rohzeilen oder die Rollups.
Siehe How readings are stored und Hosts, the root flow and profile root flows.
Wichtige 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 zu 1.024 Zeichen, JSON-Objekte oder -Arrays bis zu 4 KiB. Nur Zahlen werden in Diagrammen dargestellt und aggregiert. |
| Zeitstempel | Millisekunden seit der Epoche, UTC. Werte, die mehr als 10 Minuten in der Zukunft liegen, werden verworfen (anpassbar). |
| Duplikate | Dieselben Werte zur selben Zeit für dasselbe Gerät werden einmal gespeichert. |
| Letzter 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 Tagesrollups. |
| Aufbewahrung | Eine Klasse von 7, 30, 90, 365 oder 1.095 Tagen gemäß Ihrem Tarif. Rohzeilen werden höchstens 90 Tage aufbewahrt. |
| Nachrichtenkontingent | Wird monatlich gezählt. Eine Überschreitung stoppt Ihre Geräte niemals. |
In diesem Abschnitt
| Seite | Inhalt |
|---|---|
| How readings are stored | Nachrichtenzeilen, das Schlüsselverzeichnis, letzte Werte, Rollups |
| Telemetry keys | Schlüsselregeln, reservierte Präfixe, raw, die Schlüsselobergrenze, Schlüsseleinstellungen des Profils |
| Timestamps, late and duplicate readings | Gerätezeit und Empfangszeit, zukünftige und alte Messwerte, Duplikate, Ausfälle |
| Numbers, text and true/false values | Was Diagramme lesen und wie Zustände gespeichert werden |
| Aggregates and rollups | Zeitfenster, die sieben Aggregatfunktionen, increase für Zähler |
| How long data is kept | Aufbewahrungsklassen und was jede Detailstufe behält |
| The device’s Telemetry tab | Letzte Werte und das Verlaufsdiagramm auf der Geräteseite |
| Exporting data | CSV- und Excel-Downloads, die API, der Organisationsexport |
| The history API | GET /api/telemetry/series und latest, mit Beispielen |
| Derived values | Berechnen und Speichern neuer Schlüssel in einem Flow |
| Message quota and usage | Was als Nachricht zählt, Tarifkontingente, Warnungen |
Verwandte Abschnitte
- Devices: Anbindung von Geräten und die Payload-Formate, 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.