Vous êtes ici:

Menu

Stacks Image 88996
Article en attente de mise à jour
@import((rwml-menu))

Thruk

Stacks Image 2659
Thruk est une interface web de supervision permettant de se connecter à de multiples brokers. Dans notre exemple, nous utiliserons une infime partie des fonctionnalités de Thruk. Le but étant de faciliter la tâche de l'administrateur de la supervision en affichant la configuration du poller comme une interface web de Nagios.
Thruk is a Web interface of supervision allowing to connect to multiple brokers.In our example, we will use a fraction of the features of Thruk. The purpose being to facilitate the task of the administrator of the supervision by displaying the configuration of the poller as a Nagios Web interface.

Installation

Nous pouvons prendre l'architecture distribuée présenté sur ce site. Mais il est possible d'utiliser un serveur Standalone. Nous installerons plus précisément Thruk sur le serveur satellite ayant un poller sous Centreon-Engine.

Pré requis

Il faut installer les paquets suivants avant d'installer le binaire deb version 1.8 de thruk.

apt-get install apache2 apache2-mpm-worker libcairo2 libmysqlclient18 libxcb-render0 libxcb-shm0 libxrender1 mysql-common libapache2-mod-fcgid libaudit0 libgd2-xpm libxaw7 libxkbfile1 libxmu6 libxpm4 x11-xkb-utils xfonts-base xserver-common xvfb

Installation de thruk

Récupérer le binaire adéquat à votre distribution sur le site de Thruk à cette adresse http://www.thruk.org/download.html. Déposez ce fichier dans /usr/local/src et installez celui-ci avec la commande dpkg.
dpkg -i thruk_1.80-3_debian7_i386.deb
Sélection du paquet thruk précédemment désélectionné.
(Lecture de la base de données... 49657 fichiers et répertoires déjà installés.)
Dépaquetage de thruk (à partir de thruk_1.80-3_debian7_i386.deb) ...
Paramétrage de thruk (1.80-3) ...
plugins enabled: business_process conf minemap mobile panorama reports2 shinken_features statusmap
Module alias already enabled
Module fcgid already enabled
Module auth_basic already enabled
Enabling module rewrite.
To activate the new configuration, you need to run:
  service apache2 restart
[ ok ] Reloading web server config: apache2.
Thruk has been configured for http://debian7/thruk/. User and password is 'thrukadmin'...

Installation du broker mk livestatus

Thruk a besoin d'une communication avec le moteur de supervision du poller. Nous utiliserons un broker spécifique mk livestatus. Celui-ci est relativement simple à mettre en place. De plus Centreon autorise, dans sa configuration, l'utilisation de plusieurs brokers. Nous allons compilez le broker en saisissant les lignes ci-dessous :
cd /usr/local/src
wget http://mathias-kettner.de/download/mk-livestatus-1.2.2p3.tar.gz
tar -xzf mk-livestatus-1.2.2p3.tar.gz 
cd mk-livestatus-1.2.2p3
./configure
make
cp src/livestatus.o /usr/local/centreon-engine/bin

Configuration du poller

Pour autoriser Thruk à accéder au socket du broker mk livestatus, nous devons ajouter le groupe www-data du service apache2 dans le groupe centreon-engine. Ne pas oublier de redémarrer apache pour qu'il prenne en compte cette modification.
usermod -aG centreon-engine www-data
service apache2 restart

Installation

We can take distributed architecture presented on this site. But it is possible to use a standalone server. We set more exactly Thruk on the server with a satellite poller with Centreon-Engine.

Prerequisites

You must install the following packages before installing the binary deb thruk 1.8.

apt-get install apache2 apache2-mpm-worker libcairo2 libmysqlclient18 libxcb-render0 libxcb-shm0 libxrender1 mysql-common libapache2-mod-fcgid libaudit0 libgd2-xpm libxaw7 libxkbfile1 libxmu6 libxpm4 x11-xkb-utils xfonts-base xserver-common xvfb

Installing thruk

Get the appropriate binary for your distribution on Thruk site at this address http://www.thruk.org/download.html. Place this file in /usr/local/src et and install it with dpkg.
dpkg -i thruk_1.80-3_debian7_i386.deb
Sélection du paquet thruk précédemment désélectionné.
(Lecture de la base de données... 49657 fichiers et répertoires déjà installés.)
Dépaquetage de thruk (à partir de thruk_1.80-3_debian7_i386.deb) ...
Paramétrage de thruk (1.80-3) ...
plugins enabled: business_process conf minemap mobile panorama reports2 shinken_features statusmap
Module alias already enabled
Module fcgid already enabled
Module auth_basic already enabled
Enabling module rewrite.
To activate the new configuration, you need to run:
  service apache2 restart
[ ok ] Reloading web server config: apache2.
Thruk has been configured for http://debian7/thruk/. User and password is 'thrukadmin'...

Installing the broker mk livestatus

Thruk requires a communication with the supervisor engine of the poller. We will use a specific broker livestatus mk. It is relatively simple to implement. Centreon allows the use of multiple brokers. We will compile the broker by entering the following lines:
cd /usr/local/src
wget http://mathias-kettner.de/download/mk-livestatus-1.2.2p3.tar.gz
tar -xzf mk-livestatus-1.2.2p3.tar.gz 
cd mk-livestatus-1.2.2p3
./configure
make
cp src/livestatus.o /usr/local/centreon-engine/bin

Poller configuration

We must add the group www-data of apache service in the group centreon-engine to allow Thruk access to the socket mk livestatus broker. Do not forget to restart apache for it to take into account this change.
usermod -aG centreon-engine www-data
service apache2 restart

Configuration

Configuration lite sans Centreon

Il est possible d'utiliser le moteur Centreon-Engine sans l'interface Centreon et son broker Centreon-broker. Il faudra configurer, en ligne de commande, les fichiers de configuration.
Rajoutez ces deux lignes dans le fichier /usr/local/centreon-engine/etc/centengine.cfg
broker_module=/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so
broker_module=/usr/local/centreon-engine/bin/livestatus.o /var/lib/centreon-engine/rw/live
Vérifiez le chemin des plugins pour centreon-engine dans le fichier /usr/local/centreon-engine/etc/resource.cfg
$USER1$=/usr/local/plugins/libexec
Redémarrez Centren-Engine
service centreon-engine restart

Configuration avec Centreon

Il faut rajouter le broker mk livestatus dans la configuration du poller. Nous utiliserons l'interface Web de Centreon pour réaliser cette configuration. Sélectionner le menu Configuration / Monitoring Engines / main.cfg. Cliquez sur la configuration du satellite (Satellite Engine CFG 1). Cliquez sur l'onglet Data.
thruk01-fr
Ajouter un nouveau broker et saisir la ligne ci-dessous
/usr/local/centreon-engine/bin/livestatus.o /var/lib/centreon-engine/rw/live
Appliquez cette configuration au poller. Vous pouvez vérifier le bon fonctionnement du broker en saisissant la ligne ci-dessous sur le serveur satellite.
root@poller-broker: tail -f /var/log/centreon-engine/centengine
Vous obtiendrez les lignes suivantes :

[1363676307] Event broker module '/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so' deinitialized successfully.

[1363676308] Event broker module '/usr/local/centreon-broker/lib/cbmod.so' deinitialized successfully.

[1363676308] Centreon Engine 1.3.0 starting ... (PID=30072)

[1363676308] Local time is Tue Mar 19 07:58:28 CET 2013

[1363676308] LOG VERSION: 2.0

[1363676308] Event broker module '/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so' initialized successfully.

[1363676308] Centreon Broker: log applier: applying 1 logging objects

[1363676308] Event broker module '/usr/local/centreon-broker/lib/cbmod.so' initialized successfully.

[1363676308] livestatus: Livestatus 1.2.0p4 by Mathias Kettner. Socket: '/var/lib/centreon-engine/rw/live'

[1363676308] livestatus: Please visit us at http://mathias-kettner.de/

[1363676308] livestatus: Hint: please try out OMD - the Open Monitoring Distribution

[1363676308] livestatus: Please visit OMD at http://omdistro.org

[1363676308] livestatus: Cannot open log archive ''

[1363676308] livestatus: Finished initialization. Further log messages go to /var/log/centreon-engine/livestatus.log

[1363676308] Event broker module '/usr/local/centreon-engine/bin/livestatus.o' initialized successfully.

[1363676308] TIMEPERIOD TRANSITION: 24x7;-1;1

[1363676308] TIMEPERIOD TRANSITION: none;-1;0

[1363676308] TIMEPERIOD TRANSITION: nonworkhours;-1;1

[1363676308] TIMEPERIOD TRANSITION: workhours;-1;0

[1363676308] INITIAL HOST STATE: Satellite;UP;HARD;1;OK - 172.16.209.177: rta 0,036ms, lost 0%

[1363676308] INITIAL SERVICE STATE: Satellite;Disk-/;OK;HARD;1;Disk OK - / TOTAL: 0.315GB USED: 0.119GB (37%) FREE: 0.196GB (63%)

[1363676308] INITIAL SERVICE STATE: Satellite;Load;OK;HARD;1;Load average: 0.00, 0.00, 0.00.

[1363676308] INITIAL SERVICE STATE: Satellite;Memory;OK;HARD;1;Total memory used : 13% ram used : 92%, swap used 0%

[1363676308] INITIAL SERVICE STATE: Satellite;Ping;OK;HARD;1;OK - 172.16.209.177: rta 0,018ms, lost 0%

Configuration de Thruk

Première connexion

Il s'agit maintenant de se connecter à l'interface Web de Thruk. Pour cela, nous utiliserons notre navigateur préféré. Saisissez l'adresse du serveur Satellite suivi de thruk, comme ceci :

http://[ip serveur satellite]/thruk

thruk02
Saisir l'utilisateur admin par défaut thrukadmin mot de passe thrukadmin. Il va de soi qu'il faudra rapidement changer le mot de passe !
thruk03
Vous obtenez la page de démarrage de Thruk. Pour configurer Thruk avec notre poller, cliquez sur Config Tool.
thruk04
Il faut configurer le broker du poller sur cette page.
thruk05

Name : satellite
Connection : /var/lib/centreon-engine/rw/live
thruk06
On peut vérifier la connexion au broker en cliquant sur le bouton test.
thruk07
Cliquez sur le bouton Save Changes pour appliquer la configuration. Un bandeau vert s'affiche un court instant avant de rendre la main.
thruk08
Vous obtenez une interface similaire à l'interface web de Nagios avec de nombreuses améliorations.

Changement du mot de passe admin

Pour des raisons de sécurité évidentes, il est nécessaire de changer le mot de passe de l'utilisateur truckadmin. Avant de le réaliser sur l'interface graphique de Thruk, il va falloir modifier quelques permissions de fichier.
cd /etc/thruk
chmod 660 htpasswd
chown www-data:www-data htpassword
chmod 660 cgi.cfg
chown www-data:www-data cgi.cfg
Ensuite, cliquez sur le menu Config Tool puis User settings.
thruk09
Dans le champ Username saisissez thrukadmin ou sélectionnez le dans la liste proposée
thruk10
Vous pouvez changer son mot de passe.
Ainsi se termine cet article, vous avez une interface web conviviale pour vérifier le fonctionnement de votre poller.

Configuration

Lite configuration without Centreon

It's possible to use Centreon-Engine without Centreon Web and his Centreon-broker. It will configure command line, configuration files.
Add these two lines in the file /usr/local/centreon-engine/etc/centengine.cfg
broker_module=/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so
broker_module=/usr/local/centreon-engine/bin/livestatus.o /var/lib/centreon-engine/rw/live
Check the path for plugin's centreon-engine in the file /usr/local/centreon-engine/etc/resource.cfg
$USER1$=/usr/local/plugins/libexec
Restart Centren-Engine
service centreon-engine restart

Centreon Configuration

You must add the broker mk livestatus in the poller configuration. We will use the Centreon web interface for this configuration. Select the Configuration / Monitoring Engines / main.cfg. Click on the satellite configuration (CFG Satellite Engine 1). Click the Data tab.
thruk01-en
Add a new broker and enter the following line :
/usr/local/centreon-engine/bin/livestatus.o /var/lib/centreon-engine/rw/live
Apply this configuration to the poller. You can check the proper operation of the broker by entering the following line to the satellite server.
root@poller-broker: tail -f /var/log/centreon-engine/centengine
You will get the following lines :

[1363676307] Event broker module '/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so' deinitialized successfully.

[1363676308] Event broker module '/usr/local/centreon-broker/lib/cbmod.so' deinitialized successfully.

[1363676308] Centreon Engine 1.3.0 starting ... (PID=30072)

[1363676308] Local time is Tue Mar 19 07:58:28 CET 2013

[1363676308] LOG VERSION: 2.0

[1363676308] Event broker module '/usr/local/centreon-engine/lib/centreon-engine/externalcmd.so' initialized successfully.

[1363676308] Centreon Broker: log applier: applying 1 logging objects

[1363676308] Event broker module '/usr/local/centreon-broker/lib/cbmod.so' initialized successfully.

[1363676308] livestatus: Livestatus 1.2.0p4 by Mathias Kettner. Socket: '/var/lib/centreon-engine/rw/live'

[1363676308] livestatus: Please visit us at http://mathias-kettner.de/

[1363676308] livestatus: Hint: please try out OMD - the Open Monitoring Distribution

[1363676308] livestatus: Please visit OMD at http://omdistro.org

[1363676308] livestatus: Cannot open log archive ''

[1363676308] livestatus: Finished initialization. Further log messages go to /var/log/centreon-engine/livestatus.log

[1363676308] Event broker module '/usr/local/centreon-engine/bin/livestatus.o' initialized successfully.

[1363676308] TIMEPERIOD TRANSITION: 24x7;-1;1

[1363676308] TIMEPERIOD TRANSITION: none;-1;0

[1363676308] TIMEPERIOD TRANSITION: nonworkhours;-1;1

[1363676308] TIMEPERIOD TRANSITION: workhours;-1;0

[1363676308] INITIAL HOST STATE: Satellite;UP;HARD;1;OK - 172.16.209.177: rta 0,036ms, lost 0%

[1363676308] INITIAL SERVICE STATE: Satellite;Disk-/;OK;HARD;1;Disk OK - / TOTAL: 0.315GB USED: 0.119GB (37%) FREE: 0.196GB (63%)

[1363676308] INITIAL SERVICE STATE: Satellite;Load;OK;HARD;1;Load average: 0.00, 0.00, 0.00.

[1363676308] INITIAL SERVICE STATE: Satellite;Memory;OK;HARD;1;Total memory used : 13% ram used : 92%, swap used 0%

[1363676308] INITIAL SERVICE STATE: Satellite;Ping;OK;HARD;1;OK - 172.16.209.177: rta 0,018ms, lost 0%

Thruk Configuration

first connection

It is now connect to the web interface Thruk. For this, we will use our preferred browser. Enter the server address Satellite with thruk like this:

http://[ip satellite server]/thruk

thruk02
Enter the default admin user password thrukadmin thrukadmin. It will quickly change the password!
thruk03
You get the start page of Thruk. To configure Thruk with our poller, click Config Tool.
thruk04
You must configure the broker's poller on this page.
thruk05

Name : satellite
Connection : /var/lib/centreon-engine/rw/live
thruk06
You can check the connection to the broker by pressing the test button.
thruk07
Click Save Changes to apply the configuration. A green band is shown for a short time before returning.
thruk08
You get an interface similar to the Nagios web interface with many improvements.

Changing the admin password

For obvious security reasons, it is necessary to change the password of the user truckadmin. Before realizing the GUI Thruk, you will have to change some file permissions.
cd /etc/thruk
chmod 660 htpasswd
chown www-data:www-data htpassword
chmod 660 cgi.cfg
chown www-data:www-data cgi.cfg
Then click the menu Config Tool and User settings.
thruk09
In the Username field enter thrukadmin or select it from the list.
thruk10
You can change the password.
This article is complete, you have a web interface to check the operation of your poller.
comments powered by Disqus
 Vous êtes ici: