Page History

Concept

Une des méthodes La méthode de notification, la plus efficace et rependu, est le mail.

• Shinken livre une solution clé en main pour envoyer vos mails lors des notifications,
• Les sous-pages suivantes expliqueront vous détailleront les différents formats de mail livré par Shinken.

Faire une commande d'essai

• Une fois que vous vous serez familiarisé avec, vous pourrez changer le modèle de mail de ces notifications.

Faire un essai de réception de mail

Commençons par faire un essai de l'envoi de mail en utilisant le script "notify_by_email.py" disponible dans une installation de Shinken.

Cela va permettre :

• de tester le bon fonctionnement de l'envoi de mail
• et vous permettre de voir le

• type de mail que vous pouvez recevoir

Exemple en ligne de commande

• par défaut.

Verification initial

Les notifications vont par défaut utiliser le serveur postfix local à la machine qui héberge le Reactionner.

• Vérifier que le serveur postfix est bien actif ( si besoin, voir la page Résolution des problèmes - Notification mail )

SI vous utilisez un autre serveur de mail, il suffira de changer l'adresse du serveur de mail à contacter ( voir plus bas ).

La ligne de commande votre premier mail

Nous commençons par une ligne de commande pour vous permettre d'envoyer un mail d'exemple,

• et donc vérifier la possibilité du script de mail de joindre le serveur de mail,
• ainsi qu'avoir un exemple de mail envoyé.

Pour celaPour vérifier le bon envoi de l'email, loguez-vous sur la machine qui héberge votre Reactionner puis utiliser le user shinken via :

su - shinken

Puis envoyer votre commande,utilisez la commande ci-dessous en remplaçant : 

• "--MAIL_SERVER--" par l'adresse du serveur de mail => par

• défaut, vous pouvez utiliser localhost, pour contacter le serveur postfix présent sur le Reactionner.
• "--CONTACT_EMAIL--" par votre adresse mail, pour que vous receviez le mail directement.
• "--SENDER--" par définir l'adresse mail de l'envoyeur ( exemple : shinken-supervision@mydomain.com ),
• "--WEBUI_URL--" pour l'address/port de la webui ( exemple: https://my-server:7767 )

/var/lib/shinken/libexec/notifications/notify_by_email.py -S "--MAIL_SERVER--" --title-tpl /var/lib/shinken/libexec/notifications/service_alert_title_template.tpl 
--content-tpl /var/lib/shinken/libexec/notifications/service_alert_content_template.tpl -F "MY@DOMAIN.COM--SENDER--" -r "my_email@mail.com--CONTACT_EMAIL--" 
-n PROBLEM -H "my--HOSTNAME-host-name" --address "my-server--HOST_ADDRESS--" --url http://my-server:7767"--WEBUI_URL--" --huuid "--HOSTUUID--" --check "my--CHECKNAME-check-name"  
--state CRITICAL --last-state 0 --last-change 1525338011.76 --last-check "03-05-2018 11:00:56" --output "Critical : memory consumption is too high 66%" --with-images

Vous devriez alors recevoir sur votre machine :

DATE,426:INFO: Mail sent successfully

Optionnellement, vous pouvez aussi remplacer :

• "--HOSTNAME--" pour le nom de l'hôte qui émet la notification.
• "--HOSTUUID--" pour un UUID de l'hôte qui émet la notification

Pour une expérience totale, il faut modifier dans la commande :

"MY@DOMAIN.COM" par la valeur de votre domaine d'email

"my-server" par l'adresse ip de votre serveur hébergeant le "Broker"

• ( voir la page TIPS - Récupérer l'UUID d'un élément ( Cluster / Hôte / Check ) )

• .
• "--HOST_ADDRESS--" pour l'adresse de l'hôte qui émet la notification.
• "--CHECKNAME--" pour le nom du

• check attaché sur l'hôte

• que vous aurez choisi.

La commande devrait vous afficher le message suivant :

YYYY-MM-JJ HH:MM:SS,Millisecondes:INFO: Mail sent successfully

et vous devriez recevoir un mail de cette forme :

Si vous avez modifié les informations optionnelles de notre test, vous pourrez,

• en cliquant sur "Detail view",
• ouvrir directement du mail, la vue détail concernant l'hôte ou le check :

Exemple en utilisant les méthodes de notifications livrées par Shinken

Si vous utilisez la méthode "email-with-images" ( voir la page email-with-images - Méthode de notification ) et qu'une notification se déclenche, vous obtiendrez un mail de la forme suivante