Ajouter un modèle d'alarme

Pour ajouter un modèle d'alarme, accédez à /root/Alarming et sélectionnez Add alarm template dans la liste déroulante Alarm Templates ou cliquez sur l'icône à gauche de la liste déroulante :

 

Saisissez un nom et une ligne d'objet pour le message d'alarme. Configurez ensuite le message d'alarme à l'aide des balises disponibles dans les trois listes déroulantes tags. Les Common tags sont des balises qui décrivent l'alarme en général (horodatages, durée…), le deuxième ensemble de balises, Source object tags, décrit l'objet auquel l'appareil d'alarme ou le groupe d'alarmes est lié, tandis que le troisième ensemble de balises, Origin object tags, décrit l'objet qui a réellement émis l'alarme.

Si un signe pourcent doit être envoyé dans le message d'alarme, par exemple dans un lien encodé en URL, il doit être échappé avec un caractère « % » au début. Le caractère « / » encodé en URL (%2F), par exemple, doit s'écrire %%2F

Par défaut, les alarmes sont envoyées au format texte brut. Si vous le souhaitez, les alarmes peuvent également être envoyées au format HTML. Pour ce faire, la section Body doit commencer par une balise HTML. Pour commencer, consultez le HTML template example fourni à droite de la section Body. Le contenu de cet exemple peut être collé directement dans la section Body et modifié selon vos besoins.

Exemple complet de modèle d'e-mail d'alarme

Définition de l'objet :

SKOOR Engine - Alarm from %o %n on Device %-A   --  State: %s  Event: %e


Résultat pour un Job : SKOOR Engine - Alarm from Deviceprinter on Device printer -- State: Major Event: AlarmOpened
Résultat pour un SLO : SKOOR Engine - Alarm from SLO Printing department on Device printer -- State: Major Event: AlarmOpened

Définition du corps :

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


Le corps du message réellement reçu serait alors (pour l'exemple de SLO ci-dessus) :

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)

Les hyperliens HTTP %u et %U dans l'e-mail permettent au destinataire d'accéder directement à l'objet SKOOR Engine (%u) qui a émis l'alarme ou à la liste d'alarmes de l'objet.

Exemple complet de modèle de fichier CSV d'alarme

Définition de l'objet :

Alarm from %o %n State: %s Event: %e %t

Définition du corps :

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

Exemple de modèle de SMS d'alarme

Pour les SMS, il est recommandé de définir un modèle d'alarme distinct. En général, pour les modèles de SMS, seul l'objet est pris en compte et le corps est ignoré. Pour les messages plus longs, utilisez uniquement le champ du corps du message et laissez le champ d'objet vide. Plusieurs SMS seront alors envoyés.

Définition de l'objet :

Alarm %t %e %-n on %-A

SMS résultant : Alarm 2017.08.24 13:59:50 (Europe/Zurich) AlarmSeverityUp Icmp on localhost

Configuration de l'URL pour les balises %u et %U

Pour pouvoir ouvrir un objet dans SKOOR Engine directement depuis un message d'alarme, l'URL de SKOOR Engine doit être configurée en définissant le paramètre ui_url dans le fichier de configuration suivant :

/etc/opt/eranger/eranger-server.cfg

Exemple pour le server SKOOR Engine skoorsrv :

ui_url          = https://skoorsrv