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

