Jede Messung wird zu einem Zeitpunkt gespeichert. Diese Seite erklärt, welcher Zeitpunkt das ist, welche Messwerte aufgrund ihrer Zeit abgelehnt werden, wie Duplikate behandelt werden und was mit verspätet eintreffenden Messwerten geschieht.
Gerätezeit oder Empfangszeit
| Was das Gerät sendet | Gespeichert um |
|---|---|
Ein flaches Objekt, zum Beispiel {"temperature": 21.5} | Der Zeitpunkt, zu dem die Plattform die Nachricht empfangen hat |
{"ts": 1759572000000, "values": {...}} | ts: die eigene Zeit des Geräts |
| Ein Array aus beiden Formen | Jedes Element zu seiner eigenen Zeit |
ts ist eine ganze Zahl in Millisekunden seit dem 1. Januar 1970, UTC. Jedes andere ts (Sekunden, ein String, eine negative Zahl) verwirft den Datensatz als bad_ts. Siehe MQTT-Topics und Referenz der Payloads.
Sende ts nur, wenn die Uhr des Geräts synchronisiert ist. Ein Gerät ohne verlässliche Uhr sollte flache Objekte senden und die Plattform die Zeitstempel setzen lassen. Eine driftende Uhr erzeugt Messwerte an falscher Stelle in Diagrammen und kann abgelehnt werden.
In einem Flow ist die Aufzeichnungszeit msg.metadata.recordTs und die Empfangszeit msg.metadata.ts. Der Block Save telemetry speichert standardmäßig die Aufzeichnungszeit; über seine Einstellung ts kann auf die Empfangszeit umgestellt werden, und mit ts_path lässt sich ein Datensatz anhand eines Werts in der Nachricht neu zeitlich einordnen.
Messwerte aus der Zukunft
Ein Datensatz, dessen Zeitstempel mehr als 10 Minuten nach dem Zeitpunkt seines Eingangs liegt, wird als bad_ts verworfen. Er wird niemals auf „jetzt“ korrigiert. Die Toleranz ändern Sie unter Einstellungen > Telemetrie (IoT-Telemetrie-Einstellungen):
| Einstellung | Standard | Bereich |
|---|---|---|
| Toleranz für Zeitstempel in der Zukunft (Minuten) | 10 | 1 bis 1.440 |
| Ältester akzeptierter Messwert (Tage) | 0 (beliebiges Alter) | 0 bis 36.500 |
Ein Datensatz, der älter ist als Älteste akzeptierte Messung (Tage) vor seinem Eingang, wird als bad_ts verworfen. Damit verhindern Sie, dass ein Gerät sehr alte gepufferte Daten erneut sendet. Die Seite benötigt die Berechtigungen IoT-Telemetrie-Einstellungen anzeigen und IoT-Telemetrie-Einstellungen ändern (standardmäßig Admin). Änderungen wirken innerhalb einer Minute auf den Ingest.
Messwerte aus der Vergangenheit
Ein Messwert, der älter ist als Ihre Aufbewahrungsklasse für Rohdaten, wird vom Speicher als too_old abgelehnt, unabhängig von den oben genannten Einstellungen:
| Aufbewahrungsklasse | Ein Messwert wird abgelehnt, wenn er älter ist als |
|---|---|
| 7 Tage | 7 Tage |
| 30 Tage | 7 Tage |
| 90 Tage | 30 Tage |
| 365 Tage | 90 Tage |
| 1.095 Tage | 90 Tage |
Messwerte innerhalb des Rohdatenfensters werden auch dann gespeichert, wenn sie alt sind, und in die Zusammenfassungen je Minute, Stunde und Tag übernommen. Siehe Wie lange Daten aufbewahrt werden.
Duplikate
Ein Gerät, ein Gateway oder ein Wiederholungsversuch kann dieselbe Messung zweimal senden. Hermetry behandelt das an zwei Stellen:
- Vor dem Flow. Eine Gerätenachricht, deren Message-ID innerhalb von 60 Sekunden bereits gesehen wurde, oder – wenn sie keine ID, aber eine eigene
tsenthält – deren Inhalt bereits gesehen wurde, wird ohne Lauf bestätigt. Eine Messung ohne ID und ohnetsgilt nie als Wiederholung: Der gleiche Wert zweimal sind zwei Messungen. - Im Speicher. Eine Nachricht mit denselben Werten zur selben Zeit für dasselbe Gerät wird einmal gespeichert. Eine erneut zugestellte oder wiedergegebene Nachricht ändert nichts.
Zwei verschiedene Nachrichten mit demselben Zeitstempel werden beide behalten. Wenn die API Rohwerte liest, gibt sie pro Zeitstempel einen Punkt zurück. Der neueste Wert behält den ersten Wert, den sie für diesen Zeitstempel gesehen hat.
Nicht in der Reihenfolge eintreffende Messwerte
Ein Gerät, das Messwerte offline puffert und später sendet, liefert sie nach neueren Daten. Sie werden im Verlauf zu ihren eigenen Zeiten gespeichert. Sie ersetzen keinen neueren letzten Wert. Alarmregeln behandeln Datensätze, die älter als der zuletzt ausgewertete sind, als Nachlieferung: Sie werden nicht live ausgewertet, und eine Regel mit aktivierter Nachlieferung löst Alarme aus diesen Daten aus, ohne jemanden zu benachrichtigen. Siehe Clear-Bedingungen und verspätete Messwerte.
Messwerte, die durch einen Ausfall verzögert sind
Nachrichten warten in einer Warteschlange, solange ein Verarbeitungs-Worker ausgefallen ist. Wenn die Plattform aufholt, ist eine Gerätenachricht, die länger als ihre Time-to-live (standardmäßig 5 Minuten) gewartet hat, eine verspätete Nachricht:
- Sie durchläuft trotzdem ihren Root-Flow und wird gespeichert. Ein Rückstau sind Ihre Daten, daher wird sie dort nie verworfen.
- Sie wird als verspätet markiert (
msg.metadata.late). Blöcke, die außerhalb der Plattform wirken, überspringen sie: keine Benachrichtigung, kein Gerätebefehl, kein HTTP-Aufruf und keine MQTT-Veröffentlichung (sofern die Einstellung late des Blocks nichtsendist), kein ausgesendetes Ereignis. - Der Block Alarm rules wertet sie als Nachlieferung aus: Alarme werden in den Verlauf geschrieben, als Backfilled markiert, und für die Vergangenheit wird niemand alarmiert. Ein Alarm, der noch offen ist, wenn Live-Messwerte wieder einsetzen, wird dann gemeldet.
- Andere Flows, die darauf reagieren würden (zum Beispiel ein
alarm-Listener), verwerfen ihn und zählen ihn als Zu alt.
Siehe Schutzmechanismen und fehlgeschlagene Nachrichten.
Zeitzonen
Alles wird in UTC gespeichert. Konsole, Dashboards und Exporte zeigen Zeiten in der Zeitzone des Betrachters. Tagesaggregationen laufen von Mitternacht bis Mitternacht UTC; für lokale Tage siehe Aggregationen und Rollups.
Fehlersuche
| Symptom | Wahrscheinliche Ursache |
|---|---|
| Ein Messwert fehlt, andere desselben Geräts sind vorhanden | Sein ts lag in der Zukunft oder außerhalb des gültigen Bereichs (bad_ts) oder war älter als das Rohdatenfenster (too_old). Prüfen Sie die Laufprotokolle des Root-Flows. |
| Messwerte erscheinen stunden- oder tageweise verschoben | Das Gerät sendet ts in Ortszeit oder in Sekunden. Senden Sie UTC-Millisekunden oder flache Objekte. |
| Der letzte Wert ändert sich nicht, obwohl neue Messwerte eintreffen | Die neuen Messwerte haben eine ältere oder gleiche ts als die gespeicherte. |
| Ein korrigierter Wert wird nicht angezeigt | Er wurde mit derselben ts wie das Original gesendet; der letzte Wert behält den ersten. Senden Sie die Korrektur mit einer neuen ts. |
Siehe auch Falsche Zeiten und Lücken.

