Áú»¢¶Ä²© agent 2 to agent nowej generacji, kt¨®ry mo?e by? u?ywany zamiast Áú»¢¶Ä²© agent.
Ta sekcja zawiera list? obs?ugiwanych parametr¨®w w pliku konfiguracyjnym agenta Áú»¢¶Ä²© 2 (zabbix_agent2.conf).
Nale?y zauwa?y?, ?e:
Parametr | Obowi?zkowy | Zakres | Domy?lny | Opis | |
---|---|---|---|---|---|
Alias | nie | Ustawia alias dla klucza pozycji. Mo?e by? u?ywany do zast?powania d?ugiego i z?o?onego klucza pozycji kr¨®tszym i prostszym. Mo?e by? obecnych wiele parametr¨®w Alias. Niedozwolone s? wielokrotne parametry o tym samym kluczu Alias. R¨®?ne klucze Alias mog? odnosi? si? do tego samego klucza pozycji. Alias mo?na u?ywa? w parametrze HostMetadataItem, ale nie w parametrach HostnameItem. Przyk?ady: 1. Pobieranie identyfikatora u?ytkownika 'zabbix'. Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] Teraz mo?na u?y? skr¨®tu zabbix.userid do pobierania danych. 2. Pobieranie u?ycia procesora z domy?lnymi i niestandardowymi parametrami. Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] To pozwala u?y? klucza cpu.util do pobierania procentowego u?ycia procesora z domy?lnymi parametrami, a tak?e u?y? cpu.util[all, idle, avg15] do uzyskania konkretnych danych dotycz?cych u?ycia procesora. 3. Wykonywanie wielu zasad wykrywania niskopoziomowego, przetwarzaj?cych te same pozycje wykrycia. Alias=vfs.fs.discovery[*]:vfs.fs.discovery Teraz mo?liwe jest skonfigurowanie kilku regu? wykrywania za pomoc? vfs.fs.discovery z r¨®?nymi parametrami dla ka?dej regu?y, np. vfs.fs.discovery[foo], vfs.fs.discovery[bar], itp. |
|||
AllowKey | nie | Zezwalaj na wykonanie tych kluczy pozycji, kt¨®re pasuj? do wzorca. Wzorzec klucza to wyra?enie wildcard, kt¨®re obs?uguje znak "*", aby pasowa? do dowolnej liczby dowolnych znak¨®w. Mo?na zdefiniowa? wiele regu? dopasowania kluczy w po??czeniu z DenyKey. Parametry s? przetwarzane jeden po drugim zgodnie z ich kolejno?ci? pojawiania si?. Ten parametr jest obs?ugiwany od wersji Áú»¢¶Ä²© 5.0.0. Zobacz tak?e: Ograniczenia sprawdzania agenta. |
|||
BufferSend | nie | 1-3600 | 5 | Interwa? czasu w sekundach, kt¨®ry okre?la, jak cz?sto warto?ci s? wysy?ane z bufora do serwera Áú»¢¶Ä²©. Zwr¨®? uwag?, ?e je?li bufor jest pe?ny, dane zostan? wys?ane wcze?niej. |
|
BufferSize | nie | 2-65535 | 100 | Maksymalna liczba warto?ci w buforze pami?ci. Agent wy?le wszystkie zebrane dane do serwera Áú»¢¶Ä²© lub proxy, je?li bufor jest pe?ny. Ten parametr powinien by? u?ywany tylko wtedy, gdy bufor trwa?y jest wy??czony (EnablePersistentBuffer=0). |
|
ControlSocket | nie | /tmp/agent.sock | Gniazdo kontrolne, u?ywane do wysy?ania polece¨½ kontroli dzia?ania z opcj? '-R'. | ||
DebugLevel | nie | 0-5 | 3 | Okre?la poziom debugowania: 0 - podstawowe informacje o uruchamianiu i zatrzymywaniu proces¨®w Áú»¢¶Ä²© 1 - informacje krytyczne 2 - informacje o b??dach 3 - ostrze?enia 4 - do debugowania (wytwarza du?o informacji) 5 - rozszerzone debugowanie (wytwarza jeszcze wi?cej informacji) |
|
DenyKey | nie | Zabrania wykonywania tych kluczy pozycji, kt¨®re pasuj? do wzorca. Wzorzec klucza to wyra?enie wildcard, kt¨®re obs?uguje znak "*", aby pasowa? do dowolnej liczby dowolnych znak¨®w. Mo?na zdefiniowa? wiele regu? dopasowania kluczy w po??czeniu z AllowKey. Parametry s? przetwarzane jeden po drugim zgodnie z ich kolejno?ci? pojawiania si?. Ten parametr jest obs?ugiwany od wersji Áú»¢¶Ä²© 5.0.0. Zobacz tak?e: Ograniczenia sprawdzania agenta. |
|||
EnablePersistentBuffer | nie | 0-1 | 0 | W??cza lokalny trwa?y bufor dla aktywnych pozycji. 0 - wy??czone 1 - w??czone Je?li bufor trwa?y jest wy??czony, b?dzie u?ywany bufor pami?ci. |
|
ForceActiveChecksOnStart | nie | 0-1 | 0 | Wykonuje aktywne sprawdzanie natychmiast po restarcie dla pierwszej otrzymanej konfiguracji. 0 - wy??czone 1 - w??czone Dost?pne r¨®wnie? jako parametr konfiguracji pluginu, na przyk?ad: Plugins.Uptime.System.ForceActiveChecksOnStart=1 Obs?ugiwane od wersji Áú»¢¶Ä²© 6.0.2. |
|
HostInterface | nie | 0-255 znak¨®w | Parametr opcjonalny, kt¨®ry definiuje interfejs hosta. Interfejs hosta jest u?ywany w procesie autorejestracji hosta. Agent zg?osi b??d i nie uruchomi si?, je?li warto?? przekroczy limit 255 znak¨®w. Je?li nie zdefiniowano, warto?? zostanie pobrana z HostInterfaceItem. Obs?ugiwane od wersji Áú»¢¶Ä²© 4.4.0. |
||
HostInterfaceItem | nie | Parametr opcjonalny, kt¨®ry definiuje pozycj? u?ywan? do pobierania interfejsu hosta. Interfejs hosta jest u?ywany w procesie autorejestracji hosta. Podczas ??dania autorejestracji agent zapisze log poziomu ostrze?enie, je?li warto?? zwr¨®cona przez okre?lon? pozycj? przekroczy limit 255 znak¨®w. Pozycja system.run[] jest obs?ugiwana niezale?nie od warto?ci AllowKey/DenyKey. Ta opcja jest u?ywana tylko w przypadku braku zdefiniowanego HostInterface. Obs?ugiwane od wersji Áú»¢¶Ä²© 4.4.0. |
|||
HostMetadata | nie | 0-255 znak¨®w | Parametr opcjonalny, kt¨®ry definiuje metadane hosta. Metadane hosta s? u?ywane w procesie autorejestracji hosta. Agent zg?osi b??d i nie uruchomi si?, je?li okre?lona warto?? przekroczy limit lub b?dzie nieprawid?owym ?a¨½cuchem UTF-8. Je?li nie zdefiniowano, warto?? zostanie pobrana z HostMetadataItem. |
||
HostMetadataItem | nie | Parametr opcjonalny, kt¨®ry definiuje pozycj? u?ywan? do pobierania metadanych hosta. Warto?? pozycji metadanych hosta jest pobierana przy ka?dej pr¨®bie autorejestracji dla procesu autorejestracji hosta. Podczas ??dania autorejestracji agent zapisze log poziomu ostrze?enie, je?li warto?? zwr¨®cona przez okre?lon? pozycj? przekroczy limit 255 znak¨®w. Ta opcja jest u?ywana tylko w przypadku braku zdefiniowanych HostMetadata. Obs?uguje Parametry U?ytkownika i aliasy. Obs?uguje system.run[] niezale?nie od warto?ci AllowKey/DenyKey. Zwracana przez pozycj? warto?? musi by? ?a¨½cuchem UTF-8, w przeciwnym razie zostanie zignorowana. |
|||
Hostname | nie | Ustawiane przez HostnameItem | Lista unikalnych, rozr¨®?niaj?cych wielko?? liter nazw host¨®w oddzielonych przecinkami. Wymagane dla aktywnych sprawdze¨½ i musi odpowiada? nazwom host¨®w skonfigurowanym na serwerze. Warto?? jest pobierana z HostnameItem, je?li niezdefiniowana. Dozwolone znaki: alfanumeryczne, '.', ' ', '_' i '-'. Maksymalna d?ugo??: 128 znak¨®w na nazw? hosta, 2048 znak¨®w dla ca?ej linii. |
||
HostnameItem | nie | system.hostname | Pozycja u?ywana do generowania Hostname, je?li nie jest zdefiniowany. Ignorowany, je?li zdefiniowany jest Hostname. Nie obs?uguje Parametr¨®w U?ytkownika ani alias¨®w, ale obs?uguje system.run[] niezale?nie od warto?ci AllowKey/DenyKey. |
||
Include | nie | Mo?esz do??czy? pojedyncze pliki lub wszystkie pliki z katalogu do pliku konfiguracyjnego. Podczas instalacji Áú»¢¶Ä²© utworzy katalog include w /usr/local/etc, chyba ?e zostanie zmodyfikowany podczas kompilacji. Aby do??czy? tylko istotne pliki z okre?lonego katalogu, obs?ugiwany jest znak gwiazdki typu wildcard do dopasowania wzorca. Na przyk?ad: /?³¦¾±±ð?°ì²¹/²¹²ú²õ´Ç±ô³Ü³Ù²Ô²¹/»å´Ç/±è±ô¾±°ì¨®·É/°ì´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦²âÂá²Ô²â³¦³ó/*.³¦´Ç²Ô´Ú .Od wersji Áú»¢¶Ä²© 6.0.0 ?cie?ka mo?e by? wzgl?dna w stosunku do lokalizacji pliku zabbix_agent2.conf. Zobacz specjalne uwagi dotycz?ce ogranicze¨½. |
|||
ListenIP | nie | 0.0.0.0 | Lista adres¨®w IP oddzielonych przecinkami, na kt¨®rych agent powinien nas?uchiwa?. Pierwszy adres IP jest przesy?any do serwera Áú»¢¶Ä²©, je?li si? z nim ??czy, aby pobra? list? aktywnych sprawdze¨½. |
||
ListenPort | nie | 1024-32767 | 10050 | Agent b?dzie nas?uchiwa? na tym porcie na po??czenia z serwera. | |
LogFile | tak, je?li LogType jest ustawione na file, w przeciwnym razie nie |
/tmp/zabbix_agent2.log | Nazwa pliku logu, je?li LogType to 'file'. | ||
LogFileSize | nie | 0-1024 | 1 | Maksymalny rozmiar pliku logu w MB. 0 - wy??cza automatyczn? rotacj? logu. Uwaga: Je?li limit rozmiaru pliku logu zostanie osi?gni?ty, a rotacja pliku nie powiedzie si?, z jakiegokolwiek powodu, istniej?cy plik logu zostanie uci?ty i rozpocznie si? na nowo. |
|
LogType | nie | file | Okre?la, gdzie zapisywane s? komunikaty logu: system - syslog, file - plik okre?lony parametrem LogFile, console - standardowe wyj?cie. |
||
PersistentBufferFile | nie | Plik, w kt¨®rym Áú»¢¶Ä²© Agent2 powinien przechowywa? baz? danych SQLite. Musi by? pe?n? nazw? pliku. Ten parametr jest u?ywany tylko wtedy, gdy bufor trwa?y jest w??czony (EnablePersistentBuffer=1). |
|||
PersistentBufferPeriod | nie | 1m-365d | 1h | Okres czasu, przez kt¨®ry dane powinny by? przechowywane, gdy nie ma po??czenia z serwerem lub proxy. Starsze dane zostan? utracone. Dane logu zostan? zachowane. Ten parametr jest u?ywany tylko wtedy, gdy bufor trwa?y jest w??czony (EnablePersistentBuffer=1). |
|
PidFile | nie | /tmp/zabbix_agent2.pid | Nazwa pliku PID. | ||
Plugin | nie | Od wersji Áú»¢¶Ä²© 6.0.0 wi?kszo?? plugin¨®w ma swoje w?asne pliki konfiguracyjne. Plik konfiguracyjny agenta zawiera poni?ej wymienione parametry pluginu. | |||
Plugins.Log.MaxLinesPerSecond | nie | 1-1000 | 20 | Maksymalna liczba nowych linii, kt¨®re agent b?dzie wysy?a? na sekund? do serwera Áú»¢¶Ä²© lub proxy podczas przetwarzania aktywnych sprawdze¨½ 'log' i 'eventlog'. Podana warto?? zostanie zast?piona przez parametr 'maxlines', podany w kluczu pozycji 'log' lub 'eventlog'. Uwaga: Áú»¢¶Ä²© przetworzy 10 razy wi?cej nowych linii ni? ustawiono w MaxLinesPerSecond w celu wyszukania wymaganego ci?gu w pozycjach logu. Ten parametr jest obs?ugiwany od wersji 4.4.2 i zast?puje MaxLinesPerSecond. |
|
Plugins.SystemRun.LogRemoteCommands | nie | 0 | W??cza rejestrowanie wykonywanych polece¨½ pow?oki jako log poziomu ostrze?enie. 0 - wy??czone 1 - w??czone Polecenia b?d? rejestrowane tylko w przypadku ich zdalnego wykonania. Wpisy logu nie b?d? tworzone, je?li system.run[] zostanie uruchomiony lokalnie przez parametry HostMetadataItem, HostInterfaceItem lub HostnameItem. Ten parametr jest obs?ugiwany od wersji 4.4.2 i zast?puje LogRemoteCommands. |
||
PluginSocket | nie | /tmp/agent.plugin.sock | ?cie?ka do gniazda Unix do komunikacji z pluginami ?adowanymi dynamicznie. | ||
PluginTimeout | nie | 1-30 | Globalny limit czasu | Limit czasu dla po??cze¨½ z pluginami ?adowanymi dynamicznie. | |
RefreshActiveChecks | nie | 60-3600 | 120 | Jak cz?sto lista aktywnych sprawdze¨½ jest od?wie?ana, w sekundach. Uwaga: Po nieudanym od?wie?eniu aktywnych sprawdze¨½ nast?pne od?wie?enie zostanie podj?te po 60 sekundach. |
|
Server | tak | Lista adres¨®w IP oddzielonych przecinkami, opcjonalnie w notacji CIDR, lub nazw DNS serwer¨®w Áú»¢¶Ä²© i proxy Áú»¢¶Ä²©. Po??czenia przychodz?ce b?d? akceptowane tylko od wymienionych tutaj host¨®w. Je?li obs?uga IPv6 jest w??czona, to '127.0.0.1', '::ffff:127.0.0.1' s? traktowane r¨®wnowa?nie, a '::/0' umo?liwia dowolny adres IPv4 lub IPv6. '0.0.0.0/0' mo?e by? u?ywane do zezwolenia na dowolny adres IPv4. Przyk?ad: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com Spacje s? dozwolone. |
|||
ServerActive | nie | Adres serwera/proxy Áú»¢¶Ä²© lub konfiguracja klastra do pobierania aktywnych sprawdze¨½. Adres serwera/proxy to adres IP lub nazwa DNS i opcjonalny port oddzielone dwukropkiem. Konfiguracja klastra to jeden lub wi?cej adres¨®w serwera oddzielonych ?rednikiem. Mo?na poda? wiele serwer¨®w Áú»¢¶Ä²©/klastr¨®w i proxy Áú»¢¶Ä²©, oddzielaj?c je przecinkiem. Nale?y unika? podawania wi?cej ni? jednego proxy Áú»¢¶Ä²© z ka?dego serwera/klastra Áú»¢¶Ä²©. Je?li podano proxy Áú»¢¶Ä²©, to serwer/klaster Áú»¢¶Ä²© dla tego proxy nie powinien by? podany. Mo?na poda? wiele adres¨®w oddzielonych przecinkiem, aby u?y? kilku niezale?nych serwer¨®w Áú»¢¶Ä²© r¨®wnolegle. Spacje s? dozwolone. Je?li port nie jest okre?lony, u?ywany jest port domy?lny. Adresy IPv6 musz? by? umieszczone w nawiasach kwadratowych, je?li okre?lono port dla tego hosta. Je?li port nie jest okre?lony, nawiasy kwadratowe dla adres¨®w IPv6 s? opcjonalne. Je?li ten parametr nie jest okre?lony, aktywne sprawdzenia s? wy??czone. Przyk?ad dla proxy Áú»¢¶Ä²©: ServerActive=127.0.0.1:10051 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 | nie | Adres IP ?r¨®d?owy dla: - wychodz?cych po??cze¨½ do serwera Áú»¢¶Ä²© lub proxy Áú»¢¶Ä²©; - nawi?zywania po??cze¨½ podczas wykonywania niekt¨®rych pozycji (web.page.get, net.tcp.port, itp.) |
|||
StatusPort | nie | 1024-32767 | Je?li ustawiono, agent b?dzie nas?uchiwa? na tym porcie ??dania stanu HTTP (http://localhost:<port>/status). | ||
Timeout | nie | 1-30 | 3 | Nie sp?dzaj wi?cej ni? Timeout sekund na przetwarzaniu. | |
TLSAccept | tak, je?li parametry certyfikatu TLS lub PSK s? zdefiniowane (nawet dla niezaszyfrowanego po??czenia), w przeciwnym razie nie | Jakie przyjmowa? przychodz?ce po??czenia. U?ywane dla sprawdze¨½ pasywnych. Mo?na poda? wiele warto?ci, oddzielonych przecinkami: unencrypted - akceptuj po??czenia bez szyfrowania (domy?lnie) psk - akceptuj po??czenia z TLS i kluczem wsp¨®?dzielonym (PSK) cert - akceptuj po??czenia z TLS i certyfikatem |
|||
TLSCAFile | nie | Pe?na ?cie?ka do pliku zawieraj?cego certyfikaty najwy?szego poziomu CA do weryfikacji certyfikatu pary, u?ywane do zaszyfrowanej komunikacji mi?dzy komponentami Áú»¢¶Ä²©. | |||
TLSCertFile | nie | Pe?na ?cie?ka do pliku zawieraj?cego certyfikat agenta lub ?a¨½cuch certyfikat¨®w, u?ywany do zaszyfrowanej komunikacji z komponentami Áú»¢¶Ä²©. | |||
TLSConnect | tak, je?li parametry certyfikatu TLS lub PSK s? zdefiniowane (nawet dla niezaszyfrowanego po??czenia), w przeciwnym razie nie | Jak agent powinien ??czy? si? z serwerem Áú»¢¶Ä²© lub proxy. U?ywane dla sprawdze¨½ aktywnych. Mo?na poda? tylko jedn? warto??: unencrypted - ??cz si? bez szyfrowania (domy?lnie) psk - ??cz si? za pomoc? TLS i klucza wsp¨®?dzielonego (PSK) cert - ??cz si? za pomoc? TLS i certyfikatu |
|||
TLSCRLFile | nie | Pe?na ?cie?ka do pliku zawieraj?cego odwo?ane certyfikaty. Ten parametr jest u?ywany do zaszyfrowanej komunikacji z komponentami Áú»¢¶Ä²©. | |||
TLSKeyFile | nie | Pe?na ?cie?ka do pliku zawieraj?cego prywatny klucz agenta u?ywany do zaszyfrowanej komunikacji z komponentami Áú»¢¶Ä²©. | |||
TLSPSKFile | nie | Pe?na ?cie?ka do pliku zawieraj?cego klucz wsp¨®?dzielony agenta u?ywany do zaszyfrowanej komunikacji z komponentami Áú»¢¶Ä²©. | |||
TLSPSKIdentity | nie | Ci?g identyfikuj?cy klucz wsp¨®?dzielony, u?ywany do zaszyfrowanej komunikacji z serwerem Áú»¢¶Ä²©. | |||
TLSServerCertIssuer | nie | Dozwolony wydawca certyfikatu serwera (proxy). | |||
TLSServerCertSubject | nie | Dozwolony podmiot certyfikatu serwera (proxy). | |||
UnsafeUserParameters | nie | 0,1 | 0 | Zezwalaj na przekazywanie wszystkich znak¨®w w argumentach do zdefiniowanych przez parametry u?ytkownika. Nast?puj?ce znaki s? niedozwolone: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ Dodatkowo niedozwolone s? znaki nowej linii. |
|
UserParameter | nie | Parametr zdefiniowany przez u?ytkownika do monitorowania. Mo?e by? kilka takich parametr¨®w zdefiniowanych przez u?ytkownika. Format: UserParameter=<klucz>,<polecenie pow?oki> Uwaga: polecenie pow?oki nie mo?e zwraca? pustego ci?gu ani tylko znak ko¨½ca linii(EOL). Polecenia pow?oki mog? mie? wzgl?dne ?cie?ki, je?li okre?lono parametr UserParameterDir. Przyk?ady: UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh |
|||
UserParameterDir | nie | Domy?lna ?cie?ka wyszukiwania polece¨½ UserParameter. Je?li u?ywane, agent zmieni swoj? bie??c? lokalizacj? na t? okre?lon? 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=/opt/myscripts |