12 Wtyczka PostgreSQL

Przegląd

Plik konfiguracyjny Zabbix agent 2 służy do konfigurowania wtyczek. Następujące parametry konfiguracyjne Zabbix agent 2 są obsługiwane podczas działania wtyczki PostgreSQL.

Zaleca się określenie ich we własnym pliku konfiguracyjnym (np. postgresql.conf), a następnie użycie dyrektywy Include do dodania tego pliku do konfiguracji Zabbix agent 2.

Wtyczka PostgreSQL jest wtyczką ładowaną i jest dostępna oraz w pełni opisana w repozytorium wtyczki PostgreSQL.

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają domyślne ustawienia procesu, a nie wartości w dostarczonych plikach konfiguracyjnych.
  • Wartości obsługują zmienne środowiskowe;
  • Zabbix obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 bez BOM.
  • Komentarze rozpoczynające się od "#" są obsługiwane tylko na początku wiersza.

Opcje

Parameter Description
-V --version Wyświetla wersję pluginu oraz informacje o licencji.
-h --help Wyświetla informacje pomocy (skrót).
-t, --test <item key> Uruchamia plugin do testowania (konfiguracja pluginu jest ignorowana).

Parametry

Parameter Mandatory Range Default Description
Plugins.PostgreSQL.Default.CacheMode no prepare Tryb pamięci podręcznej dla połączenia 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 pamiętać, że "describe" jest przede wszystkim przydatne, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas korzystania z poolera połączeń, takiego jak PgBouncer.
Plugins.PostgreSQL.CallTimeout no 1-30 global timeout Maksymalny czas oczekiwania (w sekundach) na zakończenie żądania.
Plugins.PostgreSQL.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/postgreSQL dla systemów Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL dla systemów Windows, gdzie * jest nazwą dysku z zmiennej środowiskowej ProgramFiles		 Pełna ścieżka do katalogu zawierającego pliki .sql z niestandardowymi zapytaniami.
Plugins.PostgreSQL.CustomQueriesEnabled no false Jeśli ustawione, włącza wykonywanie klucza pozycja postgresql.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane z katalogu niestandardowych zapytań.
Plugins.PostgreSQL.Default.Database no Domyślna baza danych do łączenia z PostgreSQL; używana, jeśli w kluczu pozycji lub nazwanej sesji nie określono wartości.
Plugins.PostgreSQL.Default.Password no Domyślne hasło do łączenia z PostgreSQL; używane, jeśli w kluczu pozycji lub nazwanej sesji nie określono wartości.
Plugins.PostgreSQL.Default.TLSCAFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Pełna ścieżka do pliku zawierającego certyfikat(y) głównego urzędu CA do weryfikacji certyfikatu peer dla szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.PostgreSQL.Default.TLSCertFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Pełna ścieżka do pliku zawierającego certyfikat PostgreSQL lub łańcuch certyfikatów dla szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.PostgreSQL.Default.TLSConnect no Typ szyfrowania dla komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używany, jeśli w nazwanej sesji nie określono żadnej wartości.
Obsługiwane wartości:
required - połączenie z użyciem TLS jako trybu transportu bez sprawdzania tożsamości;
verify_ca - połączenie z użyciem TLS i weryfikacją certyfikatu;
verify_full - połączenie z użyciem TLS, weryfikacją certyfikatu oraz sprawdzeniem, czy tożsamość bazy danych (CN) określona przez DBHost jest zgodna z jej certyfikatem.
Nieokreślony typ szyfrowania oznacza połączenie nieszyfrowane.
Plugins.PostgreSQL.Default.TLSKeyFile no
(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to verify_ca or verify_full)		 Pełna ścieżka do pliku zawierającego prywatny klucz PostgreSQL dla szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.PostgreSQL.Default.Uri no Domyślny URI do łączenia z PostgreSQL; używany, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi być zgodny z formatem URI.
Obsługiwane schematy: tcp, unix.
Przykłady: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Default.User no Domyślna nazwa użytkownika do łączenia z PostgreSQL; używana, jeśli w kluczu pozycji lub nazwanej sesji nie określono wartości.
Plugins.PostgreSQL.KeepAlive no 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń wtyczki.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode no prepare Tryb pamięci podręcznej dla połączenia PostgreSQL.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
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 pamiętać, że "describe" jest przede wszystkim przydatne, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas korzystania z poolera połączeń, takiego jak PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database no Baza danych dla połączenia sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.Password no Must match the password format. Hasło dla połączenia sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile no
(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to verify_ca or verify_full)		 Pełna ścieżka do pliku zawierającego certyfikat(y) głównego urzędu CA do weryfikacji certyfikatu peer.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified 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 no Typ szyfrowania dla połączenia PostgreSQL.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Obsługiwane wartości:
required - połączenie z użyciem TLS jako trybu transportu bez sprawdzania tożsamości;
verify_ca - połączenie z użyciem TLS i weryfikacją certyfikatu;
verify_full - połączenie z użyciem TLS, weryfikacją certyfikatu oraz sprawdzeniem, czy tożsamość bazy danych (CN) określona przez DBHost jest zgodna z jej certyfikatem.
Nieokreślony typ szyfrowania oznacza połączenie nieszyfrowane.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified 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 no Ciąg połączenia nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi być zgodny z formatem URI.
Obsługiwane schematy: tcp, unix.
Przykłady: tcp://127.0.0.1:5432
tcp://localhost
unix:/var/run/postgresql/.s.PGSQL.5432
Plugins.PostgreSQL.Sessions.<SessionName>.User no Nazwa użytkownika nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.PostgreSQL.System.Path yes Ścieżka do pliku wykonywalnego wtyczki PostgreSQL.
Przykład użycia: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout no 1-30 global timeout Limit czasu wykonania żądania (czas w sekundach, przez jaki należy czekać na zakończenie żądania przed jego przerwaniem).

Zobacz także: