Parametry konfiguracji: Zabbix agent (Windows)

Przegląd

Parametry konfiguracji umożliwiają dostosowanie działania agent na systemie Windows.

Określ wartości parametrów w pliku konfiguracji agent Zabbix (zabbix_agentd.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 Ustaw alias dla klucza pozycji.
AllowKey Zezwól na wykonywanie kluczy pozycji pasujących do wzorca.
AllowKeyRegexp Zezwól na wykonywanie kluczy pozycji pasujących do wzorca opartego na wyrażeniu regularnym.
BufferSend Ustaw częstotliwość wysyłania wartości z bufora do serwera/proxy Zabbix.
BufferSize Ustaw maksymalną liczbę wartości w buforze pamięci.
DebugLevel Ustaw poziom debugowania.
DenyKey Zabroń wykonywania kluczy pozycji pasujących do wzorca.
DenyKeyRegexp Zabroń wykonywania kluczy pozycji pasujących do wzorca opartego na wyrażeniu regularnym.
EnableRemoteCommands Zezwól na zdalne polecenia z serwera Zabbix. Ten parametr jest przestarzały; zamiast niego użyj AllowKey, AllowKeyRegexp, DenyKey lub DenyKeyRegexp.
HeartbeatFrequency Ustaw częstotliwość komunikatów heartbeat w sekundach.
HostInterface Określ interfejs host.
HostInterfaceItem Określ pozycję służącą do pobierania interfejsu host.
HostMetadata Określ metadane host.
HostMetadataItem Określ pozycję agent Zabbix służącą do pobierania metadanych host.
Hostname Określ nazwę host.
HostnameItem Określ pozycję agent Zabbix służącą do pobierania nazwy host.
Include Określ katalog lub pojedyncze pliki, które mają zostać dołączone do pliku konfiguracji.
ListenBacklog Ustaw maksymalną liczbę oczekujących połączeń w kolejce TCP.
ListenIP Określ adres IP nasłuchiwania agent dla połączeń z serwera/proxy.
ListenPort Określ port nasłuchiwania agent.
LogFile Określ plik dziennika agent.
LogFileSize Ustaw maksymalny rozmiar pliku dziennika.
LogRemoteCommands Włącz rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń.
LogType Określ typ wyjścia dziennika.
MaxLinesPerSecond Ustaw maksymalną liczbę nowych wierszy na sekundę wysyłanych do serwera/proxy Zabbix podczas przetwarzania aktywnych kontroli log, logrt lub eventlog.
PerfCounter Zdefiniuj 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 Zdefiniuj 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 odróżnieniu od PerfCounter ścieżki liczników wydajności muszą być podane w języku angielskim.
RefreshActiveChecks Określ częstotliwość odświeżania listy aktywnych kontroli.
Server Określ adresy IP lub nazwy DNS serwerów/proxy Zabbix.
ServerActive Określ adres serwera/proxy Zabbix lub konfigurację klastra, z którego mają być pobierane aktywne kontrole.
SourceIP Określ źródłowy adres IP.
StartAgents Ustaw liczbę wstępnie rozgałęzionych instancji zabbix_agentd do przetwarzania pasywnych kontroli.
Timeout Określ czas oczekiwania (w sekundach) na ustanowienie połączenia i wymianę danych z serwerem lub proxy Zabbix.
TLSAccept Określ wymagany poziom szyfrowania dla połączeń przychodzących.
TLSCAFile Określ pełną ścieżkę do pliku zawierającego certyfikaty głównego urzędu certyfikacji (CA) do weryfikacji certyfikatu peera, używane w szyfrowanej komunikacji między komponentami Zabbix.
TLSCertFile Określ pełną ścieżkę do pliku zawierającego certyfikat agent lub łańcuch certyfikatów, używane w szyfrowanej komunikacji między komponentami Zabbix.
TLSConnect Określ wymagany poziom szyfrowania dla połączeń z serwerem lub proxy Zabbix.
TLSCRLFile Określ pełną ścieżkę do pliku zawierającego unieważnione certyfikaty. Ten parametr jest używany w szyfrowanej komunikacji między komponentami Zabbix.
TLSKeyFile Określ pełną ścieżkę do pliku zawierającego klucz prywatny agent, używany w szyfrowanej komunikacji między komponentami Zabbix.
TLSPSKFile Określ pełną ścieżkę do pliku zawierającego klucz wstępnie współdzielony agent, używany w szyfrowanej komunikacji z serwerem lub proxy Zabbix.
TLSPSKIdentity Określ ciąg identyfikatora klucza wstępnie współdzielonego, używany w szyfrowanej komunikacji z serwerem lub proxy Zabbix.
TLSServerCertIssuer Określ dozwolonego wystawcę certyfikatu serwera (proxy).
TLSServerCertSubject Określ dozwolony podmiot certyfikatu serwera (proxy).
UnsafeUserParameters Zezwól na przekazywanie wszystkich znaków w argumentach do parametrów zdefiniowanych przez użytkownika.
UserParameter Określ parametr zdefiniowany przez użytkownika do monitorowania.
UserParameterDir Określ domyślną ścieżkę wyszukiwania poleceń UserParameter.

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają wartości domyślne demona, a nie wartości zawarte w dostarczanych 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żna go użyć do zastąpienia długiego i złożonego klucza pozycji krótszym i prostszym.
Może występować wiele parametrów Alias. Nie można używać wielu parametrów z takim 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 parametrach HostnameItem ani PerfCounter.

Przykład 1: Pobieranie procentowego użycia pliku stronicowania z serwera.

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

Teraz można użyć skróconego klucza pg_usage do pobierania danych.

Przykład 2: Pobieranie obciążenia procesora z parametrami domyślnymi i niestandardowymi.

Alias=cpu.load:system.cpu.load
Alias=cpu.load[*]:system.cpu.load[*]

Umożliwia to użycie klucza cpu.load do pobierania obciążenia procesora z parametrami domyślnymi, a także użycie cpu.load[percpu,avg15] do pobierania szczegółowych danych dotyczących obciążenia procesora.

Przykład 3: Uruchamianie wielu reguł niskopoziomowego wykrywania przetwarzających te same pozycje wykrywania.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Teraz można skonfigurować kilka reguł wykrywania przy użyciu 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.
Można zdefiniować wiele reguł dopasowania kluczy 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ń agenta.

AllowKeyRegexp

Zezwalaj na wykonywanie 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 DenyKeyRegexp, AllowKey i DenyKey. Parametry są przetwarzane jeden po drugim, zgodnie z kolejnością ich występowania. Kolejność określa, która pasująca reguła będzie miała pierwszeństwo. Zobacz także: Ograniczanie sprawdzania przez agent.

Przykład:

AllowKeyRegexp=^system\.run\[(?:/usr)?/bin/hostname(?: -[fsd])?\]$
BufferSend

Ustaw częstotliwość wysyłania wartości z bufora do serwera/proxy Zabbix (w sekundach).

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.

Domyślnie: 100
Zakres: 2-65535

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

Zabroń wykonywania tych kluczy pozycji, które pasują do wzorca. Wzorzec klucza jest wyrażeniem wieloznacznym obsługującym znak *, który dopasowuje dowolną liczbę dowolnych znaków.
Można definiować wiele reguł dopasowywania kluczy w połączeniu z AllowKey, AllowKeyRegexp i DenyKeyRegexp. Parametry są przetwarzane pojedynczo, zgodnie z kolejnością ich występowania. Kolejność określa, która pasująca reguła będzie miała pierwszeństwo. Zobacz także: Ograniczanie sprawdzania przez agent.

Wartość domyślna: DenyKey=system.run[*]

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 po kolei, zgodnie z kolejnością ich występowania. Kolejność określa, która pasująca reguła będzie miała pierwszeństwo.
Wszystkie pozycje system.run[] są domyślnie zabronione (DenyKey=system.run[*]), chyba że określono inną regułę system.run[*].

Zobacz także: Ograniczanie kontroli agentów.

EnableRemoteCommands

Zezwalaj na zdalne polecenia z serwera Zabbix.
Ten parametr jest przestarzały. Zamiast niego użyj AllowKey=system.run[*], AllowKeyRegexp=^system\.run\[.*\]$, DenyKey=system.run[*] lub DenyKeyRegexp=^system\.run\[.*\]$.
Jest to wewnętrzny alias parametrów AllowKey, AllowKeyRegexp, DenyKey i DenyKeyRegexp, zależny od wartości:

  • 0 - DenyKey=system.run[*] (DenyKeyRegexp=^system\.run\[.*\]$)
  • 1 - AllowKey=system.run[*] (AllowKeyRegexp=^system\.run\[.*\]$)

Wartość domyślna: 0
Wartości: 0 - nie zezwalaj, 1 - zezwalaj

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śl 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 znajdziesz 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ę służącą do ustalenia interfejsu hosta (adresu IP lub nazwy DNS) podczas automatycznej rejestracji hosta. Ta wartość jest używana tylko wtedy, gdy parametr HostInterface nie jest zdefiniowany. Więcej informacji zawiera sekcja Używanie DNS jako domyślnego interfejsu.

Podczas żądania automatycznej rejestracji 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, AllowKeyRegexp, DenyKey lub DenyKeyRegexp.

HostMetadata

Określ metadane używane do identyfikowania lub rozróżniania hosta podczas automatycznej rejestracji hosta (aktywny agent).
HostMetadata umożliwia rozróżnianie hostów niezależnie od ich nazw.

Jeśli parametr nie zostanie zdefiniowany, wartość zostanie pobrana z HostMetadataItem.

agent zgłosi błąd i nie uruchomi się, jeśli określona wartość przekroczy limit 2034 bajtów lub będzie ciągiem znaków innym niż UTF-8.
Jeśli 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 — dane wyjściowe zostaną obcięte przy pierwszym znaku końca wiersza.

Zakres: 0–2034 bajty

HostMetadataItem

Określ pozycję agenta Zabbix, aby uzyskać metadane hosta. Ta opcja jest używana tylko wtedy, gdy HostMetadata nie jest zdefiniowane.

Wartość HostMetadataItem jest pobierana przy każdej próbie automatycznej rejestracji i używana wyłącznie podczas procesu automatycznej rejestracji hosta (aktywny agent). HostMetadataItem umożliwia rozróżnianie hostów na podstawie innych informacji niż nazwa hosta.

Obsługiwane są parametry użytkownika, liczniki wydajności i aliasy. Pozycja system.run[] jest obsługiwana niezależnie od ustawień AllowKey, AllowKeyRegexp, DenyKey lub DenyKeyRegexp.

Podczas żądania automatycznej rejestracji 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 znaków UTF-8; w przeciwnym razie zostanie zignorowana. Jeśli parametr oczekuje adresu IP lub nazwy DNS, wartości, które są prawidłowym tekstem UTF-8, ale nie są prawidłowymi adresami IP ani nazwami DNS, również zostaną odrzucone i zgłoszone jako nieprawidłowe.

Metadane wielowierszowe nie są obsługiwane — dane wyjściowe zostaną obcięte przy pierwszym znaku końca wiersza.

Nazwa hosta

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 określona.
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

Określ pozycję agenta Zabbix służącą do pobierania nazwy hosta.
Ta opcja jest używana tylko wtedy, gdy Hostname nie jest zdefiniowane.
Parametry użytkownika, liczniki wydajności ani aliasy nie są obsługiwane, ale pozycja system.run[] jest obsługiwana niezależnie od wartości AllowKey, AllowKeyRegexp, DenyKey lub DenyKeyRegexp.
Więcej informacji zawiera szczegółowy opis.

Wartość domyślna: 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, 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).

Ogólne zasady dotyczące parametru Include:

  • Ścieżka może być względna względem lokalizacji pliku zabbix_agentd.conf.
  • W jednym pliku konfiguracyjnym można określić wiele parametrów Include.
  • Zabbix przetwarza parametr Include natychmiast po jego odczytaniu, dlatego należy rozważyć 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 należy zakładać żadnej kolejności uwzględniania (np. pliki nie są uwzględniane w kolejności alfabetycznej).
  • Nie należy definiować tego samego parametru w więcej niż jednym uwzględnianym pliku (np. w celu zastąpienia ustawienia ogólnego ustawieniem szczegółowym), ponieważ nie można przewidzieć, która wartość zostanie użyta.
  • Należy uważać na kopie zapasowe tworzone automatycznie przez niektóre edytory tekstu (np. edycja pliku include/my_specific.conf może utworzyć plik 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 wzorców.

Przykład:

Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf
ListenBacklog

Ustaw maksymalną liczbę oczekujących połączeń w kolejce TCP.
Wartość domyślna jest zakodowaną na stałe stałą, która zależy od systemu.
Maksymalna obsługiwana wartość również zależy od systemu; zbyt wysokie wartości mogą zostać bez ostrzeżenia obcięte do „maksimum określonego przez implementację”.

Domyślnie: SOMAXCONN
Zakres: 0 - INT_MAX

ListenIP

Określa adres IP, na którym agent nasłuchuje połączeń z serwera/proxy. Lista rozdzielana przecinkami.

Domyślnie: 0.0.0.0

ListenPort

Określ port nasłuchiwania agenta dla połączeń z serwera/proxy.

Domyślnie: 10050
Zakres: 1024-32767

LogFile

Określ plik dziennika agenta.

Domyślnie: c:\zabbix_agentd.log
Wymagane: 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

LogRemoteCommands

Włącz rejestrowanie wykonywanych poleceń powłoki jako ostrzeżeń.
Polecenia będą rejestrowane tylko wtedy, gdy zostaną wykonane zdalnie.
Wpisy w dzienniku 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

LogType

Określ typ wyjścia logów:

  • file - zapisuj log do pliku określonego parametrem LogFile;
  • system - zapisuj log do Dziennika zdarzeń systemu Windows;
  • console - zapisuj log do standardowego wyjścia.

Domyślnie: file

MaxLinesPerSecond

Ustaw maksymalną liczbę nowych linii na sekundę wysyłanych do serwera/proxy Zabbix podczas przetwarzania aktywnych kontroli log, logrt lub eventlog.
Podana wartość zostanie zastąpiona przez parametr maxlines określony w kluczu pozycja log, logrt lub eventlog.
Uwaga: Zabbix przetworzy 10 razy więcej nowych linii niż ustawiono w MaxLinesPerSecond, aby wyszukać wymagany ciąg w pozycjach dziennika.

Domyślnie: 20
Zakres: 1-1000

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 do PerfCounter, ścieżki perfcounter muszą być podane 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.

RefreshActiveChecks

Określa 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.
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. Należy pamiętać, że "IPv4-compatible IPv6 addresses" (0000::/96 prefix) są obsługiwane, ale przestarzałe zgodnie z RFC4291. Dozwolone są spacje.

Przykład:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Wymagane: tak, jeśli StartAgents nie jest jawnie ustawione na 0

ServerActive

Określ adres serwera/proxy Zabbix lub konfigurację klastra, aby pobierać aktywne kontrole z.
Adres serwera/proxy jest adresem IP lub nazwą DNS oraz opcjonalnym portem oddzielonym dwukropkiem.
Konfiguracja klastra to jeden lub więcej adresów członków grupy serwerów 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 używać kilku niezależnych serwerów Zabbix równolegle. Spacje są dozwolone.
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.
Jeśli ten parametr nie zostanie określony, aktywne kontrole 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 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

Zakres: Liczba aktywnych serwerów wymienionych w ServerActive plus liczba wstępnie utworzonych instancji dla pasywnych kontroli określonych w StartAgents musi być mniejsza niż 64.

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.port itp.).
StartAgents

Ustaw liczbę wstępnie utworzonych instancji zabbix_agentd do przetwarzania pasywnych kontroli.
Jeśli ustawiono 0, pasywne kontrole są wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP.

Domyślnie: 10
Zakres: 0-100 (*)

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 określa 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 oraz danych pozycji w active checks;
  • pobieranie danych dziennika za pośrednictwem monitorowania pliku dziennika lub dziennika zdarzeń systemu Windows;
  • wysyłanie komunikatów heartbeat;
  • maksymalny czas trwania dla sprawdzeń vfs.*;
  • używany przez moduły agent Zabbix;
  • pełnienie roli wartości awaryjnej w scenariuszach, w których serwer lub proxy w wersji starszej niż 7.0 wysyła sprawdzenia bez limitów czasu.

Ten limit czasu nie będzie używany dla tych sprawdzeń agent, które mają konfigurowalne ustawienia limitu czasu w frontendzie (na poziomie globalnym, 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 kontroli pasywnych.
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 współdzielonym kluczem wstępnym (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 głównych urzędów CA do weryfikacji certyfikatu peer, używaną do szyfrowanej komunikacji między komponentami Zabbixa.

TLSCertFile

Określ pełną ścieżkę do pliku zawierającego certyfikat agent lub łańcuch certyfikatów, używany do szyfrowanej komunikacji z komponentami Zabbix.

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

Określ pełną ścieżkę do pliku zawierającego prywatny klucz agenta, 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śla 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>
Należy pamiętać, ż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 wskazany tutaj przed wykonaniem polecenia. Dzięki temu polecenia UserParameter mogą mieć względny prefiks ./ zamiast pełnej ścieżki. Dozwolony jest tylko jeden wpis.

Przykład:

UserParameterDir=C:\opt\myscripts