12 Plugin PostgreSQL

Panoramica

Il file di configurazione di Zabbix agent 2 viene utilizzato per configurare i plugin. Questi parametri di configurazione di Zabbix agent 2 sono supportati per il funzionamento del plugin PostgreSQL.

Si consiglia di specificarli in un proprio file di configurazione (ad esempio postgresql.conf) e quindi di utilizzare la direttiva Include per aggiungere questo file alla configurazione di Zabbix agent 2.

Il plugin PostgreSQL è un plugin caricabile ed è disponibile e descritto completamente nel repository del plugin PostgreSQL.

Si noti che:

  • I valori predefiniti riflettono i valori predefiniti del processo, non i valori presenti nei file di configurazione distribuiti.
  • I valori supportano le variabili d'ambiente;
  • Zabbix supporta file di configurazione solo con codifica UTF-8 senza BOM.
  • I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

Opzioni

Parameter Description
-V --version Stampa la versione del plugin e le informazioni sulla licenza.
-h --help Stampa le informazioni di aiuto (abbreviazione).
-t, --test <item key> Avvia il plugin per il test (la configurazione del plugin viene ignorata).

Parametri

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode no prepare Modalità cache per la connessione PostgreSQL.
Valori supportati:
prepare (predefinito) - creerà istruzioni preparate sul server PostgreSQL;
describe - utilizzerà l'istruzione preparata anonima per descrivere un'istruzione senza creare un'istruzione sul server.
Si noti che "describe" è utile principalmente quando l'ambiente non consente istruzioni preparate, ad esempio quando si esegue un connection pooler come PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 timeout globale Tempo massimo di attesa (in secondi) per il completamento di una richiesta.
Plugins.PostgreSQL.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/postgreSQL for Unix systems

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL for Windows systems, where * is the drive name from the ProgramFiles environment variable		 Percorso completo di una directory contenente file .sql con query personalizzate.
Plugins.PostgreSQL.CustomQueriesEnabled no false Se impostato, abilita l'esecuzione della chiave item postgresql.custom.query. Se disabilitato, nessuna query verrà caricata dal percorso della directory delle query personalizzate.
Plugins.PostgreSQL.Default.Database no Database predefinito per la connessione a PostgreSQL; utilizzato se non viene specificato alcun valore in una chiave item o in una sessione con nome.
Plugins.PostgreSQL.Default.Password no Password predefinita per la connessione a PostgreSQL; utilizzata se non viene specificato alcun valore in una chiave item o in una sessione con nome.
Plugins.PostgreSQL.Default.TLSCAFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Percorso completo di un file contenente il certificato della CA di livello superiore per la verifica del certificato del peer nelle comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; utilizzato se non viene specificato alcun valore in una sessione con nome.
Plugins.PostgreSQL.Default.TLSCertFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Percorso completo di un file contenente il certificato PostgreSQL o la catena di certificati per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; utilizzato se non viene specificato alcun valore in una sessione con nome.
Plugins.PostgreSQL.Default.TLSConnect no Tipo di cifratura per le comunicazioni tra Zabbix agent 2 e i database monitorati; utilizzato se non viene specificato alcun valore in una sessione con nome.
Valori supportati:
required - connessione tramite TLS come modalità di trasporto senza controlli dell'identità;
verify_ca - connessione tramite TLS e verifica del certificato;
verify_full - connessione tramite TLS, verifica del certificato e verifica che l'identità del database (CN) specificata da DBHost corrisponda al suo certificato.
Un tipo di cifratura non definito indica una connessione non cifrata.
Plugins.PostgreSQL.Default.TLSKeyFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Percorso completo di un file contenente la chiave privata PostgreSQL per le comunicazioni cifrate tra Zabbix agent 2 e i database monitorati; utilizzato se non viene specificato alcun valore in una sessione con nome.
Plugins.PostgreSQL.Default.Uri no URI predefinito per la connessione a PostgreSQL; utilizzato se non viene specificato alcun valore in una chiave item o in una sessione con nome.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Schemi supportati: tcp, unix.
Esempi: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User no Nome utente predefinito per la connessione a PostgreSQL; utilizzato se non viene specificato alcun valore in una chiave item o in una sessione con nome.
Plugins.PostgreSQL.KeepAlive no 60-900 300 Tempo massimo di attesa (in secondi) prima che le connessioni del plugin inutilizzate vengano chiuse.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode no prepare Modalità cache per la connessione PostgreSQL.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Valori supportati:
prepare (predefinito) - creerà istruzioni preparate sul server PostgreSQL;
describe - utilizzerà l'istruzione preparata anonima per descrivere un'istruzione senza creare un'istruzione sul server.
Si noti che "describe" è utile principalmente quando l'ambiente non consente istruzioni preparate, ad esempio quando si esegue un connection pooler come PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database no Database per la connessione della sessione.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.Sessions.<SessionName>.Password no Must match the password format. Password per la connessione della sessione.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 Percorso completo di un file contenente il certificato della CA di livello superiore per la verifica del certificato del peer.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified Percorso completo di un file contenente il certificato PostgreSQL o la catena di certificati.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect no Tipo di cifratura per la connessione PostgreSQL.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.

Valori supportati:
required - connessione tramite TLS come modalità di trasporto senza controlli dell'identità;
verify_ca - connessione tramite TLS e verifica del certificato;
verify_full - connessione tramite TLS, verifica del certificato e verifica che l'identità del database (CN) specificata da DBHost corrisponda al suo certificato.
Un tipo di cifratura non definito indica una connessione non cifrata.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified Percorso completo di un file contenente la chiave privata PostgreSQL.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri no Stringa di connessione di una sessione con nome.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Schemi supportati: tcp, unix.
Esempi: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User no Nome utente della sessione con nome.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Plugins.PostgreSQL.System.Path yes Percorso dell'eseguibile del plugin PostgreSQL.
Esempio di utilizzo: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout no 1-30 timeout globale Timeout di esecuzione della richiesta (la durata, in secondi, di attesa del completamento di una richiesta prima di interromperla).

Vedi anche: