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

Hosts, der Root-Flow und Profil-Root-Flows

Die Hosts IoT und General, wie jede Gerätenachricht an genau einen Root-Flow gelangt, der Standard-Root, Profil-Roots und was zu prüfen ist, wenn nichts gespeichert wird.

Ein Host ist der Teil von Hermetry, der Flows einer Art ausführt. Der IoT-Host führt die Flows aus, die Gerätenachrichten empfangen; der General-Host führt Flows für Zeitpläne, Webhooks und Ereignisse aus. Auf dem IoT-Host geht jede Gerätenachricht an genau einen Root-Flow, der die Daten speichert. Diese Seite erklärt Hosts, Root-Flows und wie Sie sie sicher ändern.

Die beiden Hosts

IoTGeneral
Nachrichtentypentelemetry, attributes, connect, disconnect, activity, inactivity, rpc_request, rpc_response, attributes_updated, alarm; außerdem Zeitpläne, Injects, Webhooks, Timer und EreignisseZeitpläne, Injects, Webhooks, Timer, Ereignisse und Nachrichten aus anderen Flows
Root-FlowsJa: der mandantenweite Root und die Profil-RootsNein
GerätebausteineDevice message, Save telemetry, Save attributes, Alarm rules, Send command, Raise alarm, Anreicherungsbausteine …Nein
Monatliche AnzahlGerätenachrichten zählen als IoT-NachrichtenAngenommene Einträge zählen als Automation-Nachrichten

Den Host wählen Sie beim Erstellen eines Flows; er lässt sich später nicht ändern. Der Filter Host in der Flow-Liste zeigt die Flows eines Hosts.

Root-Flows

Ein Root-Flow ist der Eingang für die Gerätenachrichten eines Hosts. Auf dem IoT-Host gibt es zwei Arten:

RootLäuft fürErforderlich
Mandantenweiter RootJedes Gerät, dessen Profil keinen eigenen Root hatJa: Es gibt immer einen. Er kann ersetzt, aber nie entfernt werden.
Profil-RootDie Geräte eines GeräteprofilsNein

Jede Gerätenachricht startet einen Root: den Root ihres Profils, falls vorhanden, sonst den mandantenweiten Root. Sie tritt am Baustein Flow input des Roots ein (im Standard-Root heißt er Device messages). Telemetrie kommt als eine Nachricht pro Datensatz an: Ein Gerät, das einen Stapel von 10 zeitgestempelten Datensätzen sendet, startet 10 Nachrichten.

Root-Flows zeigen in der Flow-Liste ein Root-Badge mit dem, wofür sie laufen („Root · Tenant-wide“ bzw. der Name des Profils).

Der Standard-Root-Flow

Jede Organisation beginnt mit dem Default root flow, mandantenweit zugewiesen. Er wird automatisch erstellt und bereitgestellt:

Device messages (Flow input)
  → Alarm rules
  → Message type (Switch on msg.metadata.msgType)
       telemetry   → Save telemetry
       attributes  → Save client attributes
       rpc_request → System log "RPC request from …"
       otherwise   → System log "Other device message"
Errors (Catch, uncaught only) → System log

„Jede Gerätenachricht im Geltungsbereich dieses Roots tritt an seinem Flow input ein: Die Alarmregeln des Geräteprofils werden ausgewertet, Telemetrie und Client-Attribute werden gespeichert, RPC-Anfragen von Geräten und andere Nachrichten werden protokolliert. Entfernen Sie einen Speicherbaustein, werden diese Daten nicht mehr gespeichert.“

Sie können ihn wie jeden Flow bearbeiten: abgeleitete Werte, Weiterleitung oder Filter hinzufügen. Lassen Sie Alarm rules, Save telemetry und Save client attributes auf ihren Pfaden, sonst hört diese Arbeit für jedes Gerät auf, das der Root bedient.

Einen Profil-Root anlegen

Verwenden Sie einen Profil-Root, wenn eine Gerätegruppe anders behandelt werden muss, zum Beispiel ein Decoder für ein Profil, das Binärdaten sendet, oder zusätzliche Schritte für eine Produktlinie.

  1. Legen Sie einen Flow auf dem IoT-Host an, idealerweise aus der Vorlage Default root flow, damit der Speicherpfad von Anfang an vorhanden ist.
  2. Fügen Sie Ihre Schritte hinzu. Behalten Sie Alarm rules, Save telemetry und Save client attributes bei.
  3. Stellen Sie ihn eingeschaltet bereit. „Nur ein laufender Flow kann dort ein Root sein.“
  4. Öffnen Sie in der Flow-Liste die Details des Flows und wählen Sie Set as root.
  5. Wählen Sie unter Run it for das Geräteprofil aus und bestätigen Sie mit Set as root.

Hat das Profil bereits einen Root, meldet der Dialog „It replaces flow, which runs here now.“ und bittet Sie, den Namen des ersetzten Flows einzugeben.

Ein Root wird nie von einem anderen Flow ausgeführt. Wird ein Flow als Root gesetzt, werden die Run flow-Bausteine entfernt, die ihn aus anderen Flows heraus starten; jeder dieser Flows erhält eine neue Version, und der Dialog listet sie zuerst auf.

Root lösen oder löschen

  • Lösen Sie einen Profil-Root über dessen Details: Geben Sie zur Bestätigung den Namen des Flows ein. Die Geräte des Profils gehen dann an den mandantenweiten Root.
  • Beim Löschen eines Root-Flows wird dasselbe abgefragt, mit Unbind and delete.
  • Der mandantenweite Root kann nicht gelöst oder gelöscht werden. Um ihn abzulösen, setzen Sie zuerst einen anderen laufenden Flow als mandantenweiten Root; danach kann der alte gelöscht werden.
  • Ein Root muss eingeschaltet bleiben und laufen. Nur der Not-Aus hält einen Root an; die automatische Pause nie. Siehe Schutzmechanismen und fehlgeschlagene Nachrichten.

Flows, die keine Roots sind

Ein Flow, der kein Root ist, empfängt keine gewöhnlichen Gerätenachrichten. Er wird auf diesen Wegen erreicht:

WegAblauf
Von einem RootRun flow (reicht die Nachricht weiter) oder Link out / Link call
Alarmänderungen und AttributaktualisierungenEin Trigger Device message mit dem Typ alarm oder attributes_updated, nach Namen angehakt: Diese gehen an jeden zuhörenden Flow, Root oder nicht.
Befehlsergebnisserpc_response-Nachrichten sind Gerätenachrichten: Sie erreichen den Root des Geräts. Von dort reichen Sie sie mit Run flow weiter.
Zeit, Webhooks, EreignisseTrigger Schedule, Inject, Webhook, Event, Named timer

Eine mit Run flow weitergereichte Nachricht behält ihr Gerät, sodass Bausteine wie Save telemetry dort weiterhin funktionieren.

Reihenfolge der Nachrichten

Nachrichten desselben Geräts laufen nacheinander in der Reihenfolge ihres Eintreffens, bis zum ersten externen Aufruf (eine HTTP-Anfrage, eine E-Mail, eine Wartezeit oder ein Detach). Danach ist die Reihenfolge nicht garantiert. Nachrichten verschiedener Geräte laufen parallel.

Verspätete Nachrichten

Eine Gerätenachricht, die länger als ihre Time-to-live (standardmäßig 5 Minuten, nach einem Ausfall) gewartet hat, läuft trotzdem durch ihre Root und wird gespeichert, als verspätet markiert. Blöcke, die außerhalb der Plattform handeln, überspringen sie. Andere lauschende Flows verwerfen sie. Siehe Timestamps, late and duplicate readings.

Online, aber nichts wird gespeichert

Ein Gerät kann als online erscheinen (seine Verbindung wird von der Plattform verfolgt), während seine Messwerte nicht gespeichert werden. Prüfen Sie:

  1. Gibt es einen laufenden Root? Filtern Sie in Automation nach dem IoT-Host. Ein Root-Flow muss Running sein. Ein Banner „No worker is running the IoT host right now…“ bedeutet, dass die Verarbeitung der Plattform gestört ist; wenden Sie sich an den Support.
  2. Ist der Not-Aus aktiv? Ein Banner „Emergency stop: n flows are paused…“ bedeutet, dass nichts läuft, bis Sie fortsetzen.
  3. Hat das Geräteprofil einen eigenen Root? Dessen Root, nicht der mandantenweite, verarbeitet das Gerät. Prüfen Sie seinen Baustein Save telemetry.
  4. Erreicht die Nachricht Save telemetry? Öffnen Sie das Panel Activity des Roots: die Reiter Debug und Errors sowie die Nachrichtenzähler an den Verbindungen.
  5. Meldet Save telemetry Fehler? not_a_device, too_old, no_values, key_limit: siehe IoT-Datenbausteine.
  6. Is the IoT automation available to your organisation? Ohne sie wird keine Gerätedaten gespeichert. Wenden Sie sich an den Support.

Siehe auch Daten kommen nicht an.