Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

La commande de notification notify-host-by-email permet d'envoyer un mail de notification sous le format suivant :

Image Removed
Panel

Image Added

Par défaut, la commande envoie le mail au serveur de mail local ( en ciblant "localhost" ).

Paramétrage

La commande utilise la définition suivante :

Code Block
languagetext
themeEmacs
$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$" --ack-author "$ACKAUTHOR$" 
--ack-data "$ACKDATA$" --downtime-comment "$HOSTDOWNTIMECOMMENT$" --downtime-author "$HOSTDOWNTIMEAUTHOR$" --first-notification-delay 
"$HOSTFIRSTNOTIFICATIONDELAY$" --notification-number "$HOSTNOTIFICATIONNUMBER$" --realm "$HOSTREALM$"

Données de configuration du script d'envoi de mail

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


Info
titleEnvoie 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.

Données de configuration du script d'envoi de mail

Excerpt Include
Utilisation des méthodes de notifications MAIL livrées par Shinken
Utilisation des méthodes de notifications MAIL livrées par Shinken
nopaneltrue

NomModifiable sur DéfautDescription
No Format
MAILURL

/etc/shinken/resource.d/email.cfg

http://127.0.0.1:7767

L'adresse de l'UI de visualisation de Shinken. (dans le but par exemple de donner au contact un lien vers l'élément).

No Format
SENDER

/etc/shinken/resource.d/email.cfg

shinken@localhost

L'adresse mail de l'envoyeur, pour une notification mail.

No Format
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.

No Format
CONTACTEMAIL

l'utilisateur ( Onglet Général )

---email de l'utilisateur à notifier

Données de fonctionnement indispensable pour une notification minimal

Excerpt
NomModifiable sur Description
No Format
HOSTNAME

L'hôte ( Onglet Général )

Nom de l'hôte

No Format
NOTIFICATIONTYPE
---

non modifiable

Le type de notification à envoyer. Cela correspond au type d'événement qui a été constaté sur l'élément.

Type de notification Description
PROBLEM   

Le statut de l'élément est non OK.

RECOVERY   

L'élément avait un problème, mais est de nouveau dans un statut OK.

ACKNOWLEDGEMENT 

Un utilisateur a envoyé par l'interface web un accusé de réception par rapport à un problème survenu à un hôte ou à un check. Indique le nom et le motif de la prise en compte.

FLAPPINGSTART

L'élément est entré d'un contexte de FLAPPING.

FLAPPINGSTOP

L'élément est sorti d'un contexte de FLAPPING.

FLAPPINGDISABLED 

 La détection a été désactivée pendant la durée du FLAPPING.

DOWNTIMESTART

L'élément est entré d'une période programmée d'indisponibilité. Indique le nom et le motif de l'arrêt

DOWNTIMESTOP

L'élément est sorti d'une période programmée d'indisponibilité.

DOWNTIMECANCELLED 

La période programmée d'indisponibilité de l'élément a été annulée en cours.



No Format
HOSTADDRESS

L'hôte ( Onglet Général )

Adresse

de l'hôte
No Format
HOSTUUID

---

UUID

de l'hôte

, généré par Shinken lors de sa création

No Format
HOSTSTATE
---

non modifiable

État courant de l'hôte (

UP, DOWN, ou UNREACHABLE

OK, CRITICAL )

Données pour compléter l'affichage du contenu du mail

NomModifiable sur Description
No Format
LASTHOSTSTATECHANGE

---

Etat précédent de l'hôte

No Format
LASTHOSTSTATEID

---

ID de l'état précédent de l'hôte

No Format
HOSTFIRSTNOTIFICATIONDELAY

L'hôte ( Onglet Notifications )

Nombre de minutes à attendre avant d'envoyer la première notification pour un service

No Format
HOSTNOTIFICATIONNUMBER

---

Nombre actuel de notifications pour cet événement

No Format
HOSTREALM

L'hôte ( Onglet Général )

Nom du royaume auquel appartient l'hôte

No Format
HOSTOUTPUT

---

La sortie du check à l'origine de la notification

No Format
LONGHOSTOUTPUT

---

La sortie longue du check à l'origine de la notification

No Format
DATE

---

La date d'exécution de la commande

No Format
TIME

---

L'heure d'exécution de la commande

No Format
ACKAUTHOR

---

L'auteur du contexte "Prise en compte"

No Format
ACKDATA

---

Le message d'un contexte "Prise en compte"

No Format
HOSTDOWNTIMECOMMENT

---

Le commentaire de la période programmée d'indisponibilité

No Format
HOSTDOWNTIMEAUTHOR

---

L'auteur de la période programmée d'indisponibilité

Excerpt Include
notify-host-by-email-with-images - Commande de notification
notify-host-by-email-with-images - Commande de notification
nopaneltrue

Exemples

Notification type - PROBLEM

Panel
Image Removed

Image Added

Notification type - RECOVERY

Panel

Image RemovedImage Added