6 Zabbix agent 2 (Windows)
Omówienie
Zabbix agent 2 to agent Zabbix nowej generacji i może być używany zamiast Zabbix agent.
Parametry obsługiwane przez plik konfiguracyjny Zabbix agent 2 dla systemu Windows (zabbix_agent2.conf) są wymienione w tej sekcji.
Parametry są podane bez dodatkowych informacji. Kliknij parametr, aby zobaczyć pełne szczegóły.
| Parameter | Description |
|---|---|
| Alias | Ustawia alias dla klucza pozycja. |
| AllowKey | Zezwala na wykonywanie tych kluczy pozycji, które pasują do wzorca. |
| BufferSend | Nie przechowuje danych w buforze dłużej niż N sekund. |
| BufferSize | Maksymalna liczba wartości w buforze pamięci. |
| ControlSocket | Gniazdo sterujące, używane do wysyłania poleceń w czasie działania za pomocą opcji -R. |
| DebugLevel | Poziom debugowania. |
| DenyKey | Odmowa wykonywania tych kluczy pozycji, które pasują do wzorca. |
| EnablePersistentBuffer | Włącza użycie lokalnej trwałej pamięci masowej dla aktywnych pozycji. |
| ForceActiveChecksOnStart | Wykonuje aktywne sprawdzenia natychmiast po restarcie, dla pierwszej otrzymanej konfiguracji. |
| HeartbeatFrequency | Częstotliwość komunikatów heartbeat w sekundach. |
| HostInterface | Opcjonalny parametr definiujący interfejs hosta. |
| HostInterfaceItem | Opcjonalny parametr definiujący pozycja używaną do pobierania interfejsu hosta. |
| HostMetadata | Opcjonalny parametr definiujący metadane hosta. |
| HostMetadataItem | Opcjonalny parametr definiujący pozycja agenta Zabbix używaną do pobierania metadanych hosta. |
| Hostname | Opcjonalny parametr definiujący nazwę hosta. |
| HostnameItem | Opcjonalny parametr definiujący pozycja agenta Zabbix używaną do pobierania nazwy hosta. |
| Include | Możesz dołączyć do pliku konfiguracyjnego pojedyncze pliki lub wszystkie pliki z katalogu. |
| ListenIP | Lista adresów IP rozdzielonych przecinkami, na których agent powinien nasłuchiwać. |
| ListenPort | Agent będzie nasłuchiwał na tym porcie połączeń z serwer. |
| LogFile | Nazwa pliku dziennika. |
| LogFileSize | Maksymalny rozmiar pliku dziennika. |
| LogType | Typ wyjścia dziennika. |
| PersistentBufferFile | Plik, w którym Zabbix agent 2 powinien przechowywać bazę danych SQLite. |
| PersistentBufferPeriod | Okres, przez który dane powinny być przechowywane, gdy nie ma połączenia z serwer lub proxy. |
| Plugins.<PluginName>.System.Capacity | Limit sprawdzeń na plugin, które mogą być wykonywane jednocześnie. |
| Plugins.Log.MaxLinesPerSecond | Maksymalna liczba nowych linii, które agent będzie wysyłał na sekundę do serwer lub proxy podczas przetwarzania aktywnych sprawdzeń log i logrt. |
| Plugins.SystemRun.LogRemoteCommands | Włącza rejestrowanie wykonanych poleceń powłoki jako ostrzeżeń. |
| PluginSocket | Ścieżka do nazwanego potoku systemu Windows do komunikacji z ładowalnymi pluginami. |
| PluginTimeout | Limit czasu połączeń z ładowalnymi pluginami, w sekundach. |
| PerfCounter | Definiuje nowy parametr <parameter_name>, który jest średnią wartością licznika wydajności systemu <perf_counter_path> dla określonego okresu <period> (w sekundach). |
| PerfCounterEn | Definiuje nowy parametr <parameter_name>, który jest średnią wartością licznika wydajności systemu <perf_counter_path> dla określonego okresu <period> (w sekundach). W porównaniu z PerfCounter, ścieżki perfcounter muszą być w języku angielskim. |
| RefreshActiveChecks | Jak często lista aktywnych sprawdzeń jest odświeżana. |
| Server | Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwer Zabbix i proxy Zabbix. |
| ServerActive | Adres serwer Zabbix/proxy lub konfiguracja klastra, z którego mają być pobierane aktywne sprawdzenia. |
| SourceIP | Źródłowy adres IP. |
| StatusPort | Jeśli ustawione, agent będzie nasłuchiwał na tym porcie żądań HTTP statusu (http://localhost:<port>/status). |
| Timeout | Określa, jak długo należy czekać (w sekundach) na nawiązanie połączenia i wymianę danych z proxy lub serwer Zabbix. |
| TLSAccept | Wymagany poziom szyfrowania dla połączeń przychodzących. |
| TLSCAFile | Pełna ścieżka do pliku zawierającego certyfikaty głównych urzędów CA, używane do weryfikacji certyfikatu peer w szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCertFile | Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów, używane do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSCipherAll13 | Łańcuch szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach i PSK. |
| TLSCipherCert13 | Łańcuch szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na certyfikatach. |
| TLSCipherPSK13 | Łańcuch szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK. |
| TLSConnect | Wymagany poziom szyfrowania dla połączeń agenta z serwer Zabbix lub proxy. |
| TLSCRLFile | Pełna ścieżka do pliku zawierającego certyfikaty unieważnione. Ten parametr jest używany do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSKeyFile | Pełna ścieżka do pliku zawierającego prywatny klucz agenta, używany do szyfrowanej komunikacji między komponentami Zabbix. |
| TLSPSKFile | Pełna ścieżka do pliku zawierającego klucz współdzielony z wyprzedzeniem agenta, używany do szyfrowanej komunikacji z serwer Zabbix. |
| TLSPSKIdentity | Łańcuch tożsamości klucza współdzielonego z wyprzedzeniem, używany do szyfrowanej komunikacji z serwer Zabbix. |
| TLSServerCertIssuer | Dozwolony wystawca certyfikatu serwer (proxy). |
| TLSServerCertSubject | Dozwolony podmiot certyfikatu serwer (proxy). |
| UnsafeUserParameters | Zezwala na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika. |
| UserParameter | Parametr zdefiniowany przez użytkownika do monitorowania. |
| UserParameterDir | Domyślna ścieżka wyszukiwania dla poleceń UserParameter. |
Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że parametr jest obowiązkowy.
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 zaczynające się od
#są obsługiwane tylko na początku wiersza.
Szczegóły parametrów
Alias
Ustawia alias dla klucza pozycja.
Może być używany do zastąpienia długiego i złożonego klucza pozycja krótszym i prostszym.
Może występować 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 pozycja.
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żywać skróconego klucza pg_usage do pobierania danych.
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 pobierania obciążenia CPU z domyślnymi parametrami, a także użycie cpu.load[percpu,avg15] do pobierania określonych danych o obciążeniu CPU.
Przykład 3: Uruchamianie wielu reguł low-level discovery, które przetwarzają te same elementy discovery.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Teraz można skonfigurować kilka reguł discovery, używając 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.
W połączeniu z DenyKey można zdefiniować wiele reguł dopasowywania kluczy.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Zobacz także: Ograniczanie sprawdzeń agent.
BufferSend
The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.
Note, that if the buffer is full, the data will be sent sooner.
Default: 5
Range: 1-3600
BufferSize
Ustawia 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
Gniazdo sterujące, używane do wysyłania poleceń w czasie działania za pomocą opcji -R.
Domyślnie: \\.\pipe\agent.sock
DebugLevel
Określ 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
Zabroń 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.
W połączeniu z AllowKey można zdefiniować wiele reguł dopasowywania kluczy.
Parametry są przetwarzane jeden po drugim zgodnie z kolejnością ich występowania.
Zobacz także: Ograniczanie sprawdzeń agenta.
EnablePersistentBuffer
Włącz użycie lokalnej trwałej pamięci masowej dla aktywnych pozycji. Jeśli trwała pamięć masowa jest wyłączona, użyty zostanie bufor pamięci.
Domyślnie: 0
Wartości: 0 - wyłączone, 1 - włączone
ForceActiveChecksOnStart
Wykonuj aktywne kontrole natychmiast po restarcie dla pierwszej otrzymanej konfiguracji.
Dostępne również jako parametr konfiguracji dla poszczególnych wtyczek, na przykład: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Wartość domyślna: 0
Wartości: 0 - wyłączone, 1 - włączone
HeartbeatFrequency
Częstotliwość komunikatów heartbeat w sekundach.
Używana do monitorowania dostępności aktywnych testów.
0 - komunikaty heartbeat wyłączone.
Domyślnie: 60
Zakres: 0-3600
HostInterface
Opcjonalny parametr definiujący interfejs hosta (adres IP lub nazwę DNS) używany podczas procesu autorejestracji. Ta wartość zostanie użyta do wypełnienia interfejsu w nowo utworzonym hoście i umożliwia jawną konfigurację adresu IP lub DNS. Więcej informacji można znaleźć w sekcji Używanie DNS jako domyślnego interfejsu.
Jeśli parametr nie jest zdefiniowany, 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
Opcjonalny parametr, który definiuje pozycję używaną do określenia interfejsu hosta (adresu IP lub nazwy DNS) podczas procesu autorejestracji hosta.
Ta wartość jest używana tylko wtedy, gdy HostInterface nie jest zdefiniowany.
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
Opcjonalny parametr definiujący metadane używane do identyfikacji lub rozróżnienia hosta podczas procesu autorejestracji hosta (agent aktywny).
HostMetadata umożliwia rozróżnianie hostów nie tylko na podstawie nazwy hosta.
Jeśli nie zostanie zdefiniowany, wartość zostanie pobrana z HostMetadataItem.
agent zgłosi błąd i nie uruchomi się, jeśli podana wartość przekroczy limit 2034 bajtów lub będzie 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.
Obsługa metadanych wielowierszowych nie jest wspierana — wynik zostanie obcięty przy pierwszym znaku podziału wiersza.
Zakres: 0-2034 bajtów
HostMetadataItem
Opcjonalny parametr, który definiuje pozycję agenta Zabbix używaną do pobierania metadanych hosta.
Ta opcja jest używana tylko wtedy, gdy HostMetadata nie jest zdefiniowany.
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 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.
Hostname
Lista unikalnych nazw hostów rozdzielonych przecinkami, z rozróżnianiem wielkości liter.
Wymagane dla aktywnych kontroli i musi odpowiadać nazwom hostów skonfigurowanym na serwerze.
Wartość jest pobierana z HostnameItem, jeśli nie jest zdefiniowana.
Dozwolone znaki: alfanumeryczne, '.', ' ', '_' i '-'.
Maksymalna długość: 128 znaków na nazwę hosta, 2048 znaków dla całego wiersza.
Domyślnie: Ustawiane przez HostnameItem
HostnameItem
Opcjonalny parametr, który definiuje pozycję używaną 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
Dołączenie
Możesz dołączyć pojedyncze pliki lub wszystkie pliki w katalogu do pliku konfiguracyjnego (domyślnie znajduje się on w C:\Program Files\Zabbix Agent 2, jeśli agent Zabbix jest instalowany przy użyciu pakietów instalacyjnych Windows MSI; znajduje się w folderze wskazanym podczas instalacji, jeśli agent Zabbix jest instalowany jako archiwum zip).
Wszystkie dołączone pliki muszą mieć
poprawną składnię, w przeciwnym razie agent nie uruchomi się.
Ścieżka może być względna względem lokalizacji pliku zabbix_agent2.conf (np.
Include=.\zabbix_agent2.d\plugins.d\*.conf).
Aby dołączać tylko odpowiednie pliki w określonym katalogu, obsługiwany jest znak wieloznaczny gwiazdki do dopasowywania wzorców.
Informacje o ograniczeniach znajdziesz w special notes.
Przykład:
Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf
ListenIP
Lista adresów IP rozdzielonych przecinkami, na których agent powinien nasłuchiwać. Pierwszy adres IP jest wysyłany do serwera Zabbix, jeśli nawiązuje z nim połączenie, w celu pobrania listy aktywnych kontroli.
Wartość domyślna: 0.0.0.0
ListenPort
agent będzie nasłuchiwał na tym porcie połączeń z serwera.
Domyślnie: 10050
Zakres: 1024-32767
LogFile
Nazwa pliku dziennika agent.
Domyślnie: c:\zabbix_agent2.log
Wymagane: Tak, jeśli LogType ma ustawioną wartość file; w przeciwnym razie nie
LogFileSize
Maksymalny rozmiar pliku dziennika w MB.
0 - wyłącza automatyczną rotację logów.
Uwaga: Jeśli zostanie osiągnięty limit rozmiaru pliku dziennika, a rotacja pliku nie powiedzie się z jakiegokolwiek powodu, istniejący plik dziennika zostanie obcięty i rozpoczęty na nowo.
Wartość domyślna: 1
Zakres: 0-1024
LogType
Typ wyjścia logu:
- file - zapisuj log do pliku określonego parametrem
LogFile; - console - zapisuj log do standardowego wyjścia.
Domyślnie: file
PersistentBufferFile
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 bufor trwały (EnablePersistentBuffer=1).
PersistentBufferPeriod
Okres czasu, przez który dane powinny być przechowywane, gdy nie ma połączenia z serwerem lub proxy.
Starsze dane zostaną utracone.
Dane logów zostaną zachowane.
Ten parametr jest używany tylko wtedy, gdy włączony jest trwały bufor (EnablePersistentBuffer=1).
Domyślnie: 1h
Zakres: 1m-365d
Plugins.<PluginName>.System.Capacity
Limit sprawdzeń na plugin <PluginName>, które mogą być wykonywane jednocześnie.
Domyślnie: 1000
Zakres: 1-1000
Plugins.Log.MaxLinesPerSecond
Ustaw maksymalną liczbę nowych wierszy, 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, określony w kluczu pozycja log, logrt lub eventlog.
Uwaga: Zabbix będzie przetwarzać 10 razy więcej nowych wierszy 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
Ścieżka do nazwanego potoku systemu Windows używanego do komunikacji z ładowalnymi wtyczkami.
Wartość domyślna: \\.\pipe\agent.plugin.sock
PluginTimeout
Limit czasu połączeń z ładowalnymi wtyczkami, w sekundach.
Wartość domyślna: Timeout
Zakres: 1-30
PerfCounter
Definiuje 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 obliczenia ś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
Definiuje 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 systemach 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 wartości średniej 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.
RefreshActiveChecks
Jak często odświeżana jest lista aktywnych testów, w sekundach. Należy pamiętać, że po nieudanej próbie odświeżenia aktywnych testów kolejna próba odświeżenia zostanie podjęta za 60 sekund.
Domyślnie: 5
Zakres: 1-86400
Serwer
Lista adresów IP rozdzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwerów Zabbix albo proxy Zabbix.
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.
Jeśli ten parametr nie zostanie określony, wyłącza to sprawdzanie pasywne, a agent nie będzie nasłuchiwał na żadnym porcie TCP.
Przykład:
Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
ServerActive
Adres serwera/proxy Zabbix lub konfiguracja klastra, z którego mają być pobierane aktywne testy.
Adres serwera/proxy to adres IP lub nazwa DNS oraz opcjonalny port oddzielony dwukropkiem.
Konfiguracja klastra to jeden lub więcej adresów członków grupy serwera lub proxy oddzielonych średnikiem.
Można podać wiele serwerów/klastrów Zabbix oraz proxy Zabbix, oddzielając je przecinkami.
Jeśli nie są używane grupy proxy, nie należy podawać więcej niż jednego proxy Zabbix z każdego serwera/klastra Zabbix.
Jeśli podano proxy Zabbix, nie należy podawać serwera/klastra Zabbix dla tego proxy.
Można podać wiele adresów rozdzielonych przecinkami, aby równolegle używać kilku niezależnych serwerów Zabbix.
Spacje są dozwolone.
Jeśli port nie został 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 został określony, nawiasy kwadratowe dla adresów IPv6 są opcjonalne.
Jeśli ten parametr nie zostanie określony, aktywne testy są wyłączone.
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 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
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
Jeśli ustawione, agent będzie nasłuchiwał na tym porcie żądań statusu HTTP (http://localhost:<port>/status).
Zakres: 1024-32767
Timeout
Określa, jak długo czekać (w sekundach) na ustanowienie połączenia i wymianę danych z proxy lub serwerem Zabbix.
Ten parametr określa czas trwania różnych operacji komunikacyjnych, w tym:
- oczekiwania na odpowiedź od serwera Zabbix;
- wysyłania żądań do serwera Zabbix, w tym żądań konfiguracji pozycji oraz danych pozycji w active checks;
- pobierania danych logów za pomocą monitorowania logfile lub dziennika zdarzeń Windows;
- wysyłania komunikatów heartbeat;
- maksymalnego czasu trwania kontroli
vfs.*; - użycia jako wartości zapasowej w sytuacjach, gdy serwer lub proxy starszy niż wersja 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 (na poziomie globalnym, proxy lub pojedynczej pozycji).
Domyślnie: 3
Zakres: 1-30
TLSAccept
Poziom szyfrowania wymagany dla połączeń przychodzących. Używane dla kontroli pasywnych. Można określić wiele wartości, oddzielając je przecinkiem:
- unencrypted - akceptuj połączenia bez szyfrowania (domyślnie);
- psk - akceptuj połączenia z TLS i wstępnie udostępnionym kluczem (PSK);
- cert - akceptuj połączenia z TLS i certyfikatem.
Obowiązkowe: tak, jeśli zdefiniowano parametry certyfikatu TLS lub PSK (nawet dla połączenia unencrypted); w przeciwnym razie nie
TLSCAFile
Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu lub urzędów certyfikacji (CA) do weryfikacji certyfikatu peera, używana do szyfrowanej komunikacji między komponentami Zabbix.
TLSCertFile
Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów, używanego do szyfrowanej komunikacji z komponentami Zabbix.
TLSCipherAll13
Ciąg szyfrów OpenSSL (TLS 1.3).
Zastępuje 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
Łańcuch szyfrów OpenSSL (TLS 1.3). Zastępuje 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) należy użyć zamiast tego TLSCipherAll13.
TLSCipherPSK13
Ciąg szyfrów OpenSSL (TLS 1.3). Zastępuje domyślne kryteria wyboru zestawu szyfrów dla szyfrowania opartego na PSK.
Przykład:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
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 współdzielonego klucza wstępnego (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
Pełna ścieżka do pliku zawierającego unieważnione certyfikaty. Ten parametr jest używany do szyfrowanej komunikacji między komponentami Zabbix.
TLSKeyFile
Pełna ścieżka do pliku zawierającego klucz prywatny agenta, używanego do szyfrowanej komunikacji między komponentami Zabbix.
TLSPSKFile
Pełna ścieżka do pliku zawierającego klucz współdzielony agenta, używany do szyfrowanej komunikacji z serwerem Zabbix.
TLSPSKIdentity
Ciąg tożsamości klucza współdzielonego, używany do szyfrowanej komunikacji z serwerem Zabbix.
TLSServerCertIssuer
Dozwolony wystawca certyfikatu serwera (proxy).
TLSServerCertSubject
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: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @
Ponadto znaki nowej linii są niedozwolone.
Domyślnie: 0
Wartości: 0 - nie zezwalaj, 1 - zezwalaj
UserParameter
Parametr zdefiniowany przez użytkownika do monitorowania.
Może istnieć kilka parametrów zdefiniowanych przez użytkownika.
Format: UserParameter=<key>,<shell command>
Należy pamiętać, że polecenie powłoki nie może zwracać pustego ciągu ani wyłącznie EOL.
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
Domyślna ścieżka wyszukiwania dla poleceń UserParameter.
Jeśli jest używana, agent zmieni swój bieżący 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