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 ;
- 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
- 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.
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
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
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
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;
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 :
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 :
- Utilisation d'un alias (accès par http://server/zabbix)
- Utilisation d'un virtualhost (accès par http://server)
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.
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 :
- http://localhost/zabbix si vous êtes sur le serveur ;
- http://mon_serveur/zabbix si vous êtes sur une autre machine.
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 :
- "/etc/init.d/zabbix-server" par https://bugs.launchpad.net/ubuntu/+source/zabbix/+bug/172775
- "/etc/init.d/zabbix-agent" par https://bugs.launchpad.net/ubuntu/+source/zabbix/+bug/96644/comments/2
- 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