Commit initial, readme et images.

readme.md

@@ -0,0 +1,76 @@
+# Nagstamon
+
+Nous allons voir comment connecter nagstamon, une appliquette de bureau de notification d'alerte, au serveur icinga 2 et de filtrer les alertes pour ne garder que celles en rapport avec les services (nom de domaines) qui vous concernent.
+
+
+## Installation 
+
+Normalement Nagstamon est présent dans les dépôts de votre distribution GNU\Linux.
+
+Par exemple sur Debian avec les droits d'installation : 
+
+```bash
+
+apt install nagstamon
+
+```
+
+
+## Configuration 
+
+C'est la partie intéressante, mais nous n'irons (pour le moment) pas dans de la personnalisation avancée. 
+
+Tout d'abord vous devez vous munir de différentes choses : 
+- Adresse du serveur de l'interface web icinga 2.
+- Identifiant de connexion à l'interface web icinga 2.
+- Mot de passe de connexion à l'interface web icinga 2.
+- Une liste des nom de domaines pour lesquels vous voulez des alertes. 
+
+
+Au premier lancement vous devriez tomber directement sur l'interface (fenêtre flottante) permettant l'ajout des serveurs. 
+
+![](images/serveurs.png)
+
+Dans le cas contraire depuis la fenêtre principale, accessible via l’icône de barre d'appliquettes, cliquez sur settings (possiblement présent dans le menu sandwich). Une fenêtre flottante doit alors apparaître.
+
+Cliquer sur 'New Server...'
+
+Dans la nouvelle fenêtre remplissez comme suis : 
+- Laissez 'enable' coché
+- Monitor type : IcingaWeb2 
+- Monitor name : Chalec (Mais c'est a votre discrétion, c'est purement visuel et pour vous)
+- Monitor url : L'adresse de l'interface web d'icinga 2
+- Username : Votre identifiant de connexion
+- Password : Votre mot de passe de connexion 
+- Save password : Je le coche mais cela dépend énormément de la sécurité de votre environnement et de votre politique de gestion des secrets. 
+- Use proxy : Ici encore cela dépend de votre configuration.
+- Show more option : je ne vais pas le traiter ici mais cela concerne l'authentification par certificat (entre autre) et des options visuelles. 
+
+![](images/serveur-configuration.png)
+
+Vous pouvez cliquez sur OK. 
+Cela devrait vous notifiez de toutes les alertes en cours sur le serveur d'interface icinga 2. 
+
+C'est assez gênant et cela entraîne un spam inutile pour l'administrateur en manque de temps. 
+
+La solution est de mettre en place des filtres basés par exemple sur les noms de domaines.
+
+Pour cela dans depuis l'écran de configuration (settings) il y a plusieurs onglets autre que "Servers", celui qui nous intéresse est l'onglet 'Filters'.
+
+Dans cet onglet il faut : 
+
+- Cocher "Regular expression for hosts"
+- Remplir le champs avec les nom de domaines séparés par le caractère "|",les habitués des expressions régulières auront reconnu le OU.
+Par exemple si vous voulez monitorer service-un.domaine.org, service-deux.domaine.org et service-trois.domaine.org cela donnera.
+```
+service-un.domaine.org|service-deux.domaine.org|service-trois.domaine.org 
+```
+- Finalement il faut cocher reverse.
+- Cliquer sur 'Ok'
+
+![](images/filtres.png)
+
+On aurait tout à fait pu mettre les noms de domaines des services non gérés et ne pas cocher "reverse" mais cela est moins résilient et demande de maintenir une plus grande liste. 
+
+Voilà, n'hésitez pas à explorer et tester pour adapter le comportement du logiciel à vos besoins.
+