Развернуть и настроить виртуальный сервер Zabbix Proxy

Развертывание виртуального сервера Zabbix Proxy для мониторинга локальных агентов.

Нужно перенастроить агентов для связи с Zabbix Proxy, чтобы этот сервер отправлял данные на Zabbix Server.

• Гипервизор (удобней Vmware Workstation);
• iso-образ Debian 13;
• Сформированный файл zabbix_proxy.conf и ключ proxy.psk (их нужно создать и сгенерировать самому);
• Место на диске (для развертывания ВМ);
• Наличие доступа к Zabbix Server;
• Схожие версии агентов, сервера и прокси (по крайней мере, версии 7.4.x).

Шаг 1: Развертывание ВМ, установка Debian и настройки сети

1. Запустить Vmware Workstation Pro и создать виртуальную машину, выбрав iso-образ Debian;
2. Выделить 1 ядро процессора, 2 Гб ОЗУ и примерно 16-20 Гб дисковой памяти, сеть обязательно Bridge;
3. Запустить установщик Debian, все выбрать по умолчанию, кроме трех моментов:

• имя хоста лучше задать примерно zbx-proxy-client (вместо client выбрать другое имя);
• имя пользователя для простоты лучше задать zbx;
• после запуска tasksel выбрать только сервер SSH и стандартные системные утилиты, то есть без DE.

4. После завершения установки перезагрузиться и ввести базовые команды:

sudo apt update && sudo apt -y upgrade
sudo timedatectl set-timezone Europe/Moscow    
ip a                                            
ip route
sudo apt install -y resolvconf curl wget
sudo systemctl restart networking

5. Изменить DHCP на статику:

• сначала открыть текстовым редактором настройки сети:

  sudo nano /etc/network/interfaces

• затем добавить следующее в конфиг:

   allow-hotplug ens33
   iface ens33 inet static
       address 192.168.X.X/24
       gateway 192.168.X.1
       dns-nameservers <тот DNS, что был в resolv.conf>

• после сохранить, выйти из редактора и перезапустить сетевую службу:

sudo systemctl restart networking

6. Проверить изменения сети:

ip a        # адрес без пометки "dynamic" и без таймеров valid_lft
cat /etc/resolv.conf   # если DNS-строка пропала — прописать вручную:
echo "nameserver 
<DNS>" | sudo tee /etc/resolv.conf
ping <шлюз>
ping ya.ru

Шаг 2: Установка и настройка Zabbix Proxy

7. Скачать репозиторий и установить Zabbix Proxy:

wget https://repo.zabbix.com/zabbix/7.4/release/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.4+debian13_all.deb
sudo dpkg -i zabbix-release_latest_7.4+debian13_all.deb
sudo apt update
sudo apt install -y zabbix-proxy-sqlite3 zabbix-get fping

8. Скопировать конфиг zabbix_proxy.conf и ключ proxy.psk из Windows в ВМ (они должны быть в одной сети):

scp .\zabbix_proxy.conf .\proxy.psk zbx@<IP-прокси>:~/

9. Раскидать конфиг и ключ по нужным папкам внутри Debian и дать права на них:

sudo cp zabbix_proxy.conf /etc/zabbix/zabbix_proxy.conf
sudo cp proxy.psk /etc/zabbix/proxy.psk
sudo chown zabbix:zabbix /etc/zabbix/proxy.psk
sudo chmod 600 /etc/zabbix/proxy.psk

10. Проверить на «невидимый мусор из Windows»:

file /etc/zabbix/zabbix_proxy.conf     # если видите "CRLF line terminators" — лечим:
sudo apt install -y dos2unix
sudo dos2unix /etc/zabbix/zabbix_proxy.conf

11. Проверить и поправить конфиг:

• открыть в редакторе:

sudo nano /etc/zabbix/zabbix_proxy.conf

• проверить по чек-листу настройки:

• после сохранить и выйти из редактора;
• закрепить директорию /run/zabbix, чтобы она пересоздавалась при каждой перезагрузке (/run — tmpfs, обнуляется):

echo 'd /run/zabbix 0755 zabbix zabbix -' | sudo tee /etc/tmpfiles.d/zabbix-proxy.conf
sudo systemd-tmpfiles --create /etc/tmpfiles.d/zabbix-proxy.conf

Для быстрой проверки конфига без танцев с systemctl+journalctl:**

sudo -u zabbix zabbix_proxy -c /etc/zabbix/zabbix_proxy.conf -f

12. Запустить службу:

sudo mkdir -p /var/lib/zabbix && sudo chown zabbix:zabbix /var/lib/zabbix
sudo systemctl enable --now zabbix-proxy
sudo systemctl status zabbix-proxy

13. Проверить связь с сервером Zabbix:

getent hosts <ip-адрес Zabbix-сервера или DNS-имя>          # должно вернуть белый ip
nc -vz <ip-адрес Zabbix-сервера или DNS-имя> 10051          # должно быть "succeeded"/"open"
curl -s ifconfig.me; echo                    # внешний IP площадки

Шаг 3: Установка и настройка Zabbix агентов той же сети, что и Zabbix Proxy

14. Установить Zabbix Agent 2 на клиентские ПК;
15. Открыть текстовый редактор от имени администратора и оттуда открыть zabbix_agent2.conf;
16. Привести настройки к следующему виду:

Server=<IP виртуалки с прокси>
ServerActive=<IP виртуалки с прокси>
Hostname=<уникальное имя машины, латиницей>
HostMetadata=client:<клиент>;os:windows;mode:active

Для справки:

• Hostname должен посимвольно совпадать с именем узла в Zabbix — это самая частая причина, почему хост «не виден». Опечатка на одну букву (SRV vs SRV1) — и данные никуда не привязываются.

• HostMetadata работает только вместе с настроенным правилом автоregистрации на сервере (Configuration/Data collection → Actions → Autoregistration actions). Если правило не настроено — узел нужно создавать вручную в веб-интерфейсе с точно таким же именем.

• Restart-Service «Zabbix Agent 2» — после правки конфига служба сама его не перечитывает. Выбор режима — определитесь заранее и придерживайтесь одного варианта на клиента:

• Active (mode:active, шаблон «… by Zabbix agent active»): агент сам стучится к прокси. У узла в веб-интерфейсе интерфейс «Агент» не нужен вообще — если он есть, лучше удалить, иначе индикатор ZBX будет висеть серым, пытаясь опросить нерабочий адрес.

• Passive (mode:passive, обычный шаблон «… by Zabbix agent», без «active»): прокси сам стучится к агенту по локальной сети клиента. Для этого на Windows-машине клиента нужно разрешить входящие подключения на порт 10050 от IP прокси в Windows Firewall, а в свойствах узла в веб-интерфейсе интерфейс «Агент» должен указывать на реальный локальный IP этой машины (не IP прокси и не белый IP).

На роутере/ИБП/коммутаторе, если их нужно мониторить — включить SNMP v2c, сообщить community-строку и адреса, проверки настроятся на стороне сервера, опрашивать будет прокси.

17. Сохранить изменения и перезапустить службу Zabbix Agent2 через диспетчер задач;

Шаг 4: Создание узла Proxy и добавление клиентского ПК на Zabbix Server

18. Авторизоваться в веб-конфигураторе Zabbix Server;
19. В Администрирование -> Прокси создать прокси с режимом «Активный», указав имя и вставив ключ PSK (все в соответствии с zabbix_proxy.conf;
20. В Сбор данных -> Узлы сети создать узел сети со следующими настройками:

• имя хоста — такое же, какое указано в конфиге Zabbix Agent2 у клиентского ПК в строке «Hostname»;
• шаблон — Windows by zabbix agent active (или Linux by zabbix agent active);
• группы узлов сети — Discovered hosts и Silent monitoring;
• наблюдение — через прокси (указать имя прокси, которое было создано в пункте 19).

Виртуальная машина Zabbix Proxy поднята, агенты посылают информацию о себе Proxy, оттуда уже идет отправка на сервер. Даже в случае сбоев сети информация об агентах сохраняется на сервере Zabbix Proxy 30 дней по умолчанию.

Будет приведено в виде таблицы: