Parametry konfiguracji: Zabbix agent 2 (Windows)
Przegląd
Parametry konfiguracji umożliwiają dostosowanie działania Zabbix agent 2 w systemie Windows.
Określ wartości parametrów w pliku konfiguracji agent 2 Zabbix (zabbix_agent2.conf). Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że dany parametr jest wymagany.
Ta strona ma następującą strukturę:
- Przegląd parametrów (aby wyświetlić pełne informacje o parametrze, kliknij jego nazwę)
- Szczegóły parametrów
| Parametr | Opis |
|---|---|
| Alias | Ustawia alias dla klucza pozycji. |
| AllowKey | Zezwala na wykonywanie kluczy pozycji pasujących do wzorca. |
| AllowKeyRegexp | Zezwala na wykonywanie kluczy pozycji pasujących do wzorca opartego na wyrażeniu regularnym. |
| BufferSend | Ustawia częstotliwość wysyłania wartości z bufora do serwera Zabbix. |
| BufferSize | Ustawia maksymalną liczbę wartości w buforze pamięci. |
| ControlSocket | Określa gniazdo sterujące używane do wysyłania poleceń wykonywanych w czasie działania za pomocą opcji -R. |
| DebugLevel | Ustawia poziom debugowania. |
| DenyKey | Zabrania wykonywania kluczy pozycji pasujących do wzorca. |
| DenyKeyRegexp | Zabrania wykonywania kluczy pozycji pasujących do wzorca opartego na wyrażeniu regularnym. |
| EnablePersistentBuffer | Włącza używanie lokalnego trwałego magazynu dla aktywnych pozycji. |
| ForceActiveChecksOnStart | Wykonuje aktywne sprawdzenia natychmiast po ponownym uruchomieniu dla pierwszej odebranej konfiguracji. |
| HeartbeatFrequency | Ustawia częstotliwość komunikatów heartbeat w sekundach. |
| HostInterface | Określa interfejs host. |
| HostInterfaceItem | Określa pozycję używaną do pobierania interfejsu host. |
| HostMetadata | Określa metadane host. |
| HostMetadataItem | Określa pozycję Zabbix agent używaną do pobierania metadanych host. |
| Hostname | Określa nazwę host. |
| HostnameItem | Określa pozycję Zabbix agent używaną do pobierania nazwy host. |
| Include | Określa katalog lub pojedyncze pliki, które mają zostać uwzględnione w pliku konfiguracji. |
| ListenIP | Określa adres IP nasłuchiwania agent dla połączeń z serwera/proxy. |
| ListenPort | Określa port nasłuchiwania agent. |
| LogFile | Określa plik dziennika agent. |
| LogFileSize | Ustawia maksymalny rozmiar pliku dziennika. |
| LogType | Określa typ wyjścia dziennika. |
| PerfCounter | Określa nowy parametr <parameter_name>, który jest średnią wartością systemowego licznika wydajności <perf_counter_path> dla określonego okresu <period> (w sekundach). |
| PerfCounterEn | Określa nowy parametr <parameter_name>, który jest średnią wartością systemowego licznika wydajności <perf_counter_path> dla określonego okresu <period> (w sekundach). W odróżnieniu od PerfCounter ścieżki liczników wydajności muszą być podane w języku angielskim. |
| PersistentBufferFile | Określa plik, w którym Zabbix agent 2 powinien przechowywać bazę danych SQLite. |
| PersistentBufferPeriod | Ustawia czas przechowywania danych w przypadku braku połączenia z serwerem lub proxy. |
| Plugins.<PluginName>.System.Capacity | Ustawia limit liczby sprawdzeń dla wtyczki, które mogą być wykonywane jednocześnie. |
| Plugins.Log.MaxLinesPerSecond | Ustawia maksymalną liczbę nowych wierszy, które agent wyśle na sekundę do serwera Zabbix lub proxy podczas przetwarzania aktywnych sprawdzeń log, logrt i eventlog. |
| Plugins.SystemRun.LogRemoteCommands | Włącza rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń. |
| PluginSocket | Określa ścieżkę do nazwanej potoku systemu Windows używanego do komunikacji z ładowalnymi wtyczkami. |
| PluginTimeout | Ustawia limit czasu dla połączeń z ładowalnymi wtyczkami, w sekundach. |
| RefreshActiveChecks | Określa częstotliwość odświeżania listy aktywnych sprawdzeń. |
| Server | Określa adresy IP lub nazwy DNS serwerów/proxy Zabbix. |
| ServerActive | Określa adres serwera/proxy Zabbix lub konfigurację klastra, z której mają być pobierane aktywne sprawdzenia. |
| SourceIP | Określa źródłowy adres IP. |
| StatusPort | Ustawia port, na którym agent nasłuchuje żądań stanu HTTP (http://localhost:<port>/status). |
| Timeout | Określa czas oczekiwania (w sekundach) na ustanowienie połączenia i wymianę danych z serwerem lub proxy Zabbix. |
| TLSAccept | Określa wymagany poziom szyfrowania dla połączeń przychodzących. |
| TLSCAFile | Określa pełną ścieżkę do pliku zawierającego certyfikaty głównych urzędów certyfikacji (CA) używane do weryfikacji certyfikatu peera podczas szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCertFile | Określa pełną ścieżkę do pliku zawierającego certyfikat agent lub łańcuch certyfikatów używany podczas szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCipherAll13 | Określa ciąg szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK. |
| TLSCipherCert13 | Określa ciąg szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach. |
| TLSCipherPSK13 | Określa ciąg szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK. |
| TLSConnect | Określa wymagany poziom szyfrowania dla połączeń z serwerem lub proxy Zabbix. |
| TLSCRLFile | Określa pełną ścieżkę do pliku zawierającego unieważnione certyfikaty. Ten parametr jest używany podczas szyfrowanej komunikacji między komponentami Zabbix. |
| TLSKeyFile | Określa pełną ścieżkę do pliku zawierającego klucz prywatny agent używany podczas szyfrowanej komunikacji między komponentami Zabbix. |
| TLSPSKFile | Określa pełną ścieżkę do pliku zawierającego klucz wstępnie współdzielony agent, używany podczas szyfrowanej komunikacji z serwerem lub proxy Zabbix. |
| TLSPSKIdentity | Określa ciąg tożsamości klucza wstępnie współdzielonego używany podczas szyfrowanej komunikacji z serwerem lub proxy Zabbix. |
| TLSServerCertIssuer | Określa dozwolonego wystawcę certyfikatu serwera (proxy). |
| TLSServerCertSubject | Określa dozwolony podmiot certyfikatu serwera (proxy). |
| UnsafeUserParameters | Zezwala na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika. |
| UserParameter | Określa parametr zdefiniowany przez użytkownika do monitorowania. |
| UserParameterDir | Określa domyślną ścieżkę wyszukiwania poleceń UserParameter. |
Należy pamiętać, że:
- Wartości domyślne odzwierciedlają wartości domyślne procesu, a nie wartości znajdujące się w dostarczonych plikach konfiguracji;
- Wartości obsługują zmienne środowiskowe;
- Zabbix obsługuje pliki konfiguracji wyłącznie w kodowaniu UTF-8, bez BOM;
- Komentarze rozpoczynające się od
#są obsługiwane tylko na początku wiersza.
Szczegóły parametru
Alias
Ustaw alias dla klucza pozycji.
Może on służyć do zastąpienia długiego i złożonego klucza pozycji krótszym i prostszym.
Może być obecnych wiele parametrów Alias.
Nie są dozwolone wiele parametrów z tym samym kluczem Alias.
Różne klucze Alias mogą odwoływać się do tego samego klucza pozycji.
Aliasów można używać w HostMetadataItem, ale nie w parametrze HostnameItem.
Przykład 1: Pobieranie użycia pliku stronicowania w procentach z serwera.
Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]
Teraz można użyć skróconego klucza pg_usage, aby pobrać dane.
Przykład 2: Pobieranie obciążenia CPU z domyślnymi i niestandardowymi parametrami.
Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]
Umożliwia to użycie klucza cpu.load do pobrania obciążenia CPU z domyślnymi parametrami, a także użycie cpu.load[percpu,avg15] do pobrania określonych danych o obciążeniu CPU.
Przykład 3: Uruchamianie wielu reguł low-level discovery przetwarzających te same elementy wykrywania.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Teraz można skonfigurować kilka reguł wykrywania z użyciem vfs.fs.discovery z różnymi parametrami dla każdej reguły, np. vfs.fs.discovery[foo], vfs.fs.discovery[bar] itd.
AllowKey
Zezwalaj na wykonywanie tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem wieloznacznym, które obsługuje znak * do dopasowania dowolnej liczby dowolnych znaków.
Wiele reguł dopasowywania kluczy może być zdefiniowanych w połączeniu z DenyKey, AllowKeyRegexp i DenyKeyRegexp.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Kolejność określa, która z pasujących reguł będzie miała priorytet.
Zobacz także: Ograniczanie sprawdzeń agent.
AllowKeyRegexp
Zezwalaj na wykonywanie tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem regularnym.
Można zdefiniować wiele reguł dopasowania kluczy w połączeniu z DenyKeyRegexp, AllowKey i DenyKey.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Kolejność określa, która z pasujących reguł będzie miała priorytet.
Zobacz też: Ograniczanie sprawdzeń agent.
BufferSend
Ustaw częstotliwość wysyłania wartości z bufora do serwera/proxy Zabbix (w sekundach).
Uwaga: jeśli bufor jest pełny, dane zostaną wysłane wcześniej.
Domyślnie: 5
Zakres: 1-3600
BufferSize
Ustaw maksymalną liczbę wartości w buforze pamięci.
Agent wyśle wszystkie zebrane dane do serwera Zabbix lub proxy, jeśli bufor zostanie zapełniony.
Ten parametr należy używać tylko wtedy, gdy trwały bufor jest wyłączony (EnablePersistentBuffer=0).
Domyślnie: 1000
Zakres: 2-65535
ControlSocket
Określ gniazdo sterujące, używane do wysyłania poleceń w czasie działania za pomocą opcji -R.
Domyślnie: \\.\pipe\agent.sock
DebugLevel
Ustaw poziom debugowania:
- 0 - podstawowe informacje o uruchamianiu i zatrzymywaniu procesów Zabbix;
- 1 - informacje krytyczne;
- 2 - informacje o błędach;
- 3 - ostrzeżenia;
- 4 - do debugowania (generuje dużo informacji);
- 5 - rozszerzone debugowanie (generuje jeszcze więcej informacji).
Domyślnie: 3
Zakres: 0-5
DenyKey
Zabrania wykonywania tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem wieloznacznym, które obsługuje znak * do dopasowania dowolnej liczby dowolnych znaków.
Można zdefiniować wiele reguł dopasowywania kluczy w połączeniu z AllowKey, AllowKeyRegexp i DenyKeyRegexp.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Kolejność określa, która z pasujących reguł będzie miała priorytet.
Zobacz także: Ograniczanie sprawdzeń agenta.
DenyKeyRegexp
Zabroń wykonywania tych kluczy pozycji, które pasują do wzorca.
Wzorzec klucza jest wyrażeniem regularnym.
Można zdefiniować wiele reguł dopasowywania kluczy w połączeniu z AllowKeyRegexp, AllowKey i DenyKey.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Kolejność określa, która z pasujących reguł będzie miała priorytet.
Zobacz także: Ograniczanie sprawdzeń agent.
EnablePersistentBuffer
Włącz użycie lokalnej trwałej pamięci masowej dla aktywnych pozycji. Jeśli trwała pamięć masowa jest wyłączona, używany będzie bufor pamięci.
Domyślnie: 0
Wartości: 0 - wyłączone, 1 - włączone
ForceActiveChecksOnStart
Wykonuj aktywne sprawdzenia natychmiast po restarcie, aby pobrać pierwszą otrzymaną konfigurację.
Dostępne również jako parametr konfiguracji dla poszczególnych wtyczek, na przykład: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Domyślnie: 0
Wartości: 0 - wyłączone, 1 - włączone
HeartbeatFrequency
Ustaw częstotliwość wiadomości heartbeat w sekundach.
Używane do monitorowania dostępności aktywnych kontroli.
0 - wiadomości heartbeat wyłączone.
Domyślnie: 60
Zakres: 0-3600
HostInterface
Określa interfejs hosta (adres IP lub nazwa DNS) używany podczas autorejestracji hosta. Ta wartość zostanie użyta do wypełnienia interfejsu w nowo utworzonym hoście i umożliwia jawne skonfigurowanie adresu IP lub DNS. Więcej informacji można znaleźć w sekcji Using DNS as default interface.
Jeśli nie zostanie zdefiniowana, wartość zostanie pobrana z HostInterfaceItem.
agent zgłosi błąd i nie uruchomi się, jeśli wartość przekroczy limit 255 znaków.
Zakres: 0-255 znaków
HostInterfaceItem
Określ pozycję, aby ustalić interfejs hosta (adres IP lub nazwę DNS) podczas autorejestracji.
Ta wartość jest używana tylko wtedy, gdy HostInterface nie jest zdefiniowane.
Więcej informacji można znaleźć w sekcji Using DNS as default interface.
Podczas żądania autorejestracji agent zapisze komunikat ostrzegawczy, jeśli wartość zwrócona przez określoną pozycję przekroczy limit 255 znaków.
Pozycja system.run[] jest obsługiwana niezależnie od ustawień AllowKey/DenyKey.
HostMetadata
Określ metadane używane do identyfikacji lub rozróżniania hosta podczas autorejestracji hosta (active agent).
HostMetadata umożliwia rozróżnianie hostów nie tylko na podstawie nazwy hosta.
Jeśli nie zostanie zdefiniowane, wartość zostanie pobrana z HostMetadataItem.
agent zgłosi błąd i nie uruchomi się, jeśli określona wartość przekracza limit 2034 bajtów lub jest ciągiem innym niż UTF-8. Gdy parametr oczekuje adresu IP lub nazwy DNS, wartości poprawne w UTF-8, ale niebędące prawidłowymi adresami IP ani nazwami DNS, również zostaną odrzucone i zgłoszone jako nieprawidłowe.
Metadane wielowierszowe nie są obsługiwane — wynik zostanie obcięty przy pierwszym znaku podziału wiersza.
Zakres: 0-2034 bajty
HostMetadataItem
Określ pozycję agenta Zabbix, aby pobrać metadane hosta.
Ta opcja jest używana tylko wtedy, gdy HostMetadata nie jest zdefiniowane.
Wartość HostMetadataItem jest pobierana przy każdej próbie autorejestracji i jest używana wyłącznie w procesie autorejestracji hosta (aktywny agent).
HostMetadataItem umożliwia rozróżnianie hostów nie tylko na podstawie nazwy hosta.
Obsługiwane są parametry użytkownika i aliasy.
Pozycja system.run[] jest obsługiwana niezależnie od ustawień AllowKey/DenyKey.
Podczas żądania autorejestracji agent zapisze komunikat ostrzegawczy, jeśli wartość zwrócona przez określoną pozycję przekroczy limit 65535 punktów kodowych UTF-8. Wartość zwrócona przez pozycję musi być ciągiem UTF-8, w przeciwnym razie zostanie zignorowana. Gdy parametr oczekuje adresu IP lub nazwy DNS, wartości poprawne jako UTF-8, ale niepoprawne jako adresy IP lub nazwy DNS, również zostaną odrzucone i zgłoszone jako nieprawidłowe.
Metadane wielowierszowe nie są obsługiwane — wynik zostanie obcięty przy pierwszym znaku podziału wiersza.
Hostname
Określ unikalne nazwy hostów rozróżniające wielkość liter.
Lista rozdzielona przecinkami.
Wymagane dla aktywnych kontroli i musi odpowiadać nazwom hostów skonfigurowanym na serwerze.
Wartość jest pobierana z HostnameItem, jeśli nie została zdefiniowana.
Dozwolone znaki: alfanumeryczne, '.', ' ', '_' i '-'.
Maksymalna długość: 128 znaków na każdą nazwę hosta, 2048 znaków dla całego wiersza.
Domyślnie: Ustawiane przez HostnameItem
HostnameItem
Określ pozycję służącą do pobierania nazwy hosta.
Ta opcja jest używana tylko wtedy, gdy Hostname nie jest zdefiniowane.
Parametry użytkownika ani aliasy nie są obsługiwane, ale pozycja system.run[] jest obsługiwana niezależnie od wartości AllowKey/DenyKey.
Domyślnie: system.hostname
Include
Określ katalog lub pojedyncze pliki, które mają zostać uwzględnione w pliku konfiguracyjnym (domyślnie znajdującym się w C:\Program Files\Zabbix Agent 2, jeśli agent Zabbix został zainstalowany przy użyciu pakietów instalacyjnych Windows MSI; znajdującym się w folderze określonym podczas instalacji, jeśli agent Zabbix został zainstalowany jako archiwum zip).
Podczas instalacji Zabbix ten parametr jest ustawiany na /usr/local/etc, chyba że zmienisz go podczas kompilacji.
Ogólne zasady dotyczące parametru Include:
- Ścieżka może być względna względem lokalizacji pliku
zabbix_agent2.conf(np.Include=.\zabbix_agent2.d\plugins.d\*.conf). - W jednym pliku konfiguracyjnym można określić wiele parametrów
Include. - Zabbix przetwarza parametr
Includenatychmiast po jego odczytaniu, dlatego rozważ umieszczenie go na końcu pliku konfiguracyjnego.
Zasady dotyczące uwzględnianych plików:
- Każdy plik musi być możliwy do odczytu.
- Każdy plik musi mieć poprawną składnię. W przeciwnym razie komponent nie zostanie uruchomiony.
Zasady dotyczące uwzględniania katalogów lub wzorców plików:
- Nie zakładaj żadnej kolejności uwzględniania (np. pliki nie są uwzględniane w kolejności alfabetycznej).
- Nie definiuj tego samego parametru w więcej niż jednym uwzględnianym pliku (np. aby zastąpić ustawienie ogólne ustawieniem szczegółowym), ponieważ nie można przewidzieć, która wartość zostanie użyta.
- Zwracaj uwagę na kopie zapasowe tworzone automatycznie przez niektóre edytory tekstu (np. edycja
include/my_specific.confmoże utworzyćinclude/my_specific.conf.BAK), ponieważ oba pliki zostaną uwzględnione.
Aby uwzględnić tylko odpowiednie pliki z katalogu, użyj symbolu wieloznacznego (*) do dopasowywania wzorca.
Przykład:
Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf
ListenIP
Określa adres IP, na którym agent nasłuchuje połączeń z serwera/proxy.
Lista rozdzielona przecinkami.
Pierwszy adres IP jest wysyłany do serwera Zabbix, jeśli następuje połączenie z nim, aby pobrać listę aktywnych kontroli.
Domyślnie: 0.0.0.0
ListenPort
Określa port nasłuchu agenta dla połączeń z serwera/proxy.
Domyślnie: 10050
Zakres: 1024-32767
LogFile
Określ plik dziennika agenta.
Domyślnie: c:\zabbix_agent2.log
Obowiązkowe: Tak, jeśli LogType jest ustawione na file; w przeciwnym razie nie
LogFileSize
Ustaw maksymalny rozmiar pliku dziennika (w MB).
0 - wyłącza automatyczną rotację dziennika.
Uwaga: Jeśli zostanie osiągnięty limit rozmiaru pliku dziennika, a rotacja pliku z jakiegokolwiek powodu się nie powiedzie, istniejący plik dziennika zostanie obcięty i utworzony od nowa.
Domyślnie: 1
Zakres: 0-1024
LogType
Określ typ wyjścia logu:
- file - zapisuj log do pliku określonego parametrem
LogFile; - console - zapisuj log do standardowego wyjścia.
Domyślnie: file
PerfCounter
Zdefiniuj nowy parametr <parameter_name>, który jest średnią wartością licznika wydajności systemu <perf_counter_path> dla określonego przedziału czasu <period> (w sekundach).
Składnia: <parameter_name>,"<perf_counter_path>",<period>
Na przykład, jeśli chcesz otrzymywać średnią liczbę przerwań procesora na sekundę z ostatniej minuty, możesz zdefiniować nowy parametr "interrupts" w następujący sposób:
PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60
Zwróć uwagę na podwójne cudzysłowy wokół ścieżki licznika wydajności.
Nazwa parametru (interrupts) ma być używana jako klucz pozycja podczas tworzenia pozycji.
Próbki do obliczania średniej wartości będą pobierane co sekundę.
Możesz uruchomić typeperf -qx, aby uzyskać listę wszystkich liczników wydajności dostępnych w systemie Windows.
PerfCounterEn
Zdefiniuj nowy parametr <parameter_name>, który jest średnią wartością licznika wydajności systemu <perf_counter_path> dla określonego przedziału czasu <period> (w sekundach).
W porównaniu z PerfCounter, ścieżki perfcounter muszą być w języku angielskim.
Obsługiwane tylko w Windows Server 2008/Vista i nowszych.
Składnia: <parameter_name>,"<perf_counter_path>",<period>
Na przykład, jeśli chcesz otrzymywać średnią liczbę przerwań procesora na sekundę z ostatniej minuty, możesz zdefiniować nowy parametr "interrupts" w następujący sposób:
PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60
Zwróć uwagę na podwójne cudzysłowy wokół ścieżki licznika wydajności.
Nazwa parametru (interrupts) ma być używana jako klucz pozycji podczas tworzenia pozycji.
Próbki do obliczania średniej wartości będą pobierane co sekundę.
Listę angielskich ciągów można znaleźć, przeglądając następujący klucz rejestru: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.
PersistentBufferFile
Określ plik, w którym agent 2 Zabbix powinien przechowywać bazę danych SQLite.
Musi to być pełna nazwa pliku.
Ten parametr jest używany tylko wtedy, gdy włączony jest trwały bufor (EnablePersistentBuffer=1).
PersistentBufferPeriod
Ustaw czas przechowywania danych, gdy nie ma połączenia z serwerem lub proxy.
Starsze dane zostaną utracone.
Dane dziennika będą zachowane.
Ten parametr jest używany tylko wtedy, gdy bufor trwały jest włączony (EnablePersistentBuffer=1).
Domyślnie: 1h
Zakres: 1m-365d
Wtyczki.<PluginName>.System.Capacity
Ustaw limit kontroli na wtyczkę <PluginName>, które mogą być wykonywane jednocześnie.
Domyślnie: 1000
Zakres: 1-1000
Plugins.Log.MaxLinesPerSecond
Ustaw maksymalną liczbę nowych linii, które agent będzie wysyłał na sekundę do serwera Zabbix lub proxy podczas przetwarzania aktywnych kontroli log, logrt i eventlog.
Podana wartość zostanie zastąpiona przez parametr maxlines podany w kluczu pozycja log, logrt lub eventlog.
Uwaga: Zabbix będzie przetwarzać 10 razy więcej nowych linii niż ustawiono w MaxLinesPerSecond, aby wyszukać wymagany ciąg w pozycjach dziennika.
Domyślnie: 20
Zakres: 1-1000
Plugins.SystemRun.LogRemoteCommands
Włącz rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń.
Polecenia będą rejestrowane tylko wtedy, gdy zostaną wykonane zdalnie.
Wpisy dziennika nie będą tworzone, jeśli system.run[] zostanie uruchomione lokalnie przez parametry HostMetadataItem, HostInterfaceItem lub HostnameItem.
Domyślnie: 0
Wartości: 0 - wyłączone, 1 - włączone
PluginSocket
Określ ścieżkę do nazwanego potoku systemu Windows używanego do komunikacji z ładowalnymi wtyczkami.
Domyślnie: \\.\pipe\agent.plugin.sock
PluginTimeout
Ustaw limit czasu dla połączeń z ładowalnymi wtyczkami, w sekundach.
Domyślnie: Timeout
Zakres: 1-30
RefreshActiveChecks
Określ częstotliwość odświeżania listy aktywnych kontroli, w sekundach.
Należy pamiętać, że po nieudanym odświeżeniu aktywnych kontroli następna próba odświeżenia zostanie podjęta po 60 sekundach.
Domyślnie: 5
Zakres: 1-86400
Serwer
Określ adresy IP, opcjonalnie w notacji CIDR, lub nazwy DNS serwerów/proxy Zabbix.
Lista rozdzielana przecinkami.
Jeśli parametr nie zostanie określony, sprawdzanie pasywne będzie wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP.
Połączenia przychodzące będą akceptowane tylko od hostów wymienionych tutaj.
Jeśli obsługa IPv6 jest włączona, 127.0.0.1, ::127.0.0.1, ::ffff:127.0.0.1 są traktowane jednakowo, a ::/0 zezwoli na dowolny adres IPv4 lub IPv6.
0.0.0.0/0 można użyć, aby zezwolić na dowolny adres IPv4.
Dozwolone są spacje.
Przykład:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
ServerActive
Określa adres serwera/proxy Zabbix lub konfigurację klastra, z którego mają być pobierane aktywne kontrole.
Jeśli parametr nie zostanie określony, aktywne kontrole są wyłączone.
Adres serwera/proxy jest adresem IP lub nazwą DNS oraz opcjonalnym portem oddzielonym dwukropkiem.
Jeśli port nie zostanie określony, używany jest port domyślny.
Adresy IPv6 muszą być ujęte w nawiasy kwadratowe, jeśli dla tego hosta określono port.
Jeśli port nie jest określony, nawiasy kwadratowe dla adresów IPv6 są opcjonalne.
Konfiguracja klastra to jeden lub więcej adresów członków grupy serwera lub proxy oddzielonych średnikiem.
Można określić wiele serwerów/klastrów Zabbix oraz proxy Zabbix, oddzielając je przecinkami.
O ile nie są używane grupy proxy, nie należy określać więcej niż jednego proxy Zabbix z każdego serwera/klastra Zabbix. Jeśli określono proxy Zabbix, nie należy określać serwera/klastra Zabbix dla tego proxy.
Można podać wiele adresów rozdzielonych przecinkami, aby używać kilku niezależnych serwerów Zabbix równolegle. Dozwolone są spacje.
Przykład dla proxy Zabbix:
ServerActive=127.0.0.1:10051
Przykład dla grupy proxy Zabbix:
ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com
Przykład dla wielu serwerów:
ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\]
Przykład dla wysokiej dostępności:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Przykład dla wysokiej dostępności z dwoma klastrami i jednym serwerem:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP
Określ adres IP źródłowy dla:
- połączeń wychodzących do serwera Zabbix lub proxy Zabbix;
- nawiązywania połączeń podczas wykonywania niektórych pozycji (
web.page.get,net.tcp.portitp.).
StatusPort
Ustaw port, na którym agent nasłuchuje żądań statusu HTTP (http://localhost:<port>/status).
Zakres: 1024-32767
Limit czasu
Określa, jak długo należy czekać (w sekundach) na nawiązanie połączenia i wymianę danych z proxy lub serwerem Zabbix.
Ten parametr definiuje czas trwania różnych operacji komunikacyjnych, w tym:
- oczekiwanie na odpowiedź z serwera Zabbix;
- wysyłanie żądań do serwera Zabbix, w tym żądań konfiguracji pozycji i danych pozycji w aktywnych kontrolach;
- pobieranie danych dziennika przez monitorowanie logfile lub dziennika zdarzeń systemu Windows;
- wysyłanie komunikatów heartbeat;
- maksymalny czas trwania kontroli
vfs.*; - pełnienie roli wartości awaryjnej w scenariuszach, w których serwer lub proxy w wersji starszej niż 7.0 wysyła kontrole bez limitów czasu.
Ten limit czasu nie będzie używany dla tych kontroli agenta, które mają konfigurowalne ustawienia limitu czasu we frontendzie (globalnie, na poziomie proxy lub dla pojedynczej pozycji).
Domyślnie: 3
Zakres: 1-30
TLSAccept
Określ poziom szyfrowania wymagany dla połączeń przychodzących.
Używane dla pasywnych kontroli.
Można podać wiele wartości, oddzielając je przecinkiem:
- unencrypted - akceptuj połączenia bez szyfrowania (domyślnie);
- psk - akceptuj połączenia z TLS i wstępnie współdzielonym kluczem (PSK);
- cert - akceptuj połączenia z TLS i certyfikatem.
Wymagane: tak, jeśli zdefiniowano parametry certyfikatu TLS lub PSK (nawet dla połączenia unencrypted); w przeciwnym razie nie
TLSCAFile
Określ pełną ścieżkę do pliku zawierającego certyfikaty najwyższego poziomu CA do weryfikacji certyfikatu peer, używaną do szyfrowanej komunikacji między komponentami Zabbix.
TLSCertFile
Podaj pełną ścieżkę do pliku zawierającego certyfikat agent lub łańcuch certyfikatów, używany do szyfrowanej komunikacji z komponentami Zabbix.
TLSCipherAll13
Określ ciąg szyfrów OpenSSL (TLS 1.3). Zastąp domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK.
Przykład:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert13
Określ ciąg szyfrów OpenSSL (TLS 1.3). Zastąp domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach.
Należy pamiętać, że tego parametru nie można używać razem z TLSAccept=cert,psk; dla połączenia certyfikatowego (TLSConnect=cert) użyj zamiast tego TLSCipherAll13.
TLSCipherPSK13
Określ ciąg szyfrów OpenSSL (TLS 1.3). Zastąp domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK.
Przykład:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Określ poziom szyfrowania wymagany dla połączeń agent z serwerem Zabbix lub proxy.
Używane dla aktywnych kontroli.
Można określić tylko jedną wartość:
- unencrypted - połączenie bez szyfrowania (domyślnie);
- psk - połączenie z użyciem TLS i wstępnie współdzielonego klucza (PSK);
- cert - połączenie z użyciem TLS i certyfikatu.
Obowiązkowe: tak, jeśli zdefiniowano parametry certyfikatu TLS lub PSK (nawet dla połączenia unencrypted); w przeciwnym razie nie
TLSCRLFile
Określ pełną ścieżkę do pliku zawierającego unieważnione certyfikaty. Ten parametr jest używany do szyfrowanej komunikacji między komponentami Zabbix.
TLSKeyFile
Podaj pełną ścieżkę do pliku zawierającego prywatny klucz agent, używany do szyfrowanej komunikacji między komponentami Zabbix.
TLSPSKFile
Określ pełną ścieżkę do pliku zawierającego współdzielony klucz agenta, używany do szyfrowanej komunikacji z serwerem Zabbix lub proxy.
TLSPSKIdentity
Określ ciąg tożsamości pre-shared key, używany do szyfrowanej komunikacji z serwerem Zabbix lub proxy.
TLSServerCertIssuer
Określ dozwolonego wystawcę certyfikatu serwera (proxy).
TLSServerCertSubject
Określ dozwolony temat certyfikatu serwera (proxy).
UnsafeUserParameters
Zezwalaj na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika.
Następujące znaki są niedozwolone: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ %
Dodatkowo znaki nowej linii są niedozwolone.
Domyślnie: 0
Wartości: 0 - nie zezwalaj, 1 - zezwalaj
UserParameter
Określ zdefiniowany przez użytkownika parametr do monitorowania.
Może istnieć kilka takich parametrów.
Format: UserParameter=<key>,<shell command>
Pamiętaj, że polecenie powłoki nie może zwracać pustego ciągu ani wyłącznie znaku końca linii.
Polecenia powłoki mogą używać ścieżek względnych, jeśli określono parametr UserParameterDir.
Przykład:
UserParameter=system.test,dir /b | find /c /v ""
UserParameter=check_cpu,.\custom\_script.bat
UserParameterDir
Określa domyślną ścieżkę wyszukiwania dla poleceń UserParameter.
Jeśli jest używana, agent zmieni swój katalog roboczy na katalog określony tutaj przed wykonaniem polecenia.
Dzięki temu polecenia UserParameter mogą używać względnego prefiksu .\ zamiast pełnej ścieżki.
Dozwolony jest tylko jeden wpis.
Przykład:
UserParameterDir=C:\opt\myscripts