12 Plugin PostgreSQL

Aperçu

Le fichier de configuration de Zabbix agent 2 est utilisé pour configurer les plugins. Ces paramètres de configuration de Zabbix agent 2 sont pris en charge pour l’exploitation du plugin PostgreSQL.

Il est recommandé de les spécifier dans leur propre fichier de configuration (par ex. postgresql.conf), puis d’utiliser la directive Include pour ajouter ce fichier à la configuration de Zabbix agent 2.

Le plugin PostgreSQL est un plugin chargeable, disponible et entièrement décrit 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 uniquement les fichiers de configuration encodés en UTF-8 sans BOM.
  • Les commentaires commençant par « # » ne sont pris en charge qu’au début de la ligne.

Options

Paramètre Description
-V --version Affiche la version du plugin et les informations de licence.
-h --help Affiche les informations d’aide (forme abrégée).
-t, --test <item key> Lance le plugin pour les tests (configuration du plugin ignorée).

Paramètres

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode non 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 créer d’instruction 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 pooler de connexions comme PgBouncer.
Plugins.PostgreSQL.CallTimeout non 1-30 délai global Temps d’attente maximal (en secondes) pour qu’une requête soit terminée.
Plugins.PostgreSQL.CustomQueriesPath non /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 non false Si défini, active l’exécution de la clé d’élément postgresql.custom.query. Si désactivé, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.
Plugins.PostgreSQL.Default.Database non 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 non 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 non
(oui, si Plugins.PostgreSQL.Default.TLSConnect est défini sur verify_ca ou verify_full)		 Chemin complet d’un fichier contenant le ou les certificats de l’autorité de certification racine pour la vérification du certificat du pair dans 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.TLSCertFile non
(oui, si Plugins.PostgreSQL.Default.TLSConnect est défini sur verify_ca ou 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 non 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 - se connecter en utilisant TLS comme mode de transport sans vérification d’identité ;
verify_ca - se connecter en utilisant TLS et vérifier le certificat ;
verify_full - se connecter en utilisant TLS, vérifier le certificat et vérifier 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 non
(oui, si Plugins.PostgreSQL.Default.TLSConnect est défini sur verify_ca ou 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 non 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 respecter le 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 non 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 non 60-900 300 Temps d’attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode non 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 créer d’instruction 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 pooler de connexions comme PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database non 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 non Doit respecter le format du mot de passe. 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 non
(oui, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect est défini sur verify_ca ou verify_full)		 Chemin complet d’un fichier contenant le ou les certificats de l’autorité de certification racine 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 oui, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile est spécifié 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 non 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 - se connecter en utilisant TLS comme mode de transport sans vérification d’identité ;
verify_ca - se connecter en utilisant TLS et vérifier le certificat ;
verify_full - se connecter en utilisant TLS, vérifier le certificat et vérifier 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 oui, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile est spécifié 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 non 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 respecter le 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 non 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 oui 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 non 1-30 délai global Délai d’exécution de la requête (durée, en secondes, pendant laquelle attendre qu’une requête se termine avant de l’arrêter).

Voir aussi :