8 Wtyczka MSSQL

Przegląd

Plik konfiguracyjny Zabbix agent 2 służy do konfigurowania wtyczek. Te parametry konfiguracyjne Zabbix agent 2 są obsługiwane do działania wtyczki MSSQL.

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

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

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają domyślne wartości procesu, a nie wartości w dostarczanych 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ę wtyczki oraz informacje o licencji.
-h --help Wyświetla informacje pomocy (skrót).
-t, --test <item key> Uruchamia wtyczkę w celu testowania (konfiguracja wtyczki jest ignorowana).

Parametry

Parametr Wymagany Zakres Domyślnie Opis
Plugins.MSSQL.CustomQueriesDir nie /usr/local/share/zabbix/custom-queries/mssql dla systemów Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\MSSQL dla systemów Windows, gdzie * to nazwa dysku ze zmiennej środowiskowej ProgramFiles		 Określa ścieżkę do katalogu zawierającego zdefiniowane przez użytkownika pliki .sql z niestandardowymi zapytaniami, które wtyczka może wykonywać. Wtyczka ładuje wszystkie dostępne pliki .sql ze skonfigurowanego katalogu podczas uruchamiania. Oznacza to, że wszelkie zmiany w plikach niestandardowych zapytań nie będą widoczne do momentu ponownego uruchomienia wtyczki. Wtyczka jest uruchamiana i zatrzymywana razem z Zabbix agent 2.
Plugins.MSSQL.CustomQueriesEnabled nie false Jeśli ustawione, włącza wykonywanie klucza pozycji mssql.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane ze ścieżki katalogu niestandardowych zapytań.
Plugins.MSSQL.Default.CACertPath nie Domyślna ścieżka do certyfikatu klucza publicznego urzędu certyfikacji (CA), który wydał certyfikat serwera MSSQL. Certyfikat musi być w formacie PEM.
Plugins.MSSQL.Default.Database nie Domyślna nazwa bazy danych, z którą ma zostać nawiązane połączenie.
Plugins.MSSQL.Default.Encrypt nie Określa domyślny typ szyfrowania połączenia. Możliwe wartości:
true - przesyłanie danych między wtyczką a serwerem jest szyfrowane;
false - przesyłanie danych między wtyczką a serwerem nie jest szyfrowane poza pakietem logowania;
strict - przesyłanie danych między wtyczką a serwerem jest szyfrowane end-to-end z użyciem TDS8;
disable - przesyłanie danych między wtyczką a serwerem nie jest szyfrowane.
Plugins.MSSQL.Default.HostNameInCertificate nie Domyślna nazwa pospolita (CN) certyfikatu serwera MSSQL.
Plugins.MSSQL.Default.Password nie Hasło, które domyślnie ma być wysyłane do chronionego serwera MSSQL.
Plugins.MSSQL.Default.TLSMinVersion nie Domyślna minimalna wersja TLS. Możliwe wartości: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate nie Określa, czy wtyczka ma domyślnie ufać certyfikatowi serwera bez jego weryfikacji. Możliwe wartości: true, false.
Plugins.MSSQL.Default.Uri nie sqlserver://localhost:1433 Domyślny URI połączenia. Jedynym obsługiwanym schematem jest sqlserver://. Schemat można pominąć. Osadzone dane uwierzytelniające zostaną zignorowane.
Plugins.MSSQL.Default.User nie Domyślna nazwa użytkownika, która ma być wysyłana do chronionego serwera MSSQL.
Plugins.MSSQL.KeepAlive nie 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń wtyczki.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath nie Ścieżka do certyfikatu klucza publicznego urzędu certyfikacji (CA), który wydał certyfikat serwera MSSQL dla nazwanej sesji. Certyfikat musi być w formacie PEM.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Database nie Nazwa bazy danych, z którą ma zostać nawiązane połączenie dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt nie Określa typ szyfrowania połączenia dla nazwanej sesji. Możliwe wartości:
true - przesyłanie danych między wtyczką a serwerem jest szyfrowane;
false - przesyłanie danych między wtyczką a serwerem nie jest szyfrowane poza pakietem logowania;
strict - przesyłanie danych między wtyczką a serwerem jest szyfrowane end-to-end z użyciem TDS8;
disable - przesyłanie danych między wtyczką a serwerem nie jest szyfrowane.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate nie Nazwa pospolita (CN) certyfikatu serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Password nie Hasło, które ma być wysyłane do chronionego serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion nie Minimalna wersja TLS używana dla nazwanej sesji. Możliwe wartości: 1.0, 1.1, 1.2, 1.3.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate nie Określa, czy wtyczka ma ufać certyfikatowi serwera bez jego weryfikacji dla nazwanej sesji. Możliwe wartości: true, false.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Uri nie sqlserver://localhost:1433 URI połączenia dla nazwanej sesji. Jedynym obsługiwanym schematem jest sqlserver://. Schemat można pominąć. Osadzone dane uwierzytelniające zostaną zignorowane.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.User nie Nazwa użytkownika, która ma być wysyłana do chronionego serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.System.Path nie Ścieżka do pliku wykonywalnego wtyczki MSSQL.
Ustawienie globalne dla wtyczki MSSQL. Stosowane do wszystkich połączeń.
Przykład użycia: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout nie 1-30 global timeout Czas oczekiwania w sekundach na odpowiedź serwera przy pierwszym nawiązywaniu połączenia oraz podczas kolejnych operacji w sesji.

Zobacz także: