Contexte
La commande de notification notify-host-by-email-with-images 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$/host_alert_title_template.tpl --content-tpl $NOTIFPLUGINDIR$/host_alert_content_template.tpl -F "$SENDER$" -r "$CONTACTEMAIL$" -n $NOTIFICATIONTYPE$ -H "$HOSTNAME$" --address "$HOSTADDRESS$" --url $MAILURL$ --huuid $HOSTUUID$ --state $HOSTSTATE$ --last-state $LASTHOSTSTATEID$ --last-change $LASTHOSTSTATECHANGE$ --last-check "$DATE$ $TIME$" --output "$HOSTOUTPUT$" --long-output "$LONGHOSTOUTPUT$" --with-images --ack-author "$ACKAUTHOR$" --ack-data "$ACKDATA$" --downtime-comment "$HOSTDOWNTIMECOMMENT$" --downtime-author "$HOSTDOWNTIMEAUTHOR$" --first-notification-delay "$HOSTFIRSTNOTIFICATIONDELAY$" --notification-number "$HOSTNOTIFICATIONNUMBER$" --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 ) )
L'option "--with-images" d'afficher les STATUTS et CONTEXTES en image.
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 | ||||||||||||||||||||||
HOSTSTATE | non modifiable | État courant de l'hôte ( OK, 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 |
LASTHOSTSTATECHANGE | non modifiable | Etat précédent de l'hôte |
LASTHOSTSTATEID | non modifiable | ID de l'état précédent de l'hôte |
HOSTFIRSTNOTIFICATIONDELAY | L'hôte ( Onglet Notifications ) | Nombre de minutes à attendre avant d'envoyer la première notification pour un service |
HOSTNOTIFICATIONNUMBER | non modifiable | Nombre actuel de notifications pour cet événement |
HOSTREALM | L'hôte ( Onglet Général ) | Nom du royaume auquel appartient l'hôte |
HOSTOUTPUT | non modifiable | La sortie du check à l'origine de la notification |
LONGHOSTOUTPUT | non modifiable | La sortie longue du check à l'origine de la notification |
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" |
HOSTDOWNTIMECOMMENT | non modifiable | Le commentaire de la période programmée d'indisponibilité |
HOSTDOWNTIMEAUTHOR | non modifiable | L'auteur de la période programmée d'indisponibilité |
Exemples
Notification type - PROBLEM
Notification type - RECOVERY
