3,054
edits
Changes
Jump to navigation
Jump to search
Line 310:
Line 310: − + − L'agent Zabbix est un petit démon qui va rassembler des informations sur l'hôte à surveiller, et les renvoyer à un ou plusieurs serveur (s) (ou proxy (s)). − − − ===== Installation ===== − − Pour installer Zabbix agent , il suffit d'utiliser yum: − yum --enablerepo=smecontribs install smeserver-zabbix-agent − − − Ce paquet sera téléchargé avec au moins les dépendances suivantes: − *zabbix (tout petit paquet avec les répertoires communs utilisés par tous les composants de Zabbix) − *zabbix-agent (l'agent) − *smeserver-remoteuseraccess: cette contrib est nécessaire car elle fournit des modèles de métadonnées nécessaires pour le fichier /etc/sudoers. − − ===== Paramètres BD ===== − − Voici la liste des paramètres BD du service Zabbix-agent sur SME: − *'''RemoteCommands''': (enabled|disabled). Si vous souhaitez activer à distance des commandes sur l'agent Zabbix (vous devriez lire la documentation Zabbix). Il faut savoir qu'il y a des répercussions sur la sécurité si vous l'activez. Cette fonction est désactivée par défaut − *'''ServerPort''': port pour contacter le serveur lors de l'exécution en mode actif. Par défaut à 10051 − *'''Servers''': Liste de serveurs (ou proxy), séparés par des virgules, à qui envoyer les informations. Le premier sera utilisé pour le mode actif, les autres sont seulement pour le mode passif − *'''TCPPort''': Le port TCP sur lequel l'agent sera à l'écoute, si le mode passif est activé − *'''access''': (public|private) Si vous souhaitez ouvrir l'agent sur l'interface publique (ne sera utile que si passive est activé). Si vous réglez cela sur «public», vous devez utiliser la clé AllowHosts pour limiter l'accès − *'''active''': (enabled|disabled) Voulez-vous activé le mode actif − *'''passive''': (enabled|disabled) Voulez-vous activé le mode passif − *'''status''': (enabled|disabled) Si le service est lancé automatiquement − − − − Une fois que vous avez tout configuré comme vous voulez, il suffit de faire − signal-event zabbix-agent-update − − pour appliquer les modifications et redémarrer les services nécessaires. − − ===== Items supplémentaires ===== − − − Même si l'agent Zabbix supporte nativement un grand nombre d'items, certains étaient manquants pour mon utilisation, j'ai ajouté quelques entrés "UserParameters" dans le fichier de configuration. Pour chacun de ces items, vous devez ajouter un nouvel élément avec le nom de l'item comme clé. − Configurer les items sur le serveur peut être assez long. Vous pouvez jeter un œil sur les [http://sme.firewall-services.com/downloads/zabbix/zabbix_SME.zip modèles] je les utilise pour surveiller des serveurs de SME. Cette archive contient quelques templates/items/graphes/déclencheurs au format XML (exportés de Zabbix). Vous pouvez utiliser la fonctionnalité d'import / export de Zabbix (Manuel Chap. 8.XML IMPORTATION ET EXPORTATION page 154) pour l'importer sur votre serveur. − − Vous pouvez aussi jeter un œil sur le fichier de configuration /etc/zabbix/zabbix_agentd.conf pour voir les commandes utilisées pour retourner les valeurs correspondantes. Vous trouverez également pour chaque UserParameter des informations sur la manière de créer l'item correspondant sur le serveur. − − Merci de lire le chapitre 4.11.User Paramètres de la page 119 du manuel pour avoir plus d'informations sur la façon dont fonctionne UserParameters. − − *IP externe: − **'''ip.external''': Retourne la véritable adresse IP externe. − *Incoming mails statistics: − − {{Note box|Depuis la version 0.1-28 smeserver-zabbix-agent, les clés pour récupérer les statistiques des e-mails ont changé. La valeur renvoyées sont pour les 10 dernières minutes (les statistiques sont mises à jour avec un cron toutes les 10 minutes), vous devrez donc configurer ces item pour se rafraîchir toutes les 600 secondes}} − − **'''mail.in[dnsbl]''': nombre d'e-mails rejetés par DNSBL − **'''mail.in[rhsbl]''': nombre d'e-mails rejetés par RHSBL − **'''mail.in[clamav]''': nombre d'e-mails rejetés par CLAMAV − **'''mail.in[check_earlytalker]''': nombre d'e-mails rejetés par EARLYTALKER − **'''mail.in[check_basicheaders]''': nombre d'e-mails rejetés par BASICHEADERS − **'''mail.in[check_goodrcptto]''': nombre d'e-mails rejetés par GOODRCPTTO − **'''mail.in[check_spamhelo]''': nombre d'e-mails rejetés par SPAMHELO − **'''mail.in[total_denied]''': somme d'e-mails rejetés (somme des vérifications ci-dessus) − **'''mail.in[spam_denied]''': nombre d'e-mails rejetés par SPAMASSASSIN − **'''mail.in[other_denied]''': nombre d'e-mails rejetés par d'autres contrôles − **'''mail.in[spam_queued]''': nombre d'e-mails acceptés, mais marqués comme spam par SpamAssassin − **'''mail.in[queued]''': nombre d'emails acceptés (HAM) − **'''mail.in[total]''': nombre d'emails reçus (acceptés + refusés) − − *Statistiques de l'envoi de mails − **'''mail.out[total]''': somme de courrier sortant − **'''mail.out[success]''': nombre d'e-mails transmis − **'''mail.out[deferral]''': nombre d'e-mails différés − **'''mail.out[failure]''': nombre d'échecs − − *utilisation de Mémoire / Swap − **'''vm.memory.size.used''': Mémoire utilisée en octets − **'''vm.memory.size.pused''': Mémoire utilisée en % − **'''system.swap.size.used''': Espace swap utilisée en octets − − * Informations MySQL − **'''mysql.uptime''': temps de fonctionnement du serveur MySQL en secondes − **'''mysql.threads''': nombre de threads − **'''mysql.questions''': nombre de requêtes depuis que mysql a été lancé − **'''mysql.slowqueries''': nombre de requêtes lentes (slow queries) − **'''mysql.qps''': moyenne des requêtes par secondes − **'''mysql.size''': espace total utilisé par les bases de données mysql − − *Utilisation du réseau. Ces items sont utiles si vous voulez surveiller plusieurs serveurs SME en utilisant un modèle (mêmes items), mais ces serveurs utilisent différentes interfaces (eth0, eth1, br0, bond0, ppp0 etc ..) − **'''net.if.in.internal''': Équivalent à net.if.in [ethX, octets], mais est indépendant du nom de l'interface interne (eth0, bond0, br0 etc ...) − **'''net.if.out.internal''': Équivalent à net.if.out[ethX,bytes] − **'''net.if.in.external''': Équivalent à net.if.in [ethX, octets], mais est indépendant du nom de l'interface externe (eth0, eth1, ppp0 etc ..) − **'''net.if.out.external''': Équivalent à net.if.out[ethX,bytes] − − *statut de l'onduleur (UPS) − **'''ups.load''': Charge (en %) de votre UPS − **'''ups.battery.charge''': Charge (en %) de la batterie − **'''ups.status''': État actuel de l'onduleur (OL, OB, OL CHRG etc ..) − **'''ups.model''': Modèle de l'onduleur − − *Raid Array Monitoring − **'''raid.sw.status''': État actuel de votre raid logiciel (tout les volumes raid logiciel sont surveillés) − **'''raid.mega.status''': État actuel de vos volumes raid basés sur un chipset MegaRaid (par exemple, les cartes perc5/5(i) sont basées sur un chipset MegaRaid). Nécessite le paquet MegaCli disponible ici: [http://www.lsi.com/storage_home/products_home/internal_raid/megaraid_sas/] + − Le proxy Zabbix est un démon léger. Il agira comme un serveur pour les agents, mettra en cache localement (dans une base de données mysql) les informations et les enverra au serveur à qui il appartient. C'est utile pour surveiller des éléments derrière un pare-feu. − − ===== Installation ===== − − Pour installer Zabbix proxy , il suffit d'utiliser yum: − yum --enablerepo=smecontribs install smeserver-zabbix-proxy − − ===== DB Parameters ===== − *'''DbName''': le nom de la base de données utilisée par le proxy. La valeur par défaut est zabbixproxydb − *'''DbPassword''': le mot de passe pour accéder à la base de données − *'''DbUser''': l'utilisateur pour accéder à la base de données − *'''Servers''': Liste de serveurs (séparés par des virgules) à qui envoyer les informations − *'''TCPPort''': Le port TCP sur lequel le proxy écoute. Les clients pourront se connecter sur le proxy comme sur un serveur Zabbix. La valeur par défaut est 10051 − *'''access''': (private|public) Si vous souhaitez ouvrir Zabbix-proxy sur l'interface externe. Si vous définissez l'accès à public, vous devez utiliser la touche AllowHosts pour limiter l'accès − *'''status''': (enabled|disabled) Si le service est lancé automatiquement − + − + Line 440:
Line 329: − + − + Line 463:
Line 352: − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
no edit summary
==== Agent ====
==== Agent ====
Voir la page en anglais [[zabbix-agent]].
Voir la page en anglais [[Zabbix-agent]].
==== Proxy ====
==== Proxy ====
Voir la page en anglais [[zabbix-proxy]].
=== Surveillance des serveurs SME ===
=== Surveillance des serveurs SME ===
Si vous voulez surveiller des serveurs SME avec Zabbix, vous devez d'abord installer l'agent, comme expliqué précédemment, puis configurer l'agent pour qu'il accepte les connexions depuis votre serveur. Par exemple, pour surveiller votre serveur local (celui qui exécute le serveur Zabbix):
Si vous voulez surveiller des serveurs SME avec Zabbix, vous devez d'abord installer l'agent, comme expliqué précédemment, puis configurer l'agent pour qu'il accepte les connexions depuis votre serveur. Par exemple, pour surveiller votre serveur local (celui qui exécute le serveur Zabbix) :
db configuration setprop zabbix-agent Servers localhost active disabled passive enabled
db configuration setprop zabbix-agent Servers localhost active disabled passive enabled
signal-event zabbix-agent-update
signal-event zabbix-agent-update
{{Note box|Après l'installation, l'agent est configuré en mode actif. Ici, nous désactivons le mode actif, et permettons seulement le mode passif.}}
{{Note box|type=Note : |après l'installation, l'agent est configuré en mode actif. Ici, nous désactivons le mode actif, et permettons seulement le mode passif.}}
Ensuite, il suffit d'ajouter un hôte dans Zabbix, pointant sur localhost.
Ensuite, il suffit d'ajouter un hôte dans Zabbix, pointant sur localhost.
Maintenant, vous pouvez commencer à ajouter des items (type agent, actif ou passif, selon le mode que vous utilisez sur l'agent) à ce nouvel hôte.
Maintenant, vous pouvez commencer à ajouter des items (type agent, actif ou passif, selon le mode que vous utilisez sur l'agent) à ce nouvel hôte.
Si vous voulez surveiller des serveurs SME sur Internet et utiliser le mode passif, le serveur va initier des connexions vers l'agent. Vous avez besoin de rediriger le port, si vous utilisez le mode serveur seul (serveronly) (la valeur par défaut est le port TCP 10050), ou d'ouvrir ce port dans le pare-feu si vous utilisez le mode serveur et passerelle (server&gateway):
Si vous voulez surveiller des serveurs SME sur Internet et utiliser le mode passif, le serveur va initier des connexions vers l'agent. Vous avez besoin de rediriger le port, si vous utilisez le mode serveur seul (serveronly) (la valeur par défaut est le port TCP 10050), ou d'ouvrir ce port dans le pare-feu si vous utilisez le mode serveur et passerelle (server&gateway) :
db configuration setprop zabbix-agent Servers w.x.y.z active disabled passive enabled access public AllowHosts w.x.y.z
db configuration setprop zabbix-agent Servers w.x.y.z active disabled passive enabled access public AllowHosts w.x.y.z
signal-event zabbix-agent-update
signal-event zabbix-agent-update
{{Warning box|Si vous utilisez le mode actif, vous avez besoin d'utiliser le nom exact de l'hôte dans le serveur Zabbix 'hostname.domainname.tld' (vérifiez le fichier /etc/Zabbix/zabbix_agentd.conf, la directive Hostname). Si vous ne le faites pas, les contrôles ne fonctionneront pas}}
{{Warning box|type=Attention : |si vous utilisez le mode actif, vous avez besoin d'utiliser le nom exact de l'hôte dans le serveur Zabbix 'NomHote.Nom.Domaine.tld' (vérifiez le fichier /etc/Zabbix/zabbix_agentd.conf, la directive NomHote). Si vous ne le faites pas, les contrôles ne fonctionneront pas.}}
Vous pouvez télécharger [http://sme.firewall-services.com/downloads/zabbix/zabbix_SME.zip ici] une archive avec plusieurs modèles (template) d'exports XML que j'utilise pour surveiller mes serveurs. Extrayez l'archive et importez les modèles (template) que vous souhaitez dans Zabbix (en utilisant l'Import / Export Zabbix dans le menu de configuration)
Vous pouvez télécharger [http://sme.firewall-services.com/downloads/zabbix/zabbix_SME.zip ici] une archive avec plusieurs modèles (template) d'exports XML que j'utilise pour surveiller mes serveurs. Extrayez l'archive et importez les modèles (template) que vous souhaitez dans Zabbix (en utilisant l'Import / Export Zabbix dans le menu de configuration)
*'''Template_icmp''': crée deux items pour vérifier si le serveur est en vie, et mesure le temps de latence. Il ajoute également un graphique de latence et certains déclencheurs (si la latence est trop élevée, si l'hôte est in-joignable depuis plus de 5 minutes ou plus de 1 heure)
*'''Template_icmp''': crée deux items pour vérifier si le serveur est en vie, et mesure le temps de latence. Il ajoute également un graphique de latence et certains déclencheurs (si la latence est trop élevée, si l'hôte est in-joignable depuis plus de 5 minutes ou plus de 1 heure)
=== Bugs ===
=== Monitoring ressources ===
* https://github.com/zabbix/community-templates
* https://git.lapiole.org/rpms/zabbix-agent-addons
*
=== Upgrading 4.4 to 5.0 ===
see this page https://www.zabbix.com/documentation/5.0/en/manual/installation/upgrade_notes_500. Mostly you will need to
* migrate your db from mariadb 5.5 to mariadb 10.5 with its user if not already done
* fix the row format to dynamic<syntaxhighlight lang="bash">
echo "USE $(config getprop zabbix-server DbName); alter table hosts row_format = dynamic; "|mysql105
</syntaxhighlight>
* fix ENGINE if forgotten before (y'''ou better doing it before importing it''', converting the history table could take days (yes days not hours)
<syntaxhighlight lang="bash">
echo "SELECT CONCAT('ALTER TABLE ',TABLE_NAME,' ENGINE=InnoDB;') FROM INFORMATION_SCHEMA.TABLES WHERE ENGINE='MyISAM' AND table_schema = 'zabbixdb';" |mysql105 -s|mysql105 zabbixdb
</syntaxhighlight>
* fix collation, for the issue "[Z3005] query failed: [1071] Specified key was too long; max key length is 3072 bytes [create index items_1 on items (hostid,key_(1021))]" [https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/401826-database-upgrade-failed-specified-key-was-too-long-max-key-length-is-3072-bytes see here.]<syntaxhighlight lang="bash">
echo "SELECT CONCAT('ALTER TABLE ',TABLE_SCHEMA,'.',TABLE_NAME,' CONVERT TO CHARACTER SET utf8 COLLATE utf8_bin;') FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'zabbixdb';" |mysql105 -s |mysql10
</syntaxhighlight>
* fix the table with database/mysql/double.sql<syntaxhighlight lang="mysql">
cat /usr/share/doc/zabbix-server-mysql-5.0.30/double.sql |mysql105 `config getprop zabbix-server DbName`
</syntaxhighlight>
* fix the foreign key for the issue "[Z3005] query failed: [1091] Can't DROP FOREIGN KEY `c_items_1`; check that it exists [alter table items drop foreign key c_items_1]" [https://www.zabbix.com/forum/zabbix-troubleshooting-and-problems/402412-zabbix-4-4-8-to-5-0-upgrade-failure see here]<syntaxhighlight lang="bash">
echo "ALTER TABLE items ADD CONSTRAINT c_items_1 FOREIGN KEY (hostid) REFERENCES hosts (hostid) ON DELETE CASCADE;
CREATE INDEX items_1 ON items (hostid);" |mysql105 zabbixdb
</syntaxhighlight>
* install 5.0 using rpms<syntaxhighlight lang="bash">
db yum_repositories setprop zabbix44 status disabled
db yum_repositories setprop zabbix50 status enabled
db yum_repositories setprop zabbix50-frontend status enabled
expand-template /etc/yum.smerepos.d/sme-base.repo
rpm -e --nodeps zabbix-web-mysql zabbix-web smeserver-zabbix-server
yum install smeserver-zabbix-server-z50 --enablerepo=smecontribs,smetest,smedev
</syntaxhighlight>
** fix collation after install
<syntaxhighlight lang="bash">
echo "alter database $(config getprop zabbix-server DbName) character set utf8mb4 collate utf8mb4_bin;" |mysql105
wget https://www.zabbix.com/documentation/current/assets/en/manual/appendix/install/utf8mb4_convert.sql
cat utf8mb4_convert.sql |mysql105 `config getprop zabbix-server DbName`
echo "SET @ZABBIX_DATABASE = '$(config getprop zabbix-server DbName)'; \
set innodb_strict_mode = OFF; \
CALL zbx_convert_utf8(); \
set innodb_strict_mode = ON; \
drop procedure zbx_convert_utf8;"|mysql105 `config getprop zabbix-server DbName`
</syntaxhighlight>
=== Migrate DB from mariadb 5.5. to mariadb 10.5 ===
The script will check if zabbixdb is present in mariadb 5.5. path, as long as it is it will keep using this db, even if one is present in mariadb 10.5.<syntaxhighlight lang="bash">
# need testing, writing inspired from Nextcloud contrib page
mysqldump `config getprop zabbix-server DbName` > zabbixdb.sql
echo "CREATE DATABASE IF NOT EXISTS `config getprop zabbix-server DbName` CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"| mysql105
cat zabbixdb.sql |sed 's/ENGINE=MyISAM/ENGINE=InnoDB/g'|mysql105 `config getprop zabbix-server DbName`
echo "CREATE USER IF NOT EXISTS `config getprop zabbix-server DbUser`@localhost IDENTIFIED BY '`config getprop zabbix-server DbPassword`';"| mysql105
echo "GRANT ALL PRIVILEGES ON `config getprop zabbix-server DbName`.* TO `config getprop zabbix-server DbUser`@localhost; FLUSH PRIVILEGES;" | mysql105
echo "drop database `config getprop zabbix-server DbName`;" |mysql
signal-event smeserver-zabbix-server-update
</syntaxhighlight>{{Warning box|These lines of code need to be tested first, try on a test environment and be prepared to restore a backup of your db.}}
=== Bogues ===
Merci de faire parvenir les problèmes à SME-Contribs sur [http://bugs.contribs.org/enter_bug.cgi bugzilla]
Merci de faire parvenir les problèmes à SME-Contribs sur [http://bugs.contribs.org/enter_bug.cgi bugzilla]
en sélectionnant le logiciel smeserver-zabbix ou en utilisant un de ces liens :
en sélectionnant le logiciel smeserver-zabbix ou en utilisant un de ces liens :