Documentation
Table of Contents
4 Agent Zabbix (Windows)
Parametry obsługiwane w pliku konfiguracji agenta Zabbix (Windows):
| Parametr | Wymagany | Zakres | Wartość domyślna | Opis |
|---|---|---|---|---|
| Alias | nie | Ustawia alias dla klucza pozycji. Może być używany jako zamiennik dla długich i skomplikowanych kluczy pozycji. Może istnieć wiele parametrów Alias. Niedozwolone jest wprowadzanie wielu kluczy z takim samym parametrem Alias. Różne klucze Alias mogą odwoływać się do tego samego klucza pozycji. Na przykład, żeby uzyskać użycie pliku stronicowania w procentach z serwera: Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage] Od tej chwili do pobrania danych można używać skrótu klucza pg_usage. Aliasów można używać w parametrze HostMetadataItem, w HostnameItem oraz w PerfCounter nie są obsługiwane. |
||
| BufferSend | nie | 1-3600 | 5 | Nie przetrzymuj danych w buforze dłużej niż N sekund. |
| BufferSize | nie | 2-65535 | 100 | Maksymalna ilość wartości w buforze pamięciowym. Agent wyśle wszystkie zebrane dane do serwera lub proxy Zabbix, gdy bufor zostanie zapełniony. |
| DebugLevel | nie | 0-4 | 3 | Określa poziom śledzenia: 0 - bez śledzenia 1 - informacje krytyczne 2 - informacje o błędach 3 - ostrzeżenia 4 - dla debugowania (wytwarza mnóstwo informacji) |
| EnableRemoteCommands | nie | 0 | Czy polecenia zdalne z serwera Zabbix są dozwolone. 0 - niedozwolone 1 - dozwolone |
|
| HostMetadata | nie | 0-255 znaków | Parametr opcjonalny definiujący metadane hosta. Metadane hosta używane są wyłącznie w procesie automatycznej rejestracji (aktywny agent). Jeżeli nie są zdefiniowane, wartość zostanie pobrana z HostMetadataItem. Agent zgłosi błąd i nie uruchomi się, jeżeli określono wartość przekraczającą limit lub nie jest to ciąg UTF-8. Opcja ta jest dostępna od wersji 2.2.0. |
|
| HostMetadataItem | nie | Parametr opcjonalny, definiujący pozycję agenta Zabbix używaną do pobierania metadanych hosta. Opcja ta jest używana jedynie wtedy, gdy nie jest zdefiniowane HostMetadata. Obsługuje Parametry Użytkownika, liczniki wydajności oraz aliasy. Obsługuje system.run[] niezależnie od wartości EnableRemoteCommands. Metadane hosta używane są wyłącznie w procesie automatycznej rejestracji (aktywny agent). Podczas procesu automatycznej rejestracji, agent zaloguje ostrzeżenie, jeżeli wartość zwracana przez określoną pozycję przekracza limit 255 znaków. Wartość zwracana musi być ciągiem UTF-8, w przeciwnym razie zostanie zignorowana. Opcja ta jest dostępna od wersji 2.2.0. |
||
| Hostname | nie | Ustawiane przez HostnameItem | Unikalna nazwa hosta (czułe na wielkość liter). Wymagane przy sprawdzeniach aktywnych, musi być zgodne z nazwą hosta zdefiniowaną na serwerze. Dozwolone znaki: alfanumeryczne, '.', ' ', '_' i '-'. Maksymalna długość: 64 |
|
| HostnameItem | nie | system.hostname | Parametr opcjonalny, definiujący pozycję agenta Zabbix używaną do pobierania nazwy hosta. Opcja ta jest używana, jeżeli nie zdefiniowano HostMetadata. Nie obsługuje Parametrów Użytkownika ani aliasów, ale obsługuje system.run[], niezależnie od wartości EnableRemoteCommands. Opcja ta jest obsługiwana od wersji 1.8.6. Zobacz też bardziej szczegółowe informacje. |
|
| Include | nie | W pliku konfiguracji można dołączać indywidualne pliki. | ||
| ListenIP | nie | 0.0.0.0 | Lista adresów IP, oddzielonych przecinkami, na których powinien nasłuchiwać agent. Wiele adresów IP obsługiwane jest od wersji 1.8.3. |
|
| ListenPort | nie | 1024-32767 | 10050 | Agent będzie nasłuchiwał połączeń z serwera na tym porcie. |
| LogFile | nie | Nazwa pliku logu. Jeżeli nie została ustawiona, zostanie użyty Log zdarzeń Windows. |
||
| LogFileSize | nie | 0-1024 | 1 | Maksymalny rozmiar pliku logu w MB. 0 - wyłącza automatyczną rotację. Uwaga: Jeżeli osiągnięty zostanie limit rozmiaru pliku logu i rotacja z jakiegokolwiek powodu zawiedzie, istniejący plik logu zostanie wyczyszczony i rozpocznie się od nowa. |
| LogRemoteCommands | nie | 0 | Włącza logowanie wykonywanych poleceń powłoki jako ostrzeżeń. 0 - wyłączone 1 - włączone |
|
| MaxLinesPerSecond | nie | 1-1000 | 100 | Maksymalna liczba nowych linii na sekundę wysyłanych przez agenta do serwera\\lub proxy Zabbix, podczas przetwarzania aktywnych sprawdzeń 'log', 'logrt' oraz 'eventlog'. Podana wartość zostanie nadpisana przez parametr 'maxlines', podany w kluczu pozycji 'log', 'logrt' lub 'eventlog'. |
| PerfCounter | nie | Składnia: <nazwa_parametru>,"<ścieżka_licznika_wydajności>",<okres> Definiuje nowy parametr <nazwa_parametru> będący średnią wartością dla systemowego licznika wydajności <ścieżka_licznika_wydajności> dla określonego okresu czasu <okres> (w sekundach). Na przykład, Jeżeli chcemy uzyskać średnią liczbę przerwań na sekundę z ostatniej minuty, można zdefiniować parametr "interrupts" w następujący sposób: PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 Należy zwrócić uwagę na cudzysłowy przy ścieżce licznika wydajności. Nazwa parametru (interrupts) zostanie użyta jako klucz pozycji podczas tworzenia pozycji. Wartości średnie będą wyliczane co sekundę. Uruchomienie "typeperf -qx" pozwoli uzyskać listę wszystkich dostępnych w Windows liczników. |
||
| RefreshActiveChecks | nie | 60-3600 | 120 | Jak często jest odświeżana lista aktywnych sprawdzeń, w sekundach. Należy zauważyć, że po błędzie odświeżenia aktywnych sprawdzeń, kolejna próba nastąpi po 60 sekundach. |
| Server | nie | Lista oddzielonych przecinkami adresów IP (lub nazw hostów) serwerów Zabbix. Spacje są dozwolone od wersji Zabbix 2.2. Połączenia przychodzące akceptowane są wyłącznie z hostów podanych tutaj. Należy zauważyć, że nazwy hostów muszą być rozwiązywalne, tzn.: nazwa hosta→adres IP oraz adres IP→nazwa hosta. Jeżeli włączono obsługę IPv6, to '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' są traktowane identycznie. |
||
| ServerActive | nie | IP:port (lub nazwa hosta:port) serwera lub proxy Zabbix dla sprawdzeń aktywnych. Można podać wiele adresów oddzielonych przecinkami, żeby używać równolegle niezależnych serwerów Zabbix. Spacje są zabronione. Jeżeli nie podano portu, użyty zostanie port domyślny. Jeżeli port dla hosta zostanie podany, to adresy IPv6 muszą być podane w nawiasach kwadratowych. Jeżeli port nie zostanie określony, nawiasy kwadratowe dla adresów IPv6 są opcjonalne. Jeżeli parametr nie zostanie określony, sprawdzenia aktywne zostaną wyłączone. |
||
| SourceIP | nie | Adres IP Źródła dla połączeń wychodzących. | ||
| StartAgents | nie | 0-63 (*) | 3 | Liczba wstępnie uruchomionych instancji procesów zabbix_agentd, przetwarzających sprawdzenia pasywne. Jeżeli ustawione na 0, pasywne sprawdzenia zostaną wyłączone, a agent nie będzie nasłuchiwał na żadnym porcie TCP. Przed wersją 1.8.5 górną granicą było 16. |
| Timeout | nie | 1-30 | 3 | Nie spędzaj więcej niż Timeout sekund na przetwarzanie |
| UnsafeUserParameters | nie | 0-1 | 0 | Pozwala na przekazywanie dowolnych znaków w argumentach parametrów użytkowników. 0 - nie pozwalaj 1 - pozwalaj |
| UserParameter | Parametry użytkownika do monitorowania. Może być kilka parametrów użytkownika. Format: UserParameter=<klucz>,<polecenie powłoki> Należy zauważyć, że polecenia powłoki nie mogą zwracać jedynie pustego ciągu lub EOL. Przykład: UserParameter=system.test,who|wc -l |
|||
(*) Liczba aktywnych serwerów wyszczególnionych w ServerActive plus liczba wstępnie uruchomionych instancji sprawdzeń pasywnych określona w StartAgents musi być mniejsza niż 64.
W wersji 2.0.0 agenta Zabbix zostały zmienione parametry konfiguracyjne związane ze sprawdzeniami pasywnymi i aktywnymi.
Zobacz "Zobacz też" na dole tej strony, żeby przeczytać więcej szczegółów na temat tych zmian.
Zabbix obsługuje pliki konfiguracyjne w kodowaniu UTF-8 bez BOM.