Introduction
Les notifications sont toutes manières d'informer les utilisateurs d'un changement de statut ou de contexte d'un hôte, check ou cluster.
Ces pages vont expliquer :
- la logique de notification ( quand, qui, comment ) ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Les notifications )
- une utilisation simple en utilisant les packs livrés par Shinken. ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Utilisation des méthodes de notifications livrées par Shinken )
- les escalades ( voir la page Escalade des notifications )
Dans une deuxième temps, il sera peut-être nécessaire d'avoir recours à une utilisation plus spécifique, pour cela un certain nombre de pages expliqueront :
- Comment faire vos propres méthodes de notifications ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Créer une méthode de notification spécifique - bonnes pratiques )
- Comment faire vos propres commandes de notifications ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Créer des commandes de notification spécifique - bonnes pratiques )
- Comment faire vos propres modèles de mail ( voir la page NEW_PAGE - 003.5.6 - SEF-11240 - Créer votre propre modèle de mail de notification )
Reactionner et réaction
Lorsque des objets supervisés changent d'état, et qu'ils sont paramétrés pour réagir à ce changement, alors le démon Reactionner permet d’exécuter une réaction.
Une réaction est une commande qui est paramétrée dans Shinken.
La réaction peut être :
- Une commande de notification
- Une commande du Gestionnaire d'événements
Dans ces pages, nous allons nous intéresser aux commandes de notification, et comment les personnaliser.
| Avant de commencer à lire cette page, il est important de comprendre que la commande de notification peut utiliser n'importe quels scripts placés sur votre Reactionner. Donc, potentiellement, la commande peut vous alerter de manière traditionnelle, en vous envoyant un email via une commande "mail", mais pourquoi pas en envoyant un message instantané via votre serveur Jabber, ou encore en faisant clignoter une LED branchée sur votre Raspberry! |
Problème
Tester votre commande
Si vous souhaitez envoyer une commande depuis votre Reactionner afin de vérifier le bon envoi de l'email, loguez-vous en shinken via :
su - shinken |
Puis envoyer votre commande, par exemple :
/var/lib/shinken/libexec/notifications/notify_by_email.py --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 "ENVOYEUR@DOMAIN.COM" -r "RECEVEUR@DOMAIN.COM" -n PROBLEM -H "mon-serveur" --address "172.16.0.10" --url http://172.16.0.10:7767 --huuid 7b0513f631a011e889e9080027da5b5c --check "Memory" --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%" --long-output "" --ack-author "" --ack-data "" |
Vous devriez alors recevoir :
DATE,426:INFO: Mail sent successfully |
Et vous devriez recevoir l'email dans votre boite email.
Logs
Si vous avez des difficultés, veuillez vérifier les logs :
- Du Réactionner dans /var/log/shinken/
- De votre serveur mail linux (postfix/smtp) dans /var/log/maillog
Configuration avancée (relais SMTP)
Si votre serveur SMTP principal est un serveur connu et généralisé dans votre architecture, vous pouvez aussi modifier votre configuration afin de relayer n'importe quel email vers ce serveur :
- Editer le fichier /etc/postfix/main.cf
- Modifier la ligne avec l'IP de votre serveur SMTP (ici 192.168.1.240) : relayhost = 192.168.1.240
Redémarrer postfix
service postfix restart
Test d'envoi de mail :
ls | mailx -s test mon.mail@shinkendom.local