Contexte
La commande de notification notify-service-by-email permet d'envoyer un mail de notification sous le format suivant :
Paramétrage
La commande utilise la définition suivante :
$NOTIFPLUGINDIR$/notify_by_email.py --title-tpl $NOTIFPLUGINDIR$/service_alert_title_template.tpl --content-tpl $NOTIFPLUGINDIR$/service_alert_content_template.tpl -F "$SENDER$" -r "$CONTACTEMAIL$" -n $NOTIFICATIONTYPE$ -H "$HOSTNAME$" --address "$HOSTADDRESS$" --url $MAILURL$ --huuid $HOSTUUID$ --serviceuuid $SERVICEUUID$ --check "$SERVICEDESC$" --state $SERVICESTATE$ --last-state $LASTSERVICESTATEID$ --last-change $LASTSERVICESTATECHANGE$ --last-check "$DATE$ $TIME$" --output "$SERVICEOUTPUT$" --long-output "$LONGSERVICEOUTPUT$" --ack-author "$ACKAUTHOR$" --ack-data "$ACKDATA$" --downtime-comment "$SERVICEDOWNTIMECOMMENT$" --downtime-author "$SERVICEDOWNTIMEAUTHOR$" --first-notification-delay "$SERVICEFIRSTNOTIFICATIONDELAY$" --notification-number "$SERVICENOTIFICATIONNUMBER$" --realm "$HOSTREALM$"
Les commandes utilisent le mécanisme des Variables pour recevoir les informations spécifiques à l'élément de la notification ( voir la page Les Variables ( Remplacement dynamique de contenu - Anciennement les Macros ) )
Envoie vers un serveur de mail différent de localhost
A noter que l'option -S, permettant d'envoyer le mail vers un serveur mail différent de "localhost", n'est pas présente dans la commande.
- Pour éviter tout conflit lors des prochaines livraisons de Shinken, nous vous conseillons de faire une copie de la méthode de notification et de cette commande pour faire les votres ( Voir la page Créer une méthode de notification spécifique - bonnes pratiques ).
Données de configuration du script d'envoi de mail
| Nom | Modifiable sur | Défaut | Description |
|---|---|---|---|
MAILURL | /etc/shinken/resource.d/email.cfg | L'adresse de l'UI de Visualisation de Shinken ( dans le but par exemple de donner au contact un lien vers l'élément ). | |
SENDER | /etc/shinken/resource.d/email.cfg | shinken@localhost | L'adresse mail de l'envoyeur, qui apparait dans le mail ( l'émetteur du mail ). |
NOTIFPLUGINDIR | /etc/shinken/resource.d/email.cfg | /var/lib/shinken/libexec/notifications | Le répertoire dans lequel se trouve la commande de notification à exécuter. |
CONTACTEMAIL | l'utilisateur ( Onglet Général ) | --- | Email de l'utilisateur à notifier |
Données de fonctionnement indispensable pour une notification minimal
| Nom | Modifiable sur | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
HOSTNAME | L'hôte ( Onglet Général ) | Nom de l'hôte | ||||||||||||||||||||||
NOTIFICATIONTYPE | non modifiable | Le type de notification à envoyer. Cela correspond au type d'événement qui a été constaté sur l'élément.
| ||||||||||||||||||||||
HOSTADDRESS | L'hôte ( Onglet Général ) | Adresse de l'hôte | ||||||||||||||||||||||
SERVICEDESC | Le check ( Onglet Général ) | Nom du check | ||||||||||||||||||||||
SERVICESTATE | non modifiable | État courant du check ( OK, WARNING, UNKNOWN, CRITICAL ) |
Données pour compléter l'affichage du contenu du mail
| Nom | Modifiable sur | Description |
|---|---|---|
HOSTUUID | non modifiable | UUID de l'hôte, généré par Shinken lors de sa création |
SERVICEUUID | non modifiable | UUID du check, généré par Shinken lors de sa création |
LASTSERVICESTATEID | non modifiable | Numéro correspondant à l'état précédent du check ( 0=UP, 1=DOWN, ou 2=UNREACHABLE ) |
LASTSERVICESTATECHANGE | non modifiable | Date au format timestamp du dernier changement d'état du check |
SERVICEFIRSTNOTIFICATIONDELAY | non modifiable | Nombre de minutes à attendre avant d'envoyer la première notification pour un service |
SERVICENOTIFICATIONNUMBER | non modifiable | N° d'ordre d'une notification pour un événement donné |
HOSTREALM | L'hôte ( Onglet Général ) | Nom du royaume auquel appartient l'hôte |
SERVICEOUTPUT | non modifiable | Résultat de la dernière vérification du check |
LONGSERVICEOUTPUT | non modifiable | Résultat long de la dernière vérification du check |
DATE | non modifiable | La date d'exécution de la commande |
TIME | non modifiable | L'heure d'exécution de la commande |
ACKAUTHOR | non modifiable | L'auteur du contexte "Prise en compte" |
ACKDATA | non modifiable | Le message d'un contexte "Prise en compte" |
SERVICEDOWNTIMECOMMENT | non modifiable | Le commentaire de la période programmée d'indisponibilité |
SERVICEDOWNTIMEAUTHOR | non modifiable | L'auteur de la période programmée d'indisponibilité |
Exemple
Notification type - PROBLEM
Notification type - RECOVERY
