Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

6 Agent Áú»¢¶Ä²© 2 (Windows)

Aper?u

L'agent Áú»¢¶Ä²© 2 est une nouvelle g¨¦n¨¦ration d'agent Áú»¢¶Ä²© et peut ¨ºtre utilis¨¦ ¨¤ la place de l'agent Áú»¢¶Ä²©.

Cette section r¨¦pertorie les param¨¨tres pris en charge dans un fichier de configuration de l'agent Áú»¢¶Ä²© 2 (zabbix_agent2.win.conf).

Notez que:

  • Les valeurs par d¨¦faut refl¨¨tent les valeurs par d¨¦faut du processus, et non les valeurs des fichiers de configuration livr¨¦s?;
  • Áú»¢¶Ä²© prend en charge les fichiers de configuration uniquement en encodage UTF-8 sans ?;
  • Les commentaires commen?ant par "#" ne sont pris en charge qu'en d¨¦but de ligne.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð Obligatoire Plage ¶Ù¨¦´Ú²¹³Ü³Ù Description
Alias non D¨¦finit un alias pour une cl¨¦ d'¨¦l¨¦ment. Il peut ¨ºtre utilis¨¦ pour remplacer une cl¨¦ d'¨¦l¨¦ment longue et complexe par une cl¨¦ plus petite et plus simple.
Plusieurs param¨¨tres Alias peuvent ¨ºtre pr¨¦sents. Plusieurs param¨¨tres avec la m¨ºme cl¨¦ Alias sont autoris¨¦s.
Diff¨¦rentes cl¨¦s Alias peuvent faire r¨¦f¨¦rence ¨¤ la m¨ºme cl¨¦ d'¨¦l¨¦ment.
Les alias peuvent ¨ºtre utilis¨¦s dans HostMetadataItem mais pas dans les param¨¨tres HostnameItem.

Exemples :

1. R¨¦cup¨¦ration de l'ID de l'utilisateur 'zabbix'.
Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]
D¨¦sormais, la cl¨¦ abr¨¦g¨¦e zabbix.userid peut ¨ºtre utilis¨¦e pour r¨¦cup¨¦rer des donn¨¦es.

2. Obtenir l'utilisation du processeur avec des param¨¨tres par d¨¦faut et personnalis¨¦s.
Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]
Cela permet d'utiliser la cl¨¦ cpu.util pour obtenir le pourcentage d'utilisation du processeur avec les param¨¨tres par d¨¦faut ainsi que d'utiliser cpu.util[all, idle, avg15] pour obtenir des donn¨¦es sp¨¦cifiques sur l'utilisation du processeur.

3. Ex¨¦cution de plusieurs r¨¨gles de d¨¦couverte de bas niveau traitant les m¨ºmes ¨¦l¨¦ments de d¨¦couverte.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Il est d¨¦sormais possible de configurer plusieurs r¨¨gles de d¨¦couverte ¨¤ l'aide de vfs.fs.discovery avec des param¨¨tres diff¨¦rents pour chaque r¨¨gle, par exemple, vfs.fs.discovery[foo], vfs.fs.discovery[bar], etc.
AllowKey non Autoriser l'ex¨¦cution des cl¨¦s d'¨¦l¨¦ment qui correspondent ¨¤ un mod¨¨le. Le mod¨¨le de cl¨¦ est une expression g¨¦n¨¦rique qui prend en charge le caract¨¨re "*" pour correspondre ¨¤ n'importe quel nombre de caract¨¨res.
Plusieurs r¨¨gles de correspondance de cl¨¦ peuvent ¨ºtre d¨¦finies en combinaison avec DenyKey. Les param¨¨tres sont trait¨¦s un par un selon leur ordre d'apparition.
Ce param¨¨tre est support¨¦ depuis Áú»¢¶Ä²© 5.0.0.
Voir aussi : Restriction des v¨¦rifications d'agent.
BufferSend non 1-3600 5 L'intervalle de temps en secondes qui d¨¦termine la fr¨¦quence ¨¤ laquelle les valeurs sont envoy¨¦es du tampon au serveur Áú»¢¶Ä²©.
Notez que si le tampon est plein, les donn¨¦es seront envoy¨¦es plus t?t.
BufferSize non 2-65535 100 Nombre maximal de valeurs dans une m¨¦moire tampon. L'agent enverra toutes les donn¨¦es collect¨¦es au serveur Áú»¢¶Ä²© ou au proxy si le tampon est plein.
Ce param¨¨tre ne doit ¨ºtre utilis¨¦ que si le tampon persistant est d¨¦sactiv¨¦ (EnablePersistentBuffer=0).
ControlSocket non \\.\pipe\agent.sock Le socket de contr?le, utilis¨¦ pour envoyer des commandes d'ex¨¦cution avec l'option '-R'.
DebugLevel non 0-5 3 Sp¨¦cifie le niveau de d¨¦bogage :
0 - informations de base sur le d¨¦marrage et l'arr¨ºt des processus Áú»¢¶Ä²©
1 - informations critiques
2 - informations sur les erreurs
3 - avertissements
4 - pour le d¨¦bogage (produit beaucoup d'informations)
5 - d¨¦bogage ¨¦tendu (produit encore plus d'informations)
DenyKey non Refuser l'ex¨¦cution de ces cl¨¦s d'¨¦l¨¦ment qui correspondent ¨¤ un mod¨¨le. Le mod¨¨le de cl¨¦ est une expression g¨¦n¨¦rique qui prend en charge le caract¨¨re "*" pour correspondre ¨¤ n'importe quel nombre de caract¨¨res.
Plusieurs r¨¨gles de correspondance de cl¨¦ peuvent ¨ºtre d¨¦finies en combinaison avec AllowKey. Les param¨¨tres sont trait¨¦s un par un selon leur ordre d'apparition.
Ce param¨¨tre est support¨¦ depuis Áú»¢¶Ä²© 5.0.0.
Voir aussi : Restriction des v¨¦rifications d'agent.
EnablePersistentBuffer non 0-1 0 Activer l'utilisation du stockage persistant local pour les ¨¦l¨¦ments actifs.
0 - d¨¦sactiv¨¦
1 - activ¨¦
Si le stockage persistant est d¨¦sactiv¨¦, la m¨¦moire tampon sera utilis¨¦e.
ForceActiveChecksOnStart non 0-1 0 Effectuer des v¨¦rifications actives imm¨¦diatement apr¨¨s le red¨¦marrage pour la premi¨¨re configuration re?ue.
0 - d¨¦sactiv¨¦
1 - activ¨¦
?galement disponible selon le param¨¨tre de configuration du plug-in, par exemple : Plugins.Uptime.System.ForceActiveChecksOnStart=1
Pris en charge depuis Áú»¢¶Ä²© 6.0.2.
HostInterface non 0-255 characters ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð facultatif qui d¨¦finit l'interface h?te.
L'interface h?te est utilis¨¦e lors du processus d'enregistrement automatique de l'h?te.
Un agent ¨¦mettra une erreur et ne d¨¦marrera pas si la valeur d¨¦passe la limite de 255 caract¨¨res.
Si elle n'est pas d¨¦finie, la valeur sera acquise ¨¤ partir de HostInterfaceItem.
Pris en charge depuis Áú»¢¶Ä²© 4.4.0.
HostInterfaceItem non ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð facultatif qui d¨¦finit un ¨¦l¨¦ment utilis¨¦ pour obtenir l'interface h?te.
L'interface h?te est utilis¨¦e lors du processus d'enregistrement automatique de l'h?te.
Lors d'une demande d'enregistrement automatique, un agent enregistrera un message d'avertissement si la valeur renvoy¨¦e par l'¨¦l¨¦ment sp¨¦cifi¨¦ d¨¦passe la limite de 255 caract¨¨res.
Cette option n'est utilis¨¦e que lorsque HostInterface n'est pas d¨¦fini.
Pris en charge depuis Áú»¢¶Ä²© 4.4.0.
HostMetadata non 0-255 characters ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð facultatif qui d¨¦finit les m¨¦tadonn¨¦es de l'h?te. Les m¨¦tadonn¨¦es de l'h?te sont utilis¨¦es lors du processus d'enregistrement automatique de l'h?te.
Un agent ¨¦mettra une erreur et ne d¨¦marrera pas si la valeur sp¨¦cifi¨¦e d¨¦passe la limite ou une cha?ne non UTF-8.
Si elle n'est pas d¨¦finie, la valeur sera acquise de HostMetadataItem.
HostMetadataItem non ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð facultatif qui d¨¦finit un ¨¦l¨¦ment utilis¨¦ pour obtenir les m¨¦tadonn¨¦es de l'h?te. La valeur de l'¨¦l¨¦ment de m¨¦tadonn¨¦es de l'h?te est r¨¦cup¨¦r¨¦e ¨¤ chaque tentative d'enregistrement automatique pour le processus d'enregistrement automatique de l'h?te.
Lors d'une demande d'enregistrement automatique, un agent enregistrera un message d'avertissement si la valeur renvoy¨¦e par l'¨¦l¨¦ment sp¨¦cifi¨¦ d¨¦passe la limite de 255 caract¨¨res.
Cette option n'est utilis¨¦ que lorsque HostMetadata n'est pas d¨¦fini.
Prend en charge les param¨¨tres utilisateur et les alias. Prend en charge system.run[] quelle que soit la valeur de EnableRemoteCommands.
La valeur renvoy¨¦e par l'¨¦l¨¦ment doit ¨ºtre une cha?ne UTF-8, sinon elle sera ignor¨¦e.
Hostname non D¨¦fini par HostnameItem Liste des noms d'h?te uniques, d¨¦limit¨¦s par des virgules et sensibles ¨¤ la casse.
Requis pour les v¨¦rifications actives et doit correspondre aux noms d'h?te tels qu'ils sont configur¨¦s sur le serveur. La valeur est acquise ¨¤ partir de HostnameItem si elle n'est pas d¨¦finie.
Caract¨¨res autoris¨¦s : alphanum¨¦rique, '.', ' ', '_' et '-'.
Longueur maximale : 128 caract¨¨res par nom d'h?te, 2 048 caract¨¨res pour toute la ligne.
HostnameItem non system.hostname ·¡±ô¨¦³¾±ð²Ô³Ù utilis¨¦ pour g¨¦n¨¦rer le nom d'h?te s'il n'est pas d¨¦fini. Ignor¨¦ si le nom d'h?te est d¨¦fini.
Ne prend pas en charge les param¨¨tres utilisateur ou les alias, mais prend en charge system.run[] quelle que soit la valeur de EnableRemoteCommands.
La longueur de sortie est limit¨¦e ¨¤ 512 Ko.
Include non Vous pouvez inclure des fichiers individuels ou tous les fichiers d'un r¨¦pertoire dans le fichier de configuration.
Pendant l'installation, Áú»¢¶Ä²© cr¨¦era le r¨¦pertoire d'inclusion dans /usr/local/etc, sauf modification pendant la compilation.
Pour n'inclure que les fichiers pertinents fichiers dans le r¨¦pertoire sp¨¦cifi¨¦, le caract¨¨re g¨¦n¨¦rique ast¨¦risque est pris en charge pour la correspondance de mod¨¨le. Par exemple : C:\Program Files\Áú»¢¶Ä²© Agent\zabbix_agentd.d\*.conf.
Depuis Áú»¢¶Ä²© 6.0.0, un chemin peut ¨ºtre relatif ¨¤ l'emplacement du fichier zabbix_agent2.win.conf.<br >Voir les notes sp¨¦ciales sur les limitations.
ListenIP non 0.0.0.0 Liste des adresses IP d¨¦limit¨¦es par des virgules sur lesquelles l'agent doit ¨¦couter.
La premi¨¨re adresse IP est envoy¨¦e au serveur Áú»¢¶Ä²©, s'il s'y connecte, pour r¨¦cup¨¦rer la liste des v¨¦rifications actives.
ListenPort non 1024-32767 10050 L'agent ¨¦coutera sur ce port les connexions du serveur.
LogFile oui, si LogType est d¨¦fini sur file, sinon
non
c:\zabbix_agent2.log Nom du fichier journal si LogType est 'file'.
LogFileSize non 0-1024 1 Taille maximale du fichier journal en Mo.
0 - d¨¦sactive la rotation automatique du journal.
Remarque : si la limite de taille du fichier journal est atteinte et que la rotation du fichier ¨¦choue, pour quelque raison que ce soit, le fichier journal existant est tronqu¨¦ et d¨¦marr¨¦ nouveau.
LogType non file Sp¨¦cifie o¨´ les messages du journal sont ¨¦crits :
file - fichier sp¨¦cifi¨¦ par le param¨¨tre LogFile,
console - sortie standard.
PersistentBufferFile non Le fichier, o¨´ Áú»¢¶Ä²© Agent2 doit conserver la base de donn¨¦es SQLite.
Doit ¨ºtre un nom de fichier complet.
Ce param¨¨tre n'est utilis¨¦ que si le tampon persistant est activ¨¦ (EnablePersistentBuffer=1).
PersistentBufferPeriod non 1m-365d 1h La p¨¦riode pendant laquelle les donn¨¦es doivent ¨ºtre stock¨¦es, lorsqu'il n'y a pas de connexion au serveur ou au proxy. Les anciennes donn¨¦es seront perdues. Les donn¨¦es du journal seront conserv¨¦es.
Ce param¨¨tre n'est utilis¨¦ que si le tampon persistant est activ¨¦ (EnablePersistentBuffer=1).
Plugins non Depuis Áú»¢¶Ä²© 6.0.0, la plupart des plugins ont leurs propres fichiers de configuration. Le fichier de configuration de l'agent contient les param¨¨tres de plug-in r¨¦pertori¨¦s ci-dessous.
Plugins.Log.MaxLinesPerSecond non 1-1000 20 Nombre maximum de nouvelles lignes que l'agent enverra par seconde au serveur Áú»¢¶Ä²© ou au proxy lors du traitement des v¨¦rifications actives 'log' et 'eventlog'.
La valeur fournie sera remplac¨¦e par le param¨¨tre 'maxlines',
fourni dans la cl¨¦ d'¨¦l¨¦ment 'log' ou 'eventlog'.
Remarque : Áú»¢¶Ä²© traitera 10 fois plus de nouvelles lignes que d¨¦fini dans MaxLinesPerSecond pour rechercher la cha?ne requise dans les ¨¦l¨¦ments de journal.
Ce param¨¨tre est pris en charge depuis la version 4.4.2 et remplace MaxLinesPerSecond.
Plugins.SystemRun.LogRemoteCommands non 0 Activer la journalisation des commandes shell ex¨¦cut¨¦es en tant qu'avertissements.
0 - d¨¦sactiv¨¦
1 - activ¨¦
Les commandes ne seront enregistr¨¦es que si elles sont ex¨¦cut¨¦es ¨¤ distance. Les entr¨¦es de journal ne seront pas cr¨¦¨¦es si system.run[] est lanc¨¦ localement par les param¨¨tres HostMetadataItem, HostInterfaceItem ou HostnameItem.
Ce param¨¨tre est pris en charge depuis 4.4.2 et remplace LogRemoteCommands.
PluginSocket non \\..plugin.sock Chemin d'acc¨¨s au socket unix pour les communications de plug-in chargeables.
PluginTimeout non 1-30 Timeout global Timeout pour les connexions avec des plugins chargeables.
RefreshActiveChecks non 60-3600 120 Fr¨¦quence d'actualisation de la liste des v¨¦rifications actives, en secondes.
Notez qu'apr¨¨s l'¨¦chec de l'actualisation des v¨¦rifications actives, la prochaine actualisation sera tent¨¦e apr¨¨s 60 secondes.
Server oui Liste des adresses IP d¨¦limit¨¦es par des virgules, ¨¦ventuellement en notation CIDR, ou noms DNS des serveurs Áú»¢¶Ä²© et des proxys Áú»¢¶Ä²©.
Les connexions entrantes ne seront accept¨¦es qu'¨¤ partir des h?tes r¨¦pertori¨¦s ici.
Si la prise en charge d'IPv6 est activ¨¦e, alors '127.0. 0.1', '::ffff:127.0.0.1' sont trait¨¦s de la m¨ºme mani¨¨re et '::/0' autorisera n'importe quelle adresse IPv4 ou IPv6.
'0.0.0.0/0' peut ¨ºtre utilis¨¦ pour autoriser n'importe quelle adresse IPv4.< br>Exemple : Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
Les espaces sont autoris¨¦s.
ServerActive non Adresse de serveur/proxy Áú»¢¶Ä²© ou configuration de cluster ¨¤ partir de laquelle obtenir des v¨¦rifications actives.
L'adresse de serveur/proxy est l'adresse IP ou le nom DNS et le port facultatif s¨¦par¨¦s par deux-points.
La configuration de cluster est une ou plusieurs adresses de serveur s¨¦par¨¦es par un point-virgule.< br>Plusieurs serveurs/clusters Áú»¢¶Ä²© et proxys Áú»¢¶Ä²© peuvent ¨ºtre sp¨¦cifi¨¦s, s¨¦par¨¦s par une virgule.
Plus d'un proxy Áú»¢¶Ä²© ne doit pas ¨ºtre sp¨¦cifi¨¦ ¨¤ partir de chaque serveur/cluster Áú»¢¶Ä²©.
Si le proxy Áú»¢¶Ä²© est sp¨¦cifi¨¦, alors le serveur/cluster Áú»¢¶Ä²© pour ce proxy ne doit pas ¨ºtre sp¨¦cifi¨¦.
Plusieurs adresses peuvent ¨ºtre fournies pour utiliser plusieurs serveurs Áú»¢¶Ä²© ind¨¦pendants en parall¨¨le. Les espaces sont autoris¨¦s.
Si le port n'est pas sp¨¦cifi¨¦, le port par d¨¦faut est utilis¨¦.
Les adresses IPv6 doivent ¨ºtre entre crochets si le port de cet h?te est sp¨¦cifi¨¦.
Si le port n'est pas sp¨¦cifi¨¦, les crochets pour IPv6 les adresses sont facultatives.
Si ce param¨¨tre n'est pas sp¨¦cifi¨¦, les v¨¦rifications actives sont d¨¦sactiv¨¦es.
Exemple pour le proxy Áú»¢¶Ä²© :
ServerActive=127.0.0.1:10051
Exemple pour plusieurs serveurs :
ServerActive= 127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Exemple de haute disponibilit¨¦ :
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Exemple de haute disponibilit¨¦ avec deux clusters et un serveur :
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP non Adresse IP source pour :
- les connexions sortantes au serveur Áú»¢¶Ä²© ou au proxy Áú»¢¶Ä²© ;
- l'¨¦tablissement de connexions lors de l'ex¨¦cution de certains ¨¦l¨¦ments (web.page.get, net.tcp.port, etc.)
StatusPort non 1024-32767 Si d¨¦fini, l'agent ¨¦coutera sur ce port les demandes d'¨¦tat HTTP (http://localhost:<port>/status).
Timeout non 1-30 3 Ne passer plus de Timeout secondes sur le traitement.
TLSAccept oui, si le certificat TLS ou les param¨¨tres PSK sont d¨¦finis (m¨ºme pour une connexion non crypt¨¦e), sinon non Quelles connexions entrantes accepter. Utilis¨¦ pour un contr?le passif. Plusieurs valeurs peuvent ¨ºtre sp¨¦cifi¨¦es, s¨¦par¨¦es par une virgule :
unencrypted - accepte les connexions sans cryptage (par d¨¦faut)
psk - accepte les connexions avec TLS et une cl¨¦ pr¨¦-partag¨¦e (PSK)
cert - accepter les connexions avec TLS et un certificat
TLSCAFile non Chemin d'acc¨¨s complet d'un fichier contenant les certificats des autorit¨¦s de certification de niveau sup¨¦rieur pour la v¨¦rification des certificats par les pairs, utilis¨¦ pour les communications chiffr¨¦es entre les composants Áú»¢¶Ä²©.
TLSCertFile non Chemin d'acc¨¨s complet d'un fichier contenant le certificat de l'agent ou la cha?ne de certificats, utilis¨¦ pour les communications chiffr¨¦es avec les composants Áú»¢¶Ä²©.
TLSConnect oui, si le certificat TLS ou les param¨¨tres PSK sont d¨¦finis (m¨ºme pour une connexion non crypt¨¦e), sinon non Comment l'agent doit se connecter au serveur ou au proxy Áú»¢¶Ä²©. Utilis¨¦ pour les v¨¦rifications actives. Une seule valeur peut ¨ºtre sp¨¦cifi¨¦e :
unencrypted - se connecter sans chiffrement (par d¨¦faut)
psk - se connecter ¨¤ l'aide de TLS et d'une cl¨¦ pr¨¦-partag¨¦e (PSK)
cert - se connecter ¨¤ l'aide de TLS et un certificat
TLSCRLFile non Chemin d'acc¨¨s complet d'un fichier contenant des certificats r¨¦voqu¨¦s. Ce param¨¨tre est utilis¨¦ pour les communications chiffr¨¦es avec les composants Áú»¢¶Ä²©.
TLSKeyFile non Chemin d'acc¨¨s complet d'un fichier contenant la cl¨¦ priv¨¦e de l'agent utilis¨¦e pour les communications chiffr¨¦es avec les composants Áú»¢¶Ä²©.
TLSPSKFile non Nom de chemin complet d'un fichier contenant la cl¨¦ pr¨¦-partag¨¦e de l'agent utilis¨¦e pour les communications chiffr¨¦es avec les composants Áú»¢¶Ä²©.
TLSPSKIdentity non Cha?ne d'identit¨¦ de cl¨¦ pr¨¦-partag¨¦e, utilis¨¦e pour les communications chiffr¨¦es avec le serveur Áú»¢¶Ä²©.
TLSServerCertIssuer non ?metteur de certificat de serveur (proxy) autoris¨¦.
TLSServerCertSubject non Sujet du certificat de serveur (proxy) autoris¨¦.
UnsafeUserParameters non 0,1 0 Autoriser la transmission de tous les caract¨¨res dans les arguments des param¨¨tres d¨¦finis par l'utilisateur.
Les caract¨¨res suivants ne sont pas autoris¨¦s :
\ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
De plus, les caract¨¨res de retour ¨¤ la ligne ne sont pas autoris¨¦s.
UserParameter non ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð d¨¦fini par l'utilisateur ¨¤ surveiller. Il peut y avoir plusieurs param¨¨tres d¨¦finis par l'utilisateur.
Format : UserParameter=<cl¨¦>,<commande shell>
Notez que la commande shell ne doit pas renvoyer de cha?ne vide ou EOL uniquement.
Les commandes shell peuvent avoir des chemins relatifs, si le param¨¨tre UserParameterDir est sp¨¦cifi¨¦.
Exemples :
UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir non Chemin de recherche par d¨¦faut pour les commandes UserParameter. S'il est utilis¨¦, l'agent remplacera son r¨¦pertoire de travail par celui sp¨¦cifi¨¦ ici avant d'ex¨¦cuter une commande. Ainsi, les commandes UserParameter peuvent avoir un pr¨¦fixe relatif ./ au lieu d'un chemin complet.
Une seule entr¨¦e est autoris¨¦e.
Exemple : UserParameterDir=/opt/myscripts