diff --git a/images/filtres.png b/images/filtres.png new file mode 100644 index 0000000..5875b43 Binary files /dev/null and b/images/filtres.png differ diff --git a/images/serveur-configuration.png b/images/serveur-configuration.png new file mode 100644 index 0000000..833271d Binary files /dev/null and b/images/serveur-configuration.png differ diff --git a/images/serveurs.png b/images/serveurs.png new file mode 100644 index 0000000..c12d5a4 Binary files /dev/null and b/images/serveurs.png differ diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..8fe59f8 --- /dev/null +++ b/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. +