Paramètres de configuration: Zabbix agent
Vue d’ensemble
Les paramètres de configuration permettent de personnaliser le comportement de l’agent Zabbix.
Indiquez les valeurs des paramètres dans le fichier de configuration de l’agent Zabbix (zabbix_agentd.conf).
Tous les paramètres sont facultatifs, sauf indication explicite contraire.
Cette page est structurée comme suit :
- Vue d’ensemble des paramètres (pour afficher tous les détails d’un paramètre, cliquez sur son nom)
- Détails des paramètres
| Paramètre | Description |
|---|---|
| Alias | Définir un alias pour une clé d’élément. |
| AllowKey | Autoriser l’exécution des clés d’élément correspondant à un modèle. |
| AllowKeyRegexp | Autoriser l’exécution des clés d’élément correspondant à un modèle basé sur une expression régulière. |
| AllowRoot | Autoriser l’agent à s’exécuter en tant que root. |
| BufferSend | Définir la fréquence d’envoi des valeurs de la mémoire tampon au serveur/proxy Zabbix. |
| BufferSize | Définir le nombre maximal de valeurs dans la mémoire tampon. |
| DebugLevel | Définir le niveau de débogage. |
| DenyKey | Interdire l’exécution des clés d’élément correspondant à un modèle. |
| DenyKeyRegexp | Interdire l’exécution des clés d’élément correspondant à un modèle basé sur une expression régulière. |
| EnableRemoteCommands | Autoriser les commandes distantes provenant du serveur Zabbix. |
| HeartbeatFrequency | Définir la fréquence des messages de pulsation, en secondes. |
| HostInterface | Indiquer l’interface du hôte. |
| HostInterfaceItem | Indiquer un élément permettant d’obtenir l’interface du hôte. |
| HostMetadata | Indiquer les métadonnées du hôte. |
| HostMetadataItem | Indiquer un élément de l’agent Zabbix permettant d’obtenir les métadonnées du hôte. |
| Hostname | Indiquer le nom du hôte. |
| HostnameItem | Indiquer un élément de l’agent Zabbix permettant d’obtenir le nom du hôte. |
| Include | Indiquer un répertoire ou des fichiers individuels à inclure dans le fichier de configuration. |
| ListenBacklog | Définir le nombre maximal de connexions en attente dans la file TCP. |
| ListenIP | Indiquer l’adresse IP d’écoute de l’agent pour les connexions provenant du serveur/proxy. |
| ListenPort | Indiquer le port d’écoute de l’agent. |
| LoadModule | Indiquer le module à charger au démarrage de l’agent. |
| LoadModulePath | Indiquer le chemin complet vers l’emplacement des modules de l’agent. |
| LogFile | Indiquer le fichier journal de l’agent. |
| LogFileSize | Définir la taille maximale du fichier journal. |
| LogRemoteCommands | Activer la journalisation des commandes shell exécutées en tant qu’avertissements. |
| LogType | Indiquer le type de sortie du journal. |
| MaxLinesPerSecond | Définir le nombre maximal de nouvelles lignes par seconde à envoyer au serveur/proxy Zabbix lors du traitement des vérifications actives log ou logrt. |
| PidFile | Indiquer le fichier PID. |
| RefreshActiveChecks | Indiquer la fréquence d’actualisation de la liste des vérifications actives. |
| Server | Indiquer les adresses IP ou les noms DNS des serveurs/proxies Zabbix. |
| ServerActive | Indiquer l’adresse du serveur/proxy Zabbix ou la configuration du cluster depuis laquelle obtenir les vérifications actives. |
| SourceIP | Indiquer l’adresse IP source. |
| StartAgents | Définir le nombre d’instances pré-forkées de zabbix_agentd pour le traitement des vérifications passives. |
| Timeout | Indiquer le délai d’attente (en secondes) pour établir la connexion et échanger des données avec le proxy ou le serveur Zabbix. |
| TLSAccept | Indiquer le niveau de chiffrement requis pour les connexions entrantes. |
| TLSCAFile | Indiquer le chemin complet du fichier contenant les certificats de l’autorité de certification (CA) de niveau supérieur pour la vérification du certificat du pair, utilisé pour les communications chiffrées entre les composants Zabbix. |
| TLSCertFile | Indiquer le chemin complet du fichier contenant le certificat ou la chaîne de certificats de l’agent, utilisé pour les communications chiffrées entre les composants Zabbix. |
| TLSCipherAll | Indiquer la chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur un certificat et sur une clé pré-partagée (PSK). |
| TLSCipherAll13 | Indiquer la chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure avec TLS 1.3. Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur un certificat et sur une clé pré-partagée (PSK). |
| TLSCipherCert | Indiquer la chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur un certificat. |
| TLSCipherCert13 | Indiquer la chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure avec TLS 1.3. Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur un certificat. |
| TLSCipherPSK | Indiquer la chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur une clé pré-partagée (PSK). |
| TLSCipherPSK13 | Indiquer la chaîne de chiffrement pour OpenSSL 1.1.1 ou version ultérieure avec TLS 1.3. Remplacer les critères de sélection par défaut de la suite de chiffrement pour le chiffrement basé sur une clé pré-partagée (PSK). |
| TLSConnect | Indiquer le niveau de chiffrement requis pour les connexions au serveur ou au proxy Zabbix. |
| TLSCRLFile | Indiquer le chemin complet du fichier contenant les certificats révoqués. Ce paramètre est utilisé pour les communications chiffrées entre les composants Zabbix. |
| TLSKeyFile | Indiquer le chemin complet du fichier contenant la clé privée de l’agent, utilisée pour les communications chiffrées entre les composants Zabbix. |
| TLSPSKFile | Indiquer le chemin complet du fichier contenant la clé pré-partagée de l’agent, utilisée pour les communications chiffrées avec le serveur ou le proxy Zabbix. |
| TLSPSKIdentity | Indiquer la chaîne d’identité de la clé pré-partagée, utilisée pour les communications chiffrées avec le serveur ou le proxy Zabbix. |
| TLSServerCertIssuer | Indiquer l’émetteur autorisé du certificat du serveur (proxy). |
| TLSServerCertSubject | Indiquer le sujet autorisé du certificat du serveur (proxy). |
| UnsafeUserParameters | Autoriser le passage de tous les caractères dans les arguments des paramètres définis par l’utilisateur. |
| User | Abandonner les privilèges au profit d’un utilisateur spécifique existant sur le système. |
| UserParameter | Indiquer un paramètre défini par l’utilisateur à surveiller. |
| UserParameterDir | Indiquer le chemin de recherche par défaut des commandes UserParameter. |
Notez que :
- Les valeurs par défaut correspondent aux valeurs par défaut du daemon, et non aux valeurs des fichiers de configuration fournis.
- Les valeurs prennent en charge les variables d’environnement.
- Zabbix prend uniquement en charge les fichiers de configuration encodés en UTF-8 sans BOM.
- Les commentaires commençant par
#sont pris en charge uniquement au début de la ligne.
Détails du paramètre
Alias
Définissez 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 faire référence à 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.
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 les données.
Exemple 2: Obtention de l'utilisation CPU 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 CPU avec des 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 à bas niveau traitant les mêmes éléments découverts.
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.
AllowKey
Autorise 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 faire correspondre n'importe quel nombre de caractères.
Plusieurs règles de correspondance de clés peuvent être définies en combinaison avec DenyKey, AllowKeyRegexp et DenyKeyRegexp.
Les paramètres sont traités un par un selon leur ordre d'apparition.
L'ordre détermine quelle règle correspondante aura la priorité.
Voir aussi : Restriction des vérifications de l'agent.
AllowKeyRegexp
Autoriser l'exécution des clés d'élément qui correspondent à un motif.
Le motif de clé est une expression régulière.
Plusieurs règles de correspondance de clés peuvent être définies en combinaison avec DenyKeyRegexp, AllowKey et DenyKey.
Les paramètres sont traités un par un selon leur ordre d'apparition.
L'ordre détermine quelle règle correspondante aura la priorité.
Voir aussi : Restriction des vérifications de l'agent.
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 plutôt de basculer vers l'utilisateur zabbix.
Sans effet si l'agent est démarré sous un utilisateur standard.
Par défaut: 0
Valeurs: 0 - ne pas autoriser; 1 - autoriser
BufferSend
Définissez la fréquence d'envoi des valeurs du tampon vers le serveur/proxy Zabbix (en secondes).
Par défaut: 5
Plage: 1-3600
BufferSize
Définit 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
DebugLevel
Définissez 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
DenyKey
Interdire l'exécution des clés d'élément qui correspondent à un motif.
Le motif 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, AllowKeyRegexp et DenyKeyRegexp.
Les paramètres sont traités un par un selon leur ordre d'apparition.
L'ordre détermine quelle règle correspondante aura la priorité.
Voir aussi: Restriction des vérifications de l'agent.
DenyKeyRegexp
Interdire l'exécution des clés d'élément qui correspondent à un motif.
Le motif de clé est une expression régulière.
Plusieurs règles de correspondance de clés peuvent être définies en combinaison avec AllowKeyRegexp, AllowKey et DenyKey.
Les paramètres sont traités un par un selon leur ordre d'apparition.
L'ordre détermine quelle règle correspondante aura la priorité.
Voir aussi: Restriction des vérifications de l'agent.
EnableRemoteCommands
Autoriser les commandes distantes depuis le serveur Zabbix.
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[*]
Par défaut : 0
Valeurs : 0 - ne pas autoriser, 1 - autoriser
HeartbeatFrequency
Définissez la fréquence des messages de heartbeat en secondes.
Utilisé pour surveiller la disponibilité des vérifications actives.
0 - messages de heartbeat désactivés.
Par défaut: 60
Plage: 0-3600
HostInterface
Spécifiez l'interface de l'hôte (adresse IP ou nom DNS) utilisée lors de l'autoregistration 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.
Si elle n'est pas définie, la valeur sera obtenue à partir de HostInterfaceItem.
L'agent générera une erreur et ne démarrera pas si la valeur dépasse la limite de 255 caractères.
Plage : 0-255 caractères
HostInterfaceItem
Spécifiez un élément pour déterminer l'interface de l'hôte (adresse IP ou nom DNS) lors de l'autoregistration de l'hôte.
Cette valeur n'est utilisée que si HostInterface n'est pas défini.
Pour plus de détails, consultez Utiliser DNS comme interface par défaut.
Lors d'une requête d'autoregistration, 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[] est pris en charge indépendamment des paramètres AllowKey/DenyKey.
HostMetadata
Spécifiez les métadonnées permettant d'identifier ou de distinguer le hôte lors de l'enregistrement automatique du hôte (agent actif).
HostMetadata permet de distinguer les hôtes au-delà du nom d'hôte.
Si cette valeur n'est pas définie, elle sera obtenue à partir de HostMetadataItem.
L'agent génère une erreur et ne démarre pas si la valeur spécifiée dépasse la limite de 2034 octets ou s'il s'agit d'une chaîne qui n'est pas au format UTF-8. Lorsqu'un paramètre attend une adresse IP ou un nom DNS, les valeurs qui sont valides au format UTF-8, mais qui ne sont pas des adresses IP ou des noms DNS valides, sont également rejetées et signalées comme non valides.
Les métadonnées multilignes ne sont pas prises en charge : la sortie est tronquée au premier saut de ligne.
Plage : 0-2034 octets
HostMetadataItem
Spécifiez un élément de l'agent Zabbix pour obtenir les métadonnées de l'hôte.
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'enregistrement automatique et utilisée uniquement lors du processus d'enregistrement automatique de l'hôte (agent actif).
HostMetadataItem permet de distinguer les hôtes autrement que par leur nom d'hôte.
Les paramètres utilisateur et les alias sont pris en charge.
L'élément system.run[] est pris en charge quels que soient les paramètres AllowKey/DenyKey.
Lors d'une demande d'enregistrement automatique, l'agent consignera un 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 ; dans le cas contraire, elle sera ignorée. Lorsqu'un paramètre attend une adresse IP ou un nom DNS, les valeurs qui sont valides en UTF-8, mais qui ne sont pas des adresses IP ou des noms DNS valides, seront également rejetées et signalées comme non valides.
Les métadonnées multilignes ne sont pas prises en charge : la sortie sera tronquée au premier saut de ligne.
Nom d'hôte
Spécifiez des noms d'hôte uniques, sensibles à la casse. Une liste délimitée 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
HostnameItem
Spécifiez un élément d'agent Zabbix pour obtenir le nom d'hôte.
Cette option est utilisée uniquement 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[] est pris en charge indépendamment des valeurs AllowKey/DenyKey.
Par défaut: system.hostname
Inclure
Spécifiez un répertoire ou des fichiers individuels à inclure dans le fichier de configuration.
Lors de l'installation de Zabbix, ce paramètre est défini sur /usr/local/etc, sauf si vous le modifiez lors de la compilation.
Règles générales pour le paramètre Include :
- Le chemin peut être relatif à l'emplacement du fichier
zabbix_agentd.conf. - Vous pouvez spécifier plusieurs paramètres
Includedans un même fichier de configuration. - Zabbix traite le paramètre
Includedès qu'il le lit, donc envisagez de le placer à la fin du fichier de configuration.
Règles pour les fichiers inclus :
- Chaque fichier doit être lisible.
- Chaque fichier doit avoir une syntaxe correcte. Sinon, le composant ne démarrera pas.
Règles pour l'inclusion de répertoires ou de modèles de fichiers :
- Ne supposez pas d'ordre d'inclusion particulier (par exemple, les fichiers ne sont pas inclus par ordre alphabétique).
- Ne définissez pas le même paramètre dans plusieurs fichiers inclus (par exemple, pour remplacer un paramètre général par un paramètre spécifique), car vous ne pouvez pas prévoir quelle valeur sera utilisée.
- Faites attention aux copies de sauvegarde que certains éditeurs de texte créent automatiquement (par exemple, la modification de
include/my_specific.confpeut créerinclude/my_specific.conf.BAK), car les deux fichiers seront inclus.
Pour inclure uniquement les fichiers pertinents d'un répertoire, utilisez le caractère générique (*) pour la correspondance de modèle.
Exemple :
Include=/absolute/path/to/config/files/*.conf
ListenBacklog
Définit le nombre maximal de connexions en attente dans la file d'attente 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
ListenIP
Spécifiez l'adresse IP d'écoute de l'agent pour les connexions provenant du serveur/proxy. Liste séparée par des virgules.
Par défaut: 0.0.0.0
ListenPort
Spécifiez le port d'écoute de l'agent pour les connexions provenant du serveur/proxy.
Par défaut: 10050
Plage: 1024-32767
LoadModule
Spécifie 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=<module.so>LoadModule=<path/module.so>LoadModule=</abs_path/module.so>
Il est permis d'inclure plusieurs paramètres LoadModule.
LoadModulePath
Spécifiez le chemin complet vers l'emplacement des modules de l'agent.
La valeur par défaut dépend des options de compilation.
LogFile
Spécifiez le fichier journal de l'agent.
Obligatoire : Oui, si LogType est défini sur file ; sinon non
LogFileSize
Définissez la taille maximale du fichier journal (en Mo).
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
LogRemoteCommands
Active la journalisation des commandes shell exécutées en tant qu'avertissements.
Les commandes ne seront journalisé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é
LogType
Spécifiez le type de sortie du journal :
- file - écrire le journal dans le fichier spécifié par le paramètre
LogFile; - system - écrire le journal dans syslog ;
- console - écrire le journal dans la sortie standard.
Par défaut : file
MaxLinesPerSecond
Définit le nombre maximal de nouvelles lignes par seconde à envoyer au serveur/proxy Zabbix lors du traitement des vérifications actives log ou logrt.
La valeur fournie sera remplacée par le paramètre maxlines, indiqué dans la clé d'élément log ou logrt.
Remarque : 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
PidFile
Spécifiez le fichier PID.
Par défaut: /tmp/zabbix_agentd.pid
RefreshActiveChecks
Spécifiez la fréquence d'actualisation de la liste des vérifications actives, en secondes.
Notez qu'après un échec d'actualisation des vérifications actives, la prochaine actualisation sera tentée dans 60 secondes.
Par défaut: 5
Plage: 1-86400
Serveur
Spécifiez les adresses IP, éventuellement en notation CIDR, ou les noms DNS des serveurs/proxys Zabbix. Une liste séparée par des virgules.
Les connexions entrantes seront acceptées uniquement 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é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.
Notez que les "adresses IPv6 compatibles IPv4" (préfixe 0000::/96) sont prises en charge mais obsolètes selon RFC4291.
Les espaces sont autorisés.
Exemple :
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
ServerActive
Spécifiez l'adresse du serveur/proxy Zabbix ou la configuration du cluster pour obtenir les vérifications actives.
L'adresse du serveur/proxy est une adresse IP ou un nom DNS, avec éventuellement un port séparé par deux-points.
La configuration du cluster est constituée d'une ou plusieurs adresses de membres du groupe de serveurs ou de proxy séparées par des points-virgules.
Plusieurs serveurs/clusters Zabbix et proxies Zabbix peuvent être spécifiés, séparés par des virgules.
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:
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:
ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Exemple pour la haute disponibilité:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Exemple pour la 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
Spécifiez 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.).
StartAgents
Définit le nombre d'instances pré-forkées de zabbix_agentd pour le traitement des vérifications passives.
Si la valeur est 0, les vérifications passives sont désactivées et l'agent n'écoutera sur aucun port TCP.
Valeur par défaut: 10
Plage: 0-100
Délai d'attente
Spécifiez la durée d'attente, en secondes, pour établir la connexion et échanger des données avec le proxy ou le 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 requêtes de données des éléments dans les vérifications actives ;
- 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 de chaque élément).
Par défaut : 3
Plage : 1-30
TLSAccept
Spécifiez le niveau de chiffrement requis pour les connexions entrantes.
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 du certificat TLS ou du PSK sont définis (même pour une connexion unencrypted) ; sinon non
TLSCAFile
Spécifiez le chemin d'accès complet du fichier contenant les certificats de l'autorité de certification racine pour la vérification du certificat du pair, utilisé pour les communications chiffrées entre les composants Zabbix.
TLSCertFile
Spécifiez 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.
TLSCipherAll
Spécifiez 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 des certificats et sur PSK.
Exemple :
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherAll13
Spécifiez la chaîne de chiffrement pour OpenSSL 1.1.1 ou une version plus récente dans TLS 1.3. Remplacez 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 :
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
TLSCipherCert
Spécifiez la chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacez les critères de sélection de la suite de chiffrement par défaut pour le chiffrement basé sur les certificats.
Exemple pour GnuTLS :
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 :
EECDH+aRSA+AES128:RSA+aRSA+AES128
TLSCipherCert13
Spécifiez la chaîne de chiffrement pour OpenSSL 1.1.1 ou une version plus récente dans 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.
TLSCipherPSK
Spécifiez la chaîne de priorité GnuTLS ou la chaîne de chiffrement OpenSSL (TLS 1.2). Remplacez les critères de sélection de la suite de chiffrement par défaut pour le chiffrement basé sur PSK.
Exemple pour GnuTLS :
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 :
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Spécifiez 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 PSK.
Exemple :
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Spécifiez le niveau de chiffrement requis pour les connexions de l'agent au serveur Zabbix ou au proxy.
Utilisé pour les vérifications actives.
Une seule valeur peut être spécifiée :
- unencrypted - connexion sans chiffrement (par défaut) ;
- psk - connexion à l'aide de TLS et d'une clé prépartagée (PSK) ;
- cert - connexion à l'aide de TLS et d'un certificat.
Obligatoire : oui, si des paramètres de certificat TLS ou de PSK sont définis (même pour une connexion unencrypted) ; sinon non
TLSCRLFile
Spécifiez 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.
TLSKeyFile
Indiquez le chemin d'accès complet du fichier contenant la clé privée de l'agent, utilisée pour les communications chiffrées entre les composants Zabbix.
TLSPSKFile
Spécifiez 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 ou le proxy.
TLSPSKIdentity
Spécifiez la chaîne d'identité de clé pré-partagée, utilisée pour les communications chiffrées avec le serveur Zabbix ou le proxy.
TLSServerCertIssuer
Spécifiez l'émetteur de certificat autorisé du serveur (proxy).
TLSServerCertSubject
Spécifiez le sujet du certificat autorisé du serveur (proxy).
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
Utilisateur
Abaisser les privilèges vers un utilisateur spécifique existant sur le système.
Ne prend effet que si l'exécution se fait en tant que root et que AllowRoot est désactivé.
Par défaut: zabbix
UserParameter
Spécifiez un paramètre défini par l'utilisateur à surveiller.
Il peut y avoir plusieurs paramètres définis par l'utilisateur.
Format : UserParameter=<key>,<shell command>
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 :
UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh
UserParameterDir
Spécifie 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 indiqué 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 :
UserParameterDir=/opt/myscripts