Documentation
Table of Contents
2 Agent
Aper?u
L'agent Áú»¢¶Ä²© est d¨¦ploy¨¦ sur une cible de surveillance pour surveiller activement les ressources locales et les applications (disques durs, m¨¦moire, statistiques de processeur, etc.).
L'agent rassemble les informations op¨¦rationnelles localement et transmet les donn¨¦es au serveur Áú»¢¶Ä²© pour un traitement ult¨¦rieur. En cas d'¨¦chec (par exemple, un disque dur plein ou un service en panne), le serveur Áú»¢¶Ä²© peut alerter activement les administrateurs de la machine particuli¨¨re qui a signal¨¦ la panne.
Les agents Áú»¢¶Ä²© sont extr¨ºmement efficaces en raison de l'utilisation d'appels syst¨¨me natifs pour collecter des informations statistiques.
V¨¦rifications passives et actives
Les agents Áú»¢¶Ä²© peuvent effectuer des v¨¦rifications passives et actives.
Dans une v¨¦rification passive, l'agent r¨¦pond ¨¤ une demande de donn¨¦es. Le serveur Áú»¢¶Ä²© (ou le proxy) demande des donn¨¦es, par exemple, la charge du processeur, et l'agent Áú»¢¶Ä²© renvoie le r¨¦sultat.
Les v¨¦rifications actives n¨¦cessitent un traitement plus complexe. L'agent doit d'abord r¨¦cup¨¦rer une liste d'¨¦l¨¦ments du serveur Áú»¢¶Ä²© pour un traitement ind¨¦pendant. Ensuite, il enverra p¨¦riodiquement de nouvelles valeurs au serveur.
Que ce soit pour effectuer des v¨¦rifications passives ou actives, cela se configure en s¨¦lectionnant un type d'¨¦l¨¦ment. L'agent Áú»¢¶Ä²© traite les ¨¦l¨¦ments de type 'Agent Áú»¢¶Ä²©' ou 'Agent Áú»¢¶Ä²© (actif)'.
Plateformes support¨¦es
L¡¯agent Áú»¢¶Ä²© est support¨¦ sur :
- Linux
- IBM AIX
- FreeBSD
- NetBSD
- OpenBSD
- HP-UX
- Mac OS X
- Solaris : 9, 10, 11
- Windows : toutes les versions bureautique et serveurs depuis XP
Agent sur les syst¨¨mes de type Unix
L¡¯agent Áú»¢¶Ä²© sur les syst¨¨mes de type Unix s'ex¨¦cute sur l¡¯h?te qui est surveill¨¦.
Installation
Voir la section installation des packages pour voir les instructions d¡¯installation de l¡¯agent Áú»¢¶Ä²© sous forme de package.
Sinon r¨¦f¨¦rez-vous aux instructions d¡¯installation manuelle si vous ne voulez pas utiliser de packages.
En g¨¦n¨¦ral, les agents Áú»¢¶Ä²© 32bits fonctionnent sur les syst¨¨mes 64bits, mais cela peut ne pas fonctionner dans certains cas.
Si install¨¦ comme package
L¡¯agent Áú»¢¶Ä²© s¡¯ex¨¦cute comme un processus d¨¦mon. L¡¯agent peut ¨ºtre d¨¦marr¨¦ en ex¨¦cutant :
Cela fonctionnera sur la plupart des systems GNU/Linux. Sur les autres syst¨¨mes vous devrez ex¨¦cuter la commande suivante?:
De m¨ºme, pour arr¨ºter/red¨¦marrer/afficher l'¨¦tat de l'agent Áú»¢¶Ä²©, utilisez les commandes suivantes :
shell> service zabbix-agent stop
shell> service zabbix-agent restart
shell> service zabbix-agent statusD¨¦marrage manuel
Si les commandes pr¨¦c¨¦dentes ne fonctionnent pas, il faudra d¨¦marrer l¡¯agent manuellement. Trouvez le chemin des binaires zabbix_agentd puis ex¨¦cutez?:
Agent sur les syst¨¨mes Windows
L'agent Áú»¢¶Ä²© sur Windows s'ex¨¦cute en tant que service Windows.
±Ê°ù¨¦±è²¹°ù²¹³Ù¾±´Ç²Ô
L¡¯agent Áú»¢¶Ä²© est distribu¨¦ sous forme d¡¯archive au format zip. Apr¨¨s le t¨¦l¨¦chargement de l¡¯archive vous devrez la d¨¦compresser. Vous pouvez choisir n¡¯importe quel dossier pour stocker l¡¯agent Áú»¢¶Ä²© et le fichier de configuration. ex :
Copiez les fichiers bin\zabbix_agentd.exe et conf\zabbix_agentd.conf vers la destination choisie pr¨¦c¨¦demment.
Editez le fichier c:\zabbix\zabbix_agentd.conf selon vos besoins en prenant soin de sp¨¦cifier correctement le param¨¨tre ¡°Hostname¡±.
Installation
Une fois que les ¨¦tapes pr¨¦c¨¦dentes sont r¨¦alis¨¦es, ex¨¦cutez la commande suivante pour installer l¡¯agent Áú»¢¶Ä²© en tant que service :
Maintenant vous devriez ¨ºtre capable de configurer le service ¡°Agent Áú»¢¶Ä²©¡± comme les autres services Windows.
Voir plus de details sur l'installation et l'ex¨¦cution de l'agent Áú»¢¶Ä²© sur Windows.
Autres options de l'agent
Il est possible d'ex¨¦cuter plusieurs instances de l'agent sur un h?te. Une seule instance peut utiliser le fichier de configuration par d¨¦faut ou un fichier de configuration sp¨¦cifi¨¦ dans la ligne de commande. Dans le cas d'instances multiples, chaque instance d'agent doit poss¨¦der son propre fichier de configuration (l'une des instances peut utiliser le fichier de configuration par d¨¦faut).
Les param¨¨tres de ligne de commande suivants peuvent ¨ºtre utilis¨¦s avec l'agent Áú»¢¶Ä²© :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Agent UNIX et Windows | |
| -c --config <config-file> | Chemin vers le fichier de configuration. Vous devez utiliser cette option pour sp¨¦cifier le fichier de configuration qui n'est pas celui par d¨¦faut. Sur UNIX, le fichier par d¨¦faut est /usr/local/etc/zabbix_agentd.conf ou comme appliqu¨¦ par les variables compile-time --sysconfdir ou --prefix Sur Windows, le fichier par d¨¦faut est c:\zabbix_agentd.conf |
| -p --print | Affiche les ¨¦l¨¦ments connus et quitte. Note: Pour retourner ¨¦galement les r¨¦sultats des param¨¨tres utilisateur, vous devez sp¨¦cifier le fichier de configuration (s'il n'est pas ¨¤ l'emplacement par d¨¦faut). |
| -t --test <item key> | Teste l'¨¦l¨¦ment sp¨¦cifi¨¦ et quitte. Note: Pour retourner ¨¦galement les r¨¦sultats des param¨¨tres utilisateur, vous devez sp¨¦cifier le fichier de configuration (s'il n'est pas ¨¤ l'emplacement par d¨¦faut). |
| -h --help | Affiche les informations d'aide |
| -V --version | Affiche le num¨¦ro de version |
| Agent UNIX uniquement | |
| -R --runtime-control <option> | Effectue des fonctions administratives. Voir runtime control. |
| Agent Windows uniquement | |
| -m --multiple-agents | Utilise plusieurs instances d'agent (avec les fonctions -i,-d,-s,-x). Pour distinguer les noms des services des noms des instances, chaque nom de service inclura la valeur Hostname du fichier de configuration sp¨¦cifi¨¦. |
| Agent Windows uniquement (fonctions) | |
| -i --install | Installe l'agent Windows Áú»¢¶Ä²© en tant que service |
| -d --uninstall | D¨¦sinstalle le service de l'agent Windows Áú»¢¶Ä²© |
| -s --start | D¨¦marre le service de l'agent Windows Áú»¢¶Ä²© |
| -x --stop | Arr¨ºte le service de l'agent Windows Áú»¢¶Ä²© |
Exemples sp¨¦cifiques d'utilisation des param¨¨tres de ligne de commande :
- affichage de tous les ¨¦l¨¦ments d'agent int¨¦gr¨¦s avec des valeurs
- tester un param¨¨tre utilisateur avec la cl¨¦ "mysql.ping" d¨¦finie dans le fichier de configuration sp¨¦cifi¨¦
- installation d¡¯un service "Agent Áú»¢¶Ä²©" pour Windows en utilisant le chemin par d¨¦faut du fichier de configuration c:\zabbix_agentd.conf
- installation d'un service "Agent Áú»¢¶Ä²© [Hostname]" pour Windows en utilisant le fichier de configuration zabbix_agentd.conf situ¨¦ dans le m¨ºme dossier que l'ex¨¦cutable de l'agent et rend le nom de service unique en l'¨¦tendant par la valeur ¡®Hostname¡¯ du fichier config
shell> zabbix_agentd --print
shell> zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
shell> zabbix_agentd.exe -i
shell> zabbix_agentd.exe -i -m -c zabbix_agentd.confRuntime control
Avec les options de runtime control, vous pouvez changer le niveau de journalisation des processus de l¡¯agent.
| Option | Description | Cible |
|---|---|---|
| log_level_increase[=<target>] | Augmente le niveau de journalisation. Si la cible n'est pas sp¨¦cifi¨¦e, tous les processus sont affect¨¦s. |
La cible peut ¨ºtre sp¨¦cifi¨¦e de la mani¨¨re suivante : :pid - process identifier (1 to 65535)process type - tous les processus du type sp¨¦cifi¨¦ (e.g., poller)process type,N - type de processus et num¨¦ro (e.g., poller,3) |
| log_level_decrease[=<target>] | Diminue le niveau de journalisation. Si la cible n'est pas sp¨¦cifi¨¦e, tous les processus sont affect¨¦s. |
Note that the usable range of PIDs for changing the log level of a single agent process is 1 to 65535. On systems with large PIDs, the <process type,N> target can be used for changing the log level of a single process. Notez que la plage utilisable de PID pour modifier le niveau de journalisation d'un processus d'un seul agent est comprise entre 1 et 65535. Sur les syst¨¨mes dot¨¦s de PID volumineux, la cible <process type, N> peut ¨ºtre utilis¨¦e pour modifier le niveau de journalisation d'un seul processus.
Exemples:
- augmente le niveau de journalisation de tous les processus
- augmente le niveau de journalisation du second processus listener
- augmente le niveau de journalisation du processus avec le PID 1234
- diminue le niveau de journalisation de tous les processus nomm¨¦s "active check"
shell> zabbix_agentd -R log_level_increase
shell> zabbix_agentd -R log_level_increase=listener,2
shell> zabbix_agentd -R log_level_increase=1234
shell> zabbix_agentd -R log_level_decrease="active checks"Runtime control n'est pas support¨¦ sur OpenBSD, NetBSD et Windows.
Processus utilisateur
L'agent Áú»¢¶Ä²© sous UNIX est con?u pour s'ex¨¦cuter en tant qu'utilisateur non root. Il fonctionnera comme n'importe quel utilisateur non-root. Vous pouvez donc ex¨¦cuter l'agent comme n'importe quel utilisateur non root sans aucun probl¨¨me.
Si vous essayez de l'ex¨¦cuter en tant que 'root', il passera ¨¤ un utilisateur 'zabbix' cod¨¦ en dur, qui doit ¨ºtre pr¨¦sent sur votre syst¨¨me. Vous pouvez uniquement ex¨¦cuter l'agent en tant que 'root' si vous modifiez le param¨¨tre 'AllowRoot' dans le fichier de configuration de l'agent associ¨¦.
Fichier de configuration
Pour plus de d¨¦tails sur la configuration de l'agent Áú»¢¶Ä²©, voir les options du fichier de configuration pour zabbix_agentd ou l'agent Windows.
Environnement local
Notez que l'agent requiert un environnement local UTF-8 afin que certains ¨¦l¨¦ments textuels d'agent puissent renvoyer le contenu attendu. La plupart des syst¨¨mes modernes de type Unix ont un param¨¨tre r¨¦gional UTF-8 par d¨¦faut, cependant, certains syst¨¨mes peuvent avoir besoin d'¨ºtre d¨¦finis sp¨¦cifiquement.
Code de sortie
Avant la version 2.2, l'agent Áú»¢¶Ä²© renvoyait 0 en cas de sortie r¨¦ussie et 255 en cas d'¨¦chec. A partir de la version 2.2 et sup¨¦rieure, l'agent Áú»¢¶Ä²© renvoie 0 en cas de r¨¦ussite et 1 en cas d'¨¦chec.