Alarmierung

Funktionsbeschreibung

Die HOOC-Alarmierung ist eine Anwendung, welche es erlaubt, auf einfachste Weise Regeln zur Überwachung einer Anlage zu definieren. Dabei spielt es keine Rolle, ob die Bedingungen eine Überprüfung von Werten aus dem Secure Remote Control (SERC) Dienst beinhalten oder ob eine Meldung gesendet werden soll im Falle einer Verbindung auf die Anlage mittels Secure Remote Access (SERA). Bedingungen können miteinander verknüpft und direkt getestet werden. Empfänger und Benachrichtigungskanle (Voice, SMS, Push, E-Mail) der Alarmmeldungen können im HOOC Notification Center konfiguriert werden.

Konfiguration

Der Dienst kann bei der Anlage unter Dienste -> Alarmierung konfiguriert werden.

services-alerting

Eine Regel kann getestet werden. Das Ergebnis wird in der Spalte Letzter Zustand dargestellt.

  • Klick auf das Symbol zum manuellen Aktualisieren der Regel
  • Klick auf das Symbol zum Testen der Regel mit Weiterleitung an Notification Center

Folgende Operationen stehen je nach Konfiguration der Regel zur Verfügung:

Operationen Beschreibung
Verarbeitung pausieren
Verarbeitung starten
Explizite Meldung an Benachrichtigungskanal Kollaboration via Notification Center senden
Alarm quittieren

Weiter stehen folgende Aktionen zur Verfügung:

Aktion Beschreibung
Regel editieren
Regel kopieren
Logs Alarmevents anzeigen
Regel entfernen

Regeln erstellen

Durch einen Klick auf das Symbol kann eine neue Regel hinzugefügt werden. Folgende Einstellungen können getätigt werden:

Allgemein

services-alerting-rule-tab0

Eigenschaft Beschreibung
Regelname Name der Regel (wird auch in der HOOC-App für die Funktion Meldung empfangen verwendet)
Mehrsprachig … Übersetzter Regelname, welcher anhand der eingestellten Sprache in der HOOC-App dargestellt werden (optional)
Kategorie Kategorie der Regel (Information, Warung, Alarm)
Regel aktiv Falls aktiv, wird die Regel überprüft, ansonsten nicht

Falls die Option Melde, falls das Ergebnis der Regel… aus den allgemeinen Einstellungen gesetzt wird, erfolgt die Benachrichtigung mit dem Status OK.

Meldungen

services-alerting-rule-tab1

Alarmmeldungen können für die unterschiedlichen Zustände (Alarm, Quittierung und Recovery) individuell erfasst werden.

Eigenschaft Beschreibung
Titel Titel der Meldung
Nachricht Nachricht der Meldung
Mehrsprachig … Übersetzte Elmente, welche anhand der benutzerdefinierten Sprache für die Benachrichtigung verwendet werden (optional)

Es können Platzhalter verwendet werden. Diese werden beim Erstellen der Meldungen durch die entsprechenden Werte ersetzt.

Platzhalter Beispiel Beschreibung
{{1}}, {{2}}, {{3}} Wert der entsprechenden Bedingung
{{ACKED_BY}} Name der Person, welche den Alarm quittiert hat (nur bei Quittierung)
{{ESCALATION_LEVEL}} Aktuelle Eskalationsstufe

Bedingungen

services-alerting-rule-tab2

Um eine Regel anzulegen wird im minimum eine Bedingung benötigt. Es können jedoch mehrere Bedingungen miteinander verknüpft werden.

  • Klick auf zum anfügen einer neuen Bedingung
  • Klick auf zum entfernen der Bedingung
  • Die Bedingungen können via Drag and Drop verschoben werden

Logischer Operator

Die erste Bedingung startet immer mit dem logischen Operator WENN. Falls mehrere Bedingungen verwendet werden, stehen mehrere logische Operatoren zur Verfügung:

logischer Operator Beschreibung
AND UND Verknüpfung
NAND NICHT-UND Verknüpfung
NOR NICHT-ODER Verknüpfung
OR ODER Verknüpfung
XNOR EXKLUSIV-NICHT-ODER Verknüpfung
XOR EXKLUSIV-ODER Verknüpfung

Die Bedingungen werden nacheinander miteinander verknüpft. Bedingung_01 verknüpft mit Bedingung_02. Dieses Ergebnis wird dann verknüpft mit Bedingung_03 u.s.w.

Verwendung Datenquelle HOOC Gateway (Secure Remote Access)

Bei der Verwendung der Datenquelle HOOC Gateway kann ausgewählt werden, ob als Bedingung der Verbindungsstatus des HOOC-Gateways einer Zeitperiode verwenden möchte, oder ob eine Abfrage auf die Anzahl Benutzerverbindungen zur Anlage gemacht werden soll.

Verwendung Datenquelle Datenpunkt (Secure Remote Control)

Bei der Verwendung der Datenquelle Datenpunkt kann mittels Drop-Down der gewünschte Datenpunkt ausgewählt werden.

Falls der Datenpunktname im Dienst Secure Remote Control geändert wird, wird diese Einstellung nicht automatisch in diesen Dienst übernommen. Dies wird dazu führen, dass das Resultat der entsprechenden Regel nicht mehr korrekt sein wird.

Die Abfragedefinitionen sind wie folgt unterteilt:

Abfragedefinition Beschreibung
Mittelwert Summe aller Messwerte des Zeitraums geteilt durch Anzahl Messwerte des Zeitraums (Arithmetisches Mittel)
Median Messwerte werden aufsteigend sortiert und derjenige Wert “in der Mitte” wird verwendet
Wertgültigkeit Falls der Datenpunktwert eines ereignisgesteuerten Protokolls (Bspw. KNX) für den gesamten Zeitraum als ungültig markiert ist (Letzter bekannter Wert), wird der Wert 0 (nicht in Ordnung) zugewiesen

Nach der Auswahl der Abfragedefinitionen des Datenpunkts können Vergleichsoperator und die entsprechenden Grenzwerte erfasst werden.

Bei nicht Ereignisgesteuerten Protokollen (Bspw. Modbus) wird falls keine Werte des Datenpunktes vorhanden sind, der Wert null zugewiesen. Bei Ereignisgesteuerten Protokollen (Bspw. KNX) kann die Gültigkeit des Datenpunkts mit der Abfragedefinition Wertgültigkeit überprüft werden.

Verwendung Datenquelle KNX Endgerät (Secure Remote Control)

Bei der Verwendung der Datenquelle KNX Endgerät kann die Verbindung zum KNX-Gateway/Router oder die Busauslastung überwacht werden.

Verwendung Datenquelle LoRa Endgerät (Secure Remote Control)

Bei der Verwendung der Datenquelle LoRa Endgerät kann die Verbindung zu einem bestimmten LoRA Endgerät überwacht werden. Die Verbindung ist getrennt falls vom LoRa Endgerät in der angegebenen Zeitperiode keine Daten empfangen werden konnten.

Vergleichsoperationen

Aus untenstehender Tabelle können die möglichen Verglichsoperationen entnommen werden.

Beschreibung Operation Information
gleich Trifft zu wenn (Wert == Feld0)
grösser Trifft zu wenn (Wert > Feld0)
kleiner Trifft zu wenn (Wert < Feld0)
innerhalb Trifft zu wenn ((Wert >= Feld0) && (Wert <= Feld1))
ausserhalb Trifft zu wenn ((Wert < Feld0) && (Wert > Feld1))
null Trifft zu wenn (Wert == null) Trifft zu, wenn kein Wert vorhanden ist
nur Bits Trifft zu wenn ((Wert > 0) && ((Wert & Bitmaske) == Wert)) Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH
ein Bit Trifft zu wenn ((Wert & Bitmaske) > 0) Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH
alle Bits Trifft zu wenn ((Wert & Bitmaske) == Bitmaske) Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH
kein Bit Trifft zu wenn ((Wert & Bitmaske) == 0) Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH

Testen der Bedingungen

Die erfassten Bedingungen der Regel können mittels Klick auf “Teste Bedingungen” getestet werden, ohne das Meldungen gesendet werden. Nach dem Test kann bei jeder Bedingung folgendes sichtbar sein:

  • Der Wert der Datenquelle wird im Tooltip angezeigt
  • Resultat Bedingung WAHR
  • Resultat Bedingung FALSCH

Das Ergebnis der Regel wird links neben dem Button “Teste Bedingungen” dargestellt.

Eskalation

services-alerting-rule-tab2

Im Konfigurationstab Eskalation können die Eskalationsregeln erfasst werden. Mittels Eskalationsregeln wird die Meldung bei anstehendem Ereignis im Meldungsinterval ausgelöst, solange keine Quittierung erfolgte. Es können auch übergeordnete Eskalationsregeln erfasst und zugeordnet werden.

Eigenschaft Beschreibung
Start Eskalation nach Zeit nachdem das entsprechende Meldungsinterval verwendet wird
Meldungsinterval In diesem Interval wird die Nachricht bei anstehendem Ereignis versendet
Option Eskalation neu starten… Nach Erreichen der letzten Eskalationsstufe wird wieder bei der ersten Eskalationsstufe begonnen
Zeitverzögerung Neustart Eskalation Zeitverzögerung bis der Neustart der Eskalation erfolgen soll (Wechsel von letzer Eskalationsstufe zur ersten Eskalationsstufe)

Ein anstehendes Ereignis bzw. Alarm kann mittels Klick auf das Symbol quittiert werden.

Die Eskalationsstufe 0 tritt unmittelbar nach dem eintreten der Bedingungen ein. Falls bei einer Regel Eskalationsregeln erfasst sind, tritt die Eskalationsstufe 1 nach dem eintreten der ersten Bedingung ein.

Kollaboartion

services-alerting-rule-tab4

Im Konfigurationstab Kollaboration können die individuellen Einstellungen im Zusammenhang mit dem Dienst HOOC Kollaboration konfiguriert werden. Falls Empfänger von HOOC Kollaboration benachrichtigt werden sollen, muss zwingend die Option Verwendung im Dient Kollaboration aktiviert werden.

Je Alarmregel können individuelle Meldungstexte für diesen Benachrichtigungskanal definiert werden.

Weiteres

Die Benachrichtigung kann auch an bspw. externe E-Mail Empfänger gesendet werden. Diese Funktionalität steht im HOOC Notification Center zur Verfügung.

Verwendung in der HOOC-App

Die Funktionalitäten für die Benachrichtigungskanäle, Konfiguration zum Empfangen von Meldungen und die Mitteilungszentrale stehen in der HOOC-App zur Verfügung. Weiter können folgende Eisntellungen getätigt werden:

  • Alarme können im Menü Alarmierung quittiert werden, indem das entsprechende Element nach Rechts gewischt wird.
  • Die Einstellungen für die Optionen Benachrichtigungskanäle können je Anlage im Menü Mehr vorgenommen werden.