Alarmvorlage hinzufügen
Um eine Alarmvorlage hinzuzufügen, navigieren Sie zu /root/Alarming und wählen Sie „Alarmvorlage hinzufügen” aus dem Dropdown-Menü „Alarmvorlagen” oder klicken Sie auf das Symbol links neben dem Dropdown-Menü:
Geben Sie einen Namen und eine Betreffzeile für die Alarmmeldung ein. Konfigurieren Sie dann die Alarmmeldung mithilfe der Tags, die in den drei Dropdown-Listen „Tags“ verfügbar sind. Die allgemeinen Tags beschreiben den Alarm im Allgemeinen (Zeitstempel, Dauer ...), die zweite Gruppe von Tags, die Quellobjekt-Tags, beschreiben das Objekt, mit dem das Alarmgerät oder die Alarmgruppe verknüpft ist, während die dritte Gruppe von Tags, die Ursprungsobjekt-Tags, das Objekt beschreiben, das den Alarm tatsächlich ausgelöst hat.
Wenn ein Prozentzeichen in der Alarmmeldung gesendet werden muss, beispielsweise in einem URL-kodierten Link, muss es mit einem vorangestellten „%“-Zeichen maskiert werden. Das URL-kodierte Zeichen „/“ (%2F) muss beispielsweise als %%2F geschrieben werden.
Alarme werden standardmäßig im Klartextformat gesendet. Auf Wunsch können Alarme auch im HTML-Format gesendet werden. Dazu muss der Body-Abschnitt mit einem HTML-Tag beginnen. Als Ausgangspunkt dienen die HTML-Vorlagenbeispiele rechts neben dem Body-Abschnitt. Der Inhalt dieses Beispiels kann direkt in den Body-Abschnitt eingefügt und dort nach Bedarf bearbeitet werden.
Vollständiges Beispiel für eine Alarm-E-Mail-Vorlage
Betreffdefinition:
SKOOR Engine - Alarm from %o %n on Device %-A -- State: %s Event: %e
Ergebnis für einen Auftrag: SKOOR Engine – Alarm vom Gerätedrucker auf dem Gerätedrucker – Status: Major-Ereignis: AlarmOpened
Ergebnis für einen SLO: SKOOR Engine – Alarm von der SLO-Druckabteilung auf dem Gerätedrucker – Status: Major-Ereignis: AlarmOpened Definition
des Hauptteils:
Common: ======== +-------------------------------------------------------------------- # Event type: %e # Device: %-A # Reason: %r +-------------------------------------------------------------------- Time Stamp Current: %t Time Stamp Opened: %T Duration: %d Comment: %c Currently Assigned: %q Alarming object: %u Alarms on object: %U Source Object (Alarm from): ============================ The object where the Alarm-Group/Device is linked to Name: %n Type: %o State: %s Statistics: %S1 Statistics detail: %S2 Values: %v Device Address: %a Device Name: %A Job info: %i Alarm limits: %h Origin Object (Alarm Cause) ============================ The real culprit, initial reason Name: %-n Type: %-o State: %-s Values: %-v Device Address: %-a Device Name: %-A Job Info: %-i Alarm Limits: %-h
Der tatsächlich empfangene Nachrichtentext würde dann (für das obige SLO-Beispiel) wie folgt lauten:
Allgemein:
========
+--------------------------------------------------------------------#
Ereignistyp:
AlarmOpened# Gerät:
Drucker# Grund: SLO „Druckabteilung” befindet sich im Status „Major”, da der Auftrag „Snmp sysName.0” auf „Drucker” sich im Status „Major” befindet, da der Fehlercode 5 (Zeitüberschreitungsfehler) > 0 (kein Fehler) ist
. +--------------------------------------------------------------------
Zeitstempel aktuell: 24.08.2017 17:03:35 (MET)
Zeitstempel geöffnet: 24.08.2017 17:03:35 (MET)
Dauer: 0s
Kommentar:
Derzeit zugewiesen:
Alarmierendes Objekt: http://<SKOOR Engine-Server>/?do=navigate-obj&type=SLO&id=93
Alarme zu Objekt: http://<SKOOR Engine-Server>/?do=navigate-alarm&type=SLO&id=93&alarmid=7189&ts=1385049815
Quellobjekt (Alarm von):
============================
Das Objekt, mit dem die Alarmgruppe/das Gerät verknüpft ist
Name: Druckabteilung
Typ: SLO
Status: Major
Statistik: Warning: 0
Minor: 0
Major: 1
Statistikdetails: Auftrag „Snmp sysName.0” ist Major
Werte:
Geräteadresse:
Gerätename:
Auftragsinformationen:
Alarm Limit:
Ursprungsobjekt (Alarmursache)
============================
Der eigentliche Verursacher, ursprünglicher Grund
Name: Snmp sysName.0
Typ: Auftrag
Status: Major
Werte: Fehlercode = 5 (Zeitüberschreitungsfehler)
Geräteadresse: 10.1.0.156
Gerätename: Drucker
Auftragsinformationen: Zeitüberschreitung bei Anfrage von 10.1.0.156:161. (OID 1)
Alarm Limits: Warning: wenn Fehlercode
<> 0 (kein Fehler)
Major: wenn Fehlercode
> 0 (kein Fehler)
Über die HTTP-Hyperlinks %u und %U in der E-Mail kann der Empfänger direkt zum SKOOR Engine-Objekt (%u) springen, das den Alarm ausgelöst hat, oder zur Alarmliste des Objekts.
Beispiel für eine vollständige CSV-Dateivorlage für Alarme
Definition des Betreffs:
Alarm from %o %n State: %s Event: %e %t
Definition des Textes:
Event Type: %e, Timestamp Current: %t, Opened: %T, Duration: %d, Comment: %c, Name: %n, Device Address: %a, Device Name: %A, Job Info: %i, Object Type: %o, State: %s, Values: %v, Limits: %h, Alarm Info (short): %0, Alarm Info (long): %1, Alarm Info (file):%2, Name: %-n, DeviceAddress: %-a, Device Name: %-A, Job Info: %-I, Object Type: %-o, State: %-s, Values: %-v, Alarm Limits: %-h, Origin Alarm Info (short): %-0, Origin Alarm Info (long): %-1, Origin Alarm Info (file):%-2
Beispiel für eine Alarm-SMS-Vorlage
Für SMS wird empfohlen, eine separate Alarmvorlage zu definieren. Im Allgemeinen wird bei SMS-Vorlagen nur der Betreff berücksichtigt und der Text ignoriert. Verwenden Sie für längere Nachrichten nur das Textfeld und lassen Sie das Betrefffeld leer. Es werden dann mehrere SMS gesendet.
Betreffdefinition:
Alarm %t %e %-n on %-A
Ergebnis-SMS: Alarm 2017.08.24 13:59:50 (Europe/Zurich) AlarmSeverityUp Icmp auf localhost
URL-Konfiguration für %u- und %U-Tags
Um ein Objekt in der SKOOR Engine direkt aus einer Alarmmeldung öffnen zu können, muss die SKOOR Engine-URL durch Setzen des Parameters ui_url in der folgenden Konfigurationsdatei konfiguriert werden:
/etc/opt/eranger/eranger-server.cfg
Beispiel für den SKOOR Engine-Server skoorsrv:
ui_url = https://skoorsrv

