Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

4 Áú»¢¶Ä²© agent 2 (UNIX)

Przegl?d

Áú»¢¶Ä²© 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:

  • Domy?lne warto?ci odzwierciedlaj? domy?lne warto?ci procesu, a nie warto?ci w dostarczonych plikach konfiguracyjnych;
  • Áú»¢¶Ä²© obs?uguje pliki konfiguracyjne tylko w kodowaniu UTF-8, bez ;
  • Komentarze rozpoczynaj?ce si? od "#" s? obs?ugiwane tylko na pocz?tku linii.

Parametry

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