Plugin PostgreSQL

Panoramica

I parametri di configurazione consentono di personalizzare il comportamento del plugin PostgreSQL.

Si consiglia di specificarli in un file di configurazione dedicato (ad esempio postgresql.conf), anziché nel file di configurazione di agent 2. Utilizzare quindi la direttiva Include per includere questo file nella configurazione di Zabbix agent 2.

Il plugin PostgreSQL è un plugin caricabile ed è disponibile e descritto in modo completo nel repository del plugin PostgreSQL.

Tutti i parametri sono opzionali, a meno che non sia esplicitamente indicato che il parametro è obbligatorio.

Questa pagina è strutturata come segue:

• Panoramica dei parametri (per vedere i dettagli completi di un parametro, fare clic sul suo nome)
• Dettagli dei parametri

|Plugins.PostgreSQL.System.Path|Specifica il percorso dell'eseguibile del plugin PostgreSQL.| |Plugins.PostgreSQL.Timeout|Imposta il timeout di esecuzione della richiesta.|

Si noti che:

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

Dettagli del parametro

Plugins.PostgreSQL.CallTimeout

Imposta il tempo massimo di attesa, in secondi, affinché una richiesta venga completata.

Predefinito: global timeout
Intervallo: 1-30

Plugins.PostgreSQL.CustomQueriesPath

Specifica il percorso completo della directory contenente i file .sql con query personalizzate.

Valori predefiniti:
/usr/local/share/zabbix/custom-queries/postgreSQL - per i sistemi Unix,
*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL - per i sistemi Windows (dove * è il nome dell'unità dalla variabile di ambiente ProgramFiles)

Esempio:

/etc/zabbix/oracle/sql

Plugins.PostgreSQL.CustomQueriesEnabled

Abilita l'esecuzione della chiave item postgresql.custom.query.
Se disabilitato, non verrà caricato alcun query dal percorso della directory delle query personalizzate.

Predefinito: false
Intervallo: true/false

Plugins.PostgreSQL.Default.CacheMode

Specifica la modalità di cache predefinita per la connessione PostgreSQL.

Predefinito: prepare
Intervallo:
prepare - crea statement preparati sul server PostgreSQL;
describe - usa lo statement preparato anonimo per descrivere uno statement senza creare uno statement sul server.

Nota che describe è utile principalmente quando l'ambiente non consente statement preparati, ad esempio quando si utilizza un pooler di connessioni come PgBouncer.

Plugins.PostgreSQL.Default.Database

Specifica il database predefinito per la connessione a PostgreSQL.
Usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.PostgreSQL.Default.Password

Specifica la password predefinita per la connessione a PostgreSQL.
Utilizzata se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.PostgreSQL.Default.TLSCAFile

Specifica il percorso completo del file contenente il certificato CA di livello superiore per la verifica del certificato del peer nelle comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
Usato se non è specificato alcun valore in una sessione denominata.

Obbligatorio: yes, se Plugins.PostgreSQL.Default.TLSConnect è impostato su verify_ca o verify_full

Plugins.PostgreSQL.Default.TLSCertFile

Specifica il percorso completo del file contenente il certificato PostgreSQL o la catena di certificati per le comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
Usato se non è specificato alcun valore in una sessione denominata.

Obbligatorio: yes, se è specificato Plugins.PostgreSQL.Default.TLSKeyFile

Plugins.PostgreSQL.Default.TLSConnect

Specifica il livello predefinito di crittografia per le comunicazioni tra Zabbix agent 2 e i database monitorati.
Usato se non viene specificato alcun valore in una sessione denominata.

Intervallo:
required - connessione tramite TLS come modalità di trasporto senza controlli di 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 relativo certificato.

Un tipo di crittografia non definito indica una connessione non crittografata.

Plugins.PostgreSQL.Default.TLSKeyFile

Specifica il percorso completo del file contenente la chiave privata PostgreSQL per le comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
Usato se non è specificato alcun valore in una sessione denominata.

Obbligatorio: yes, se Plugins.PostgreSQL.Default.TLSCertFile è specificato

Plugins.PostgreSQL.Default.Uri

Specifica l'URI predefinito per la connessione a PostgreSQL.
Usato se non è specificato alcun valore in una chiave item o in una sessione denominata.
Le 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

Specifica il nome utente predefinito per la connessione a PostgreSQL.
Usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.PostgreSQL.KeepAlive

Imposta il tempo massimo di attesa (in secondi) prima che le connessioni del plugin non utilizzate vengano chiuse.

Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode

Specifica la modalità di cache della sessione con nome per la connessione PostgreSQL.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Predefinito: prepare
Intervallo:
prepare - crea statement preparati sul server PostgreSQL;
describe - usa lo statement preparato anonimo per descrivere uno statement senza crearne uno sul server.

Nota che describe è utile principalmente quando l'ambiente non consente statement preparati, ad esempio quando si esegue un pooler di connessioni come PgBouncer.

Plugins.PostgreSQL.Sessions.<SessionName>.Database

Specifica il database della sessione denominata per la connessione a PostgreSQL.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Plugins.PostgreSQL.Sessions.<SessionName>.Password

Specifica la password della sessione denominata per la connessione a PostgreSQL.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.
Deve corrispondere al formato della password.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile

Specifica il percorso completo del file contenente il certificato della CA di livello superiore per la verifica del certificato del peer nelle comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Obbligatorio: yes, se Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect è impostato su verify_ca o verify_full

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile

Specifica il percorso completo del file contenente il certificato PostgreSQL o la catena di certificati per le comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Obbligatorio: yes, se Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile è specificato

Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect

Specifica il livello di crittografia della sessione denominata per le comunicazioni tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Intervallo:
required - connessione tramite TLS come modalità di trasporto senza controlli di 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 relativo certificato.

Un tipo di crittografia non definito indica una connessione non crittografata.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Specifica il percorso completo del file contenente la chiave privata PostgreSQL per le comunicazioni crittografate tra Zabbix agent 2 e i database monitorati.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Obbligatorio: yes, se è specificato Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile.

Plugins.PostgreSQL.Sessions.<SessionName>.Uri

Specifica l'URI della sessione denominata per la connessione a PostgreSQL.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.
Le 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

Specifica il nome utente della sessione denominata per la connessione a PostgreSQL.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Plugins.PostgreSQL.System.Path

Specificare il percorso dell'eseguibile del plugin PostgreSQL.

Obbligatorio: yes

Esempio:

Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql

Plugins.PostgreSQL.Timeout

Imposta il timeout di esecuzione della richiesta (la durata, in secondi, da attendere affinché una richiesta venga completata prima di interromperla).

Predefinito: global timeout
Intervallo: 1-30

Opzioni

Vedi anche

• Descrizione dei parametri di configurazione generali di Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
• Istruzioni per la configurazione dei plugin