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 la liste déroulante Modèles d'alarme ou en cliquant sur l'icône à gauche de la liste déroulante :

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

Si un signe de pourcentage doit être envoyé dans le message d'alarme, par exemple dans un lien encodé en URL, il doit être précédé d'un caractère "%". Le caractère "/" encodé dans l'URL (%2F) par exemple doit être écrit sous la forme %%2F

Les alarmes sont envoyées au format texte brut par défaut. Si vous le souhaitez, les alarmes peuvent également être envoyées en HTML. Pour ce faire, la section Corps doit commencer par une balise HTML. Comme point de départ, 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 y être modifié selon les besoins.

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

Définition du sujet :

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


Résultat d'une tâche : SKOOR Engine - Alarme de Deviceprinter sur l' imprimante de périphérique -- État : Événement Major : AlarmOpened
Résultat pour un SLO : SKOOR Engine - Alarme du service d'impression SLO sur l' imprimante de l'appareil -- État : Événement Major : Alarme ouverte

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) :

Commun:
========
+------------------------------------------------------------- -------------------
# Type d'événement : Alarme ouverte
# Périphérique : imprimante
# Raison : SLO 'Service d'impression' est à l'état ' Major ' car le travail 'Snmp sysName.0' sur 'imprimante' est à l'état ' Major ' car le code d'erreur est 5 (erreur de délai d'attente) > 0 (pas d'erreur)
+------------------------------------------------------------- -------------------

Horodatage Actuel : 2017.08.24 17:03:35 (MET)
Heure d'ouverture : 2017.08.24 17:03:35 (MET)
Durée : 0 s
Commentaire:
Actuellement affecté :

Objet alarmant : http://< SKOOR Engine - server >/?do=navigate-obj&type=SLO&id=93
Alarmes sur 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 d'alarmes/dispositif est lié

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

Détail des statistiques : le travail 'Snmp sysName.0' est Major
Valeurs:

Adresse de l'appareil :
Nom de l'appareil:
Informations sur l'emploi :
Limites d'alarme :

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

Nom : SNMP sysName.0
Type : Emploi
Etat : Major
Valeurs : code d'erreur = 5 (erreur de dépassement de délai)

Adresse de l'appareil : 10.1.0.156
Nom de l'appareil : imprimante
Infos sur la tâche : Délai d'expiration de la demande à partir de 10.1.0.156:161. (OID 1)
Limites d'alarme : Warning : le cas échéant
Code d'erreur <> 0 (pas d'erreur)
Major : le cas échéant
Code d'erreur > 0 (Pas d'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 d'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 séparé. En général, pour les modèles de SMS, seul le sujet 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 d'objet vide. Plusieurs SMS seront alors envoyés.

Définition du sujet :

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

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

Configuration d'URL pour les balises %u et %U

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