Documentation
Table of Contents
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 |
|||