Ajouter un modèle d'alarme

Pour ajouter un modèle d'alarme, accédez à /root/Alarming et sélectionnez Ajouter un modèle d'alarme dans le menu déroulant Modèles d'alarme ou en cliquant sur l'icône à gauche du menu déroulant :

Entrez un nom et un 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, etc.), le deuxième ensemble de balises, les balises d'objet source, décrit l'objet auquel le dispositif d'alarme ou le groupe d'alarme est lié, tandis que le troisième ensemble de balises, les balises d'objet d'origine, décrit l'objet qui a réellement déclenché l'alarme.

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

Les alarmes sont envoyées au format texte brut par défaut. Si vous le souhaitez, les alarmes peuvent également être envoyées au format HTML. Pour ce faire, la section Corps 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é 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 une tâche : SKOOR Engine - Alarme provenant de Deviceprinter sur l'imprimante Device -- État : Événement majeur : AlarmOpened
Résultat pour un SLO : SKOOR Engine - Alarme provenant du service d'impression SLO sur l'imprimante Device -- État : Événement majeur : 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 effectivement reçu serait alors (pour l'exemple SLO ci-dessus) :

Commun :
========
+--------------------------------------------------------------------#
Type d'événement :
AlarmOpened# Périphérique :
imprimante# Raison : le SLO « Service d'impression » est dans l'état « Major » car la tâche « Snmp sysName.0 » sur « imprimante » est dans l'état « Major » car le code d'erreur est 5 (erreur de délai d'attente) > 0 (aucune erreur)
+--------------------------------------------------------------------

Horodatage actuel : 24/08/2017 17:03:35 (MET)
Horodatage d'ouverture : 24/08/2017 17:03:35 (MET)
Durée : 0 s
Commentaire :
Actuellement attribué : Objet

d'alarme : 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 provenant de) :
============================
Objet auquel le groupe d'alarme/périphérique est lié

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

Détails des statistiques : La tâche « Snmp sysName.0 » est Major
Valeurs : Adresse

du périphérique : Nom
du périphérique : Informations
sur la tâche :
Limites d'alarme : Objet

d'origine (cause de l'alarme)
============================
Le véritable coupable, raison initiale

Nom : Snmp sysName.0
Type : Tâche
État : Major
Valeurs : Code d'erreur = 5 (erreur de délai d'attente) Adresse

du périphérique : 10.1.0.156 Nom
du périphérique : imprimante Informations
sur la tâche : Délai d'attente de la requête de 10.1.0.156:161. (OID 1) Limites
d'alarme : Warning : si code
d'erreur <> 0 (aucune erreur)
Major : si code
d'erreur > 0 (aucune erreur)

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 des alarmes de l'objet.

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

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 SMS, seul l'objet sera pris en compte et le corps sera 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 : Alarme 2017.08.24 13:59:50 (Europe/Zurich) AlarmSeverityUp Icmp sur localhost

Configuration URL pour les balises %u et %U

Pour pouvoir ouvrir un objet dans SKOOR Engine directement à partir d'un message d'alarme, l'URL 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