Documentation
Table of Contents
11 Plugin PostgreSQL
Przegląd
Ta sekcja zawiera listę parametrów obsługiwanych w pliku konfiguracyjnym pluginu PostgreSQL dla agenta Zabbix 2 (postgresql.conf).
Od Zabbix 6.0.10, plugin PostgreSQL jest pluginem ładowalnym i jest dostępny oraz w pełni opisany w repozytorium pluginu PostgreSQL.
Prekompilowane binaria pluginu dla Windows są dostępne od Zabbix 6.0.19 i są kompatybilne z wcześniejszymi wersjami 6.0.
Należy zauważyć, że:
- Wartości domyślne odzwierciedlają domyślne wartości procesów, a nie wartości w dostarczonych plikach konfiguracyjnych;
- Zabbix obsługuje pliki konfiguracyjne tylko w kodowaniu UTF-8 bez BOM;
- Komentarze zaczynające się od "#" są obsługiwane tylko na początku linii.
Opcje
| Parametr | Opis |
|---|---|
| -V --version | Wyświetla wersję pluginu i informacje o licencji. |
| -h --help | Wyświetla informacje pomocnicze (skrót). |
Parametry
W wersjach Zabbix przed 6.0.10, nazwy parametrów zaczynają się od Plugins.Postgres.<Parametr> zamiast Plugins.PostgreSQL.<Parametr>. Na przykład, Plugins.Postgres.KeepAlive.
| Parametr | Obowiązkowy | Zakres | Domyślny | Opis |
|---|---|---|---|---|
| Plugins.PostgreSQL.Default.CacheMode | nie | prepare | Tryb buforowania dla połączenia z PostgreSQL. Obsługiwane wartości: prepare (domyślnie) - utworzy przygotowane instrukcje na serwerze PostgreSQL; describe - użyje anonimowej przygotowanej instrukcji do opisania instrukcji bez tworzenia instrukcji na serwerze. Należy zauważyć, że "describe" jest głównie przydatne, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas uruchamiania poolera połączeń, takiego jak PgBouncer. Obsługiwane od wersji 6.0.25. |
|
| Plugins.PostgreSQL.CallTimeout | nie | 1-30 | global timeout | Maksymalny czas oczekiwania (w sekundach) na ukończenie żądania. |
| Plugins.PostgreSQL.CustomQueriesPath | nie | disabled | Pełna ścieżka do katalogu zawierającego pliki .sql z niestandardowymi zapytaniami. | |
| Plugins.PostgreSQL.Default.Database | nie | Domyślna baza danych do połączenia z PostgreSQL; używana, jeśli nie została podana wartość w kluczu pozycji lub nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.Password | nie | Domyślne hasło do połączenia z PostgreSQL; używane, jeśli nie została podana wartość w kluczu pozycji lub nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.TLSCAFile | nie (tak, jeśli Plugins.PostgreSQL.Default.TLSConnect jest ustawione na verify_ca lub verify_full) |
Pełna ścieżka do pliku zawierającego certyfikat(e) najwyższego poziomu dla weryfikacji certyfikatu peer dla szyfrowanych komunikacji między agentem Zabbix 2 a monitorowanymi bazami danych; używane, jeśli nie została podana wartość w nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.TLSCertFile | nie (tak, jeśli Plugins.PostgreSQL.Default.TLSConnect jest ustawione na verify_ca lub verify_full) |
Pełna ścieżka do pliku zawierającego certyfikat PostgreSQL lub łańcuch certyfikatów dla szyfrowanych komunikacji między agentem Zabbix 2 a monitorowanymi bazami danych; używane, jeśli nie została podana wartość w nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.TLSConnect | nie | Typ szyfrowania dla komunikacji między agentem Zabbix 2 a monitorowanymi bazami danych; używany, jeśli nie została podana wartość w nazwanej sesji. Obsługiwane wartości: required - połącz za pomocą TLS jako trybu transportu bez weryfikacji tożsamości; verify_ca - połącz za pomocą TLS i zweryfikuj certyfikat; verify_full - połącz za pomocą TLS, zweryfikuj certyfikat i zweryfikuj, że tożsamość bazy danych (CN) określona przez DBHost pasuje do jej certyfikatu. Niezdefiniowany typ szyfrowania oznacza połączenie bez szyfrowania. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.TLSKeyFile | nie (tak, jeśli Plugins.PostgreSQL.Default.TLSConnect jest ustawione na verify_ca lub verify_full) |
Pełna ścieżka do pliku zawierającego prywatny klucz PostgreSQL do szyfrowanych komunikacji między agentem Zabbix 2 a monitorowanymi bazami danych; używane, jeśli nie została podana wartość w nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.Uri | nie | Domyślny URI do połączenia z PostgreSQL; używany, jeśli nie została podana wartość w kluczu pozycji lub nazwanej sesji. Nie powinien zawierać osadzonych poświadczeń (będą one ignorowane). Musi odpowiadać formatowi URI. Obsługiwane schematy: tcp, unix.Przykłady: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.Default.User | nie | Domyślna nazwa użytkownika do połączenia z PostgreSQL; używana, jeśli nie została podana wartość w kluczu pozycji lub nazwanej sesji. Obsługiwane od wersji 6.0.18. |
||
| Plugins.PostgreSQL.KeepAlive | nie | 60-900 | 300 | Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń pluginu. |
| Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode | nie | prepare | Tryb buforowania dla połączenia z PostgreSQL. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. Obsługiwane wartości: prepare (domyślnie) - tworzy przygotowane instrukcje na serwerze PostgreSQL; describe - używa anonimowej przygotowanej instrukcji do opisania instrukcji bez tworzenia instrukcji na serwerze. Należy zauważyć, że "describe" jest głównie przydatne, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas uruchamiania poolera połączeń, takiego jak PgBouncer. Obsługiwane od wersji 6.0.25. |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.Database | nie | Baza danych do połączenia sesji. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Password | nie | Musi być zgodne z formatem hasła. | Hasło do połączenia sesji. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
|
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile | nie (tak, jeśli Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect jest ustawione na verify_ca lub verify_full) |
Pełna ścieżka do pliku zawierającego certyfikat(e) najwyższego poziomu dla weryfikacji certyfikatu peer. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile | tak, jeśli określono Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile Przed wersją 6.0.22 zawsze obowiązkowy, jeśli Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect jest ustawione na verify_ca lub verify_full |
Pełna ścieżka do pliku zawierającego certyfikat PostgreSQL lub łańcuch certyfikatów. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect | nie | Typ szyfrowania dla połączenia PostgreSQL. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. Obsługiwane wartości: required - połącz za pomocą TLS jako trybu transportu bez weryfikacji tożsamości; verify_ca - połącz za pomocą TLS i zweryfikuj certyfikat; verify_full - połącz za pomocą TLS, zweryfikuj certyfikat i zweryfikuj, że tożsamość bazy danych (CN) określona przez DBHost pasuje do jej certyfikatu. Niezdefiniowany typ szyfrowania oznacza połączenie bez szyfrowania. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile | tak, jeśli określono Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile Przed wersją 6.0.22 zawsze obowiązkowy, jeśli Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect jest ustawione na verify_ca lub verify_full |
Pełna ścieżka do pliku zawierającego prywatny klucz PostgreSQL. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.Uri | nie | Ciąg połączeniowy nazwanej sesji. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. Nie powinien zawierać osadzonych poświadczeń (będą one ignorowane). Musi odpowiadać formatowi URI. Obsługiwane schematy: tcp, unix.Przykłady: tcp://127.0.0.1:5432tcp://localhostunix:/var/run/postgresql/.s.PGSQL.5432 |
||
| Plugins.PostgreSQL.Sessions.<SessionName>.User | nie | Nazwa użytkownika sesji nazwanej. <SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji. |
||
| Plugins.PostgreSQL.System.Path | tak | Ścieżka do zewnętrznego pliku wykonywalnego pluginu. Obsługiwane od wersji Zabbix 6.0.10. | ||
| Plugins.PostgreSQL.Timeout | nie | 1-30 | global timeout | Limit czasu wykonania żądania (czas oczekiwania na ukończenie żądania przed jego zatrzymaniem). |
Zobacz też:
- Opis ogólnych parametrów konfiguracyjnych agenta Zabbix 2: Agent Zabbix 2 (UNIX) / Agent Zabbix 2 (Windows)
- Instrukcje konfiguracji [pluginów](/manual/config/items/plugins