Documentation
Table of Contents
2 Agent
Przegl?d
Agent Áú»¢¶Ä²© jest wdra?any na monitorowanym obiekcie, aby na bie??co monitorowa? lokalne zasoby i aplikacje (dyski twarde, pami?c, statystyki procesora itp).
Agent zbiera informacje operacyjne lokalnie i przekazuje dane do serwera Áú»¢¶Ä²© w celu dalszego przetwarzania. W przypadku b??du (takich jak przepe?niony twardy dysk lub proces us?ugi uleg? awarii), serwer Áú»¢¶Ä²© server mo?e aktywnie alarmowa? administrator¨®w maszyny, kt¨®ra zg?osi?a b??dy.
Agenci Áú»¢¶Ä²© s? niezwykle wydajni dzi?ki zastosowaniu natywnych wywo?a¨½ systemowych do zbierania informacji statystycznych.
Sprawdzenia pasywne i aktywne
Agenci Áú»¢¶Ä²© mog? wykonywa? sprawdzenia pasywne i aktywne.
Przy sprawdzeniach pasywnych agent odpowiada na zapytanie o dane. Serwer Áú»¢¶Ä²© (lub proxy) pyta o dane, na przyk?ad, obci??enie CPU, a agent Áú»¢¶Ä²© odsy?a wynik.
Aktywne sprawdzenia wymagaj? bardziej z?o?onego przetwarzania.Agent najpierw musi pobra? list? pozycji z serwera Áú»¢¶Ä²© w celu niezale?nego przetworzenia. Nast?pnie okresowo wysy?a nowe warto?ci do serwera.
To, czy przeprowadza? testy pasywne, czy aktywne, konfiguruje si?, wybieraj?c odpowiedni typ pozycji. Agent Áú»¢¶Ä²© przetwarza elementy typu 'Agent Áú»¢¶Ä²©' lub 'Agent Áú»¢¶Ä²© (aktywny)'.
Wspierane platformy
Agent Áú»¢¶Ä²© jest obs?ugiwany na nast?puj?cych platformach:
- Windows (wszystkie wersje desktopowe i serwerowe od XP)
- Linux (dost?pny r¨®wnie? w pakietach dystrybucyjnych)
- macOS
- IBM AIX
- FreeBSD
- OpenBSD
- Solaris
Mo?liwe jest r¨®wnie? pobranie starszych plik¨®w binarnych agenta Áú»¢¶Ä²© dla NetBSD i HP-UX, kt¨®re s? kompatybilne z aktualn? wersj? serwera/proxy Áú»¢¶Ä²©.
Agent w systemach typu UNIX
Agent Áú»¢¶Ä²© w systemach typu UNIX jest uruchamiany na monitorowanym ho?cie.
Instalacja
Zobacz sekcj? instalacji pakietu, aby dowiedzie? si?, jak zainstalowa? agenta Áú»¢¶Ä²© jako pakiet.
Alternatywnie zobacz instrukcje dotycz?ce instalacji r?cznej,je?li nie chcesz u?ywa? pakiet¨®w.
Og¨®lnie, 32-bitowy agent Áú»¢¶Ä²© b?dzie dzia?a? na systemach 64-bitowych, ale mog? w pewnych sytuacjach wyst?pi? b??dy.
Je?li zainstalowano jako pakiet
Agent Áú»¢¶Ä²© dzia?a jako proces demona. Agenta mo?na uruchomi? przez wykonanie:
B?dzie to dzia?a? na wi?kszo?ci system¨®w GNU/Linux. W innych systemach mo?e by? konieczne uruchomienie:
Podobnie, aby zatrzyma?/restartowa?/wy?wietli? status agenta Áú»¢¶Ä²©, nale?y u?y? nast?puj?cych polece¨½:
Uruchomienie r?cznie
Je?li powy?sza komenda nie dzia?a, musisz uruchomi? go r?cznie. Znajd? ?cie?k? do pliku binarnego zabbix_agentd i wykonaj:
Agent na systemach Windows
Agent Áú»¢¶Ä²© w systemie Windows dzia?a jako us?uga Windows.
Przygotowanie
Agent Áú»¢¶Ä²© jest dystrybuowany jako archiwum zip. Po pobraniu pliku archiwum musisz go rozpakowa?. Wybierz dowolny folder do przechowywania agenta Áú»¢¶Ä²© i pliku konfiguracyjnego, np.
Skopiuj pliki bin\zabbix_agentd.exe i conf\zabbix_agentd.conf do c:\zabbix.
Dostosuj plik c:\zabbix\zabbix_agentd.conf do swoich potrzeb, pami?taj?c o okre?leniu poprawnego parametru "Hostname".
Instalacja
Po wykonaniu tej czynno?ci u?yj nast?puj?cego polecenia, aby zainstalowa? agenta Áú»¢¶Ä²© jako us?ug? Windows:
Teraz powiniene? by? w stanie skonfigurowa? us?ug? "Agent Áú»¢¶Ä²©" jak ka?d? inn? us?ug? Windows.
Zobacz wi?cej szczeg¨®?¨®w o instalowaniu i uruchamianiu agenta Áú»¢¶Ä²© w systemie Windows.
#### Inne opcje agenta
Mo?liwe jest uruchomienie wielu instancji agenta na ho?cie. Pojedyncza instancja mo?e u?ywa? domy?lnego pliku konfiguracyjnego lub pliku konfiguracyjnego okre?lonego w wierszu polece¨½. W przypadku wielu instancji ka?da instancja agenta musi posiada? w?asny plik konfiguracyjny (jedna z instancji mo?e korzysta? z domy?lnego pliku konfiguracyjnego).
Z agentem Áú»¢¶Ä²© mo?na u?ywa? nast?puj?cych parametr¨®w wiersza polece¨½:
| Parametr | Opis |
|---|---|
| Agent dla system¨®w UNIX i Windows | |
| -c --config <plik-konfiguracyjny> | ?cie?ka do pliku konfiguracyjnego. Mo?esz u?y? tej opcji, aby okre?li? plik konfiguracyjny inny ni? |
| domy?lny. W systemie UNIX domy?lnym jest /usr/local/etc/zabbix_agentd.conf lub ustawiony podczas kompilacji zmiennymi --sysconfdir lub --prefix W systemie Windows, domy?lna warto?? to c:\zabbix_agentd.conf |
|
| -p --print | Wy?wietla znane pozycje i ko¨½czy dzia?anie. Uwaga: ?eby uzyska? r¨®wnie? parametry u?ytkownika, nale?y okre?li? plik konfiguracji (je?eli nie jest w domy?lnej lokalizacji). |
| -t --test <klucz pozycji> | Testuje okre?lon? pozycj? i ko¨½czy dzia?anie. Uwaga: ?eby uzyska? r¨®wnie? parametry u?ytkownika, nale?y okre?li? plik konfiguracji (je?eli nie jest w domy?lnej lokalizacji). |
| -h --help | Wy?wietla informacje pomocy |
| -V --version | Wy?wietla numer wersji |
| Tylko agent UNIX | |
| -R --runtime-control <opcje> | Wykonywanie funkcji administracyjnych. Zobacz [opcje kontroli dzia?ania(/manual/concepts/agent#runtime_control). |
| Tylko agent Windows | |
| -m --multiple-agents | U?yj wielu instancji agenta (z funkcjami -i, -d, -s, -x). Aby rozr¨®?ni? nazwy us?ug instancji, ka?da nazwa us?ugi b?dzie zawiera? warto?? nazwy hosta z okre?lonego pliku konfiguracyjnego. |
| Tylko agent Windows (funkcje) | |
| -i --install | Zainstaluj agenta Áú»¢¶Ä²© Windows jako us?ug? |
| -d --uninstall | Odinstaluj us?ug? agenta Áú»¢¶Ä²© Windows |
| -s --start | Uruchom us?ug? agenta Áú»¢¶Ä²© Windows |
| -x --stop | Zatrzymaj us?ug? agenta Áú»¢¶Ä²© Windows |
Konkretne przyk?ady u?ycia parametr¨®w wiersza polece¨½:
- wy?wietlanie wszystkich wbudowanych pozycji agenta z warto?ciami
- testowanie parametr¨®w u?ytkownika kluczem "mysql.ping" zdefiniowanym w okre?lonym pliku konfiguracji
- instalowanie us?ugi "Áú»¢¶Ä²© Agent" dla Windows przy u?yciu domy?lnej ?cie?ki do pliku konfiguracji c:\zabbix_agentd.conf
- instalowanie us?ugi "Áú»¢¶Ä²© Agent [Hostname]" dla Windows przy u?yciu pliku konfiguracji zabbix_agentd.conf umieszczonego w tym samym katalogu co plik wykonywalny agenta oraz utworzenie unikalnej nazwy uslugi przez rozszerzenie jej nazwy o warto?? Hostname z pliku konfiguracji
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.confKontrola dzia?ania
Dzi?ki opcjom kontroli dzia?ania mo?esz zmieni? poziom logowania proces¨®w agenta.
| Opcja | Opis | Cel |
|---|---|---|
| log_level_increase[=<cel>] | Zwi?ksz poziom logowania. Je?li cel nie jest okre?lony, dotyczy to wszystkich proces¨®w. |
Cel mo?na okre?li? jako: typ procesu - wszystkie procesy okre?lonego typu (np. listener) Zobacz wszystkie typy proces¨®w agenta. typ procesu,N - typ i numer procesu (np. listener,3) pid - identyfikator procesu (od 1 do 65535). W przypadku wi?kszych warto?ci okre?l cel jako "typ procesu,N". |
| log_level_decrease[=<cel>] | Zmniejsz poziom logowania. Je?li cel nie jest okre?lony, dotyczy to wszystkich proces¨®w. |
|
| userparameter_reload | Prze?aduj warto?ci opcji UserParameter i Include z bie??cego pliku konfiguracyjnego. |
Przyk?ady:
- zwi?kszenie poziomu logowania wszystkich proces¨®w
- zwi?kszenie poziomu logowania trzeciego procesu listener
- zwi?kszenie poziomu logowania procesu z PID 1234
- zmniejszanie poziomu logowania wszystkich proces¨®w active checks
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"Kontrola dzia?ania nie jest obs?ugiwana w systemach OpenBSD, NetBSD i Windows.
Typy proces¨®w agenta
active checks- proces do wykonywania sprawdze¨½ aktywnychcollector- proces zbierania danychlistener- proces nas?uchiwania dla sprawdze¨½ pasywnych
Plik logu agenta mo?e s?u?y? do obserwowania tych typ¨®w proces¨®w.
U?ytkownik procesu
Agent Áú»¢¶Ä²© w systemach UNIX jest przeznaczony do uruchamiania jako u?ytkownik inny ni? root. B?dzie dzia?a? jako ka?dy nieuprzywilejowany u?ytkownik, z kt¨®rym zosta? uruchomiony. W ten spos¨®b mo?esz uruchomi? agenta jako dowolny nieuprzywilejowany u?ytkownik bez ?adnych problem¨®w.
Je?li spr¨®bujesz uruchomi? agenta jako 'root', natychmiast prze??czy si? on na u?ytkownika 'zabbix', kt¨®ry musi by? obecny w twoim systemie. Jedynym sposobem uruchomienia agenta jako u?ytkownik "root" jest edycja parametru "AllowRoot" w pliku konfiguracyjnym agenta.
Plik konfiguracyjny
Aby uzyska? szczeg¨®?owe informacje na temat konfigurowania agenta Áú»¢¶Ä²©, zobacz opcje pliku konfiguracyjnego dla zabbix_agentd lub agenta Windows.
Ustawienia regionalne
Nale?y zauwa?y?, ?e agent wymaga ustawie¨½ regionalnych UTF-8, aby niekt¨®re elementy danych tekstowych agenta mog?y zwraca? poprawn? tre??. Wi?kszo?? nowoczesnych system¨®w typu Unix ma domy?lnie ustawione ustawienia regionalne UTF-8, jednak istniej? systemy, w kt¨®rych nale?y to ustawi? r?cznie.
Kod wyj?cia
Przed wersj? 2.2 agent Áú»¢¶Ä²© zwraca? 0 w przypadku sukcesu? i 255 w przypadku b??du. Pocz?wszy od Áú»¢¶Ä²© 2.2 i nowszych agent Áú»¢¶Ä²© zwraca kod 0 w przypadku p?ynnego zako¨½czenia procesu i kod 1 w przypadku niepowodzenia.