[comment]: # attributes: notoc [comment]: # ({c52b2df3-c52b2df3}) # 3 Zabbix agent (UNIX) [comment]: # ({/c52b2df3-c52b2df3}) [comment]: # ({ff7388b9-2773fc24}) ### Vue d'ensemble Les paramètres pris en charge par le fichier de configuration de l'agent Zabbix (zabbix\_agentd.conf) sont répertoriés dans cette section. Les paramètres sont listés sans informations supplémentaires. Cliquez sur le paramètre pour afficher les détails complets. |Parameter|Description| |--|--------| |[Alias](#alias)|Définit un alias pour une clé d'élément.| |[AllowKey](#allowkey)|Autorise l'exécution des clés d'élément qui correspondent à un motif.| |[AllowRoot](#allowroot)|Autorise l'agent à s'exécuter en tant que 'root'.| |[BufferSend](#buffersend)|Ne conserve pas les données plus de N secondes dans le tampon.| |[BufferSize](#buffersize)|Le nombre maximal de valeurs dans le tampon mémoire.| |[DebugLevel](#debuglevel)|Le niveau de débogage.| |[DenyKey](#denykey)|Interdit l'exécution des clés d'élément qui correspondent à un motif.| |[EnableRemoteCommands](#enableremotecommands)|Indique si les commandes distantes provenant du serveur Zabbix sont autorisées.| |[HeartbeatFrequency](#heartbeatfrequency)|La fréquence des messages de battement de coeur, en secondes.| |[HostInterface](#hostinterface)|Paramètre facultatif qui définit l'interface de l'hôte.| |[HostInterfaceItem](#hostinterfaceitem)|Paramètre facultatif qui définit un élément utilisé pour obtenir l'interface de l'hôte.| |[HostMetadata](#hostmetadata)|Paramètre facultatif qui définit les métadonnées de l'hôte.| |[HostMetadataItem](#hostmetadataitem)|Paramètre facultatif qui définit un élément de l'agent Zabbix utilisé pour obtenir les métadonnées de l'hôte.| |[Hostname](#hostname)|Paramètre facultatif qui définit le nom d'hôte.| |[HostnameItem](#hostnameitem)|Paramètre facultatif qui définit un élément de l'agent Zabbix utilisé pour obtenir le nom d'hôte.| |[Include](#include)|Vous pouvez inclure des fichiers individuels ou tous les fichiers d'un répertoire dans le fichier de configuration.| |[ListenBacklog](#listenbacklog)|Le nombre maximal de connexions en attente dans la file d'attente TCP.| |[ListenIP](#listenip)|Liste d'adresses IP séparées par des virgules sur lesquelles l'agent doit écouter.| |[ListenPort](#listenport)|L'agent écoutera sur ce port les connexions provenant du serveur.| |[LoadModule](#loadmodule)|Le module à charger au démarrage de l'agent.| |[LoadModulePath](#loadmodulepath)|Le chemin complet vers l'emplacement des modules de l'agent.| |[LogFile](#logfile)|Le nom du fichier journal.| |[LogFileSize](#logfilesize)|La taille maximale du fichier journal.| |[LogRemoteCommands](#logremotecommands)|Active la journalisation des commandes shell exécutées en tant qu'avertissements.| |[LogType](#logtype)|Le type de sortie du journal.| |[MaxLinesPerSecond](#maxlinespersecond)|Le nombre maximal de nouvelles lignes que l'agent enverra par seconde au serveur Zabbix ou au proxy lors du traitement des vérifications actives 'log' et 'logrt'.| |[PidFile](#pidfile)|Le nom du fichier PID.| |[RefreshActiveChecks](#refreshactivechecks)|Fréquence de rafraîchissement de la liste des vérifications actives.| |[Server](#server)|Liste d'adresses IP séparées par des virgules, éventuellement en notation CIDR, ou de noms DNS des serveurs Zabbix et des proxies Zabbix.| |[ServerActive](#serveractive)|Adresse du serveur Zabbix/proxy ou configuration de cluster à partir de laquelle obtenir les vérifications actives.| |[SourceIP](#sourceip)|L'adresse IP source.| |[StartAgents](#startagents)|Nombre d'instances pré-forkées de zabbix\_agentd qui traitent les vérifications passives.| |[Timeout](#timeout)|Spécifie combien de temps attendre, en secondes, l'établissement de la connexion et l'échange de données avec le proxy ou le serveur Zabbix.| |[TLSAccept](#tlsaccept)|Types de connexions entrantes à accepter.| |[TLSCAFile](#tlscafile)|Chemin complet d'un fichier contenant les certificats des AC racines pour la vérification du certificat du pair, utilisé pour les communications chiffrées entre les composants Zabbix.| |[TLSCertFile](#tlscertfile)|Chemin complet d'un fichier contenant le certificat de l'agent ou la chaîne de certificats, utilisé pour les communications chiffrées entre les composants Zabbix.| |[TLSCipherAll](#tlscipherall)|Chaîne de priorité GnuTLS ou chaîne de suites de chiffrement OpenSSL (TLS 1.2). Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur les certificats et PSK.| |[TLSCipherAll13](#tlscipherall13)|Chaîne de suites de chiffrement pour OpenSSL 1.1.1 ou version ultérieure en TLS 1.3. Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur les certificats et PSK.| |[TLSCipherCert](#tlsciphercert)|Chaîne de priorité GnuTLS ou chaîne de suites de chiffrement OpenSSL (TLS 1.2). Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur les certificats.| |[TLSCipherCert13](#tlsciphercert13)|Chaîne de suites de chiffrement pour OpenSSL 1.1.1 ou version ultérieure en TLS 1.3. Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur les certificats.| |[TLSCipherPSK](#tlscipherpsk)|Chaîne de priorité GnuTLS ou chaîne de suites de chiffrement OpenSSL (TLS 1.2). Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur PSK.| |[TLSCipherPSK13](#tlscipherpsk13)|Chaîne de suites de chiffrement pour OpenSSL 1.1.1 ou version ultérieure en TLS 1.3. Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur PSK.| |[TLSConnect](#tlsconnect)|La manière dont l'agent doit se connecter au serveur ou au proxy Zabbix.| |[TLSCRLFile](#tlscrlfile)|Chemin complet d'un fichier contenant les certificats révoqués. Ce paramètre est utilisé pour les communications chiffrées entre les composants Zabbix.| |[TLSKeyFile](#tlskeyfile)|Chemin complet d'un fichier contenant la clé privée de l'agent, utilisée pour les communications chiffrées entre les composants Zabbix.| |[TLSPSKFile](#tlspskfile)|Chemin complet d'un fichier contenant la clé pré-partagée de l'agent, utilisée pour les communications chiffrées avec le serveur Zabbix.| |[TLSPSKIdentity](#tlspskidentity)|Chaîne d'identité de la clé pré-partagée, utilisée pour les communications chiffrées avec le serveur Zabbix.| |[TLSServerCertIssuer](#tlsservercertissuer)|Émetteur de certificat du serveur (proxy) autorisé.| |[TLSServerCertSubject](#tlsservercertsubject)|Sujet du certificat du serveur (proxy) autorisé.| |[UnsafeUserParameters](#unsafeuserparameters)|Autorise le passage de tous les caractères dans les arguments des paramètres définis par l'utilisateur.| |[User](#user)|Abaisse les privilèges vers un utilisateur spécifique existant sur le système.| |[UserParameter](#userparameter)|Paramètre défini par l'utilisateur à surveiller.| |[UserParameterDir](#userparameterdir)|Chemin de recherche par défaut pour les commandes UserParameter.| Tous les paramètres sont facultatifs, sauf indication explicite qu'un paramètre est obligatoire. Notez que : - Les valeurs par défaut reflètent les valeurs par défaut du démon, et non celles des fichiers de configuration fournis ; - Zabbix prend en charge les fichiers de configuration uniquement en encodage UTF-8 sans [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) ; - Les commentaires commençant par "\#" ne sont pris en charge qu'au début de la ligne. [comment]: # ({/ff7388b9-2773fc24}) [comment]: # ({8085875f-bb271b3c}) ### Détails du paramètre [comment]: # ({/8085875f-bb271b3c}) [comment]: # ({f3842378-20d32ed1}) ##### Alias 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 courte et plus simple.
Plusieurs paramètres *Alias* peuvent être présents. Plusieurs paramètres avec la même clé *Alias* ne sont pas autorisés.
Différentes clés *Alias* peuvent référencer la même clé d'élément.
Les alias peuvent être utilisés dans *HostMetadataItem* mais pas dans le paramètre *HostnameItem*. Exemple 1 : Récupération de l'ID de l'utilisateur 'zabbix'. ```default 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. Exemple 2 : Obtention de l'utilisation CPU avec des paramètres par défaut et personnalisés. ```default 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 CPU 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 CPU. Exemple 3 : Exécution de plusieurs règles [de découverte de bas niveau](/manual/discovery/low_level_discovery) traitant les mêmes éléments découverts. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Il est désormais possible de configurer plusieurs règles de découverte en utilisant **vfs.fs.discovery** avec des paramètres différents pour chaque règle, par exemple **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc. [comment]: # ({/f3842378-20d32ed1}) [comment]: # ({3ed0c834-f52682cc}) ##### AllowKey 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és peuvent être définies en combinaison avec DenyKey. Les paramètres sont traités un par un selon leur ordre d'apparition. Voir aussi: [Restricting agent checks](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-f52682cc}) [comment]: # ({f4e3ae7a-a02d0dc0}) ##### AllowRoot Autoriser l'agent à s'exécuter en tant que 'root'. Si cette option est désactivée et que l'agent est démarré par 'root', l'agent tentera de basculer vers l'utilisateur 'zabbix' à la place. Sans effet si l'agent est démarré sous un utilisateur standard. Par défaut: `0`
Valeurs: 0 - ne pas autoriser; 1 - autoriser [comment]: # ({/f4e3ae7a-a02d0dc0}) [comment]: # ({fce8e2ee-12f60552}) ##### BufferSend Ne conservez pas les données plus de N secondes dans le tampon. Par défaut: `5`
Plage: 1-3600 [comment]: # ({/fce8e2ee-12f60552}) [comment]: # ({3033154f-397065ee}) ##### BufferSize Le nombre maximal de valeurs dans le tampon mémoire. L'agent enverra toutes les données collectées au serveur Zabbix ou au proxy si le tampon est plein. Par défaut: `100`
Plage: 2-65535 [comment]: # ({/3033154f-397065ee}) [comment]: # ({9c071f70-e5288ea7}) ##### DebugLevel Spécifiez le niveau de débogage :
*0* - informations de base sur le démarrage et l'arrêt des processus Zabbix
*1* - informations critiques;
*2* - informations d'erreur;
*3* - avertissements;
*4* - pour le débogage (génère beaucoup d'informations);
*5* - débogage étendu (génère encore plus d'informations). Par défaut : `3`
Plage : 0-5 [comment]: # ({/9c071f70-e5288ea7}) [comment]: # ({26eddabd-ef1d8b77}) ##### DenyKey Interdire 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és peuvent être définies en combinaison avec AllowKey. Les paramètres sont traités un par un selon leur ordre d'apparition. Voir aussi : [Restriction des vérifications de l'agent](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-ef1d8b77}) [comment]: # ({80a7ec45-50dcbfc8}) ##### EnableRemoteCommands Indique si les commandes à distance provenant du serveur Zabbix sont autorisées. Ce paramètre est **obsolète** ; utilisez plutôt AllowKey=system.run\[\*\] ou DenyKey=system.run\[\*\].
Il s'agit d'un alias interne des paramètres AllowKey/DenyKey selon la valeur :
0 - DenyKey=system.run\[\*\]
1 - AllowKey=system.run\[\*\] Valeur par défaut : `0`
Valeurs : 0 - ne pas autoriser, 1 - autoriser [comment]: # ({/80a7ec45-50dcbfc8}) [comment]: # ({70ff69c8-764c3d3c}) ##### HeartbeatFrequency La fréquence des messages de heartbeat en secondes. Utilisée pour surveiller la disponibilité des vérifications actives.
0 - messages de heartbeat désactivés. Par défaut: `60`
Plage: 0-3600 [comment]: # ({/70ff69c8-764c3d3c}) [comment]: # ({cd35abda-e514f4a5}) ##### HostInterface Un paramètre facultatif qui définit l'interface de l'hôte (adresse IP ou nom DNS) utilisée pendant le processus d'[enregistrement automatique](/manual/discovery/auto_registration) de l'hôte. Cette valeur sera utilisée pour renseigner l'interface dans le nouvel hôte créé et permet de configurer explicitement une adresse IP ou DNS. Pour plus de détails, voir [Utiliser DNS comme interface par défaut](/manual/discovery/auto_registration#using-dns-as-default-interface). Si elle n'est pas définie, la valeur sera obtenue à partir de HostInterfaceItem. L'agent signalera une erreur et ne démarrera pas si la valeur dépasse la limite de 255 caractères. Plage : 0-255 caractères [comment]: # ({/cd35abda-e514f4a5}) [comment]: # ({dc29c465-4965ac2b}) ##### HostInterfaceItem Un paramètre facultatif qui définit un élément utilisé pour déterminer l'interface de l'hôte (adresse IP ou nom DNS) pendant le processus [d'autoréenregistrement](/manual/discovery/auto_registration) de l'hôte. Cette valeur est utilisée uniquement si HostInterface n'est pas défini. Pour plus de détails, consultez [Utiliser DNS comme interface par défaut](/manual/discovery/auto_registration#using-dns-as-default-interface). Lors d'une requête d'autoréenregistrement, l'agent consignera un message d'avertissement si la valeur renvoyée par l'élément spécifié dépasse la limite de 255 caractères. L'élément [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) est pris en charge indépendamment des paramètres AllowKey/DenyKey. [comment]: # ({/dc29c465-4965ac2b}) [comment]: # ({ed067cab-42990e42}) ##### HostMetadata Un paramètre facultatif qui définit les [métadonnées](/manual/discovery/auto_registration#using-host-metadata) utilisées pour identifier ou distinguer l'hôte pendant le processus d'[autoregistration](/manual/discovery/auto_registration) de l'hôte (agent actif). HostMetadata permet de distinguer les hôtes au-delà du nom d'hôte. Si elle n'est pas définie, la valeur sera récupérée à partir de HostMetadataItem. L'agent signalera une erreur et ne démarrera pas si la valeur spécifiée dépasse la limite de 2034 octets ou s'il s'agit d'une chaîne non UTF-8. Lorsqu'un paramètre attend une adresse IP ou un nom DNS, les valeurs valides en UTF-8 mais qui ne sont pas des IP ou des noms DNS valides seront également rejetées et signalées comme invalides. Les métadonnées multilignes ne sont pas prises en charge — la sortie sera tronquée au premier saut de ligne. Plage: 0-2034 octets [comment]: # ({/ed067cab-42990e42}) [comment]: # ({b83b65c3-953ee255}) ##### HostMetadataItem Un paramètre facultatif qui définit un élément d'agent Zabbix utilisé pour obtenir les [métadonnées de l'hôte](/manual/discovery/auto_registration#using-host-metadata). Cette option est utilisée uniquement lorsque HostMetadata n'est pas défini. La valeur de HostMetadataItem est récupérée à chaque tentative d'[auto-enregistrement](/manual/discovery/auto_registration) et n'est utilisée que lors du processus d'auto-enregistrement de l'hôte (agent actif). HostMetadataItem permet de distinguer les hôtes au-delà du nom d'hôte. Les paramètres utilisateur et les alias sont pris en charge. L'élément [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) est pris en charge indépendamment des paramètres AllowKey/DenyKey. Lors d'une demande d'auto-enregistrement, l'agent consignera un message d'avertissement si la valeur renvoyée par l'élément spécifié dépasse la limite de 65535 points de code UTF-8. La valeur renvoyée par l'élément doit être une chaîne UTF-8, sinon elle sera ignorée. Lorsqu'un paramètre attend une adresse IP ou un nom DNS, les valeurs valides en UTF-8 mais non valides en tant qu'adresses IP ou noms DNS seront également rejetées et signalées comme invalides. Les métadonnées multilignes ne sont pas prises en charge — la sortie sera tronquée au premier saut de ligne. [comment]: # ({/b83b65c3-953ee255}) [comment]: # ({39406dda-79d09548}) ##### Nom d'hôte Une liste de noms d'hôte uniques, sensibles à la casse et séparés par des virgules. 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 obtenue à partir de HostnameItem si elle n'est pas définie.
Caractères autorisés: alphanumériques, '.', ' ', '\_' et '-'. Longueur maximale: 128 caractères par nom d'hôte, 2048 caractères pour l'ensemble de la ligne. Par défaut: défini par HostnameItem [comment]: # ({/39406dda-79d09548}) [comment]: # ({5dd0215d-14aaef49}) ##### HostnameItem Un paramètre facultatif qui définit un élément d'agent Zabbix utilisé pour obtenir le nom de l'hôte. Cette option n'est utilisée que lorsque Hostname n'est pas défini. Les paramètres utilisateur ou les alias ne sont pas pris en charge, mais l'élément [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) est pris en charge indépendamment des valeurs AllowKey/DenyKey. Par défaut: `system.hostname` [comment]: # ({/5dd0215d-14aaef49}) [comment]: # ({3ae9ed9c-1e31f1b3}) ##### Inclure Vous pouvez inclure des fichiers individuels ou tous les fichiers d'un répertoire dans le fichier de configuration. Pour n'inclure que les fichiers pertinents dans le répertoire spécifié, le caractère générique astérisque est pris en charge pour la correspondance de motifs.
Consultez les [notes spéciales](special_notes_include) concernant les limitations. Exemple : ```default Include=/absolute/path/to/config/files/*.conf ``` [comment]: # ({/3ae9ed9c-1e31f1b3}) [comment]: # ({fcd70e26-d49e31a2}) ##### ListenBacklog Le nombre maximal de connexions en attente dans la file TCP.
La valeur par défaut est une constante codée en dur, qui dépend du système.
La valeur maximale prise en charge dépend également du système ; des valeurs trop élevées peuvent être tronquées silencieusement à la « valeur maximale spécifiée par l'implémentation ». Par défaut: `SOMAXCONN`
Plage: 0 - INT\_MAX [comment]: # ({/fcd70e26-d49e31a2}) [comment]: # ({35f278c7-62349c68}) ##### ListenIP Une liste d'adresses IP séparées par des virgules sur lesquelles l'agent doit écouter. Par défaut: `0.0.0.0` [comment]: # ({/35f278c7-62349c68}) [comment]: # ({5f95bc53-e99b72c0}) ##### ListenPort L'agent écoutera sur ce port pour les connexions provenant du serveur. Par défaut: `10050`
Plage: 1024-32767 [comment]: # ({/5f95bc53-e99b72c0}) [comment]: # ({f4dfc794-fb75d239}) ##### LoadModule Le module à charger au démarrage de l'agent. Les modules sont utilisés pour étendre les fonctionnalités de l'agent. Le module doit se trouver dans le répertoire spécifié par LoadModulePath ou le chemin doit précéder le nom du module. Si le chemin précédent est absolu (commence par '/') alors LoadModulePath est ignoré.
Formats :
LoadModule=
LoadModule=
LoadModule=
Il est permis d'inclure plusieurs paramètres LoadModule. [comment]: # ({/f4dfc794-fb75d239}) [comment]: # ({b88f1651-bd604c99}) ##### LoadModulePath Le chemin complet vers l'emplacement des modules de l'agent. La valeur par défaut dépend des options de compilation. [comment]: # ({/b88f1651-bd604c99}) [comment]: # ({ce9b40ca-bb5252d8}) ##### LogFile Le nom du fichier journal. Obligatoire : Oui, si LogType est défini sur *file* ; sinon non [comment]: # ({/ce9b40ca-bb5252d8}) [comment]: # ({f7604f8f-778f1edc}) ##### LogFileSize La taille maximale d'un fichier journal en MB.
0 - désactive la rotation automatique des journaux.
*Remarque* : si la limite de taille du fichier journal est atteinte et que la rotation du fichier échoue, quelle qu'en soit la raison, le fichier journal existant est tronqué et recréé. Par défaut : `1`
Plage : 0-1024 [comment]: # ({/f7604f8f-778f1edc}) [comment]: # ({0dac5c2b-3d97cc10}) ##### LogRemoteCommands Active l'enregistrement des commandes shell exécutées en tant qu'avertissements. Les commandes ne seront consignées que si elles sont exécutées à distance. Aucune entrée de journal ne sera créée si system.run\[\] est lancé localement par les paramètres HostMetadataItem, HostInterfaceItem ou HostnameItem. Par défaut: `0`
Valeurs: 0 - désactivé, 1 - activé [comment]: # ({/0dac5c2b-3d97cc10}) [comment]: # ({ae46be35-9d26f327}) ##### LogType Le type de sortie du journal :
*file* - écrit le journal dans le fichier spécifié par le paramètre LogFile ;
*system* - écrit le journal dans syslog ;
*console* - écrit le journal sur la sortie standard. Par défaut : `file` [comment]: # ({/ae46be35-9d26f327}) [comment]: # ({8e341c19-7d39adb8}) ##### MaxLinesPerSecond Le nombre maximal de nouvelles lignes que l'agent enverra par seconde au serveur Zabbix ou au proxy lors du traitement des vérifications actives 'log' et 'logrt'. La valeur fournie sera remplacée par le paramètre 'maxlines', fourni dans la clé d'élément 'log' ou 'logrt'.
*Note* : Zabbix traitera 10 fois plus de nouvelles lignes que la valeur définie dans *MaxLinesPerSecond* afin de rechercher la chaîne requise dans les éléments de journal. Par défaut : `20`
Plage : 1-1000 [comment]: # ({/8e341c19-7d39adb8}) [comment]: # ({3d558d6c-8a5c9259}) ##### PidFile Le nom du fichier PID. Par défaut : `/tmp/zabbix_agentd.pid` [comment]: # ({/3d558d6c-8a5c9259}) [comment]: # ({3d47a4c2-b62afa60}) ##### RefreshActiveChecks Fréquence de rafraîchissement de la liste des vérifications actives, en secondes. Notez qu'après un échec de rafraîchissement des vérifications actives, la prochaine tentative de rafraîchissement sera effectuée dans 60 secondes. Par défaut: `5`
Plage: 1-86400 [comment]: # ({/3d47a4c2-b62afa60}) [comment]: # ({b967fca0-46329efe}) ##### Serveur Une liste d'adresses IP séparées par des virgules, éventuellement en notation CIDR, ou des noms DNS des serveurs Zabbix et des proxies Zabbix. Les connexions entrantes ne seront acceptées que depuis les hôtes répertoriés ici. Si la prise en charge d'IPv6 est activée, alors '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' sont traitées de la même manière et '::/0' autorisera toute adresse IPv4 ou IPv6. '0.0.0.0/0' peut être utilisé pour autoriser toute adresse IPv4. Notez que les "adresses IPv6 compatibles IPv4" (préfixe 0000::/96) sont prises en charge mais déconseillées par [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5). Les espaces sont autorisés. Exemple : ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` Obligatoire : oui, si StartAgents n'est pas explicitement défini sur 0 [comment]: # ({/b967fca0-46329efe}) [comment]: # ({85302681-d6a09b20}) ##### ServerActive L'adresse du serveur/proxy Zabbix ou la configuration du cluster à partir de laquelle récupérer les vérifications actives. L'adresse du serveur/proxy est une adresse IP ou un nom DNS, avec un port facultatif séparé par deux-points.
La configuration du cluster est constituée d'une ou plusieurs adresses de membres de groupe de serveur ou de proxy séparées par un point-virgule. Plusieurs serveurs/clusters Zabbix et proxies Zabbix peuvent être spécifiés, séparés par une virgule. Sauf en cas d'utilisation de groupes de proxy, il ne faut pas spécifier plus d'un proxy Zabbix pour chaque serveur/cluster Zabbix. Si un proxy Zabbix est spécifié, alors le serveur/cluster Zabbix correspondant à ce proxy ne doit pas être spécifié.
Plusieurs adresses séparées par des virgules peuvent être fournies pour utiliser plusieurs serveurs Zabbix 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 placées 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 un proxy Zabbix : ```default ServerActive=127.0.0.1:10051 ``` Exemple pour un groupe de proxy Zabbix : ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com Exemple pour plusieurs serveurs : ```default ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1] ``` Exemple pour la haute disponibilité : ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` Exemple pour la haute disponibilité avec deux clusters et un serveur : ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/85302681-d6a09b20}) [comment]: # ({76194937-020cc066}) ##### SourceIP L'adresse IP source pour : - les connexions sortantes vers le serveur Zabbix ou le proxy Zabbix ; - l'établissement de connexions lors de l'exécution de certains éléments (web.page.get, net.tcp.port, etc.). [comment]: # ({/76194937-020cc066}) [comment]: # ({8e63fa32-6e2d3567}) ##### StartAgents Le nombre d'instances pré-forkées de zabbix\_agentd qui traitent les vérifications passives. Si la valeur est définie sur 0, les vérifications passives sont désactivées et l'agent n'écoutera sur aucun port TCP. Par défaut: `10`
Plage: 0-100 [comment]: # ({/8e63fa32-6e2d3567}) [comment]: # ({b0f05ae1-ee64bcdf}) ##### Délai d'attente Spécifie la durée d'attente, en secondes, pour établir la connexion et échanger des données avec un proxy ou un serveur Zabbix.
Ce paramètre définit la durée de diverses opérations de communication, notamment : - l'attente d'une réponse du serveur Zabbix ; - l'envoi de requêtes au serveur Zabbix, y compris les requêtes de configuration des éléments et les données des éléments dans les [vérifications actives](/manual/appendix/items/activepassive#active-checks) ; - la récupération des données de journal via logfile ; - l'envoi de messages de heartbeat ; - la durée maximale des vérifications `vfs.*` ; - l'utilisation par les modules de l'agent Zabbix ; - le rôle de solution de repli dans les scénarios où un serveur ou un proxy antérieur à la version 7.0 envoie des vérifications sans délais d'attente. Ce délai d'attente **ne sera pas** utilisé pour les vérifications d'agent qui disposent de paramètres de délai d'attente configurables dans l'interface (au niveau global, du proxy ou par élément). Par défaut : `3`
Plage : 1-30 [comment]: # ({/b0f05ae1-ee64bcdf}) [comment]: # ({613f7954-849f8496}) ##### TLSAccept Quelles connexions entrantes accepter. Utilisé pour les vérifications passives. Plusieurs valeurs peuvent être spécifiées, séparées par des virgules :
*unencrypted* - accepter les connexions sans chiffrement (par défaut)
*psk* - accepter les connexions avec TLS et une clé prépartagée (PSK)
*cert* - accepter les connexions avec TLS et un certificat Obligatoire : oui, si les paramètres de certificat TLS ou de PSK sont définis (même pour une connexion *unencrypted*) ; sinon non [comment]: # ({/613f7954-849f8496}) [comment]: # ({65d07bda-336a620d}) ##### TLSCAFile Le chemin d'accès complet du fichier contenant le ou les certificats de l'autorité de certification racine utilisés pour la vérification du certificat du pair, employé pour les communications chiffrées entre les composants Zabbix. [comment]: # ({/65d07bda-336a620d}) [comment]: # ({005f60f1-185ad3c6}) ##### TLSCertFile Le chemin d'accès complet du fichier contenant le certificat de l'agent ou la chaîne de certificats, utilisé pour les communications chiffrées avec les composants Zabbix. [comment]: # ({/005f60f1-185ad3c6}) [comment]: # ({84033417-3e9bf2b8}) ##### TLSCipherAll La chaîne de priorité GnuTLS ou la chaîne de suites de chiffrement OpenSSL (TLS 1.2). Remplace les critères de sélection par défaut des suites de chiffrement pour le chiffrement basé sur les certificats et sur PSK. Exemple : ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/84033417-3e9bf2b8}) [comment]: # ({a9e7f94f-03e7f520}) ##### TLSCipherAll13 La chaîne de chiffrement pour OpenSSL 1.1.1 ou une version plus récente en TLS 1.3. Remplace les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur les certificats et sur PSK. Exemple pour GnuTLS : ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509 ``` Exemple pour OpenSSL : ``` EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/a9e7f94f-03e7f520}) [comment]: # ({00c9e2e3-f7468437}) ##### TLSCipherCert La chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplace les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur des certificats. Exemple pour GnuTLS : ```default NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509 ``` Exemple pour OpenSSL : ```default EECDH+aRSA+AES128:RSA+aRSA+AES128 ``` [comment]: # ({/00c9e2e3-f7468437}) [comment]: # ({fdf185a8-717d9f51}) ##### TLSCipherCert13 La chaîne de chiffrement pour OpenSSL 1.1.1 ou une version plus récente en TLS 1.3. Remplacez les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur des certificats. [comment]: # ({/fdf185a8-717d9f51}) [comment]: # ({c201c168-3a633a0a}) ##### TLSCipherPSK La chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacez les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur PSK. Exemple pour GnuTLS : ```default NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL ``` Exemple pour OpenSSL : ```default kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/c201c168-3a633a0a}) [comment]: # ({c74deda4-8208c770}) ##### TLSCipherPSK13 La chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure en TLS 1.3. Remplacez les critères de sélection de la suite de chiffrement par défaut pour le chiffrement basé sur PSK. Exemple : ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/c74deda4-8208c770}) [comment]: # ({e2ebc18f-b1151069}) ##### TLSConnect Comment l'agent doit se connecter au serveur ou au proxy Zabbix. 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 en utilisant TLS et une clé prépartagée (PSK)
*cert* - se connecter en utilisant TLS et un certificat Obligatoire : oui, si les paramètres du certificat TLS ou du PSK sont définis (même pour une connexion *unencrypted*) ; sinon non [comment]: # ({/e2ebc18f-b1151069}) [comment]: # ({ad4dc889-28aef301}) ##### TLSCRLFile Le chemin d'accès complet du fichier contenant les certificats révoqués. Ce paramètre est utilisé pour les communications chiffrées entre les composants Zabbix. [comment]: # ({/ad4dc889-28aef301}) [comment]: # ({c2aa4315-cbcbba0a}) ##### TLSKeyFile Le chemin d'accès complet du fichier contenant la clé privée de l'agent, utilisé pour les communications chiffrées entre les composants Zabbix. [comment]: # ({/c2aa4315-cbcbba0a}) [comment]: # ({11defa44-845f5b70}) ##### TLSPSKFile Le chemin d'accès complet du fichier contenant la clé pré-partagée de l'agent, utilisée pour les communications chiffrées avec le serveur Zabbix. [comment]: # ({/11defa44-845f5b70}) [comment]: # ({92d3eff0-b02e4942}) ##### TLSPSKIdentity La chaîne d'identité de la clé prépartagée, utilisée pour les communications chiffrées avec le serveur Zabbix. [comment]: # ({/92d3eff0-b02e4942}) [comment]: # ({ae5c568f-7a78525c}) ##### TLSServerCertIssuer L'émetteur autorisé du certificat du serveur (proxy). [comment]: # ({/ae5c568f-7a78525c}) [comment]: # ({fb69617f-c8d1ac8b}) ##### TLSServerCertSubject Le sujet du certificat du serveur (proxy) autorisé. [comment]: # ({/fb69617f-c8d1ac8b}) [comment]: # ({8fffe818-676eb24d}) ##### UnsafeUserParameters Autoriser tous les caractères à être transmis 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 nouvelle ligne ne sont pas autorisés. Par défaut : `0`
Valeurs : 0 - ne pas autoriser, 1 - autoriser [comment]: # ({/8fffe818-676eb24d}) [comment]: # ({ee4ad0a4-e9779b31}) ##### Utilisateur Abaisser les privilèges à un utilisateur spécifique existant sur le système.
Ne prend effet que si l'exécution est effectuée en tant que 'root' et si AllowRoot est désactivé. Par défaut: `zabbix` [comment]: # ({/ee4ad0a4-e9779b31}) [comment]: # ({1a5d86ec-1591e129}) ##### UserParameter Un paramètre défini par l'utilisateur pour la surveillance. Il peut y avoir plusieurs paramètres définis par l'utilisateur.
Format : UserParameter=,
Notez que la commande shell ne doit pas renvoyer une chaîne vide ni uniquement un EOL. Les commandes shell peuvent utiliser des chemins relatifs si le paramètre UserParameterDir est spécifié. Exemple : ```default UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh ``` [comment]: # ({/1a5d86ec-1591e129}) [comment]: # ({0a46abda-493da8fd}) ##### UserParameterDir Le chemin de recherche par défaut pour les commandes UserParameter. Si cette option est utilisée, l'agent changera son répertoire de travail vers celui spécifié ici avant d'exécuter une commande. Ainsi, les commandes UserParameter peuvent utiliser un préfixe relatif `./` au lieu d'un chemin complet.
Une seule entrée est autorisée. Exemple : ```default UserParameterDir=/opt/myscripts ``` [comment]: # ({/0a46abda-493da8fd}) [comment]: # ({94f69fcc-9170c364}) #### Voir aussi 1. [Différences dans la configuration de l'agent Zabbix pour les vérifications actives et passives à partir de la version 2.0.0](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858) [comment]: # ({/94f69fcc-9170c364})