Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbookhtml	truefalse
scroll-eclipsehelpdocbook	true
scroll-epubeclipsehelp	true
scroll-htmlepub	true

Panel

title	Sommaire

Table of Contents

style	none

Contexte

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

Panel
Image RemovedImage Added

Paramétrage

La commande utilise la définition suivante :

Code Block

language	text
theme	Emacs

$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$"

Données communes

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

title	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

Excerpt Include

	Utilisation des méthodes de notifications MAIL livrées par Shinken
	Utilisation des méthodes de notifications MAIL livrées par Shinken
nopanel	true

Données de fonctionnement indispensable pour une notification minimal

Excerpt

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription

No Format
MAILURL

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

---

http://127.0.0.1:7767

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

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/var/lib/shinken/libexec/notifications

Le répertoire dans lequel se trouve la commande de notification à exécuter.

Données de fonctionnement

Nom

Modifiable sur

Description

No Format

CONTACTEMAIL

l'utilisateur ( Onglet Général ) No Format

email de l'utilisateur à notifier

HOSTNAME

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

nom

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

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

)FLAPPINGSTART, FLAPPINGSTOP (

. 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

entré ou

sorti d'un contexte de FLAPPING

)

.

FLAPPINGDISABLED

FLAPPINGDISABLED (

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

)DOWNTIMESTART, DOWNTIMESTOP (

.
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

entré ou

sorti d'une période programmée d'indisponibilité

)DOWNTIMECANCELLED (

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

)

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

Nom du royaume auquel appartient l'hôte

No Format

.

No Format

HOSTREALM

HOSTADDRESS

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

Adresse de l'hôte

No Format
SERVICEDESC

Le check ( Onglet Général )

Nom

/description

du check

No Format
DATE

---

La date d'exécution de la commande

No Format
TIME

---

L'heure d'exécution de la commande

No Format
SERVICESTATE

---

non modifiable

État courant du check ( OK, WARNING, UNKNOWN, CRITICAL )

No Format
LASTSERVICESTATEID

---

Numéro correspondant à l'état précédent du check ( 0=UP, 1=DOWN, ou 2=UNREACHABLE )

No Format
LASTSERVICESTATECHANGE

---

Date au format timestamp du dernier changement d'état du check

No Format
SERVICEOUTPUT

---

Résultat de la dernière vérification du check

No Format
SERVICEFIRSTNOTIFICATIONDELAY

---

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

No Format
SERVICENOTIFICATIONNUMBER

---

N° d'ordre d'une notification pour un événement donné

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

NomModifiable sur Description

No Format
LONGSERVICEOUTPUT

Résultat long de la dernière vérification du check

No Format
ACKAUTHOR

---

L'auteur du contexte "Prise en compte"

No Format
ACKDATA

---

Le message d'un contexte "Prise en compte"

No Format
SERVICEDOWNTIMECOMMENT

---

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

No Format
SERVICEDOWNTIMEAUTHOR

---

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

Excerpt Include

	notify-service-by-email-with-images - Commande de notification
	notify-service-by-email-with-images - Commande de notification
nopanel	true

Exemple

Notification type - PROBLEM

Panel
Image RemovedImage Added

Notification type - RECOVERY

Image Added Panel

Image Removed

Page tree

Versions Compared

Old Version 7

New Version Current

Key

Contexte

Paramétrage

Données communes

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

Données de fonctionnement indispensable pour une notification minimal

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

Exemple

Notification type - PROBLEM

Notification type - RECOVERY