Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

10 Zabbix агент 2 на Microsoft Windows

Настройка агента

Zabbix агент 2 работает как служба Windows.

Вы можете запустить один экземпляр Zabbix агент 2 или несколько экземпляров агента на узле сети Microsoft Windows. Один экземпляр может использовать файл конфигурации по умолчанию C:\zabbix_agent2.conf или файл конфигурации, указанный в командной строке. В случае нескольких экземпляров, каждый экземпляр агента должен иметь свой собственный файл конфигурации (один из экземпляров может использовать файл конфигурации по умолчанию).

Пример файла конфигурации доступен в исходном архиве Zabbix как conf/zabbix_agent2.win.conf.

См. параметры файла конфигурации для получения подробной информации о настройке Zabbix агента 2 на Windows.

Zabbix агент для Windows не поддерживает нестандартные конфигурации Windows, в которых процессоры неравномерно распределены по узлам NUMA. Если логические ЦП распределены неравномерно, то для некоторых ЦП показатели производительности ЦП могут быть недоступны. Например, если имеется 72 логических процессора с 2 узлами NUMA, у каждого из узлов должно быть по 36 процессоров.

Параметр Hostname

Чтобы производить активные проверки на узле сети, в настройках Zabbix агента 2 должно быть определено имя узла сети. Более того, значение имени узла сети, установленное на стороне агента, должно точно соответствовать значению, заданному для узла сети в веб-интерфейсе в поле "Имя узла сети" .

Значение имени узла сети на стороне агента может быть определено параметром Hostname или HostnameItem в конфигурационном файле агента - если какой-либо из этих параметров не указан, используются значения по умолчанию.

Значение по умолчанию для параметра HostnameItem - это значение, возвращаемое ключом агента «system.hostname»; для платформы Windows оно возвращает имя узла сети NetBIOS.

Значение по умолчанию для Hostname - это значение, возвращаемое параметром HostnameItem. Таким образом, если оба этих параметра не указаны, фактическое имя узла сети будет именем NetBIOS; Zabbix агент 2 будет использовать имя NetBIOS для получения списка активных проверок с сервера Zabbix и отправки ему результатов.

Ключ system.hostname всегда возвращает имя NetBIOS, которое ограничено 15 символами только В ВЕРХНЕМ РЕГИСТРЕ - независимо от длины и символов нижнего/верхнего регистра в реальном имени узла сети.

Ключ system.hostname[узел сети] всегда возвращает полное, реальное (с учетом регистра) имя хоста Windows.

Итак, чтобы упростить настройку файла zabbix_agent2.conf и сделать его унифицированным, можно использовать два разных подхода.

  1. не определять параметры Hostname и HostnameItem - Zabbix агент 2 будет использовать NetBIOS имя как имя узла сети;
  2. не определять параметр Hostname, но определить HostnameItem как в примере ниже:
    HostnameItem=system.hostname[host]
    и Zabbix агент 2 будет использовать полное, реальное (с учетом регистра) имя хоста Windows в качестве имени узла сети.

Имя узла сети также используется как часть имени службы Windows, которая используется для установки, запуска, остановки и удаления службы Windows. Например, если в файле конфигурации Zabbix агента 2 указано Hostname=Windows_db_server, то агент будет установлен как служба Windows Zabbix Agent [Windows_db_server]. Следовательно, чтобы иметь разное имя службы Windows для каждого экземпляра Zabbix агента, каждый экземпляр должен использовать другое имя узла сети.

Установка агента как службы Windows

Чтобы установить один экземпляр Zabbix агента 2 с файлом конфигурации по умолчанию c:\zabbix_agent2.conf:

zabbix_agent2.exe --install

В 64-битной системе требуется 64-битная версия Zabbix агента для правильной работы всех проверок, связанных с запуском 64-битных процессов.

Если вы хотите использовать файл конфигурации, отличный от c:\zabbix_agent2.conf, вы должны использовать следующую команду для установки службы:

zabbix_agent2.exe --config <your_configuration_file> --install

Необходимо указать полный путь к файлу конфигурации.

Несколько экземпляров Zabbix агента 2 могут быть установлены в качестве служб следующим образом:

  zabbix_agent2.exe --config <configuration_file_for_instance_1> --install --multiple-agents
         zabbix_agent2.exe --config <configuration_file_for_instance_2> --install --multiple-agents
         ...
         zabbix_agent2.exe --config <configuration_file_for_instance_N> --install --multiple-agents

Установленная служба должна теперь отображаться в Панели управления.

Запуск агента

Чтобы запустить службу агента, вы можете использовать Панель управления или сделать это из командной строки.

Чтобы запустить единственный экземпляр Zabbix агента 2 с файлом конфигурации по умолчанию:

 zabbix_agent2.exe --start

Чтобы запустить единственный экземпляр Zabbix агента 2 с другим файлом конфигурации:

 zabbix_agent2.exe --config <your_configuration_file> --start

Чтобы запустить один из нескольких экземпляров Zabbix агента 2:

 zabbix_agent2.exe --config <configuration_file_for_this_instance> --start --multiple-agents

Остановка агента

Чтобы остановить службу агента, вы можете использовать Панель управления или сделать это из командной строки.

Чтобы остановить единственный экземпляр Zabbix агента 2, запущенного с файлом конфигурации по умолчанию:

 zabbix_agent2.exe --stop

Чтобы остановить единственный экземпляр Zabbix агента 2, запущенный с другим файлом конфигурации:

 zabbix_agent2.exe --config <your_configuration_file> --stop

Чтобы остановить один из нескольких экземпляров Zabbix агента 2:

 zabbix_agent2.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

Удаление агента из служб Windows

Чтобы удалить единственный экземпляр Zabbix агента 2 с использованием файла конфигурации по умолчанию:

   zabbix_agent2.exe --uninstall

Чтобы удалить единственный экземпляр Zabbix агента 2, использующий нестандартный файл конфигурации:

   zabbix_agent2.exe --config <your_configuration_file> --uninstall

Чтобы удалить несколько экземпляров Zabbix агента 2 из служб Windows:

  zabbix_agent2.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents
         zabbix_agent2.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents
         ...
         zabbix_agent2.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents