Diese Seite erklärt, was Hermetry schreibt, wenn ein Flow einen Messwert speichert, und warum. Das hilft dir einzuschätzen, was ein Diagramm oder die API zurückgibt, und warum manche Werte an einer Stelle erscheinen, an einer anderen aber nicht.
Nur Flows speichern Daten
Eine Gerätenachricht wird gespeichert, weil ein Flow es so vorgibt. Jede Organisation beginnt mit einem Default root flow, der jede Gerätenachricht empfängt und Telemetrie sowie Client-Attribute speichert. Der Block Save telemetry ist der einzige Weg, auf dem Telemetrie geschrieben wird:
- Entfernst du den Block (oder den Zweig, der zu ihm führt), werden die Messwerte nicht mehr gespeichert. Das Gerät wird weiterhin als online angezeigt, da die Verbindung separat erfasst wird.
- Nur
msg.payloadwird gespeichert. Die Metadaten der Nachricht (das Topic, der Transport, der Gerätename) werden nie gespeichert. - Ein Testlauf eines Flows speichert nie etwas.
Siehe Hosts, der Root-Flow und Profil-Root-Flows.
Eine Zeile pro Nachricht
Wenn der Block Save telemetry einen Datensatz schreibt, fügt der Speicher eine Zeile für den gesamten Datensatz hinzu, nicht eine Zeile pro Schlüssel:
| Teil der Zeile | Enthält |
|---|---|
| Gerät und Zeit | Die ID des Geräts und der Zeitstempel des Datensatzes (Millisekunden, UTC) |
| Zahlen | Jeder numerische Wert, gespeichert nach Schlüssel-ID |
| Andere Werte | Boolesche Werte, Text und JSON-Werte, gespeichert nach Schlüsselname |
| Nachrichten-Fingerabdruck | Ein Hash der Werte, der dazu dient, dieselbe doppelt zugestellte Nachricht zu erkennen |
Ein Datensatz mit 8 Schlüsseln ergibt eine Zeile. Das hält den Speicherbedarf gering und ermöglicht es der API, eine ganze Nachricht auf einmal zurückzugeben.
Das Schlüsselverzeichnis
Jeder Schlüssel, den deine Organisation verwendet, erhält beim ersten Speichern eine kleine Nummer in einem Verzeichnis pro Organisation. Das Verzeichnis gilt für alle deine Geräte: temperature ist ein Schlüssel, egal ob ihn ein Gerät oder zehntausend senden.
- Schlüssel werden nie umbenannt oder wiederverwendet. Ein Schlüssel bleibt im Verzeichnis, nachdem die Geräte, die ihn gesendet haben, gelöscht wurden.
- Ihr Tarif kann die Anzahl unterschiedlicher Schlüssel begrenzen. Ein neuer Schlüssel über dem Limit wird nicht gespeichert, die übrigen Schlüssel desselben Datensatzes schon. Siehe Telemetrieschlüssel.
Letzte Werte
Neben dem Verlauf speichert der Speicher pro Gerät und Schlüssel einen letzten Wert mit seinem Zeitstempel. Die Wertkarten der Dashboards, der Tab Telemetry des Geräts und der Block Latest values im Flow lesen diesen Wert.
Der letzte Wert wird nur bei einem strikt neueren Zeitstempel aktualisiert:
- Ein Messwert mit älterem Zeitstempel (ein gepufferter Rückstau, der nach einem neueren Wert eintrifft) wird im Verlauf gespeichert, ersetzt aber nicht den letzten Wert.
- Eine korrigierte erneute Übertragung mit demselben Zeitstempel wird als eigene Nachricht gespeichert, wenn sich ihre Werte unterscheiden, der letzte Wert bleibt aber der erste.
So stimmen Verlauf, letzte Werte und die Live-Ansicht immer überein.
Aggregate und Rollups
Zahlen werden außerdem zusammengefasst, damit lange Zeitfenster schnell gelesen werden können:
| Ebene | Inhalt | Befüllt durch |
|---|---|---|
| 1-Minuten-Aggregate | Pro numerischem Schlüssel und Minute: Summe, Anzahl, Minimum, Maximum und der letzte Wert | Ein Job, der jede Minute läuft |
| Stunden-Rollups | Dieselben fünf Werte pro Stunde | Abgeleitet aus den Minuten-Aggregaten |
| Tages-Rollups | Dieselben fünf Werte pro Tag (UTC) | Abgeleitet aus den Minuten-Aggregaten |
Text, boolesche Werte und JSON-Werte werden nicht aggregiert. Ein Messwert, der zu spät für eine bereits zusammengefasste Minute eintrifft, markiert diese Minute für einen weiteren Durchlauf, sodass späte Daten nachträglich eingerechnet werden. Siehe Aggregate und Rollups.
Aus welcher Quelle eine Abfrage liest
| Zeitfenster | Gelesen aus |
|---|---|
| Bis zu 24 Stunden | Die rohen Nachrichtenzeilen (jeder einzelne Messwert) |
| Länger | Das feinste Rollup, das unter 10.000 Intervallen bleibt: Minuten, dann Stunden, dann Tage |
Du kannst in der API auch eine bestimmte Auflösung anfordern. Siehe Die History-API.
Aufbewahrung
Jede Stufe wird für ihre eigene Zeit aufbewahrt. Rohzeilen werden höchstens 90 Tage, Minutenaggregate höchstens 31 Tage und Stunden- und Tages-Rollups für die volle Aufbewahrungsklasse Ihres Tarifs gespeichert. Siehe Wie lange Daten gespeichert werden.
Live-Werte
Nachdem ein Speichervorgang abgeschlossen ist, werden die neuen Werte an offene Dashboards und Geräteseiten übertragen, die das Gerät beobachten. Ein Wert, der nicht gespeichert wurde (zum Beispiel ein Schlüssel, den der Root-Flow ausfiltert), erscheint nie live. Die Live-Übertragung erfolgt höchstens viermal pro Sekunde und Schlüssel; dazwischenliegende Werte werden trotzdem gespeichert.
Wenn ein Gerät gelöscht wird
Beim Löschen eines Geräts werden seine Messwerte, Minuten-Aggregate, Rollups und letzten Werte im Hintergrund entfernt, jeweils ein Tag Daten auf einmal. Die von ihm verwendeten Schlüssel bleiben im Verzeichnis.
Zählung
| Zähler | Bedeutung |
|---|---|
| IoT-Nachrichten | Von Geräten empfangene Telemetrie- und Attributnachrichten, beim Eintreffen gezählt, unabhängig davon, ob ein Flow sie speichert |
| Gespeicherte IoT-Datenpunkte | Die tatsächlich vom Speicher eingefügten Werte. Ein vom Speicher verworfenes Duplikat wird nicht gezählt. Kein Kontingent. |

