[comment]: # ({4c4650a2-heading})
# 11 Plugin de PostgreSQL

[comment]: # ({/4c4650a2-heading})

[comment]: # ({26957231-overview})
#### Vista general

Aquesta secció llista els paràmetres admesos a l'arxiu de configuració del plugin de PostgreSQL (postgresql.conf) per a l'agent 2 de Zabbix.
 
Des de Zabbix 6.0.10, PostgreSQL és un plugin que es pot carregar, disponible i detallat al [repositori del plugin de PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse?at=refs%2Fheads%2Frelease%2F6.0)

Els binaris de plugins precompilats per a Windows són disponibles des de [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) i són compatibles amb les versions anteriors a la 6.0.

Veieu que:

-   Els valors per defecte reflecteixen els processos per defecte, no pas els valors dels arxius de configuració descarregats;
-   Zabbix admet arxius de configuració codificats només en UTF-8, sense [BOM](https://en.wikipedia.org/wiki/Byte_order_mark);
-   Els comentaris que comencen amb "\#" només s'admeten al principi de les línies.

[comment]: # ({/26957231-overview})

[comment]: # ({1a59fae9-options})
### Opcions

|Paràmetre|Descripció|
|---------|-----------|
|-V --version|Mostra la versió del plugin i informació de la llicència.|
|-h --help|Mostra la informació d'ajuda (abreujatura).|

[comment]: # ({/1a59fae9-options})

[comment]: # ({55098534-parameters})
### Paràmetres

::: noteclassic
A les versions de Zabbix anteriors a la 6.0.10, els noms dels paràmetres comencen amb *Plugins.Postgres.<Parameter>* en comptes de *Plugins.PostgreSQL.<Parameter>*. Per exemple, *Plugins.Postgres.KeepAlive*.
:::

|Paràmetre|Obligatori|Rang|Predeterminat|Descripció|
|--|--|--|--|-----------|
|Plugins.PostgreSQL.Default.CacheMode|no| |prepare|Mode cau per la connexió PostgreSQL.<br>valors admesos:<br>*preparar* (per defecte) - crearà declaracions preparades al servidor PostgreSQL;<br>*descriure* - emprarà la declaració preparada anònima per descriure una declaració sense crear-la al servidor.<br>Veieu que "descriure" és útil principalment quan l'entorn no admet sentències preparades com ara executant una agrupació de connexions com ara PgBouncer.<br>Admès des de la versió 6.0.25.|
|Plugins.PostgreSQL.CallTimeout|no|1-30|temps d'espera global|Temps d'espera màxim (en segons) per completar una sol·licitud.|
|Plugins.PostgreSQL.CustomQueriesPath|no| |disabled|Camí complet del directori que conté fitxers *.sql* amb consultes personalitzades.|
|Plugins.PostgreSQL.Default.Database|no| | |Base de dades per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.Password|no| | |Mot de pas per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.TLSCAFile|no<br>(sí, si Plugins.PostgreSQL.Default.TLSConnect està configurat en un d'aquests: verify_ca, verify_full)| | |Camí d'accés complet d'un fitxer que conté el certificat de CA(s) de nivell superior per a la verificació del certificat d'iguals per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.TLSCertFile|no<br>(sí, si Plugins.PostgreSQL.Default.TLSConnect s'estableix en un dels següents: verify_ca, verify_full)| | |Camí complet d'un fitxer que conté el certificat PostgreSQL o la cadena de certificats per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.TLSConnect|no| | |Tipus de xifrat per a les comunicacions entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió amb nom.<br>Valors admesos:<br>*obligatori*: connecteu-vos mitjançant TLS com a mode de transport sense comprovacions d'identitat;<br>*verify\_ca*: connecteu-vos mitjançant TLS i verifiqueu el certificat; <br>*verify\_full*: connecteu-vos mitjançant TLS, verifiqueu el certificat i verifiqueu que la identitat de la base de dades (CN) especificada per DBHost coincideix amb el seu certificat.<br>El tipus de xifrat no definit significa una connexió sense xifrar.<br><br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.TLSKeyFile|no<br>(sí, si Plugins.PostgreSQL.Default.TLSConnect s'estableix en un dels següents: verify_ca, verify_full)| | |Camí complet d'un fitxer que conté la clau privada de PostgreSQL per a les comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.<br><br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Default.Uri|no| | |URI per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.<br><br>No han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`.<br>Exemples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br>`unix:/var/run/postgresql/.s.PGSQL.5432`<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.Usuari predeterminat|no| | |Nom d'usuari per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.<br>S'admet des de la versió 6.0.18.|
|Plugins.PostgreSQL.KeepAlive|no|60-900|300|Temps màxim d'espera (en segons) abans que es tanquin les connexions de connectors no emprats.|
|Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode|no| |prepare|Mode cau per la connexió PostgreSQL.<br>**<SessionName>** - defineix el nom de la sessió per emprar-la a les claus d'element.<br>Valors admesos:<br>*preparar* (per defecte) - crearà declaracions preparades al servidor PostgreSQL;<br>*descriure* - emprarà la declaració preparada anònima per descriure una declaració sense crear-la al servidor.<br>Veieu que "descriure" és útil principalment quan l'entorn no admet sentències preparades com ara executant una agrupació de connexions com ara PgBouncer.<br>Admès des de la versió 6.0.25.|
|Plugins.PostgreSQL.Sessions.<SessionName>.Database|no| | |Base de dades per a la connexió de la sessió.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.Sessions.<SessionName>.Password|no|Ha de coincidir amb el format del mot de pas.| |Mot de pas per a la connexió de sessió.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile|no<br>(sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'ha establert en un dels següents: verify_ca, verify_full)| | |Camí d'accés complet d'un fitxer que conté la verificació del certificat d'iguals del certificat de CA(s) de nivell superior.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile|no<br>(sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile és establert<br><br>Abans de la versió 6.0.22 sempre era obligatori si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*| | |Camí complet d'un fitxer que conté el certificat PostgreSQL o la cadena de certificats.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect|no| | |Tipus de xifrat per a la connexió PostgreSQL.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>Valors admesos:<br>*obligatori* - connecteu-vos mitjançant TLS com a transport mode sense comprovacions d'identitat;<br>*verify\_ca* - connectar-se mitjançant TLS i verificar el certificat;<br>*verify\_full* - connectar-se mitjançant TLS, verificar el certificat i verificar que la identitat de la base de dades (CN) especificada per DBHost coincideix amb el seu certificat.<br>El tipus de xifrat no definit significa connexió sense xifrar.|
|Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile|no<br>(sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile s'ha definit<br><br>Abans de la versió 6.0. sempre era obligatori si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*| | |Camí complet d'un fitxer que conté la clau privada de PostgreSQL.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.Sessions.<SessionName>.Uri|no| | |Cadena de connexió d'una sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>No hauria d'incloure credencials incrustades (s'ignoraran).<br >Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`.<br>Exemples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br> `unix:/var/run/postgresql/.s.PGSQL.5432`|
|Plugins.PostgreSQL.Sessions.<SessionName>.Usuari|no| | |Nom d'usuari de la sessió.<br>**<Nom de la sessió>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.|
|Plugins.PostgreSQL.System.Path|sí| | |Camí a l'executable del connector extern. Admès des de Zabbix 6.0.10.|
|Plugins.PostgreSQL.Timeout|no|1-30|temps d'espera global|Temps d'espera d'execució de la petició (la durada, en segons, d'esperar que es completi una petició abans d'apagar-la).|

Veieu també:

- Descripció dels paràmetres de configuració generals de l'agent 2 de Zabbix:
     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win)
- Instruccions per configurar [plugins](/manual/config/items/plugins)

[comment]: # ({/55098534-parameters})


