10 Agent Zabbix w systemie Microsoft Windows

Konfiguracja agenta

Obie generacje agentów Zabbix działają jako usługa Windows. Dla Zabbix agent 2, zamień agentd na agent2 w poniższych instrukcjach.

Możesz uruchomić jedną instancję agenta Zabbix lub wiele instancji agenta na hoście Microsoft Windows. Pojedyncza instancja może używać domyślny plik konfiguracyjny C:\zabbix_agentd.conf lub pliku konfiguracyjnego określonego w wierszu poleceń. W przypadku wielu instancji każda instancja agenta musi mieć swój własny plik konfiguracyjny (jedna z instancji może używać domyślnego pliku konfiguracyjnego).

Przykładowy plik konfiguracyjny jest dostępny w archiwum źródłowym Zabbix jako conf/zabbix_agentd.win.conf.

Zapoznaj się z opcjami pliku konfiguracyjnego aby uzyskać szczegółowe informacje na temat konfiguracji agenta Zabbix dla Windows.

Parametr Hostname

Aby wykonywać aktywne sprawdzenie na hoście, agent Zabbix musi mieć zdefiniowaną nazwę hosta. Ponadto wartość nazwy hosta ustawionej po stronie agenta powinna dokładnie odpowiadać "Nazwie hosta" skonfigurowanej dla hosta w frontendzie.

Wartość nazwy hosta po stronie agenta można zdefiniować za pomocą parametrów Hostname lub HostnameItem w pliku konfiguracyjnym agenta - lub używane są wartości domyślne, jeśli którykolwiek z tych parametrów nie jest określony.

Domyślną wartością parametru HostnameItem jest wartość zwrócona przez klucz agenta "system.hostname". Dla systemów Windows zwraca wynik funkcji gethostname(), która zapytuje dostawców przestrzeni nazw, aby określić lokalną nazwę hosta. Jeśli żaden dostawca przestrzeni nazw nie odpowie, zwracana jest nazwa NetBIOS.

Domyślną wartością dla Hostname jest wartość zwrócona przez parametr HostnameItem. W efekcie, jeśli oba te parametry nie są określone, rzeczywista nazwa hosta będzie nazwą hosta NetBIOS; agent Zabbix użyje nazwy hosta NetBIOS do pobrania listy aktywnych sprawdzeń z serwera Zabbix i wysłania wyników do niego.

Klucz "system.hostname" obsługuje dwa opcjonalne parametry - type i transform.

Parametr type określa typ nazwy, którą element powinien zwrócić. Obsługiwane wartości:

• netbios (domyślnie) - zwraca nazwę hosta NetBIOS, która jest ograniczona do 15 symboli i składa się tylko z WIELKICH LITER;
• host - rozróżnia wielkość liter, zwraca pełną, rzeczywistą nazwę hosta systemu Windows (bez domeny);
• shorthost (obsługiwane od wersji Zabbix 5.4.7) - zwraca część nazwy hosta przed pierwszą kropką. Zwróci pełny ciąg, jeśli nazwa nie zawiera kropki.

Parametr transform jest obsługiwany od wersji Zabbix 5.4.7 i pozwala na określenie dodatkowej reguły transformacji dla nazwy hosta. Obsługiwane wartości:

• none (domyślnie) - użyj oryginalnego układu liter;
• lower - przekonwertuj tekst na małe litery.

Aby uprościć konfigurację pliku zabbix_agentd.conf i sprawić, żeby była spójna, można zastosować dwa różne podejścia.

1. pozostaw Hostname lub HostnameItem niezdefiniowane, a agent Zabbix będzie używał nazwy hosta NetBIOS jako nazwy hosta;
2. pozostaw Hostname niezdefiniowany i zdefiniuj HostnameItem w ten sposób:
   HostnameItem=system.hostname[host] - aby agent Zabbix używał pełnej, rzeczywistej (z uwzględnieniem wielkości liter) nazwy hosta systemu Windows jako nazwy hosta
   HostnameItem=system.hostname[shorthost,lower] - aby agent Zabbix używał tylko części nazwy hosta przed pierwszą kropką, przekonwertowanej na małe litery.

Nazwa hosta jest również używana jako część nazwy usługi systemowej Windows, która jest używana do instalacji, uruchamiania, zatrzymywania i odinstalowywania usługi Windows. Na przykład, jeśli plik konfiguracyjny agenta Zabbix określa Hostname=Windows_db_server, agent zostanie zainstalowany jako usługa Windows "Zabbix Agent [Windows_db_server]". Dlatego też, aby każda instancja agenta Zabbix miała inną nazwę usługi Windows, każda instancja musi używać innej nazwy hosta.

Instalowanie agenta jako usługi Windows

Aby zainstalować pojedynczą instancję agenta Zabbix z domyślnym plikiem konfiguracyjnym c:\zabbix_agentd.conf:

zabbix_agentd.exe --install

Jeśli chcesz użyć innego pliku konfiguracyjnego niż c:\zabbix_agentd.conf, powinieneś użyć następującego polecenia do instalacji usługi:

zabbix_agentd.exe --config <twój_plik_konfiguracyjny> --install

Należy podać pełną ścieżkę do pliku konfiguracyjnego.

Wiele instancji agenta Zabbix można zainstalować jako usługi w ten sposób:

  zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_1> --install --multiple-agents
         zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_2> --install --multiple-agents
         ...
         zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_N> --install --multiple-agents

Zainstalowana usługa powinna być teraz widoczna w Panelu sterowania.

Uruchamianie agenta

Aby uruchomić usługę agenta, możesz użyć Panelu sterowania lub wykonać to z wiersza poleceń.

Aby uruchomić pojedynczą instancję agenta Zabbix z domyślnym plikiem konfiguracyjnym:

 zabbix_agentd.exe --start

Aby uruchomić pojedynczą instancję agenta Zabbix z innym plikiem konfiguracyjnym:

 zabbix_agentd.exe --config <twój_plik_konfiguracyjny> --start

Aby uruchomić jedną z wielu instancji agenta Zabbix:

 zabbix_agentd.exe --config <plik_konfiguracyjny_dla_tej_instancji> --start --multiple-agents

Zatrzymywanie agenta

Aby zatrzymać usługę agenta, możesz użyć Panelu sterowania lub wykonać to z wiersza poleceń.

Aby zatrzymać pojedynczą instancję agenta Zabbix uruchomioną z domyślnym plikiem konfiguracyjnym:

 zabbix_agentd.exe --stop

Aby zatrzymać pojedynczą instancję agenta Zabbix uruchomioną z innym plikiem konfiguracyjnym:

 zabbix_agentd.exe --config <twój_plik_konfiguracyjny> --stop

Aby zatrzymać jedną z wielu instancji agenta Zabbix:

 zabbix_agentd.exe --config <plik_konfiguracyjny_dla_tej_instancji> --stop --multiple-agents

Odinstalowywanie usługi agenta Windows

Aby odinstalować pojedynczą instancję agenta Zabbix przy użyciu domyślnego pliku konfiguracyjnego:

   zabbix_agentd.exe --uninstall

Aby odinstalować pojedynczą instancję agenta Zabbix przy użyciu niestandardowego pliku konfiguracyjnego:

   zabbix_agentd.exe --config <twój_plik_konfiguracyjny> --uninstall

Aby odinstalować wiele instancji agenta Zabbix z usług systemowych Windows:

  zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_1> --uninstall --multiple-agents
         zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_2> --uninstall --multiple-agents
         ...
         zabbix_agentd.exe --config <plik_konfiguracyjny_dla_instancji_N> --uninstall --multiple-agents

Ograniczenia

Agent Zabbix dla systemu Windows nie obsługuje niestandardowych konfiguracji systemowych, w których procesory są rozłożone nierównomiernie między węzłami NUMA. Jeśli logiczne procesory są rozłożone nierównomiernie, metryki wydajności procesora mogą nie być dostępne dla niektórych procesorów. Na przykład, jeśli istnieją 72 logiczne procesory z 2 węzłami NUMA, oba węzły muszą mieć po 36 procesorów każdy.