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

4 Zabbix agent 2 (UNIX)

Aperçu

L'agent Zabbix 2 est une nouvelle génération d'agent Zabbix et peut être utilisé à la place de l'agent Zabbix.

Cette section répertorie les paramètres pris en charge dans un fichier de configuration de l'agent Zabbix 2 (zabbix_agent2.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 ;
  • Zabbix prend en charge les fichiers de configuration uniquement en encodage UTF-8 sans BOM ;
  • Les commentaires commençant par "#" ne sont pris en charge qu'en début de ligne.

Paramètres

Paramètre Obligatoire Plage Défaut 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 Zabbix 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 Zabbix.
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 Zabbix 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 Zabbix
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 Zabbix 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 Zabbix 6.0.2.
HostInterface non 0-255 caractères Paramètre 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 Zabbix 4.4.0.
HostInterfaceItem non Paramètre 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 Zabbix 4.4.0.
HostMetadata non 0-255 caractères Paramètre 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 Paramètre 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, Zabbix 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 Zabbix 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 Zabbix, 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 Zabbix 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 Zabbix 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 Zabbix 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 : Zabbix 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 Zabbix et des proxys Zabbix.
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 Zabbix 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 Zabbix et proxys Zabbix peuvent être spécifiés, séparés par une virgule.
Plus d'un proxy Zabbix ne doit pas être spécifié à partir de chaque serveur/cluster Zabbix.
Si le proxy Zabbix est spécifié, alors le serveur/cluster Zabbix pour ce proxy ne doit pas être spécifié.
Plusieurs adresses délimité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 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 Zabbix:
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 Zabbix ou au proxy Zabbix ;
- 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 Zabbix.
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 Zabbix.
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 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 à 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 Zabbix.
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 Zabbix.
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 Zabbix.
TLSPSKIdentity non Chaîne d'identité de clé pré-partagée, utilisée pour les communications chiffrées avec le serveur Zabbix.
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 Paramètre 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