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.conf).
Notez que:
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Obligatoire | Plage | ¶Ù¨¦´Ú²¹³Ü³Ù | Description | |
---|---|---|---|---|---|
Alias | non | D¨¦finir 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 pris en charge 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 | /tmp/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¨¦cifier 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 pris en charge 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 caract¨¨res | ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð 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, valeur sera acquis ¨¤ 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 caract¨¨res | ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð 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[] quelles que soient les valeurs AllowKey/DenyKey. 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 | ?l¨¦ment 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[] quelles que soient les valeurs AllowKey/DenyKey. 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: /absolute/path/to/config/files/*.conf .Depuis Áú»¢¶Ä²© 6.0.0, un chemin peut ¨ºtre relatif ¨¤ l'emplacement du fichier zabbix_agent2.conf. Voir les notes sp¨¦ciales sur connaitres 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 |
/tmp/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¨¦cifier o¨´ les messages du journal sont ¨¦crits : system - syslog, file - fichier sp¨¦cifi¨¦ par le param¨¨tre LogFile, console - sortie standard. |
||
PersistentBufferFile | non | Le fichier, o¨´ l'agent Áú»¢¶Ä²© 2 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). |
|
PidFile | non | /tmp/zabbix_agent2.pid | Nom du fichier PID. | ||
Plugin | 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 | /tmp/agent.plugin.sock | Chemin d'acc¨¨s au socket Unix pour les communications de plug-in chargeables. | ||
PluginTimeout | non | 1-30 | D¨¦lai d'expiration global | D¨¦lai d'attente 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 d¨¦limit¨¦es par des virgules 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 les adresses IPv6 sont facultatifs. 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 | S'il est d¨¦fini, l'agent ¨¦coutera sur ce port les demandes d'¨¦tat HTTP (http://localhost:<port>/status). | ||
Timeout | non | 1-30 | 3 | Ne pas 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 | Chemin d'acc¨¨s 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 |