PostgreSQL spraudnis

Pārskats

Konfigurācijas parametri ļauj pielāgot PostgreSQL spraudņa darbību.

Ieteicams tos norādīt atsevišķā konfigurācijas failā (piem., postgresql.conf), nevis aģents 2 konfigurācijas failā. Pēc tam izmantojiet direktīvu Include, lai iekļautu šo failu Zabbix aģents 2 konfigurācijā.

PostgreSQL spraudnis ir ielādējams spraudnis, un tas ir pieejams, kā arī pilnībā aprakstīts PostgreSQL spraudņa repozitorijā.

Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Šī lapa ir strukturēta šādi:

  • Parametru pārskats (lai skatītu pilnu parametra informāciju, noklikšķiniet uz tā nosaukuma)
  • Parametru detaļas
Parameter Description
Plugins.PostgreSQL.CallTimeout Iestata maksimālo gaidīšanas laiku sekundēs, līdz pieprasījums tiek pabeigts.
Plugins.PostgreSQL.CustomQueriesPath Norādiet pilnu direktorijas ceļu, kurā atrodas .sql faili ar pielāgotiem vaicājumiem.
Plugins.PostgreSQL.CustomQueriesEnabled Iespējo postgresql.custom.query vienums atslēgas izpildi.
Plugins.PostgreSQL.Default.CacheMode Norādiet PostgreSQL savienojuma noklusējuma kešatmiņas režīmu.
Plugins.PostgreSQL.Default.Database Norādiet noklusējuma datubāzes nosaukumu.
Plugins.PostgreSQL.Default.Password Norādiet noklusējuma paroli.
Plugins.PostgreSQL.Default.TLSCAFile Norādiet pilnu ceļu uz failu, kurā atrodas augstākā līmeņa CA sertifikāts(-i) vienaudža sertifikāta verifikācijai.
Plugins.PostgreSQL.Default.TLSCertFile Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL sertifikāts vai sertifikātu ķēde.
Plugins.PostgreSQL.Default.TLSConnect Norādiet noklusējuma šifrēšanas līmeni saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
Plugins.PostgreSQL.Default.TLSKeyFile Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL privātā atslēga.
Plugins.PostgreSQL.Default.Uri Norādiet noklusējuma URI.
Plugins.PostgreSQL.Default.User Norādiet noklusējuma lietotājvārdu.
Plugins.PostgreSQL.KeepAlive Iestata maksimālo gaidīšanas laiku (sekundēs) pirms neizmantotie spraudņa savienojumi tiek aizvērti.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode Norādiet nosauktās sesijas kešatmiņas režīmu PostgreSQL savienojumam.
Plugins.PostgreSQL.Sessions.<SessionName>.Database Norādiet nosauktās sesijas datubāzes nosaukumu.
Plugins.PostgreSQL.Sessions.<SessionName>.Password Norādiet nosauktās sesijas paroli.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile Norādiet pilnu ceļu uz failu, kurā atrodas augstākā līmeņa CA sertifikāts(-i) vienaudža sertifikāta verifikācijai.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL sertifikāts vai sertifikātu ķēde.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect Norādiet nosauktās sesijas šifrēšanas līmeni saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL privātā atslēga.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri Norādiet nosauktās sesijas URI.
Plugins.PostgreSQL.Sessions.<SessionName>.User Norādiet nosauktās sesijas lietotājvārdu.

|Plugins.PostgreSQL.System.Path|Norādiet ceļu uz PostgreSQL spraudņa izpildāmo failu.| |Plugins.PostgreSQL.Timeout|Iestata pieprasījuma izpildes noildzi.|

Ņemiet vērā:

  • Noklusējuma vērtības atspoguļo procesa noklusējuma iestatījumus, nevis vērtības piegādātajos konfigurācijas failos.
  • Vērtības atbalsta vides mainīgos;
  • Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM.
  • Komentāri, kas sākas ar "#", tiek atbalstīti tikai rindas sākumā.

Parametra informācija

Plugins.PostgreSQL.CallTimeout

Iestata maksimālo gaidīšanas laiku sekundēs, lai pieprasījums tiktu pabeigts.

Noklusējums: global timeout
Diapazons: 1-30

Plugins.PostgreSQL.CustomQueriesPath

Norādiet pilnu ceļa nosaukumu uz direktoriju, kurā atrodas .sql faili ar pielāgotiem vaicājumiem.

Noklusējums:
/usr/local/share/zabbix/custom-queries/postgreSQL - Unix sistēmām,
*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL - Windows sistēmām (kur * ir diska nosaukums no vides mainīgā ProgramFiles)

Piemērs:

/etc/zabbix/oracle/sql
Plugins.PostgreSQL.CustomQueriesEnabled

Iespējot postgresql.custom.query vienuma atslēgas izpildi.
Ja šī opcija ir atspējota, vaicājumi netiks ielādēti no pielāgoto vaicājumu direktorijas ceļa.

Noklusējums: false
Diapazons: true/false

Plugins.PostgreSQL.Default.CacheMode

Norādiet PostgreSQL savienojuma noklusējuma kešatmiņas režīmu.

Noklusējums: prepare
Diapazons:
prepare - izveidot sagatavotos priekšrakstus PostgreSQL serverī;
describe - izmantot anonīmu sagatavoto priekšrakstu, lai aprakstītu priekšrakstu, neveidojot priekšrakstu serverī.

Ņemiet vērā, ka describe galvenokārt ir noderīgs tad, ja vide neļauj izmantot sagatavotos priekšrakstus, piemēram, ja tiek izmantots savienojumu pūlētājs, piemēram, PgBouncer.

Plugins.PostgreSQL.Default.Database

Norādiet noklusējuma datubāzi savienojumam ar PostgreSQL.
Tiek izmantota, ja vienumā atslēgā vai nosauktajā sesijā nav norādīta vērtība.

Plugins.PostgreSQL.Default.Password

Norādiet noklusējuma paroli savienojumam ar PostgreSQL.
Tiek izmantota, ja vienums atslēgā vai nosauktajā sesijā nav norādīta vērtība.

Plugins.PostgreSQL.Default.TLSCAFile

Norādiet pilnu faila ceļu uz failu, kurā atrodas augstākā līmeņa CA sertifikāts(-i) vienādranga sertifikāta verifikācijai šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
Tiek izmantots, ja nosauktajā sesijā nav norādīta vērtība.

Obligāti: yes, ja Plugins.PostgreSQL.Default.TLSConnect ir iestatīts uz verify_ca vai verify_full

Plugins.PostgreSQL.Default.TLSCertFile

Norādiet pilnu ceļu uz failu, kurā ir PostgreSQL sertifikāts vai sertifikātu ķēde šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
Tiek izmantots, ja nosauktajā sesijā nav norādīta vērtība.

Obligāts: yes, ja ir norādīts Plugins.PostgreSQL.Default.TLSKeyFile

Plugins.PostgreSQL.Default.TLSConnect

Norādiet noklusējuma šifrēšanas līmeni saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
Tiek izmantots, ja nosauktajā sesijā nav norādīta vērtība.

Diapazons:
required - savienoties, izmantojot TLS kā transporta režīmu bez identitātes pārbaudes;
verify_ca - savienoties, izmantojot TLS un pārbaudīt sertifikātu;
verify_full - savienoties, izmantojot TLS, pārbaudīt sertifikātu un pārbaudīt, ka datubāzes identitāte (CN), kas norādīta ar DBHost, atbilst tās sertifikātam.

Nedefinēts šifrēšanas tips nozīmē nešifrētu savienojumu.

Plugins.PostgreSQL.Default.TLSKeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL privātā atslēga šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
Tiek izmantots, ja nosauktajā sesijā nav norādīta vērtība.

Obligāti: yes, ja ir norādīts Plugins.PostgreSQL.Default.TLSCertFile

Plugins.PostgreSQL.Default.Uri

Norādiet noklusējuma URI savienojumam ar PostgreSQL.
Tiek izmantots, ja vienums atslēgā vai nosauktā sesijā nav norādīta vērtība.
Iekļautie akreditācijas dati tiks ignorēti.
Tam jāatbilst URI formātam.
Atbalstītās shēmas: tcp, unix

Piemēri:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User

Norādiet noklusējuma lietotājvārdu savienojumam ar PostgreSQL.
Tiek izmantots, ja vienums atslēgā vai nosauktā sesijā nav norādīta vērtība.

Plugins.PostgreSQL.KeepAlive

Iestata maksimālo gaidīšanas laiku (sekundēs) pirms neizmantotie spraudņa savienojumi tiek slēgti.

Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode

Norādiet PostgreSQL savienojuma nosauktās sesijas kešatmiņas režīmu.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Noklusējums: prepare
Diapazons:
prepare - izveido sagatavotos priekšrakstus PostgreSQL serverī;
describe - izmanto anonīmu sagatavoto priekšrakstu, lai aprakstītu priekšrakstu, neveidojot priekšrakstu serverī.

Ņemiet vērā, ka describe galvenokārt ir noderīgs tad, ja vide neļauj izmantot sagatavotos priekšrakstus, piemēram, darbinot savienojumu pūlētāju, piemēram, PgBouncer.

Plugins.PostgreSQL.Sessions.<SessionName>.Database

Norādiet nosauktās sesijas datubāzi savienojumam ar PostgreSQL.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.PostgreSQL.Sessions.<SessionName>.Password

Norādiet nosauktās sesijas paroli savienojumam ar PostgreSQL.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.
Jāatbilst paroles formātam.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile

Norādiet pilnu ceļu uz failu, kurā atrodas augstākā līmeņa CA sertifikāts(-i) vienaudža sertifikāta verifikācijai šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Obligāti: yes, ja Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect ir iestatīts uz verify_ca vai verify_full

Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile

Norādiet pilnu ceļu uz failu, kurā ir PostgreSQL sertifikāts vai sertifikātu ķēde šifrētai saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Obligāts: yes, ja ir norādīts Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect

Norādiet nosaukto sesijas līmeņa šifrēšanu saziņai starp Zabbix aģents 2 un uzraudzītajām datubāzēm.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienuma atslēgās.

Diapazons:
required - izveidot savienojumu, izmantojot TLS kā transporta režīmu bez identitātes pārbaudēm;
verify_ca - izveidot savienojumu, izmantojot TLS un pārbaudīt sertifikātu;
verify_full - izveidot savienojumu, izmantojot TLS, pārbaudīt sertifikātu un pārbaudīt, ka datubāzes identitāte (CN), kas norādīta ar DBHost, atbilst tās sertifikātam.

Nenoteikts šifrēšanas tips nozīmē nešifrētu savienojumu.

Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

Norādiet pilnu ceļu uz failu, kurā atrodas PostgreSQL privātā atslēga šifrētai saziņai starp Zabbix aģentu 2 un uzraudzītajām datubāzēm.
<SessionName> - norādiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Obligāts: yes, ja ir norādīts Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile.

Plugins.PostgreSQL.Sessions.<SessionName>.Uri

Norādiet nosauktās sesijas URI savienojumam ar PostgreSQL.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.
Iegultie akreditācijas dati tiks ignorēti.
Jāatbilst URI formātam.
Atbalstītās shēmas: tcp, unix

Piemēri:

tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User

Norādiet nosauktās sesijas lietotājvārdu savienojumam ar PostgreSQL.
<SessionName> - definējiet sesijas nosaukumu, ko izmantot vienumu atslēgās.

Plugins.PostgreSQL.System.Path

Norādiet PostgreSQL spraudņa izpildāmā faila ceļu.

Obligāti: yes

Piemērs:

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

Iestatiet pieprasījuma izpildes noildzi (ilgumu sekundēs, cik ilgi gaidīt, līdz pieprasījums tiek pabeigts, pirms to pārtrauc).

Noklusējums: global timeout
Diapazons: 1-30

Opcijas

Parameter Description
-V --version Izdrukā spraudņa versiju un licences informāciju.
-h --help Izdrukā palīdzības informāciju (saīsināti).
-t, --test <item key> Palaiž spraudni testēšanai (spraudņa konfigurācija tiek ignorēta).

Skatiet arī