Documentation_Nagstamon/readme.md

77 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 licô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.