Configurer Shinken avec WEBUI2

Nous allons voir ici comment installer et paramétrer l’interface graphique webui2 pour détenir une vue plus user friendly de nos résultats.

Shinken peut s’interfacer avec des outils déjà existants sur le marché comme Incinga, Thruk ou encore Centreon. Mais je préfère dans un premier temps utiliser l’application front conçue par ses fondateurs !

L’interface graphique a besoin d’un paquet python à installer de la manière suivante :

  • pip install "pymongo>=3.0.3" request arrow "bottle==0.12.8"

Si jamais celui-ci est manquant, il sera alors impossible d’accéder à l’interface graphique via le port 7767 qui ne sera pas ouvert. En consultant le fichier brokerd.log, vous devriez voir apparaître le message d’erreur suivant :

Configurer l’interface graphique

  1. Se connecter via le compte root : sudo su -
  2. Initialiser shinken : shinken --init
  3. Installer le module webui2 : shinken install webui2
  4. Se connecter avec le compte shinken : su - shinken
  5. Initialiser shinken : shinken --init
  6. Installer le module auth-cfg-password : shinken install auth-cfg-passworLe pack auth-cfg-password permet une authentification simple basée sur le mot de passe enregistré dans la configuration du contact (/etc/shinken/contacts/)
  7. Installer le module mod-mongodb : shinken install mod-mongoldb
  8. Vérifier les droits dans le répertoire de logs (/var/log/shinken) avec le compte root
  9. Changer le propriétaire du fichier arbiter.log pour qu’il appartienne à l’utilisateur shinken
    sudo chown shinken:shinken /var/log/shinken
  10. Editer le fichier broker-master.cfg
    sudo vim /etc/shinken/brokers/broker-master.cfg

    1. Ajouter, à la ligne 40,webui2” à côté du mot “modules
      Pour atteindre une ligne sous vi, il suffit d’utiliser la ponctuation « » suivi du numéro de ligne. Par exemple :40. Puis de validez avec la touche Entrée.
  11. Ouvrir en sudo, le fichier /etc/shinken/modules/webui2.cfg avec l’éditeur vim
    1)
    Taper :set fileformat=unix
    2) 
    Taper :wq!
    Cela permet d’enlever les caractères de fin de ligne Windows sous la forme ^M
    Editer ce même fichier avec l’éditeur de votre choix à la ligne 90
    3)
    Ajouter derrière le mot modules « auth-cfg-password,mongodb»
  12. Editer le fichier /etc/shinken/shinken.cfg
    1) 
    Décommenter les lignes suivantes : (enlever le symbole #)

    • use_timezone=Europe/Paris
    • shinken_user=shinken
    • shinken_group=shinken
    • log_level = WARNING (2) Changer WARNING en DEBUG)
  13. Redémarrer le service shinken : sudo service shinken restart
  14. Patienter quelques instants…
  15. Lancer l’interface à partir d’un navigateur web via l’url http://localhost:7767
    Attention à changer le compte de connexion par défaut (admin: admin)