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

IoT-Datenbausteine

Referenz zu Telemetrie speichern, Attribute speichern, Shared-Attribut setzen, Alarmregeln, Gerätedetails, Neueste Werte, Profildetails, Verwandte Daten und Messwert speichern.

Diese Bausteine arbeiten mit den Daten eines Geräts auf dem IoT-Host: Sie speichern Messwerte und Attribute, werten Alarmregeln aus und ergänzen die Gerätedaten in der Nachricht. Fast alle benötigen eine Nachricht, deren Ursprung ein Gerät ist: eine Gerätenachricht oder eine Nachricht, die ein Root mit Run flow weitergegeben hat. Nachrichten, die von einem Zeitplan, Inject, Ereignis oder Timer gestartet wurden, betreffen die Organisation, nicht ein Gerät; diese Bausteine lehnen sie mit not_a_device ab.

Telemetrie speichern

Speichert die Schlüssel-Wert-Paare der Nachricht als Telemetrie des Geräts. Nur dieser Baustein speichert Telemetrie: ein Zweig ohne ihn speichert nichts. Nur msg.payload wird gespeichert, niemals die Metadaten.

EinstellungBedeutungStandardWerte
SchlüsselNur diese Schlüsseljeder SchlüsselSchlüsselnamen
tsZu welcher Zeit der Datensatz gespeichert wirdDatensatzzeitDatensatzzeit (msg.metadata.recordTs), Empfangszeit (msg.metadata.ts)
ts_pathBei Datensatzzeit: Datensatz ab diesem Wert neu zeitlich einordnenkeineein Pfad zu Epoch-Millisekunden (eine Zahl oder numerischer Text)

Ausgänge: out (sobald die Werte festgeschrieben sind), error mit msg.error.code:

CodeBedeutung
not_a_deviceDer Ursprung ist kein Gerät
invalid_valueDie Payload ist kein Objekt
bad_tsDie Zeit bei ts_path ist keine Epoch-Millisekunde
too_oldÄlter als die Rohdatenaufbewahrung Ihrer Organisation
no_valuesIn der Payload ist nichts speicherbar
key_limitKein Platz für einen neuen Schlüssel unter der Schlüsselgrenze des Tarifs
save_failedDie Datenbank hat die Zeile abgelehnt (msg.error.ts ist deren Zeit)
  • Nachrichten werden in Wellen von bis zu 500 geschrieben; die nächste Nachricht des Geräts wartet auf das Commit, sodass sie liest, was diese gespeichert hat.
  • Dieselben Werte zur gleichen Zeit werden einmal gespeichert; zwei verschiedene Nachrichten zur gleichen Zeit bleiben beide erhalten; der neueste Wert wechselt nur zu einer strikt neueren Zeit.
  • Ist die Datenbank nicht erreichbar, geht nichts verloren: der Lauf wartet und wird wiederholt, sobald sie wieder verfügbar ist.
  • Ein Testlauf speichert nichts.

Siehe Wie Messwerte gespeichert werden und Telemetrie-Schlüssel.

Attribute speichern

Speichert die Schlüssel-Wert-Paare der Nachricht als Client-Attribute des Geräts (was das Gerät über sich selbst meldet, etwa seine Firmware-Version).

EinstellungBedeutungStandardWerte
scopeWelche Attributeclientclient
SchlüsselNur diese Schlüsseljeder SchlüsselSchlüsselnamen

Fehler: not_a_device, invalid_value, save_failed. Eine erneut zugestellte Nachricht ändert nichts; eine ältere Nachricht überschreibt nie einen neueren Wert; ein unveränderter Wert wird nicht erneut geschrieben. Siehe Attribute.

Shared-Attribut setzen

Setzt Shared-Attribute des Geräts der Nachricht. Ein verbundenes Gerät erhält die Änderung sofort, ein offline Gerät beim nächsten Verbinden. Flows erfahren die Änderung als Nachricht attributes_updated.

EinstellungBedeutungWerte
EinträgeSchlüssel-Wert-Paareerforderlich; höchstens 32. Schlüssel: Buchstaben, Ziffern, _, ., -, höchstens 57 Zeichen. Wert: ein Literal (true, 22.5, {"mode":"eco"}) oder ein Pfad wie msg.payload.setpoint.

Fehler: not_a_device, device_not_found, invalid_value, bad_attribute, too_large, managed_by_settings (ein cfg.*-Schlüssel eines Geräts, dessen Einstellungen auf seinem Reiter Settings verwaltet werden), limit (das Gerät hatte in der letzten Minute zu viele Befehle und Einstellungen aus Flows; Standard 30).

  • Steuerungsebene: Das Bereitstellen erfordert Deploy flows with control-level nodes und die Eingabe des Flow-Namens.
  • Schlüssel, die mit _, fw_ oder current_fw_ beginnen, sowie session_limits und deleted gehören zur Plattform und können nicht gesetzt werden.
  • Eine verspätete Nachricht ändert nichts. Ein Testlauf zeigt an, was gesetzt würde.

Alarmregeln

Wertet die Alarmregeln des Geräteprofils aus und öffnet, aktualisiert oder löscht die Alarme des Geräts. Die Regeln werden im Geräteprofil bearbeitet; dieser Baustein legt fest, wo im Flow sie laufen. Der Standard-Root hat ihn direkt nach dem Eingang richtig platziert.

EinstellungBedeutungStandardWerte
profile_rulesDie Regeln des Profils auswertenonon, off
RegelnNur diese Alarmtypenjede RegelRegeltypen des Profils

Ausgänge:

  • out: die Nachricht, immer, nach der Auswertung (ein Problem wird protokolliert und stoppt die Nachricht nie, sodass die Speicherbausteine danach trotzdem laufen).
  • created, updated, cleared: eine Kopie der Nachricht mit msg.msgType alarm, dem Alarm in msg.payload und msg.metadata.alarm (transition, isNew, isSeverityUpdated, isCleared, repeats, durationMs, ruleId).

Telemetrie wird gegen die Regeln ausgewertet, die einen ihrer Schlüssel lesen; connect, disconnect, activity und inactivity steuern die Offline-Regel. Verspätete oder unsortierte Messwerte werden als Nachtrag ausgewertet (Verlauf mit Backfilled markiert, niemand wird benachrichtigt). Entfernt man den Baustein, stoppen die Alarmregeln für die Geräte dieses Roots; setzt man ihn wieder ein, laufen sie weiter. Siehe Alarmregeln auf Geräteprofilen.

Gerätedetails

Ergänzt die Nachricht um Fakten und Attribute des Geräts der Nachricht.

EinstellungBedeutungStandardWerte
FelderGerätefeldername, profilename, label, type, serial, model, fw_version, status, online, last_activity (epoch ms), profile, profile_id, is_gateway, gateway
AttributeAttribute: scope, key, name in der Nachrichtkeinehöchstens 50; scope client, shared oder server
ZielWohin das Objekt geschrieben wirdmsg.metadata.deviceein Pfad unter msg.metadata oder msg.payload
with_tsAttribute als { ts, value } schreibenoff
on_missingEin Feld oder Attribut ohne Werterrorerror, skip, null

Beispielergebnis: { "name": "Boiler 1", "profile": "Boilers", "online": true, "setpoint": 21 }. gateway ist { id, name, online } für ein Gerät hinter einem Gateway. Details werden 30 Sekunden zwischengespeichert; Attribute werden frisch gelesen. Fehler: missing (mit msg.error.keys), not_a_device, not_found, invalid_value, read_failed.

Letzte Werte

Ergänzt die gespeicherten letzten Werte ausgewählter Schlüssel des Geräts.

EinstellungBedeutungStandardWerte
SchlüsselTelemetrie-Schlüsselerforderlichhöchstens 50
ZielWohinmsg.metadata.latestunter msg.metadata oder msg.payload
with_ts{ ts, value } statt des Wertsoff
on_missingEin Schlüssel ohne gespeicherten Werterrorerror, skip, null

Ein Wert der gerade verarbeiteten Nachricht wird erst eingeschlossen, nachdem ihr Baustein Telemetrie speichern gelaufen ist.

Profildetails

Ergänzt Fakten des Geräteprofils.

EinstellungBedeutungStandardWerte
FelderProfilfeldernamename, id, transport, inactivity_timeout_s, rpc_timeout_s, downlink_max_bytes, online_rule, expected_interval_s
ZielWohinmsg.metadata.profileunter msg.metadata oder msg.payload
on_missingEin Feld ohne Werterrorerror, skip, null

Verknüpfte Daten

Ergänzt Daten von Assets und Geräten, die mit dem Gerät oder Asset der Nachricht verknüpft sind: dem Standort, in dem ein Gerät platziert ist, den Geräten, die ein Asset verwaltet, und einem Vorfahren drei Ebenen darüber.

EinstellungBedeutungStandardWerte
directionBeziehungen vom Ursprung aus oder zu ihm hin verfolgenfromfrom, to
relation_typesVerfolgte BeziehungstypenCONTAINSz. B. CONTAINS, MANAGES, FEEDS, MONITORS oder eigene; none = beliebig
exclude_typesNie verfolgte Typenkeine
depthEbenen11 bis 8
last_level_onlyNur die letzte Ebene behaltenoff
entity_kindWelche Entitätenbeliebigany, asset, device
profiles, kindsNur Geräte dieser Profile, Assets dieser Artenbeliebig
maxWie viele Entitäten11 bis 100 (1 schreibt ein Objekt, mehr eine Liste)
dataWas gelesen wirdattributesAttribute, neueste Werte (Geräte), Felder
BereichGeräteattribut-BereichServerServer, shared, Client
ZuordnungGelesene Schlüssel und ihre Namen in der Nachrichterforderlichhöchstens 50
ZielWomsg.metadata.relatedunter msg.metadata oder msg.payload
with_ts, on_missingWie obenoff, error

Die Asset-Hierarchie und Gerätezuordnungen zählen als CONTAINS-Beziehungen: Richtung to, CONTAINS, Tiefe 3, nur letzte Ebene; assets findet den Standort eines Geräts drei Ebenen darüber. Die Reihenfolge ist festgelegt, daher wählt max 1 jedes Mal dieselbe Entität aus. Siehe Asset-Hierarchie.

Messwert speichern (General-Host)

Speichert Schlüssel-Wert-Paare als Messwert eines Datensatztyps, der Schreibzugriffe aus Flows akzeptiert (zum Beispiel Asset-Zähler, sofern Ihr Tarif sie enthält). Gerätedaten werden hier nie gespeichert.

EinstellungBedeutungStandardWerte
kindDer Datensatztyperforderlichein Typ, der Schreibzugriffe aus Flows akzeptiert
entity_pathWo die ID des Datensatzes stehtmsg.originator.idein Pfad zu einer UUID
ts, ts_pathWie bei Telemetrie speichernZeitpunkt des Datensatzes
keysNur diese Schlüsseljeder Schlüssel

Fehler: invalid_value, invalid_entity, unknown_kind, kind_not_writable, entity_not_writable, bad_ts, save_failed.

Wo Metadaten enden

Werte, die unter msg.metadata geschrieben werden, werden nie gespeichert; Werte unter msg.payload werden von einem nachfolgenden Telemetrie speichern gespeichert. Legen Sie Anreicherungen unter msg.metadata ab, es sei denn, Sie möchten sie speichern.