Zabbix, moniteur de supervision

La gestion d'un parc de serveur est un travail de chaque instant. Un bon administrateur système doit savoir à tout moment l'état des différentes machines et des différents services. Un autre aspect clé est que l'administrateur ne peut pas se permettre de passer son temps devant un tableau avec des voyants verts en attendant qu'un voyant passe au rouge pour agir. Son temps est occupé à d'autres tâches et il ne peut donc pas surveiller le tableau de statut en permanence.

L'examen journalier des logs systèmes est un bon début. Cependant, si un problème survient, on s'en rend compte seulement le lendemain. Ce qui peut être très (trop ?) tard.

Pour se simplifier le travail, nous allons utiliser un moniteur de supervision. Le but d'un tel programme est de surveiller les services et les machines se trouvant sous notre responsabilité. Si un problème survient, le moniteur de supervision nous prévient (email, SMS, etc.).

Le moniteur de supervision que nous allons envisager est Zabbix.

Pré-requis

  • Disposer des droits d'administration ;
  • Avoir activé l'accès aux dépôts Universe ;
  • Avoir un serveur Web installé et gérant le PHP et MySQL (ou PostgreSQL), voir la page « LAMP ».
  • positionner la variable date.timezone dans php.ini (par ex: /etc/php5/apache2/php.ini) : date.timezone = Europe/Paris (nous y reviendrons)

Installation

Installation du serveur Zabbix 2.0.2

installer les paquets :

  • zabbix-server-mysql pour utiliser une base MySQL ou zabbix-server-pgsql pour utiliser une base PostGRES ;
  • zabbix-frontend-php : l'interface PHP ;
  • zabbix-agent : pour pouvoir monitorer le serveur lui-même.
Nous utiliseront dans ce tutoriel la version mysql de zabbix

Exemple pour Ubuntu 12.10 server (quantal)

apt-get install zabbix-server-mysql zabbix-frontend-php zabbix-agent

Lancement du serveur zabbix :

Activer le serveur

Le serveur zabbix n'est pas activé par défaut : la commande

sudo service zabbix-server restart

renvoie :

zabbix_server is disabled in /etc/default/zabbix-server.

Pour l'activer, modifier le fichier "/etc/default/zabbix-server" comme suit :

START=yes

Redémarrer le serveur :

sudo service zabbix-server restart

Consulter les logs du serveur :

tail -100 /var/log/zabbix-server/zabbix_server.log

L'observation des logs montre que le serveur Zabbix ne peut pas se connecter à la base de données MySQL car la base n'est pas remplie, n'est pas paramétrée, et la configuration de Zabbix n'est pas terminée.

Préparation de la base de données

Zabbix a besoin de stocker les informations de supervision dans une base de données.

Zabbix est capable de fonctionner avec un moteur de base de données MySQL ou PostgreSQL. Mais c'est à vous de choisir, et d'installer les packages mysql-server ou postgresql-server en conséquence…

Cela signifie que l'installation du package Zabbix-server ne s'accompagne pas automatiquement de la création de la base de données et de l'ajout des données de base. Il faut que vous réalisiez cette opération.

Afin de vous aider à créer la base de données Zabbix, l'installation du package Zabbix-server vous fournit les scripts de création des structures (schema), des données (data) et des images (images). L'emplacement de ces scripts dépend de la version d'Ubuntu sur laquelle vous travaillez (vois plus loin).

MySQL

Pour créer et remplir la base Zabbix dans MySQL :

Se connecter avec le compte root MySQL :

mysql -uroot -p

Indiquer le mot de passe root de mysql (celui qui a été défini lors de l'installation de MySQL)

Créer la base de données zabbix :

 mysql > create database zabbix;

Créer un utilisateur MySQL qui se nomme zabbix et qui a pour mot de passe zabbix :

 mysql > grant all privileges on zabbix.* to zabbix@localhost identified by 'zabbix';
 mysql > flush privileges;

Quitter la console mysql

mysql > exit
S'il faut, après coup ou suite à une erreur, changer le mot de passe de l'utilisateur 'zabbix', voici les commandes à utiliser depuis un terminal de commande (ici le nouveau mot de passe est mysql) :
user#  mysql -uroot -p
mysql > USE mysql ;
mysql > SET PASSWORD FOR 'zabbix'@'localhost' = PASSWORD('mysql');
mysql > FLUSH PRIVILEGES ;

Importer la structure de base de données zabbix

Attention l'ordre des commandes est important. Il faut d'abord créer les tables avant de pouvoir y mettre les données.
ubuntu < 12.04.2
root# mysql -u zabbix -p password zabbix < /usr/share/zabbix-server/mysql.sql
root# mysql -u zabbix -p password zabbix < /usr/share/zabbix-server/data.sql
ubuntu > =12.04.2
  zcat /usr/share/zabbix-server-mysql/schema.sql.gz | mysql -uzabbix -pmotdepassezabbix zabbix
  zcat /usr/share/zabbix-server-mysql/images.sql.gz | mysql -uzabbix -pmotdepassezabbix zabbix
  zcat /usr/share/zabbix-server-mysql/data.sql.gz | mysql -uzabbix -pmotdepassezabbix zabbix 
On remplacera motdepassezabbix par le mot de passe que nous avons utilisé lors de la création du compte MySQL 'zabbix'.

PostgreSQL

Pour créer et remplir la base de donnée Zabbix dans PostgreSQL:

On edite tout d'abord le fichier pg_hba.conf (il faut être en root pour cela):

root@pedro-pc:~#nano /etc/postgresql/"votre_version_de_postgresql"/main/pg_hba.conf

On descend tout en bas du fichier, on commente toutes les lignes qui ne le sont pas (pour éviter les conflits) et on ajoute les deux suivantes:

local all zabbix md5

local all postgres trust

Les utilisateurs zabbix et postgres (l'utilisateur créé par défaut et ne possédant pas de mot de passe) sont ainsi autorisés à se connecter à la Base de Données. Le premier n'étant pas encore créé, il faudra lors de sa création, lui attribuer un mot de passe.

On redémarre le service pour que les modifications soient prises en compte:

pedro@pedro-pc:~#service postgresql restart

On se connecte à la base de données :

root@pedro-pc:~#su postgres
postgres@pedro-pc:/root$psql
postgres=#create role zabbix with password 'votre_mot_de_passe' login createdb;
Le paramètre "login" autorise l'utilisateur à se connecter à la base et "createdb" à créer une base de donnée.. ;-)

On se déconnecte de la base:

postgres=#\q

Et on se reconnecte avec l'utilisateur zabbix en spécifiant la base de donnée postgres car c'est la seule qui est actuellement créée. Puis, on crée la base de donnée zabbix :

pedro@pedro-pc:~#psql -Uzabbix postgres
Password for user zabbix:
postres=>create database zabbix;

On se déconnecte de la bdd:

postgres=>\q

Importer la structure de la base dans postgresql

C'est exactement la même manipulation qu'avec mysql adaptée à postgresql :

Attention, il faut exécuter les 3 commandes une à une et bien respecter l'ordre d'exécution de celles-ci.
zcat /usr/share/zabbix-server-mysql/schema.sql.gz | psql -Uzabbix -pmotdepassezabbix zabbix
zcat /usr/share/zabbix-server-mysql/images.sql.gz | psql -Uzabbix -pmotdepassezabbix zabbix
zcat /usr/share/zabbix-server-mysql/data.sql.gz | psql -Uzabbix -pmotdepassezabbix zabbix 
  

Configuration du serveur

Il faut maintenant indiquer au serveur Zabbix les paramètres qui lui permettront de se connecter à la base de données Zabbix. En particulier, il nous faut indiquer le mot de passe pour le compte MySQL 'Zabbix' (dans notre cas, c'est 'zabbix')

Ajuster les paramètres du serveur en éditant le fichier de configuration comme suit :

sudo nano /etc/zabbix/zabbix_server.conf

Ajuster au minimum le paramètre DBPassword en ajoutant au fichier la ligne suivante :

DBPassword=zabbix

Sauvegarder les modification, quitter l'éditeur et relancer le serveur :

 sudo service zabbix-server restart

Pour confirmer que le serveur fonctionne correctement, la commande:

 tail -100 /var/log/zabbix-server/zabbix_server.log

ne doit pas retourner d'erreurs. (En l'absence totale d'erreurs, il est possible que ce fichier n'existe même pas !)

Installation de l’interface web de gestion de Zabbix

Il est possible de paramétrer l'accès à zabbix de deux manières distinctes :

Méthode 1 : Alias

La première méthode de configuration de l'accès à l'interface web de Zabbix consiste à déclarer un nouvel alias dans Apache2. De cette manière, il sera possible d'accéder à l'interface web de Zabbix en utilisant l'adresse web suivante : http://ip_du_server/zabbix.

Créer un fichier de configuration Apache2 dédié. L'emplacement de ce fichier dépend de la version d'ubuntu utilisée. Version Ubuntu < 14.04 :

user# sudo nano /etc/apache2/conf.d/zabbix-server

Version Ubuntu >= 14.04 :

user# sudo nano /etc/apache2/conf-available/zabbix-server.conf 

Le contenu du fichier de configuration apache à créer est le suivant :

# Directives pour zabbix serveur

# Définition d'un alias /zabbix
<IfModule mod_alias.c>
    Alias /zabbix /usr/share/zabbix
</IfModule>

# Définition des droits d'accès au dossier contenant les fichiers web de zabbix
<Directory /usr/share/zabbix>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride None
        Order allow,deny
        allow from all
</Directory>

Après avoir sauvegardé le fichier, il faut activer la configuration et relancer le serveur Apache2 :

sudo a2enconf zabbix-server
sudo service apache2 reload

Méthode 2 : Virtualhost

Une autre méthode de configuration de l'accès à l'interface web de Zabbix consiste à déclarer un virtualhost. Dans ce cas, l'interface web de Zabbix sera accessible en utilisation l'adresse web : http://ip_du_serveur

Créer un fichier de configuration Apache :

nano /etc/apache2/sites-available/zabbix

Dans ce fichier, insérez le paramétrage du VirtualHost apache comme suit :

<VirtualHost *:80> 
      ServerAdmin webmaster@localhost 
      DocumentRoot /usr/share/zabbix/ 
         <Directory /> 
              Options FollowSymLinks 
              AllowOverride None 
      </Directory> 
      <Directory /usr/share/zabbix/> 
              Options Indexes FollowSymLinks MultiViews 
              AllowOverride None 
              Order allow,deny 
              allow from all 
      </Directory> 
      <Directory /usr/share/zabbix/> 
              Options Indexes FollowSymLinks MultiViews 
              AllowOverride None 
              Order allow,deny 
              allow from all 
      </Directory>
       ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ 
      <Directory "/usr/lib/cgi-bin"> 
              AllowOverride None 
              Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch 
              Order allow,deny 
              Allow from all 
      </Directory> 
      ErrorLog ${APACHE_LOG_DIR}/error.log 
      # Possible values include: debug, info, notice, warn, error, crit, 
      # alert, emerg. 
      LogLevel warn
      CustomLog ${APACHE_LOG_DIR}/access.log combined 
</VirtualHost>  

Modifier le fichier de configuration de php (php.ini) pour les pré-requis de l'installation de Zabbix :

 nano /etc/php5/apache2/php.ini :
 

ubuntu >=Ubuntu 16.04.1 LTS

 sudo nano /etc/php/7.0/apache2/php.ini

Modifiez les options ci-dessous :

max_execution_time = 600
max_input_time = 600
memory_limit = 256M
post_max_size = 32M
upload_max_filesize = 16M
date.timezone = "Europe/Paris"

Enregistrez puis redémarrez Apache2 :

 /etc/init.d/apache2 restart

Créez le fichier de configuration de l'interface zabbix (vide et avec les permissions ajustées), il sera rempli automatiquement par l'installateur zabbix :

 sudo touch /etc/zabbix/zabbix.conf.php
 sudo chown root:www-data /etc/zabbix/zabbix.conf.php
 sudo chmod 660 /etc/zabbix/zabbix.conf.php

Il est maintenant possible de se connecter avec son navigateur via http://adress_ip_du_serveur ou http://adress_ip_du_serveur/zabbix suivant votre configuration

Une fois connecté sur l'interface web (cf. l'image ci-dessous), vous n'avez plus qu'à suivre les instructions, et remplir les champs en fonction de votre configuration.

Votre serveur est presque opérationnel

Supervision - Agent Zabbix

Zabbix propose un 'agent' qui s'installe sur les ordinateurs à superviser et peut transmettre au serveur principal des informations plus précises que ce que l'on pourrait obtenir par interrogation SNMP.

L'installation de l'agent Zabbix n'est toutefois pas possible sur des imprimantes ou des équipements d'infrastructure réseau comme des routeurs ou des commutateurs, pour lesquels il faudra se reposer sur les fonctions des agents SNMP proposées par les équipements.

Un agent Zabbix est un service qui fonctionne en arrière plan sur l'ordinateur sur lequel il est installé. A ce titre, il s'apparente à un programme de type serveur.

Agent Linux

Installez le paquet zabbix-agent et éditer le fichier /etc/zabbix/zabbix_agentd.conf pour y indiquer l'adresse IP du serveur Zabbix dans la variable "Server" .

Agent Windows

  • Créer le fichier c:\zabbix_agentd.conf contenant la ligne Server=xxx.xxx.xxx.xxx où xxx.xxx.xxx.xxx est l'adresse IP du serveur Zabbix.
  • Ouvrir la ligne de commande Windows, se placer dans le répertoire contenant le fichier téléchargé puis lancer la commande suivante :
    zabbix_agentd.exe --install
  • Lancer le service en lançant la commande :
    zabbix_agentd.exe --start

Utilisation et configuration

Pour accéder à Zabbix, lancez votre navigateur préféré et rendez-vous à l'adresse :

Fevrier 2016 / Ubuntu 14.04. : Zabbix-serveur MySQL version 5.5.47 : Par défaut le login est Admin et le mot de passe est zabbix

Mars 2013 / Ubuntu 12.04.2 LTS : Zabbix-serveur MySQL version 1.8.11 : Par défaut le login est Admin et le mot de passe est zabbix (By Sybillan)

Janvier 2012 / Ubuntu 11.10 : Zabbix-serveur MySQL version 1.8.10 : Par défaut le login est Admin et le mot de passe est zabbix (By Ayitita)

Décembre 2009 / Ubuntu 9.10, avec Synaptic : Zabbix-serveur MySQL version 1.6.4 (en retard ? la 1.8 est dispo) : se connecter avec Admin comme login et zabbix comme mot de passe.

En cas de problème

  • Si le message Warning: include_once(/etc/zabbix/dbconfig.php) [function.include-once]: failed to open stream: Permission denied in /usr/share/zabbix/include/db.inc.php on line 24 est affiché en haut de la page, donnez un accès en lecture au fichier /etc/zabbix/dbconfig.php au serveur Web :
    sudo chmod +r /etc/zabbix/dbconfig.php
  • Si le message Warning: mysql_pconnect() [function.mysql-pconnect]: Access denied for user 'zabbix'@'localhost' (using password: NO) in /usr/share/zabbix/include/db.inc.php on line 32 s'affiche, éditez le fichier /etc/zabbix/dbconfig.php et complétez le champ DB_PASSWORD avec le mot de passe que vous avez saisi lors de l'installation du paquet zabbix-server-mysql :
  • Si vous avez utilisé la génération automatique du mot de passe à l'installation de zabbix alors, il faut que vous repreniez le mot de passe inclus dans le fichier /etc/zabbix/zabbix_server.conf et il faut l'inclure dans le fichier /etc/zabbix/dbconfig.php :
    sudo grep DBPassword /etc/zabbix/zabbix_server.conf

    Le résultat va être le mot de passe généré par zabbix

    sudo nano /etc/zabbix/dbconfig.php

    Là dans le champ "$DB["PASSWORD"] = ", vous remplacez le mot de passe contenu par celui obtenu lors de la commande précédente.

  • Pour ces deux erreurs un bug report à été lancé sur launchpad
  • Si le serveur Zabbix ne se relance pas automatiquement après redémarrage de la machine, il faut remplacer le contenu des fichiers :
  • Depuis systemd pour le démarrage automatique

pour le serveur :

sudo systemctl enable zabbix-server

pour l'agent:

sudo systemctl enable zabbix-agent
  • Si le mot de passe fourni lors de l'installation ne fonctionne pas pour accéder à l'interface web, essayez login : admin, mdp : zabbix. (notamment sur les paquets du PPA de Bart Verwilst)

compilation du serveur

sudo apt-get install libsnmp9-dev libmysqlclient15-dev

1 - Make the zabbix user and group:

sudo adduser zabbix
enter in new password
confirm
use the remaining defaults.

Add zabbix to the admin group:

sudo adduser zabbix admin


2 - Download and Untar the sources:

su - zabbix
récupration des sources sur http://www.zabbix.com/download.php
tar zxvpf zabbix-1.4.tar.gz


3 - Create a zabbix database and populate it:

mysql -u root -p
create database zabbix;
quit;

mysql -u root -p zabbix < /home/zabbix/zabbix-1.4/create/schema/mysql.sql
mysql -u root -p zabbix < /home/zabbix/zabbix-1.4/create/data/data.sql


4 - Configure, compile and install the server:

cd zabbix-1.4/
./configure --prefix=/usr --with-mysql --with-net-snmp \
--enable-server --enable-agent &&
make
sudo make install


5 - Prepare the rest of the system:

sudo nano /etc/services

Add at the end:

zabbix_agent 10050/tcp # Zabbix ports
zabbix_trap 10051/tcp

Save and exit.

sudo mkdir /etc/zabbix
sudo chown -R zabbix.zabbix /etc/zabbix/
cp misc/conf/zabbix_* /etc/zabbix/

Edit /etc/zabbix/zabbix_agentd.conf:

nano /etc/zabbix/zabbix_agentd.conf

Make sure that the Server parameter points to the server address, for the agent that runs on the server it is like this:

Server=127.0.0.1

Edit /etc/zabbix/zabbix_server.conf:

nano /etc/zabbix/zabbix_server.conf

For small sites this default file will do, however if you are into tweaking your config for your 10+ hosts site, this is the place.

Change this:

# Database password
# Comment this line if no password used

DBPassword=Secret

Start the server :

zabbix_server

Start the client:

zabbix_agentd &


6 - Configure web interface

mkdir /home/zabbix/public_html
cp -R frontends/php/* /home/zabbix/public_html/

Edit /etc/apache2/sites-enabled/000-default:

sudo nano /etc/apache2/sites-enabled/000-default

Work into file:

Alias /zabbix/ /home/zabbix/public_html/
<Directory /home/zabbix/public_html>
AllowOverride FileInfo AuthConfig Limit Indexes
Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec
<Limit GET POST OPTIONS PROPFIND>
Order allow,deny
Allow from all
</Limit>
<LimitExcept GET POST OPTIONS PROPFIND>
Order deny,allow
Deny from all
</LimitExcept>
</Directory>

Save and exit.

Make php.ini adjustments:

sudo nano /etc/php5/apache2/php.ini

Change the following values:

max_execution_time = 300 ; Maximum execution time of each script, in seconds
date.timezone = America/Kentucky/Louisville
(use this url to find your correct timezone format: http://us3.php.net/manual/en/timezones.php )


Restart Apache:

sudo /etc/init.d/apache2 restart


Now point your browser to:

http://<servername or ip>/zabbix/

1. Introduction

read and click Next

2. License Agreement

Read, check 'I Agree', click Next

3. Check of Pre-Requisites

Fix any problems, click retry. Click Next when all pre-requisites are OK.

4. Configure DB Connection

Enter appropriate settings and click Test Connection.
Click Next when OK.

5. Pre-Installation Summary

Verify installation settings, click Next.

6. Install

Click Save Configuration file and save to machine.
Copy zabbix.conf.php to /home/zabbix/public_html/conf/zabbix.conf.php

One way to do this from a desktop machine (requires ssh installed):
scp zabbix.conf.php zabbix@<serverip>:/home/zabbix/public_html/conf/

Click Retry and click Next when OK.

7. Finish

Click Finish to complete installation.


Your New Zabbix install will now be shown.

Log in with username: Admin
No Password

First go to the tab Configuration and then Hosts.

Now create a host-group, see that you can give it some templates, e.g: Application.MySQL, Host.SNMP, Host.Standalone, Host.Unix.

Then some hosts:

Select your host-group and use Link with Template Host.Unix

Now a lot of triggers are imported and the game begins.

Go to the monitoring tab and watch the latest values roll in.

For specifics on configuration, please refer to the Zabbix user manual.

www.zabbix.com

Références

  • zabbix.txt
  • Dernière modification: Le 28/04/2018, 11:16
  • (modification externe)