Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Zeitstempel, verspätete und doppelte Messwerte

Zu welchem Zeitpunkt ein Messwert gespeichert wird, Messwerte aus der Zukunft oder Vergangenheit, die Einstellungen für Zeitstempel, Duplikate und Messwerte, die durch einen Ausfall verzögert sind.

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 sendetGespeichert 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 FormenJedes 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):

EinstellungStandardBereich
Toleranz für Zeitstempel in der Zukunft (Minuten)101 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:

AufbewahrungsklasseEin Messwert wird abgelehnt, wenn er älter ist als
7 Tage7 Tage
30 Tage7 Tage
90 Tage30 Tage
365 Tage90 Tage
1.095 Tage90 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:

  1. Vor dem Flow. Eine Gerätenachricht, deren Message-ID innerhalb von 60 Sekunden bereits gesehen wurde, oder – wenn sie keine ID, aber eine eigene ts enthält – deren Inhalt bereits gesehen wurde, wird ohne Lauf bestätigt. Eine Messung ohne ID und ohne ts gilt nie als Wiederholung: Der gleiche Wert zweimal sind zwei Messungen.
  2. 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 nicht send ist), 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

SymptomWahrscheinliche Ursache
Ein Messwert fehlt, andere desselben Geräts sind vorhandenSein 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 verschobenDas 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 eintreffenDie neuen Messwerte haben eine ältere oder gleiche ts als die gespeicherte.
Ein korrigierter Wert wird nicht angezeigtEr 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.