Documentation
Table of Contents
8 Plugin MSSQL
Przegląd
Ta sekcja wymienia parametry obsługiwane w pliku konfiguracyjnym pluginu MSSQL agenta Zabbix 2 (mssql.conf).
Plugin MSSQL jest ładowalnym pluginem i jest dostępny oraz w pełni opisany w repozytorium pluginu MSSQL.
Ten plugin jest obsługiwany od Zabbix 6.0.27. Wstępnie skompilowane pliki binarne pluginu dla systemu Windows są dostępne od Zabbix 6.0.28 i są kompatybilne z wersją 6.0.27.
Należy zauważyć, że:
- Wartości domyślne odzwierciedlają domyślne wartości procesu, 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.
Parametry
| Parametr | Obowiązkowy | Zakres | Domyślnie | Opis |
|---|---|---|---|---|
| Plugins.MSSQL.CustomQueriesDir | nie | puste | Określa ścieżkę do katalogu zawierającego pliki .sql z zapytaniami niestandardowymi, które plugin może wykonać. Plugin ładuje wszystkie dostępne pliki .sql w skonfigurowanym katalogu podczas uruchamiania. Oznacza to, że wszelkie zmiany w plikach zapytań niestandardowych nie będą widoczne do czasu ponownego uruchomienia pluginu. Plugin jest uruchamiany i zatrzymywany razem z Zabbix agent 2. | |
| Plugins.MSSQL.Default.CACertPath | nie | Domyślna ścieżka do pliku z publicznym certyfikatem 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, do której ma się połączyć. | ||
| Plugins.MSSQL.Default.Encrypt | nie | Określa domyślny typ szyfrowania połączenia. Możliwe wartości to: true - dane przesyłane między pluginem a serwerem są szyfrowane; false - dane przesyłane między pluginem a serwerem nie są szyfrowane poza pakietem logowania; strict - dane przesyłane między pluginem a serwerem są szyfrowane E2E przy użyciu TDS8; disable - dane przesyłane między pluginem a serwerem nie są szyfrowane. |
||
| Plugins.MSSQL.Default.HostNameInCertificate | nie | Domyślna nazwa wspólna (CN) certyfikatu serwera MSSQL. | ||
| Plugins.MSSQL.Default.Password | nie | Domyślne hasło do wysłania na chroniony serwer MSSQL. | ||
| Plugins.MSSQL.Default.TLSMinVersion | nie | Minimalna wersja TLS do użycia domyślnie. Możliwe wartości to: 1.0, 1.1, 1.2, 1.3. |
||
| Plugins.MSSQL.Default.TrustServerCertificate | nie | Czy plugin powinien domyślnie ufać certyfikatowi serwera bez jego weryfikacji. Możliwe wartości: true, false. |
||
| Plugins.MSSQL.Default.Uri | nie | sqlserver://localhost:1433 | Domyślne URI do połączenia. Jedynym obsługiwanym schematem jest sqlserver://. Schemat może być pominięty. Wbudowane dane uwierzytelniające będą ignorowane. |
|
| Plugins.MSSQL.Default.User | nie | Domyślna nazwa użytkownika do wysłania na chroniony serwer MSSQL. | ||
| Plugins.MSSQL.KeepAlive | nie | 60-900 | 300 | Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń pluginu. |
| Plugins.MSSQL.Sessions.<SessionName>.CACertPath | nie | Ścieżka do pliku z publicznym certyfikatem urzędu certyfikacji (CA), który wydał certyfikat serwera MSSQL dla nazwanej sesji. Certyfikat musi być w formacie PEM. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Database | nie | Nazwa bazy danych, do której należy się połączyć dla nazwanej sesji. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Encrypt | nie | Określa typ szyfrowania połączenia dla nazwanej sesji. Możliwe wartości to: true - dane przesyłane między pluginem a serwerem są szyfrowane; false - dane przesyłane między pluginem a serwerem nie są szyfrowane poza pakietem logowania; strict - dane przesyłane między pluginem a serwerem są szyfrowane E2E przy użyciu TDS8; disable - dane przesyłane między pluginem a serwerem nie są szyfrowane. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate | nie | Domyślna nazwa wspólna (CN) certyfikatu serwera MSSQL dla nazwanej sesji. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Password | nie | Hasło do wysłania na chroniony serwer MSSQL dla nazwanej sesji. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion | nie | Minimalna wersja TLS do użycia dla nazwanej sesji. Możliwe wartości to: 1.0, 1.1, 1.2, 1.3.<SessionName> - określ nazwę sesji do użycia w kluczu pozycji |
||
| Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate | nie | Czy plugin powinien ufać certyfikatowi serwera bez jego weryfikacji dla nazwanej sesji. Możliwe wartości: true, false.<SessionName> - określ nazwę sesji do użycia w pozycjach kluczowych. |
||
| Plugins.MSSQL.Sessions.<SessionName>.Uri | nie | sqlserver://localhost:1433 | URI do połączenia dla nazwanej sesji. Jedynym obsługiwanym schematem jest sqlserver://. Schemat może być pominięty. Wbudowane dane uwierzytelniające będą ignorowane.<SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
|
| Plugins.MSSQL.Sessions.<SessionName>.User | nie | Nazwa użytkownika do wysłania na chroniony serwer MSSQL dla nazwanej sesji. <SessionName> - określ nazwę sesji do użycia w kluczu pozycji. |
||
| Plugins.MSSQL.System.Path | nie | Ścieżka do wykonywalnego pliku pluginu MSSQL. Ustawienie globalne dla pluginu MSSQL. Stosowane do wszystkich połączeń. Przykład użycia: Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql |
||
| Plugins.MSSQL.Timeout | nie | 1-30 | globalny timeout | Czas oczekiwania na odpowiedź serwera podczas pierwszego połączenia i na dalsze operacje w sesji. |
Zobacz także:
- Opis ogólnych parametrów konfiguracyjnych agenta Zabbix 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instrukcje dotyczące konfiguracji pluginów