Установка Zabbix agent на Windows
В нашем примере мы установим агент для Zabbix на Windows в качестве службы, а также сделаем минимальную настройку для отправки данных на сервер.
Загрузка агента
Переходим на страницу загрузки агента Zabbix и выбираем платформу операционной системы (x32 или x64) и версию агента, например:
* помимо этого, мы можем выбрать вариант дистрибутива: с использованием шифрования или нет, а также файл установки — msi пакет или архив. В данном примере мы выбрали версию 5.
В зависимости от выбранных критериев поиска агента, ниже мы можем увидеть несколько вариантов для загрузки. Находим нужный и кликаем по DOWNLOAD для скачивания файла:
Ждем окончания загрузки и переходим к установке.
Установка агента
В зависимости от загрузки типа пакета (MSI или архив) будут разные методы установки. Рассмотрим оба.
Установка из MSI-пакета
Это удобный вариант, который позволит установить агента с помощью мастера. Чтобы начать, кликаем дважды по скачанному пакету и в окне приветствия нажимаем Next:
Принимаем лицензионное соглашение, установив галочку I accept the terms in the License Agreement и нажимаем Next:
В следующем окне оставляем имя компьютера, на который устанавливается агент и вводим имя или IP-адрес сервера zabbix, после кликаем по Next:
* в данном примере имя нашего компьютера Windows PC, а сервера — zabbix-server.dmosk.local.
Выбираем компоненты, которые хотим установить — можно просто оставить все по умолчанию и нажимаем Next:
Подтверждаем установку, кликая по Install:
Ждем завершения процесса — агент установлен.
Установка из архива
Данный метод требует дополнительных манипуляций, но с его помощью можно автоматизировать процесс. Мы рассмотрим только установку.
Распаковываем содержимое скачанного архива в каталог, где будут находиться файлы программы, например в C:\Program Files\Zabbix Agent. В итоге, у нас получится:
Открываем WordPad от администратора и в нем открываем конфигурационный файл conf/zabbix_agentd.conf и правим опцию для сервера zabbix — находим строку:
* где zabbix-server.dmosk.local — имя сервера Zabbix.
Теперь открываем командную строку от администратора и выполняем команду для установки агента:
«C:\Program Files\Zabbix Agent\bin\zabbix_agentd.exe» —config «C:\Program Files\Zabbix Agent\conf\zabbix_agentd.conf» —install
* где C:\Program Files\Zabbix Agent — папка, куда мы распаковали архив.
Мы должны увидеть что-то на подобие:
zabbix_agentd.exe [468]: service [Zabbix Agent] installed successfully
zabbix_agentd.exe [468]: event source [Zabbix Agent] installed successfully
Теперь открываем службы Windows и находим «Zabbix Agent» — кликаем по ней правой кнопкой мыши и выбираем Запустить:
Настройка брандмауэра
Если в нашей системе работает брандмауэр Windows, необходимо разрешить порт 10050 или приложение zabbix agent.
Для этого переходим в Панель управления — Система и безопасность — Брандмауэр Windows (или вводим команду control /name Microsoft.WindowsFirewall). Кликаем по ссылке Разрешение взаимодействия с приложением или компонентов в брандмауэре Windows — добавляем наше приложение zabbix_agentd в исключение.
Это же действие можно выполнить в powershell — запускаем ее от администратора и вводим команду:
New-NetFirewallRule -DisplayName «Разрешить приложение Zabbix Agent» -Direction Inbound -Action Allow -EdgeTraversalPolicy Allow -Program «C:\Program Files\Zabbix Agent\bin\zabbix_agentd.exe»
Или мы можем добавить в исключение порт. Это можно сделать также из командной строки poweshell:
New-NetFirewallRule -DisplayName «Разрешить порт 10050 для Zabbix» -Direction Inbound -Action Allow -EdgeTraversalPolicy Allow -Protocol TCP -LocalPort 10050
Проверка работы
Чтобы убедиться в работоспособности агента, мы можем зайти на сервер zabbix и выполнить подключение по telnet, например, командой:
telnet 192.168.1.15 10050
* где 192.168.1.15 — IP-адрес компьютера с установленным Zabbix.
Connected to nr-fs-06.
Escape character is ‘^]’.
.. и через небольшой интервал времени:
Connection closed by foreign host.
Но если агент не запущен или не работает, мы увидим ошибку:
telnet: connect to address . Connection refused
В панели сервера в узлах сети при корректной установке и настройке, мы также должны увидеть доступность компьютера по агенту:
Установка Zabbix-агента для Windows.
Установку агента Zabbix можно выполнить как стандартным способом установки из дистрибутива, так и простым копированием файлов. Второй способ удобней в том случае, когда необходимо установить агента на большое количество клиентов. При этом придется отдельно добавлять службу для запуска агента, но и это решается одной командой в командной строке Windows.
Установка Zabbix-агента для Windows из дистрибутива.
На официальном сайте Zabbix.com доступен для скачивания установочный файл MSI и архив: https://www.zabbix.com/download_agents
Во время установки zabbix-агента из дистрибутива MSI потребуется указать следующую обязательную информацию, необходимую для взаимодействия агента с сервером:
- Host name — имя хоста (не обязательно должно совпадать с именем компьютера);
- Zabbix-server IP/DNS — ip-адрес либо имя Zabbix-сервера.
Следующую информацию можно оставить по умолчанию:
- Agent listen port — порт агента, стандартный 10050;
- Server or Proxy for active checks — адрес дополнительного прокси-сервера zabbix, если его нет оставляем 127.0.0.1;
- Remote command — разрешает агенту выполнять удаленные команды, заданные на сервере;
- Enable PSK — включает шифрование;
- Add agent location to the PAHT — указать директорию установки агента.
Так же вы можете увидеть предупреждение «Firewall exception rule will not be installed» — это значит, что в брандмауэре Windows порт 10050 придется открывать самостоятельно. Как это сделать через командную строку Windows смотрите в конце статьи.
Установка zabbix-агента на Windows путем копирования файлов.
Если предстоит установка zabbix-агента на множество хостов, то проще это сделать обычным копированием файлов агента на целевые хосты с последующим добавлением службы агента.
В папке zabbix-агента находятся три исполняемых файла .exe и один текстовый .conf.
- zabbix_agentd.exe — файл самого агента;
- zabbix_get.exe — утилита для подключения к агенту и получения от него информации, используется для проверки работы агента;
- zabbix_sender.exe — утилита для отправки данных о производительности Zabbix-серверу;
- zabbix_agentd.conf — файл настроек агента.
1. Выполняем настройку агента путем правки конфигурации в файле zabbix_agentd.conf.
Указываем имя хоста в параметре HOSTNAME.
Имена хостов должны быть абсолютно уникальными, потому-что Zabbix-сервер не даст создать 2 хоста с одинаковым именем.
Строка указывающая адрес Zabbix-сервера:
2. Добавляем службу zabbix-агента.
Через командную строку Windows можно добавить службу так:
3. Открываем порт 10050 для входящих соединений.
Все эти команды для запуска службы и настройки брандмауэра можно закинуть в один bat-файл и выполнять его после копирования файлов агента и настройки конфигурации.
Windows zabbix agent msi
Zabbix Agent MSI Installer
This project contains the files required to build a functional Microsoft Windows MSI package for the deployment of the Zabbix Windows Agent on both x64 and x86 platforms. Both platforms are built from the same project file and will only install on their target machine types as recommended by Zabbix.
The MSI package has been tested successfully on all Windows 2000+ platforms including Server 2003, 2008 and 2012 and may be deployed with services such as Active Directory Group Policy Package Deployment.
The package is defined in WiX XML document Zabbix Agent MSI Installer.wxs , and requires open source application WiX Toolset v3.8 and the Zabbix Windows agent binaries to be compiled successfully.
The build.cmd script was created for your convenience to build both the x86 and x64 MSI packages via WiX with the required command arguments. Alternatively, Visual Studio 2010 with Votive may be used to open and build from Zabbix Agent MSI Installer.sln .
See the links below to source the required components.
What gets installed
The following components are installed by the MSI package on a target system.
- Zabbix agent binaries including zabbix_agentd , zabbix_get and zabbix_sender
- Agent configuration file zabbix_agentd.win.conf
- Environment variable ZBX_AGENT_BASE which may be used to reference script paths in agent configuration
- Agent binaries and scripts folders are added to the PATH environment variable
- The agent service is installed and started ready for responding to Zabbix server queries
- Additional files that you may define (scripts, conf.d files, etc.)
By default, all components are installed to C:\Program Files\Zabbix Agent but this is configurable both at build and run-time.
The uninstall process of the MSI successfully cleans up all of the above components.
You may test the success of an agent install by calling the following from a command prompt:
How to build the MSI
- Install WiX Toolset
- Extract the contents of zabbix_agents_2.2.1.win.zip to the src/ subdirectory of this project
- Modify src/conf/zabbix_agentd.win.conf to meet your requirements on the target systems
- Add any custom scripts you wish to deploy with the agent to the src/scripts or src/scripts/include subdirectory
- Add custom scripts and other required components as XML definitions in Zabbix Agent MSI Installer.wxs
- Compile the MSI packages with build.cmd or from Visual Studio 2010 with Zabbix Agent MSI Installer.sln
To manually compile the package, see the contents of build.cmd for the required command arguments.
If you are building the agent binaries yourself or you wish to source them from an alternative path, modify the definition of SrcPath in Zabbix Agent MSI Installer.wxs .
Let’s take a look inside the wxs file to see how it all fits together. I’ll assume you have a basic understanding of XML, Windows Installer technologies and the WiX Toolset. Most of the file will be self explanatory with some knowledge of these components, so I’ll focus on the Zabbix specific components.
Preprocessor Variables
The following variables define the name of version of the agent to be install, as well as the relative path for the agent binaries.
The next section sets required variables according to the machine architecture being built. These variables define the MSI product name, install destination folder and agent binaries source path (for the correct architecture).
Prevent 32bit install on 64bit system
The Zabbix agent documentation recommends using the 64bit binaries on 64bit Windows systems. From experience I can tell you this is good because 32bit applications cannot access some system resources on 64bit Windows systems such as 64bit registry hives, the C:\Program Files folder, etc.
Prevent ‘Files in Use’ dialogue
Because the Zabbix agent runs as a service, when you attempt to upgrade or uninstall the MSI, Windows Installer will by default complain that the agent service is running. I manually handle the starting and stopping of the service later, so I prevent this dialogue from showing.
Environment Variables
One of the nice things the Zabbix agent configuration offers is variable substitution in the UserParameter directives. In the case of an MSI installer, we can’t always be certain where the agent scripts will be installed to so it doesn’t make sense to add a full path to the scripts defined as User Parameters. I’ve solved this problem in the MSI build by setting an environment variable ZBX_AGENT_BASE to the path Windows Installer ultimately installs the MSI to.
Effectively you can now define scripts paths for User Parameters that will always resolve; no matter where the MSI is installed. Example: UserParameter=my.key,cscript %ZBX_AGENT_BASE%\scripts\myscript.vbs
In addition, the bin and scripts path of the installed files is added to the PATH environment variable so tools like zabbix_get , zabbix_sender and your custom tools can be called from any location on the command line.
The Environment Variable components have their GUIDs predefined in the XML as Windows Installer can’t seem to generate GUIDs for components not installed to a predefined list of folders (including C:\Program files , etc.)
Platform Binaries
Earlier in the document we defined the BinDir preprocessor variable to be either win32 or win64 . This correlates to a subdirectory of bin in which the platform specific binaries for the Zabbix agent reside. I know use this variable to source the correct binaries for the MSI build.
Custom Scripts
If you have custom scripts you would like to bundle with the MSI install for custom User Parameters, this is where they are defined. These will be installed to %ZBX_AGENT_BASE%\scripts\ to be referenced in your agent configuration file.
A place-holder is also created for shared libraries (Perl modules, PowerShell modules, etc.) into which you can define share file components.
Installation Actions
Once the Zabbix agent is installed on a target system, it makes sense to configure and start the agent service. The following directives make this light work and have been tested on Windows Server 2000 through 2012 in various install locations.
The custom actions are scheduled for execution as follows:
UI Definition
The final section is copied from the WixUI_InstallDir dialogue set defined in WiX sources, with the EULA dialogue removed so end users are not required to accept a generic EULA.