Plugin MySQL

Vue d'ensemble

Les paramètres de configuration permettent de personnaliser le comportement du plugin MySQL.

Il est recommandé de les spécifier dans leur propre fichier de configuration (par exemple mysql.conf), plutôt que dans le fichier de configuration de l'agent 2. Utilisez ensuite la directive Include pour inclure ce fichier dans la configuration de Zabbix agent 2.

Tous les paramètres sont facultatifs, sauf indication explicite précisant que le paramètre est obligatoire.

Cette page est structurée comme suit :

  • Vue d'ensemble des paramètres (pour voir les détails complets d'un paramètre, cliquez sur son nom)
  • Détails des paramètres
Parameter Description
Plugins.Mysql.CallTimeout Spécifie la durée maximale, en secondes, d'attente avant qu'une requête ne soit exécutée.
Plugins.Mysql.CustomQueriesPath Spécifie le chemin complet du répertoire contenant les fichiers .sql avec des requêtes personnalisées.
Plugins.Mysql.CustomQueriesEnabled Active l'exécution de la clé d'élément mysql.custom.query.
Plugins.Mysql.Default.Password Spécifie le mot de passe par défaut.
Plugins.Mysql.Default.TLSConnect Spécifie le niveau de chiffrement par défaut pour les communications entre Zabbix agent 2 et les bases de données surveillées.
Plugins.Mysql.Default.TLSCAFile Spécifie le chemin complet du fichier contenant les certificats des AC de niveau supérieur pour la vérification du certificat du pair.
Plugins.Mysql.Default.TLSCertFile Spécifie le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats.
Plugins.Mysql.Default.TLSKeyFile Spécifie le chemin complet du fichier contenant la clé privée de la base de données.
Plugins.Mysql.Default.Uri Spécifie l'URI par défaut.
Plugins.Mysql.Default.User Spécifie le nom d'utilisateur par défaut.
Plugins.Mysql.KeepAlive Spécifie la durée maximale d'attente, en secondes, avant la fermeture des connexions de plugin inutilisées.
Plugins.Mysql.Sessions.<SessionName>.Password Spécifie le mot de passe de la session nommée.
Plugins.Mysql.Sessions.<SessionName>.TLSConnect Spécifie le niveau de chiffrement de la session nommée pour les communications entre Zabbix agent 2 et les bases de données surveillées.
Plugins.Mysql.Sessions.<SessionName>.TLSCAFile Spécifie le chemin complet du fichier contenant les certificats des AC de niveau supérieur pour la vérification du certificat du pair de la session nommée.
Plugins.Mysql.Sessions.<SessionName>.TLSCertFile Spécifie le chemin complet du fichier contenant le certificat de l'agent de la session nommée ou la chaîne de certificats.
Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile Spécifie le chemin complet du fichier contenant la clé privée de la base de données de la session nommée.
Plugins.Mysql.Sessions.<SessionName>.Uri Spécifie l'URI de la session nommée.
Plugins.Mysql.Sessions.<SessionName>.User Spécifie le nom d'utilisateur de la session nommée.
Plugins.Mysql.Timeout Définit la durée maximale d'attente, en secondes, lors de l'établissement d'une connexion.

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 du paramètre

Plugins.Mysql.CallTimeout

Spécifie la durée maximale, en secondes, d'attente pour qu'une requête soit exécutée.

Par défaut: global timeout
Plage: 1-30

Plugins.Mysql.CustomQueriesPath

Spécifiez le chemin complet du répertoire contenant les fichiers .sql avec des requêtes personnalisées.

Valeurs par défaut :
/usr/local/share/zabbix/custom-queries/mysql - pour les systèmes Unix,
*:\Program Files\Zabbix Agent 2\Custom Queries\Mysql - pour les systèmes Windows (où * est le nom du lecteur provenant de la variable d'environnement ProgramFiles)

Plugins.Mysql.CustomQueriesEnabled

Activer l'exécution de la clé d'élément mysql.custom.query.
Si cette option est désactivée, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.

Par défaut: false
Plage: true/false

Plugins.Mysql.Default.Password

Spécifiez le mot de passe par défaut pour un serveur MySQL protégé.

Plugins.Mysql.Default.TLSConnect

Spécifiez le niveau de chiffrement par défaut pour les communications entre Zabbix agent 2 et les bases de données surveillées.

Plage :
required - exiger une connexion TLS;
verify_ca - vérifier les certificats;
verify_full - vérifier les certificats et l'adresse IP

Plugins.Mysql.Default.TLSCAFile

Spécifiez le chemin complet du fichier contenant le ou les certificats d'autorité de certification racine pour la vérification du certificat du pair, utilisé pour les communications chiffrées entre l'agent 2 Zabbix et les bases de données surveillées.

Obligatoire: yes, si Plugins.Mysql.Default.TLSConnect est défini sur verify_ca ou verify_full

Plugins.Mysql.Default.TLSCertFile

Spécifiez le chemin complet du fichier contenant le certificat de l'agent ou la chaîne de certificats, utilisé pour les communications chiffrées entre l'agent Zabbix 2 et les bases de données surveillées.

Obligatoire: yes, si Plugins.Mysql.Default.TLSKeyFile est spécifié

Plugins.Mysql.Default.TLSKeyFile

Indiquez le chemin d'accès complet du fichier contenant la clé privée de la base de données, utilisée pour les communications chiffrées entre l'agent 2 Zabbix et les bases de données surveillées.

Obligatoire: yes, si Plugins.Mysql.Default.TLSCertFile est spécifié

Plugins.Mysql.Default.Uri

Spécifiez l'URI par défaut pour la connexion au serveur MySQL.
Les identifiants intégrés seront ignorés.
Schémas pris en charge : tcp, unix
Le schéma peut être omis.
Le port peut être omis (par défaut=3306).

Exemples :

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Default.User

Spécifiez le nom d'utilisateur par défaut pour un serveur MySQL protégé.

Plugins.Mysql.KeepAlive

Spécifiez le temps d'attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.

Par défaut: 300
Plage: 60-900

Plugins.Mysql.Sessions.<SessionName>.Password

Spécifiez le mot de passe de la session nommée pour un serveur MySQL protégé.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Plugins.Mysql.Sessions.<SessionName>.TLSConnect

Spécifiez le niveau de chiffrement de la session nommée pour les communications entre l'agent 2 Zabbix et les bases de données surveillées.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Plage :
required - exiger une connexion TLS ;
verify_ca - vérifier les certificats ;
verify_full - vérifier les certificats et l'adresse IP

Plugins.Mysql.Sessions.<SessionName>.TLSCAFile

Spécifiez le chemin complet du fichier contenant les certificats des autorités de certification racines pour la vérification du certificat du pair dans une session nommée, utilisé pour les communications chiffrées entre Zabbix agent 2 et les bases de données surveillées.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Obligatoire: yes, si Plugins.Mysql.Sessions.<SessionName>.TLSConnect est défini sur verify_ca ou verify_full

Plugins.Mysql.Sessions.<SessionName>.TLSCertFile

Spécifiez le chemin d'accès complet du fichier contenant le certificat de l'agent ou la chaîne de certificats de la session nommée, utilisé pour les communications chiffrées entre Zabbix agent 2 et les bases de données surveillées.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Obligatoire: yes, si Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile est spécifié

Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile

Spécifiez le chemin d'accès complet du fichier contenant la clé privée de la base de données de la session nommée, utilisée pour les communications chiffrées entre l'agent 2 Zabbix et les bases de données surveillées.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'éléments.

Obligatoire: yes, si Plugins.Mysql.Sessions.<SessionName>.TLSCertFile est spécifié

Plugins.Mysql.Sessions.<SessionName>.Uri

Spécifiez l'URI de session nommée pour la connexion au serveur MySQL.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Les identifiants intégrés seront ignorés.
Schémas pris en charge: tcp, unix
Le schéma peut être omis.
Le port peut être omis (par défaut=3306).

Exemples:

tcp://localhost:3306
localhost
unix:/var/run/mysql.sock
Plugins.Mysql.Sessions.<SessionName>.User

Spécifiez le nom d'utilisateur de la session nommée pour un serveur MySQL protégé.
<SessionName> - définissez le nom d'une session à utiliser dans les clés d'élément.

Plugins.Mysql.Timeout

Définit le temps maximal, en secondes, d'attente lors de l'établissement d'une connexion.

Par défaut: global timeout
Plage: 1-30

Voir aussi