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