8 Wtyczka MSSQL

Omówienie

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

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

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

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ę 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

Parameter Mandatory Range Default Description
Plugins.MSSQL.CustomQueriesDir no /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 z zmiennej środowiskowej ProgramFiles		 Określa ścieżkę do katalogu zawierającego zdefiniowane przez użytkownika pliki .sql z niestandardowymi zapytaniami, które plugin może wykonywać. Plugin ładuje wszystkie dostępne pliki .sql z skonfigurowanego katalogu podczas uruchamiania. Oznacza to, że wszelkie zmiany w plikach niestandardowych zapytań nie będą widoczne do czasu ponownego uruchomienia pluginu. Plugin jest uruchamiany i zatrzymywany razem z Zabbix agent 2.
Plugins.MSSQL.CustomQueriesEnabled no false Jeśli ustawione, włącza wykonywanie klucza pozycji mssql.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane z ścieżki katalogu niestandardowych zapytań.
Plugins.MSSQL.Default.CACertPath no 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 no Domyślna nazwa bazy danych, z którą należy się połączyć.
Plugins.MSSQL.Default.Encrypt no Określa domyślny typ szyfrowania połączenia. Dostępne wartości to:
true - przesyłanie danych między pluginem a serwerem jest szyfrowane;
false - przesyłanie danych między pluginem a serwerem nie jest szyfrowane poza pakietem logowania;
strict - przesyłanie danych między pluginem a serwerem jest szyfrowane E2E przy użyciu TDS8;
disable - przesyłanie danych między pluginem a serwerem nie jest szyfrowane.
Plugins.MSSQL.Default.HostNameInCertificate no Domyślna nazwa pospolita (CN) certyfikatu serwera MSSQL.
Plugins.MSSQL.Default.Password no Domyślne hasło wysyłane do chronionego serwera MSSQL.
Plugins.MSSQL.Default.TLSMinVersion no Domyślna minimalna wersja TLS do użycia. Dostępne wartości to: 1.0, 1.1, 1.2, 1.3.
Plugins.MSSQL.Default.TrustServerCertificate no Określa, czy plugin ma domyślnie ufać certyfikatowi serwera bez jego weryfikacji. Dostępne wartości: true, false.
Plugins.MSSQL.Default.Uri no sqlserver://localhost:1433 Domyślny URI do połączenia. Jedynym obsługiwanym schematem jest sqlserver://. Schemat można pominąć. Osadzone poświadczenia zostaną zignorowane.
Plugins.MSSQL.Default.User no Domyślna nazwa użytkownika wysyłana do chronionego serwera MSSQL.
Plugins.MSSQL.KeepAlive no 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń pluginu.
Plugins.MSSQL.Sessions.<SessionName>.CACertPath no Ś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 no Nazwa bazy danych, z którą należy się połączyć dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Encrypt no Określa typ szyfrowania połączenia dla nazwanej sesji. Dostępne wartości to:
true - przesyłanie danych między pluginem a serwerem jest szyfrowane;
false - przesyłanie danych między pluginem a serwerem nie jest szyfrowane poza pakietem logowania;
strict - przesyłanie danych między pluginem a serwerem jest szyfrowane E2E przy użyciu TDS8;
disable - przesyłanie danych między pluginem a serwerem nie jest szyfrowane.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate no Domyślna nazwa pospolita (CN) certyfikatu serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Password no Hasło wysyłane do chronionego serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion no Minimalna wersja TLS do użycia dla nazwanej sesji. Dostępne wartości to: 1.0, 1.1, 1.2, 1.3.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate no Określa, czy plugin ma ufać certyfikatowi serwera bez jego weryfikacji dla nazwanej sesji. Dostępne wartości: true, false.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.Uri no sqlserver://localhost:1433 URI do połączenia dla nazwanej sesji. Jedynym obsługiwanym schematem jest sqlserver://. Schemat można pominąć. Osadzone poświadczenia zostaną zignorowane.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.Sessions.<SessionName>.User no Nazwa użytkownika wysyłana do chronionego serwera MSSQL dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MSSQL.System.Path no Ścieżka do pliku wykonywalnego pluginu MSSQL.
Globalne ustawienie dla pluginu MSSQL. Stosowane do wszystkich połączeń.
Przykład użycia: Plugins.MSSQL.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-mssql
Plugins.MSSQL.Timeout no 1-30 global timeout Czas oczekiwania, w sekundach, na odpowiedź serwera przy pierwszym połączeniu oraz podczas kolejnych operacji w sesji.

Zobacz także: