Ajouter un modèle d'alarme

Pour ajouter un modèle d'alarme, naviguez jusqu'à /root/Alarming et sélectionnez Ajouter un modèle d'alarme dans la liste déroulante Modèles d'alarme ou en cliquant 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 de balises. Les balises communes sont des balises qui décrivent l'alarme en général (horodatage, durée...), la deuxième série de balises, les balises de l'objet source, décrit l'objet auquel le dispositif d'alarme ou le groupe d'alarmes est lié, tandis que la troisième série de balises, les balises de l'objet d'origine, décrit l'objet qui a effectivement émis l'alarme.

Si un signe de pourcentage doit être envoyé dans le message d'alarme, par exemple dans un lien codé en URL, il doit être échappé avec un caractère "%" en tête. Le caractère "/" codé en URL (%2F), par exemple, doit être écrit comme %%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 l'exemple de modèle HTML fourni à droite de la section Corps. Le contenu de cet exemple peut être collé directement dans la section Corps et modifié si nécessaire.

Exemple de modèle de courriel d'alarme complète

Définition de l'objet :

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

Résultat d'un travail : SKOOR Engine - Alarm from Deviceprinter on Device printer -- State : Major Event : AlarmOpened
Résultat pour un SLO : SKOOR Engine - Alarme du département d'impression du SLO sur l'imprimante de l'appareil -- État : Événement majeur : AlarmOpened : Major Event : AlarmOpened

Définition du corps du message :

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 effectivement reçu serait alors (pour l'exemple SLO ci-dessus) :

Common :
========
+--------------------------------------------------------------------
# Type d'événement : AlarmOpened
# Device : printer
# Reason : SLO 'Printing department' est dans l'état 'Major' car le job 'Snmp sysName.0' sur 'printer' est dans l'état 'Major' car le code d'erreur est 5 (Timeout error) > 0 (No error)
+--------------------------------------------------------------------

Horodatage actuel : 2017.08.24 17:03:35 (MET)
Horodatage ouvert : 2017.08.24 17:03:35 (MET)
Durée : 0s
Commentaire :
Actuellement assigné :

Alarme sur l'objet : http://<SKOOR Engine-server>/?do=navigate-obj&type=SLO&id=93
Alarmes sur l'objet : http://<SKOOR Engine-server>/?do=navigate-alarm&type=SLO&id=93&alarmid=7189&ts=1385049815

Objet source (alarme de) :
============================
L'objet auquel le groupe/dispositif d'alarme est lié.

Nom : Service d'impression
Type : SLO
État : Major
Statistiques : Warning : 0
Minor : 0
Major : 1

Détail des statistiques : Le job 'Snmp sysName.0' est Major
Valeurs :

Adresse de l'appareil :
Nom de l'appareil :
Job info :
Limites de l'alarme :

Objet d'origine (cause de l'alarme)
============================
Le vrai coupable, la raison initiale

Nom : Snmp sysName.0
Type : Job
State : Major
Valeurs : Code d'erreur = 5 (erreur de délai)

Adresse de l'appareil : 10.1.0.156
Nom du périphérique : imprimante
Job Info : Timeout requesting from 10.1.0.156:161. (OID 1)
Limites de l'alarme : Warning : if Any
Code d'erreur <> 0 (pas d'erreur)
Major : si toutes les alarmes
Code d'erreur > 0 (pas d'erreur)

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

Exemple de modèle de fichier CSV d'alarme complète

Définition du sujet :

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 le sujet est pris en compte et le corps du message est ignoré. Pour les messages plus longs, utilisez uniquement le champ du corps du message et laissez le champ de l'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 à partir d'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 serveur SKOOR Engine skoorsrv:

ui_url          = https://skoorsrv