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 file di configurazione dedicato (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, con descrizione completa, 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 forniti.
  • I valori supportano le variabili d'ambiente;
  • Zabbix supporta solo file di configurazione con codifica UTF-8 senza BOM.
  • I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

Opzioni

Parametro Descrizione
-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à di cache per la connessione PostgreSQL.
Valori supportati:
prepare (predefinito) - creerà prepared statement sul server PostgreSQL;
describe - utilizzerà il prepared statement anonimo per descrivere uno statement senza creare uno statement sul server.
Si noti che "describe" è utile principalmente quando l'ambiente non consente i prepared statement, ad esempio quando si esegue un connection pooler come PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 global timeout 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 nessun valore è specificato in una chiave item o in una sessione con nome.
Plugins.PostgreSQL.Default.Password no Password predefinita per la connessione a PostgreSQL; utilizzata se nessun valore è specificato 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 nessun valore è specificato 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 nessun valore è specificato 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 nessun valore è specificato in una sessione con nome.
Valori supportati:
required - si connette usando TLS come modalità di trasporto senza controlli dell'identità;
verify_ca - si connette usando TLS e verifica il certificato;
verify_full - si connette usando TLS, verifica il 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 nessun valore è specificato in una sessione con nome.
Plugins.PostgreSQL.Default.Uri no URI predefinito per la connessione a PostgreSQL; utilizzato se nessun valore è specificato 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 nessun valore è specificato 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à di cache per la connessione PostgreSQL.
<SessionName> - definisce il nome di una sessione da utilizzare nelle chiavi item.
Valori supportati:
prepare (predefinito) - creerà prepared statement sul server PostgreSQL;
describe - utilizzerà il prepared statement anonimo per descrivere uno statement senza creare uno statement sul server.
Si noti che "describe" è utile principalmente quando l'ambiente non consente i prepared statement, 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 - si connette usando TLS come modalità di trasporto senza controlli dell'identità;
verify_ca - si connette usando TLS e verifica il certificato;
verify_full - si connette usando TLS, verifica il 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 global timeout Timeout di esecuzione della richiesta (la durata, in secondi, di attesa del completamento di una richiesta prima di interromperla).

Vedi anche: