Grafische Benutzerschnittstelle (GUI)
Alarmlog
Alarmweiterleitung
Bilanzeskalation
Remote Watchdog
REST-Schnittstelle
SOAP-Schnittstelle
An einer System-Alarming-Instanz kann optional das Paket sysal-gui installiert werden. Damit steht eine
grafische Benutzerschnittstelle zur Verfügung. Bei einer Standardinstallation erfolgt ver Einstieg über
http://example.com/sysal/gui/
In der Startansicht sind die Bilanzen der ABM (alarm balance monitor) zu sehen. Die Auflösung der Alarmbilanzen erfolgt über den Knopf am rechten Zeilenrand.
Über die entsprechende Schaltfläche im Kopf der Seite kann in die Administration des Datenmodells gewechselt werden.
Zentrales Element von System Alarming ist das Alarmlog. In dieser Implementierung wird standardmäßig der syslog-Dienst
verwendet. Gesendet wird mit der facility local5 und der Priorität info in die Datei /var/log/sysal.log.
Das aktuelle Log kann über die URL http://SERVER/sysal/log abgerufen werden.
Alarme können zu einer anderen Alarming-Instanz (AMH) weitergeleitet werden. Dazu muss folgendes eingerichtet werden:
Alarmweiterleitung
Beim AMH muss auch angegeben werden, über welche technische Schnittstelle der AMH erreicht werden kann.
Ein Sonderfall ist dabei die Weiterleitung an eine e-mail-Adresse. Dazu muss ein AMH eingerichtet werden, der als host_addr die Kombination host_name/<e-mail-Adresse> und die technische Schnittstelle EmailAlarming hat.
Das Anliegen einer neuen Alarmdringlichkeit bei einem ABM kann seinerseits einen Alarm auslösen. Dazu muss muss am ABM das entsprechende Attribut gesetzt werden.
Zur Überwachung entfernter Anwendungen kann ein RWG (remote watchdog) eingerichtet werden. Dieser erwartet periodisch ein Trigger-Ereignis. Bleibt dieses über eine gewisse Zeit aus, so wird ein Alarm gesetzt. Das Trigger-Ereignis legt seinerseits den RWG an. Über die Administration können Attribute wie Name und erwartetes Triggerintervall verändert werden.
Zum Triggern eines RWG stehen folgende Schnittstellen zur Verfügung:
Das Datenmodell von System-Alarming kann über eine REST-Schnittstelle administriert werden. Diese ist über
folgende URL erreichbar:
http://example.com/sysal/rest/<app>/<class>/<id>
<app>
: Applikation: "AlarmManagement" oder "AlarmInterface"<class>
: Klasse: siehe Datenmodell. Es sind die Klassennamen in CamelCase-Schreibweise
zu verwenden (z.B. "AlarmBalanceMonitor").<id>
(opt.): Für GET
kann und PUT
muss die id der betreffenden Instanz angegeben werden.
Die REST-Schnittstelle unterstützt folgende Operationen:
GET
PUT
: Idempotente Operation auf Instanz mit id. Falls die Instanz im System vorhanden ist, wird ein SET
ausgeführt,
falls nicht, ein CREATE
.POST
: Nur für Klasse RemoteWatchdog unterstützt: Der Request triggert den RWG
. Falls die Instanz noch nicht im System ist,
wird sie angelegt.Folgende Schnittstellen stehen als SOAP-Schnittstellen zur Verfügung: