[comment]: # ({50c00f1f-9884b1d2}) # 11 Агент Zabbix в Microsoft Windows [comment]: # ({/50c00f1f-9884b1d2}) [comment]: # ({9134e90f-bc82b50c}) #### Настройка агента Оба поколения агентов Zabbix работают как служба Windows. Для Zabbix agent 2 замените *agentd* на *agent2* в приведенных ниже инструкциях. Вы можете запускать один экземпляр агента Zabbix или несколько экземпляров агента на узле сети Microsoft Windows. Один экземпляр может использовать либо: - файл конфигурации по умолчанию, расположенный в том же каталоге, что и исполняемый файл агента; - файл конфигурации, указанный в командной строке. В случае нескольких экземпляров каждый экземпляр агента должен иметь свой собственный файл конфигурации (один из экземпляров может использовать файл конфигурации по умолчанию). Пример файла конфигурации доступен в архиве исходного кода Zabbix как: - `conf/zabbix_agentd.conf` для Zabbix agent; - `conf/zabbix_agent2.conf` для Zabbix agent2. Если вы хотите установить Zabbix agent/agent 2 для Windows как службу из [архива](https://www.zabbix.com/download_agents) без явного указания файла конфигурации, то перед установкой агента: - `conf/zabbix_agentd.conf` следует вручную скопировать в каталог, где будет установлен zabbix_agentd.exe; - `conf/zabbix_agent2.conf` и каталог `conf/zabbix_agent2.d` следует вручную скопировать в каталог, где будет установлен zabbix_agent2.exe. Подробные сведения о настройке агента Zabbix для Windows см. в разделе [файл конфигурации](/manual/appendix/config/zabbix_agentd_win). [comment]: # ({/9134e90f-bc82b50c}) [comment]: # ({5f456a33-011f29f0}) ##### Параметр Hostname Для выполнения [активных проверок](/manual/appendix/items/activepassive#active-checks) на узле сети агенту Zabbix необходимо, чтобы имя узла было определено. Более того, значение имени узла, заданное на стороне агента, должно в точности совпадать с "[Host name](/manual/config/hosts/host)", настроенным для узла сети в веб-интерфейсе. Значение имени узла на стороне агента может быть задано с помощью параметра **Hostname** или **HostnameItem** в [файле конфигурации](/manual/appendix/config/zabbix_agentd_win) агента, либо будут использованы значения по умолчанию, если какой-либо из этих параметров не указан. Значением по умолчанию для параметра **HostnameItem** является значение, возвращаемое ключом агента "system.hostname". В Windows он возвращает результат функции gethostname(), которая опрашивает поставщиков пространства имен для определения имени локального узла. Если ни один поставщик пространства имен не отвечает, возвращается имя NetBIOS. Значением по умолчанию для **Hostname** является значение, возвращаемое параметром HostnameItem. Таким образом, если оба этих параметра не указаны, фактическим именем узла будет имя узла NetBIOS; агент Zabbix будет использовать имя узла NetBIOS для получения списка активных проверок с сервера Zabbix и отправки ему результатов. Ключ "system.hostname" поддерживает два необязательных параметра — *type* и *transform*. *Type* определяет тип имени, которое должен возвращать элемент данных: - *netbios* (по умолчанию) — возвращает имя узла NetBIOS, ограниченное 15 символами и только в ВЕРХНЕМ РЕГИСТРЕ; - *host* — с учетом регистра, возвращает полное реальное имя узла Windows (без домена); - *shorthost* — возвращает часть имени узла до первой точки. Если имя не содержит точки, будет возвращена полная строка. - *fqdn* — возвращает полное доменное имя (Fully Qualified Domain Name) без завершающей точки. *Transform* позволяет указать дополнительное правило преобразования для имени узла: - *none* (по умолчанию) — использовать исходный регистр букв; - *lower* — преобразовать текст в нижний регистр. Таким образом, чтобы упростить настройку файла zabbix\_agentd.conf и сделать ее унифицированной, можно использовать три различных подхода: 1. Оставить параметры **Hostname** или **HostnameItem** неопределенными, и агент Zabbix будет использовать имя узла NetBIOS в качестве имени узла. 2. Оставить параметр **Hostname** неопределенным и задать **HostnameItem** следующим образом:
**HostnameItem=system.hostname\[host\]** — чтобы агент Zabbix использовал полное реальное имя узла Windows (с учетом регистра) в качестве имени узла.
**HostnameItem=system.hostname\[shorthost,lower\]** — чтобы агент Zabbix использовал только часть имени узла до первой точки, преобразованную в нижний регистр.
**HostnameItem=system.hostname\[fqdn\]** — чтобы агент Zabbix использовал полное доменное имя в качестве имени узла. Имя узла также используется как часть имени службы Windows, которое применяется для установки, запуска, остановки и удаления службы Windows. Например, если в файле конфигурации агента Zabbix указано `Hostname=Windows_db_server`, то агент будет установлен как служба Windows "`Zabbix Agent [Windows_db_server]`". Поэтому, чтобы у каждого экземпляра агента Zabbix было свое имя службы Windows, каждый экземпляр должен использовать свое имя узла. [comment]: # ({/5f456a33-011f29f0}) [comment]: # ({0c3a3ff4-1c178c2a}) #### Установка агента как службы Windows Перед установкой агента вручную скопируйте `conf/zabbix_agentd.conf` в каталог, где будет установлен zabbix_agentd.exe. Чтобы установить один экземпляр Zabbix агент с файлом конфигурации по умолчанию: zabbix_agentd.exe --install ::: noteimportant В 64-разрядной системе для корректной работы всех проверок, связанных с запущенными 64-разрядными процессами, требуется 64-разрядная версия Zabbix агента. ::: Если вы хотите использовать файл конфигурации, отличный от файла по умолчанию, для установки службы следует использовать следующую команду: zabbix_agentd.exe --config --install Необходимо указать полный путь к файлу конфигурации. Несколько экземпляров Zabbix агента можно установить как службы следующим образом: zabbix_agentd.exe --config --install --multiple-agents zabbix_agentd.exe --config --install --multiple-agents ... zabbix_agentd.exe --config --install --multiple-agents Установленная служба теперь должна отображаться в Панели управления. [comment]: # ({/0c3a3ff4-1c178c2a}) [comment]: # ({635edc59-635edc59}) #### Запуск агента Чтобы запустить службу агента, вы можете использовать Панель управления или сделать это из командной строки. Чтобы запустить один экземпляр Zabbix агента с файлом конфигурации по умолчанию: zabbix_agentd.exe --start Чтобы запустить один экземпляр Zabbix агента с другим файлом конфигурации: zabbix_agentd.exe --config --start Чтобы запустить один из нескольких экземпляров Zabbix агента: zabbix_agentd.exe --config --start --multiple-agents [comment]: # ({/635edc59-635edc59}) [comment]: # ({f3f0d3db-f3f0d3db}) #### Остановка агента Чтобы остановить службу агента, вы можете использовать Панель управления или сделать это из командной строки. Чтобы остановить один экземпляр Zabbix агента, запущенный с файлом конфигурации по умолчанию: zabbix_agentd.exe --stop Чтобы остановить один экземпляр Zabbix агента, запущенный с другим файлом конфигурации: zabbix_agentd.exe --config --stop Чтобы остановить один из нескольких экземпляров Zabbix агента: zabbix_agentd.exe --config --stop --multiple-agents [comment]: # ({/f3f0d3db-f3f0d3db}) [comment]: # ({db2e6708-db2e6708}) #### Удаление службы Windows агента Чтобы удалить один экземпляр агента Zabbix, используя файл конфигурации по умолчанию: zabbix_agentd.exe --uninstall Чтобы удалить один экземпляр агента Zabbix, используя файл конфигурации не по умолчанию: zabbix_agentd.exe --config --uninstall Чтобы удалить несколько экземпляров агента Zabbix из служб Windows: zabbix_agentd.exe --config --uninstall --multiple-agents zabbix_agentd.exe --config --uninstall --multiple-agents ... zabbix_agentd.exe --config --uninstall --multiple-agents [comment]: # ({/db2e6708-db2e6708}) [comment]: # ({dec5f8ea-b7b226d1}) #### Ограничения Агент Zabbix для Windows не поддерживает нестандартные конфигурации Windows, в которых процессоры распределены по NUMA-узлам неравномерно. Если логические процессоры распределены неравномерно, то метрики производительности ЦП могут быть недоступны для некоторых процессоров. Например, если имеется 72 логических процессора и 2 NUMA-узла, то на каждом узле должно быть по 36 процессоров. [comment]: # ({/dec5f8ea-b7b226d1})