12 Wtyczka PostgreSQL

Przegląd

Plik konfiguracyjny Zabbix agent 2 służy do konfigurowania wtyczek. Te 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 w celu dodania tego pliku do konfiguracji Zabbix agent 2.

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

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają wartości domyślne 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 nie 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 przydatne przede wszystkim wtedy, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas używania puli połączeń, takiej jak PgBouncer.
Plugins.PostgreSQL.CallTimeout nie 1-30 global timeout Maksymalny czas oczekiwania (w sekundach) na zakończenie żądania.
Plugins.PostgreSQL.CustomQueriesPath nie /usr/local/share/zabbix/custom-queries/postgreSQL for Unix systems

*:\Program Files\Zabbix Agent 2\Custom Queries\PostgreSQL for Windows systems, where * is the drive name from the ProgramFiles environment variable		 Pełna ścieżka do katalogu zawierającego pliki .sql z niestandardowymi zapytaniami.
Plugins.PostgreSQL.CustomQueriesEnabled nie false Jeśli ustawione, włącza wykonywanie klucza pozycji postgresql.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane ze ścieżki katalogu niestandardowych zapytań.
Plugins.PostgreSQL.Default.Database nie Domyślna baza danych do łączenia z PostgreSQL; używana, jeśli żadna wartość nie została określona w kluczu pozycji lub nazwanej sesji.
Plugins.PostgreSQL.Default.Password nie Domyślne hasło do łączenia z PostgreSQL; używane, jeśli żadna wartość nie została określona w kluczu pozycji lub nazwanej sesji.
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(y) głównego urzędu certyfikacji (CA) do weryfikacji certyfikatu partnera dla szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli żadna wartość nie została określona w nazwanej sesji.
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 szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli żadna wartość nie została określona w nazwanej sesji.
Plugins.PostgreSQL.Default.TLSConnect nie Typ szyfrowania komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używany, jeśli żadna wartość nie została określona w nazwanej sesji.
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 odpowiada jej certyfikatowi.
Niezdefiniowany typ szyfrowania oznacza połączenie nieszyfrowane.
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 klucz prywatny PostgreSQL dla szyfrowanej komunikacji między Zabbix agent 2 a monitorowanymi bazami danych; używana, jeśli żadna wartość nie została określona w nazwanej sesji.
Plugins.PostgreSQL.Default.Uri nie Domyślny URI do łączenia z PostgreSQL; używany, jeśli żadna wartość nie została określona w kluczu pozycji lub nazwanej sesji.

Nie powinien zawierać osadzonych danych uwierzytelniających (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 nie Domyślna nazwa użytkownika do łączenia z PostgreSQL; używana, jeśli żadna wartość nie została określona w kluczu pozycji lub nazwanej sesji.
Plugins.PostgreSQL.KeepAlive nie 60-900 300 Maksymalny czas oczekiwania (w sekundach), po którym nieużywane połączenia pluginu są zamykane.
Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode nie prepare Tryb pamięci podręcznej dla połączenia PostgreSQL.
<SessionName> - określa nazwę sesji używaną 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 przydatne przede wszystkim wtedy, gdy środowisko nie pozwala na przygotowane instrukcje, na przykład podczas używania puli połączeń, takiej jak PgBouncer.
Plugins.PostgreSQL.Sessions.<SessionName>.Database nie Baza danych dla połączenia sesji.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.Password nie Must match the password format. Hasło dla połączenia sesji.
<SessionName> - określa nazwę sesji używaną 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(y) głównego urzędu certyfikacji (CA) do weryfikacji certyfikatu partnera.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile tak, jeśli Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile jest określone Pełna ścieżka do pliku zawierającego certyfikat PostgreSQL lub łańcuch certyfikatów.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect nie Typ szyfrowania dla połączenia PostgreSQL.
<SessionName> - określa nazwę sesji używaną 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 odpowiada jej certyfikatowi.
Niezdefiniowany typ szyfrowania oznacza połączenie nieszyfrowane.
Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile tak, jeśli Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile jest określone Pełna ścieżka do pliku zawierającego klucz prywatny PostgreSQL.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.
Plugins.PostgreSQL.Sessions.<SessionName>.Uri nie Ciąg połączenia nazwanej sesji.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.

Nie powinien zawierać osadzonych danych uwierzytelniających (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 nie Nazwa użytkownika nazwanej sesji.
<SessionName> - określa nazwę sesji używaną w kluczach pozycji.
Plugins.PostgreSQL.System.Path tak Ścieżka do pliku wykonywalnego pluginu PostgreSQL.
Przykład użycia: Plugins.PostgreSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-postgresql
Plugins.PostgreSQL.Timeout nie 1-30 global timeout Limit czasu wykonania żądania (czas trwania, w sekundach, oczekiwania na zakończenie żądania przed jego przerwaniem).

Zobacz także: