12 Plugin PostgreSQL

Vue d'ensemble

Cette section répertorie les paramètres pris en charge dans le fichier de configuration du plugin PostgreSQL de l'agent 2 Zabbix (postgresql.conf).

Le plugin PostgreSQL est un plugin chargeable et est disponible, avec une description complète, dans le dépôt du plugin PostgreSQL.

Notez que :

  • Les valeurs par défaut reflètent les valeurs par défaut du processus, et non les valeurs 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.

Options

Parameter Description
-V --version Afficher la version du plugin et les informations de licence.
-h --help Afficher les informations d'aide (raccourci).

Paramètres

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode no prepare Mode de cache pour la connexion PostgreSQL.
Valeurs prises en charge :
prepare (par défaut) - créera des instructions préparées sur le serveur PostgreSQL ;
describe - utilisera l'instruction préparée anonyme pour décrire une instruction sans en créer une sur le serveur.
Notez que "describe" est principalement utile lorsque l'environnement n'autorise pas les instructions préparées, par exemple lors de l'utilisation d'un répartiteur de connexions comme PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 global timeout Temps d'attente maximal (en secondes) pour qu'une requête soit exécutée.
Plugins.PostgreSQL.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/postgreSQL pour les systèmes Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL pour les systèmes Windows, où * est le nom du lecteur provenant de la variable d'environnement ProgramFiles		 Chemin complet d'un répertoire contenant des fichiers .sql avec des requêtes personnalisées.
Plugins.PostgreSQL.CustomQueriesEnabled no false Si cette option est définie, elle active l'exécution de la clé d'élément postgresql.custom.query. Si elle est désactivée, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.
Plugins.PostgreSQL.Default.Database no Base de données par défaut pour la connexion à PostgreSQL ; utilisée si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.PostgreSQL.Default.Password no Mot de passe par défaut pour la connexion à PostgreSQL ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.PostgreSQL.Default.TLSCAFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Chemin complet d'un fichier contenant le ou les certificats de l'AC racine pour la vérification du certificat du pair lors des communications chiffrées entre Zabbix agent 2 et les bases de données surveillées ; utilisé si aucune valeur n'est spécifiée dans une session nommée.
Plugins.PostgreSQL.Default.TLSCertFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Chemin complet d'un fichier contenant le certificat PostgreSQL ou la chaîne de certificats pour les communications chiffrées entre Zabbix agent 2 et les bases de données surveillées ; utilisé si aucune valeur n'est spécifiée dans une session nommée.
Plugins.PostgreSQL.Default.TLSConnect no Type de chiffrement pour les communications entre Zabbix agent 2 et les bases de données surveillées ; utilisé si aucune valeur n'est spécifiée dans une session nommée.
Valeurs prises en charge :
required - connexion via TLS comme mode de transport sans vérification d'identité ;
verify_ca - connexion via TLS et vérification du certificat ;
verify_full - connexion via TLS, vérification du certificat et vérification que l'identité de la base de données (CN) spécifiée par DBHost correspond à son certificat.
Un type de chiffrement non défini signifie une connexion non chiffrée.
Plugins.PostgreSQL.Default.TLSKeyFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Chemin complet d'un fichier contenant la clé privée PostgreSQL pour les communications chiffrées entre Zabbix agent 2 et les bases de données surveillées ; utilisé si aucune valeur n'est spécifiée dans une session nommée.
Plugins.PostgreSQL.Default.Uri no URI par défaut pour la connexion à PostgreSQL ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.

Ne doit pas inclure d'identifiants intégrés (ils seront ignorés).
Doit correspondre au format URI.
Schémas pris en charge : tcp, unix.
Exemples : tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User no Nom d'utilisateur par défaut pour la connexion à PostgreSQL ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.PostgreSQL.KeepAlive no 60-900 300 Durée maximale d'attente (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode no prepare Mode de cache pour la connexion PostgreSQL.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Valeurs prises en charge :
prepare (par défaut) - créera des instructions préparées sur le serveur PostgreSQL ;
describe - utilisera l'instruction préparée anonyme pour décrire une instruction sans en créer une sur le serveur.
Notez que "describe" est principalement utile lorsque l'environnement n'autorise pas les instructions préparées, par exemple lors de l'utilisation d'un répartiteur de connexions comme PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database no Base de données pour la connexion de session.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.Sessions.<SessionName>.Password no Must match the password format. Mot de passe pour la connexion de session.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 Chemin complet d'un fichier contenant le certificat du ou des AC de niveau supérieur pour la vérification du certificat du pair.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified Chemin complet d'un fichier contenant le certificat PostgreSQL ou la chaîne de certificats.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect no Type de chiffrement pour la connexion PostgreSQL.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Valeurs prises en charge :
required - connexion via TLS comme mode de transport sans vérification d'identité ;
verify_ca - connexion via TLS et vérification du certificat ;
verify_full - connexion via TLS, vérification du certificat et vérification que l'identité de la base de données (CN) spécifiée par DBHost correspond à son certificat.
Un type de chiffrement non défini signifie une connexion non chiffrée.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified Chemin complet d'un fichier contenant la clé privée PostgreSQL.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri no Chaîne de connexion d'une session nommée.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.

Ne doit pas inclure d'identifiants intégrés (ils seront ignorés).
Doit correspondre au format URI.
Schémas pris en charge : tcp, unix.
Exemples : tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User no Nom d'utilisateur de la session nommée.
<SessionName> - définit le nom d'une session à utiliser dans les clés d'élément.
Plugins.PostgreSQL.System.Path yes Chemin vers l'exécutable du plugin PostgreSQL.
Exemple d'utilisation : Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout no 1-30 global timeout Délai d'exécution de la requête (durée, en secondes, d'attente avant d'interrompre une requête).

Voir aussi :