Event Processing

Event Processing

Event Processing ergänzt die Arbeit mit Rulechains, wenn wiederkehrende Alarm- und Ereignislogiken nicht jedes Mal manuell als eigene Knotenstruktur aufgebaut werden sollen.

Im Bereich lassen sich zwei Arten von Regeln verwalten:

• Calculate alarm rules zum automatischen Berechnen und Erzeugen von Alarmen aus eingehender Telemetrie
• Enrich alarm rules zum Anreichern bereits erzeugter Alarme mit zusätzlichen Metadaten

In der Tabellenansicht werden alle vorhandenen Event-Processing-Regeln angezeigt. Links oben wird über Erstellen eine neue Regel angelegt. Rechts oben können markierte Regeln gelöscht werden.

Über die Aktionsspalte einer bestehenden Regel stehen zusätzlich folgende Funktionen zur Verfügung:

• Regelinhalt ansehen
• Regel Geräten erneut zuweisen
• Regel löschen

Grundprinzip

Event Processing vereinfacht Alarm-Workflows, die altenativ manuell aufgebaut werden müssten.

Für Alarmregeln entspricht die Logik im Kern folgendem Ablauf:

Die tabellarische Regeldefinition bestimmt also, welche Telemetrie überwacht wird, wann ein Alarm aktiv ist und welche Zusatzinformationen mitgeführt werden.

Neue Regel anlegen

Beim Anlegen einer neuen Event-Processing-Regel wird zunächst der Typ ausgewählt.

Zur Auswahl stehen:

• Alarm Regeln berechnen
• Alarme Anreichern

Anschließend wird eine Regeldatei hochgeladen und im nächsten Schritt Geräten, Gerätelisten, Gerätetypen oder dem aktuellen Projekt zugewiesen.

Die Zuordnung kann über folgende Gruppierungstypen erfolgen:

• Single entity
• Entity list
• Entity name
• Device type
• Current project

Dadurch gilt eine Regel nur für die ausgewählten Geräte oder die definierte Gerätegruppe.

Alarm Regeln berechnen

Alarm Regeln berechnen dienen dazu, Alarmbedingungen aus Telemetriedaten deklarativ zu definieren, statt für jeden Alarm eine eigene Rulechain zu modellieren.

Nach dem Import kann die eingelesene Tabelle direkt in optiCLOUD geprüft werden.

Aufbau der Regeldatei

Die Importdatei ist tabellarisch aufgebaut. Pflichtspalten sind:

Spalte	Bedeutung
telemetry_key	Telemetriekanal, auf den die Regel angewendet wird
state_0	Bedingung oder Zielzustand für Status 0
state_1	Bedingung oder Zielzustand für Status 1
error_value	Kennzeichnet, welcher Status als Alarm gilt (state 0 oder state 1)
alarm_type	Name bzw. Typ des zu erzeugenden Alarms
alarm_active	Aktiviert oder deaktiviert die Regel

Optional können beliebig viele zusätzliche Metadaten-Spalten ergänzt werden:

• meta_field_<NAME> für Metadaten, die unabhängig vom Status gesetzt werden
• meta_field_<NAME>_value_0 für Metadaten nur bei state_0
• meta_field_<NAME>_value_1 für Metadaten nur bei state_1

Die Präfixe meta_field_ sowie die Suffixe _value_0 und _value_1 sind dabei fest vorgegeben.

Regel Berechnungen

Die Zustände können einfache feste Werte oder Ausdrücke enthalten. Beispiele sind:

• x == 1
• x >= 15
• x > 15 && x < 30
• x * 1.25 >= 100
• text == "myText"

Damit lassen sich sowohl numerische Grenzwerte als auch komplexere logische Bedingungen abbilden, wobei "x" die variable ist, die für den eingehenden Telemetriewert steht.

Beispiel

telemetry_key	state_0	state_1	error_value	alarm_type	alarm_active	meta_field_Description_EN	meta_field_Description_DE
Temperature	x>5	x<=5	0	Temperature_Alarm	Y	Temperature above 5	Temperature über 5
Pressure	x>5	x<=5	0	Pressure_Alarm	Y	Pressure above 5	Druck über 5
Humidity	x>5	x<=5	0	Humidity_Alarm	Y	Humidity above 5	Feuchtigkeit über 5

Das Besipiel kann hier heruntergeladen werden (Umwandlung in .xlsx notwendig)

Geräten erneut zuweisen

Bereits angelegte Regeln können später erneut geöffnet und anderen Geräten oder Gruppen zugeordnet werden.

Das ist nützlich, wenn dieselbe Regeldefinition für weitere Geräte gelten soll, ohne dass eine zweite Regeldatei angelegt werden muss.

In die Root Rule Chain einbinden

Damit die Regel aktiv wird, muss sie zusätzlich in die Root Rule Chain eingebunden werden.

Dazu wird in der Root Rule Chain unter Event Rule der Knoten Complex Alarm verwendet.

Der Knoten wird hinter Save Timeseries eingefügt und mit der Relation Success verbunden.

Dadurch wird ein eingehender Telemetriewert zuerst gespeichert und anschließend anhand der Alarmregeln ausgewertet.

Ergebnis am Gerät

Nach dem Speichern der Root Rule Chain erscheinen die erzeugten Alarme am jeweiligen Gerät im Bereich Benachrichtigungen. In der Zeile eines jeden Alarms, kann über das Details Icon der gesamte Alarminhalt angesehen werden.

Alarme Anreichern

Alarme Anreichern werden verwendet, um Alarme, die das Gerät direkt an Opticloud sendet, anhand ihres alarm_type mit zusätzlichen Informationen zu versehen, zum Beispiel mit Bedienhinweisen, Servicemeldungen oder anderen empfohlenen Maßnahmen. Dies ist nützlich, wenn das Gerät z.B. Alarme eines Steuergerätes and die Cloud überträgt, diese Alarme allerdings wenig Informationen enthalten. OptiCloud kann diese dann direkt mit bestehenden Informationen anreichern, was die Ansicht in Dashboards oder auch eine spätere Auswertung der Alarme vereinfacht.

Der Anlegeprozess ist identisch: Typ auswählen, Datei hochladen, Zielgeräte oder Gruppen festlegen.

Nach dem Anlegen erscheint die Regel ebenfalls in der allgemeinen Event-Processing-Übersicht.

Nach dem Import lässt sich die eingelesene Tabelle ebenfalls direkt einsehen.

Aufbau der Regeldatei

Pflichtspalten sind:

Spalte	Bedeutung
alarm_type	Alarmtyp, der angereichert werden soll
alarm_active	Aktiviert oder deaktiviert die jeweilige Regel

Zusätzliche Metadaten werden als weitere Spalten im Format meta_field_<NAME> ergänzt.

Beispiel

alarm_type	alarm_active	meta_field_servermessage	meta_field_description	meta_field_remedysteps
TemperatureDeviceAlarm	y	Temperature Alarm on Valve 10	Please look in Service Manual Page 56	Reset Temperature Valve 10
PressureDeviceAlarm	y	Pressure Alarm on Valve 10	Please look in Service Manual Page 56	Reset Pressure Valve 10
HumidityDeviceAlarm	y	Humidity Alarm on Valve 10	Please look in Service Manual Page 56	Reset Humidity Valve 10

Das Besipiel kann hier heruntergeladen werden (Umwandlung in .xlsx notwendig)

Anreicherungsregel aktivieren

Für die Verarbeitung in der Root Rule Chain wird unter Event Rule der Knoten Enrich Alarm verwendet.

Der Knoten wird hinter Save Alarms angeschlossen, damit zuerst der Alarm gespeichert und danach mit den zusätzlichen Feldern ergänzt wird.

Ergebnis in den Alarmdetails

Nach der Aktivierung können die zusätzlichen Informationen in der Geräteansicht unter Notification über die Alarmdetails eingesehen werden.

Damit lassen sich zu einem Alarm direkt kontextbezogene Informationen wie Beschreibung, Servermeldung oder empfohlene Handlungsschritte anzeigen.

Zusammenfassung

Event Processing dient in optiCLOUD als vereinfachte Oberfläche für zwei wiederkehrende Alarm-Workflows:

• Alarme aus Telemetriebedingungen berechnen
• bestehende Alarme um zusätzliche Metadaten anreichern

Beide Regeltypen werden zunächst importiert und Geräten zugewiesen. Aktiv werden sie erst dann, wenn der passende Event-Rule-Knoten in die Root Rule Chain eingebunden und gespeichert wurde.