Alarmvorlage hinzufügen
Um ein Alarm-Template hinzuzufügen, navigieren Sie zu /root/Alarming und wählen Sie Add alarm template aus dem Dropdown-Menü Alarm Templates aus 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 anschließend die Alarmmeldung mithilfe der Tags, die in den drei Dropdown-Listen tags verfügbar sind. Die Common tags sind Tags, die den Alarm im Allgemeinen beschreiben (Zeitstempel, Dauer…), der zweite Satz von Tags, Source object tags, beschreibt das Objekt, mit dem das Alarm-Device oder die Alarmgruppe verknüpft ist, während der dritte Satz von Tags, Origin object tags, das Objekt beschreibt, 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. Falls gewünscht, können Alarme auch im HTML-Format gesendet werden. Dazu muss der Abschnitt Body mit einem HTML-Tag beginnen. Als Ausgangspunkt können Sie das rechts neben dem Abschnitt Body bereitgestellte HTML template example heranziehen. Der Inhalt dieses Beispiels kann direkt in den Abschnitt Body eingefügt und dort nach Bedarf bearbeitet werden.
Vollständiges Beispiel für ein Alarm-E-Mail-Template
Betreff-Definition:
SKOOR Engine - Alarm from %o %n on Device %-A -- State: %s Event: %e
Ergebnis für einen Job: SKOOR Engine - Alarm from Deviceprinter on Device printer -- State: Major Event: AlarmOpened
Ergebnis für ein SLO: SKOOR Engine - Alarm from SLO Printing department on Device printer -- State: Major Event: AlarmOpened
Body-Definition:
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 (Body) wäre dann (für das obige SLO-Beispiel):
Common:
========
+--------------------------------------------------------------------
# Event type: AlarmOpened
# Device: printer
# Reason: SLO 'Printing department' is in state 'Major' as Job 'Snmp sysName.0' on 'printer' is in state 'Major' as Error code is 5 (Timeout error) > 0 (No error)
+--------------------------------------------------------------------
Time Stamp Current: 2017.08.24 17:03:35 (MET)
Time Stamp Opened: 2017.08.24 17:03:35 (MET)
Duration: 0s
Comment:
Currently Assigned:
Alarming object: http://<SKOOR Engine-server>/?do=navigate-obj&type=SLO&id=93
Alarms on object: http://<SKOOR Engine-server>/?do=navigate-alarm&type=SLO&id=93&alarmid=7189&ts=1385049815
Source Object (Alarm from):
============================
The object where the Alarm-Group/Device is linked to
Name: Printing department
Type: SLO
State: Major
Statistics: Warning: 0
Minor: 0
Major: 1
Statistics detail: Job 'Snmp sysName.0' is Major
Values:
Device Address:
Device Name:
Job info:
Alarm limits:
Origin Object (Alarm Cause)
============================
The real culprit, initial reason
Name: Snmp sysName.0
Type: Job
State: Major
Values: Error code = 5 (Timeout error)
Device Address: 10.1.0.156
Device Name: printer
Job Info: Timeout requesting from 10.1.0.156:161. (OID 1)
Alarm Limits: Warning: if Any
Error code <> 0 (No error)
Major: if Any
Error code > 0 (No error)
Die HTTP-Hyperlinks %u und %U in der E-Mail ermöglichen es dem Empfänger, direkt zu dem SKOOR Engine-Objekt (%u), das den Alarm ausgelöst hat, oder zur Alarmliste des Objekts zu springen.
Vollständiges Beispiel für ein Alarm-CSV-Datei-Template
Betreff-Definition:
Alarm from %o %n State: %s Event: %e %t
Body-Definition:
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 ein Alarm-SMS-Template
Für SMS wird empfohlen, ein separates Alarm-Template zu definieren. Im Allgemeinen wird bei SMS-Templates nur der Betreff berücksichtigt und der Body ignoriert. Für längere Nachrichten verwenden Sie nur das Feld für den Nachrichtentext (Body) und lassen das Betrefffeld leer. Es werden dann mehrere SMS gesendet.
Betreff-Definition:
Alarm %t %e %-n on %-A
Resultierende SMS: Alarm 2017.08.24 13:59:50 (Europe/Zurich) AlarmSeverityUp Icmp on localhost
URL-Konfiguration für die Tags %u und %U
Um ein Objekt in der SKOOR Engine direkt aus einer Alarmmeldung heraus öffnen zu können, muss die SKOOR Engine-URL konfiguriert werden, indem der Parameter ui_url in der folgenden Konfigurationsdatei gesetzt wird:
/etc/opt/eranger/eranger-server.cfg
Beispiel für den SKOOR Engine-Server skoorsrv:
ui_url = https://skoorsrv

