9 Web service Zabbix

Vue d'ensemble

Le service web Zabbix est un processus utilisé pour la communication avec des services web externes.

Les paramètres pris en charge par le fichier de configuration du service web Zabbix (zabbix_web_service.conf) sont répertoriés dans cette section.

Les paramètres sont listés sans informations supplémentaires. Cliquez sur le paramètre pour voir les détails complets.

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 processus, et non celles des fichiers de configuration fournis ;
• Les valeurs prennent en charge les variables d'environnement ;
• 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'au début de la ligne.

Détails des paramètres

AllowedIP

Une liste d'adresses IP séparées par des virgules, éventuellement en notation CIDR, ou de noms DNS de serveurs Zabbix et de proxies Zabbix. 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ées de manière identique 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.

Exemple :

127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Obligatoire : oui

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 sur les erreurs ;
• 3 - avertissements ;
• 4 - pour le débogage (produit beaucoup d'informations) ;
• 5 - débogage étendu (produit encore plus d'informations).

Par défaut : 3
Plage : 0-5

IgnoreURLCertErrors

Spécifie la gestion des erreurs de validation du certificat TLS lors de l’accès à l’URL du frontend :
0 - ne pas ignorer les erreurs de certificat ;
1 - ignorer les erreurs de certificat.

Par défaut : 0
Plage : 0-1

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 modifiez cela au moment de la compilation.

Règles générales pour le paramètre Include :

• Le chemin peut être relatif à l'emplacement du fichier zabbix_web_service.conf.
• Vous pouvez spécifier plusieurs paramètres Include dans un seul fichier de configuration.
• Zabbix traite le paramètre Include dè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 aucun ordre d'inclusion (par exemple, les fichiers ne sont pas inclus par ordre alphabétique).
• Ne définissez pas le même paramètre dans plus d'un fichier 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.conf peut créer include/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 motifs.

Exemple :

Include=/absolute/path/to/config/files/*.conf

ListenPort

Le service écoutera sur ce port les connexions provenant du serveur.

Par défaut : 10053
Plage : 1024-32767

LogFile

Le nom du fichier journal.

Exemple :

/tmp/zabbix_web_service.log

Obligatoire : Oui, si LogType est défini sur file ; sinon non

LogFileSize

La taille maximale d’un 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, pour quelque raison que ce soit, le fichier journal existant est tronqué et redémarré à zéro.

Par défaut : 1
Plage : 0-1024

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

Délai d’expiration

Le temps maximal (en secondes) consacré au formatage du report PDF d’un tableau de bord.

Par défaut : 10
Plage : 1-30

TLSAccept

Quelles connexions entrantes accepter :

• unencrypted - accepter les connexions sans chiffrement (par défaut) ;
• cert - accepter les connexions avec TLS et un certificat.

Par défaut : unencrypted

TLSCAFile

Le chemin complet du fichier contenant les certificats de la ou des autorités 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

Le chemin complet du fichier contenant le certificat du service ou la chaîne de certificats, utilisé pour les communications chiffrées avec les composants Zabbix.

TLSKeyFile

Le chemin complet du fichier contenant la clé privée du service, utilisée pour les communications chiffrées entre les composants Zabbix.