Standortstatus und Statusschlüssel

Jeder Ort in Hermetry Twin hat einen Status: Critical, Warning, OK oder Unknown. Standorttabellen und Karten färben Standorte danach ein, Drill-down-Tabellen färben Etagen und Räume, und 3D-Szenen tönen Räume und Bereiche damit. Diese Seite erklärt, woher der Status kommt.

Der Status eines Geräts

Der Status eines Geräts ist der schlechteste von drei Fakten:

1. 
   Sein Statusschlüssel. Der letzte Wert eines Telemetrieschlüssels, standardmäßig status:

   Letzter Wert (Groß-/Kleinschreibung egal, Leerzeichen ignoriert)	Status
   critical, alarm, error, fault, danger, 2, true	Critical
   warning, warn, 1	Warning
   jeder andere Wert, zum Beispiel ok, normal, 0, running	OK
   kein Wert	(vom Schlüssel ist nichts bekannt)

2. 
   Seine aktiven Alarme. Jeder offene oder bestätigte Alarm macht das Gerät mindestens Warning; ein CRITICAL-Alarm macht es Critical. Alarme zählen nur für Personen, die Alarme sehen dürfen.
3. 
   Seine Verbindung. Wenn keine der beiden obigen Regeln etwas aussagt, ist ein Gerät, das online ist oder in den letzten 10 Minuten aktiv war, OK.

Ein Gerät, über das nichts bekannt ist (kein Statuswert, kein Alarm, nicht erreichbar), ist Unknown. Die Reihenfolge von schlechtest zu bestem ist Critical, Warning, OK, Unknown.

Aggregation

Der Status eines Ortes ist der schlechteste Status der Geräte, die darauf oder darunter platziert sind. Ein Raum übernimmt seinen Status von seinen Geräten, eine Etage von ihren Räumen, ein Gebäude von seinen Etagen, ein Standort von allem darunter. Ein kritischer Sensor in einem Raum macht den Raum, die Etage, das Gebäude und den Standort kritisch.

Geräte, die Sie nicht lesen dürfen, zählen nicht. Ein Ort ohne Geräte oder ohne Geräte, die Sie lesen dürfen, ist Unknown.

Wo er angezeigt wird

Wo	Was
Vorlage Sites	The site table’s Status badge, the map markers‘ colour, the site page’s header
Drill-down-Tabellen (Status unter einem Asset)	Eine Zeile pro untergeordnetem Element mit seinem Status, Geräten und offenen Alarmen, schlechteste zuerst
3D-Szenen	Elemente, deren Schlüssel dem Code eines Room– oder Area-Assets entspricht, werden mit dessen Status getönt; ein kritisches pulsiert
Tabelle Live-Werte auf einer Standortseite	Der eigene Status jedes Geräts

Die Seite Sites & Assets und ihre Karte zeigen Alarme, nicht diesen Status: Die Karte wird nach dem schlechtesten aktiven Alarm eingefärbt.

Anderen Schlüssel verwenden

Jede Statustabelle, Karte und jeder Standortkopf liest einen Schlüssel, standardmäßig status. In den Datenoptionen der Karte erlaubt Statusschlüssel der Geräte einen anderen Schlüssel, zum Beispiel state oder health, mit demselben Wortschatz. Ein Schlüssel hat bis zu 64 Buchstaben, Ziffern, _, . oder -.

Status in einem Flow ableiten

Die meisten Geräte senden keinen Schlüssel status. Berechnen Sie ihn aus den gesendeten Daten im Root-Flow des Geräts und speichern Sie ihn mit Save telemetry:

1. 
   Öffnen Sie den Root-Flow des Profils (oder den Root-Flow des IoT-Hosts).
2. 
   Fügen Sie nach der eingehenden Nachricht einen Block Calculate mit target msg.payload.status und einem Ausdruck hinzu, zum Beispiel für einen Kühlraum:

   msg.payload.temperature > 8 ? "critical" : (msg.payload.temperature > 6 ? "warning" : "ok")

3. 
   Achten Sie darauf, dass der Zweig in Save telemetry endet, damit status zusammen mit den Messwerten gespeichert wird.
4. 
   Deployen Sie den Flow.

Tipps:

• Leiten Sie den Status in derselben Nachricht ab wie die Messwerte, aus denen er stammt, damit beide immer übereinstimmen. Siehe Abgeleitete Werte.
• Speichern Sie Text (ok, warning, critical) für die Standortfarben. Für Diagramme speichern Sie zusätzlich eine Zahl (status_code: 0, 1, 2), weil Diagramme Zahlen lesen.
• Ein Status, der aus mehreren Geräten berechnet wird (zum Beispiel „irgendeine Pumpe der Station ist gestoppt“), gehört zu einem Gerät, das die Station repräsentiert, oder zu einer Alarmregel: Offene Alarme erhöhen den Status des Ortes automatisch.
• Wenn eine Alarmregel die Bedingung bereits abdeckt, benötigen Sie unter Umständen gar keinen Statusschlüssel: Der Alarm hebt den Ort auf Warning oder Critical, solange er offen ist.

Status, Alarme und Farben im Vergleich

	Statusschlüssel	Alarm
Stammt von	Der letzte Wert des Schlüssels am Gerät	Eine Regel, ein Flow oder eine Bedienperson
Bleibt bestehen	Bis zum nächsten Wert	Bis er behoben ist
Benachrichtigt	Nein	Ja, wenn die Regel es vorsieht
Zum Sehen ist die Berechtigung für Alarme nötig	Nein	Ja
Am besten geeignet für	Die Einfärbung von Orten aus der eigenen Sicht des Geräts	Zustände, auf die Personen reagieren müssen

Fehlersuche

Problem	Ursache
Ein Ort ist Unknown	Kein Gerät darunter sendet den Schlüssel, hat einen offenen Alarm oder war in den letzten 10 Minuten aktiv; oder die Geräte sind nicht darunter platziert
Ein Ort ist rot, obwohl alles in Ordnung ist	Ein Gerät sendet true, 1, 2 oder ein Wort wie error in seinem Statusschlüssel; oder ein CRITICAL-Alarm ist noch offen
Ein Kollege sieht Grün, wo Sie Rot sehen	Er darf keine Alarme sehen, daher zählen offene Alarme für ihn nicht
Ein Raum in der 3D-Szene ist nicht getönt	Der Schlüssel des Elements stimmt nicht mit dem Code des Raums überein, oder die Art des Assets ist nicht Room oder Area