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