Активный и пассивный zabbix агент

Инструкция входит в цикл про Zabbix. Общая картина: мониторинг Linux и Windows в Zabbix, справочник ключей: ключи агента.
Нужно понять, сам агент стучится в Zabbix или сервер опрашивает агента. От этого зависят файрвол и Server/ServerActive в конфиге. Актуальная документация: zabbix.com/documentation/current.
Пассивный агент
Сервер (или прокси) подключается на порт агента, обычно 10050/tcp. В zabbix_agentd.conf или zabbix_agent2.conf:
Server=192.0.2.10
ListenPort=10050
На хосте агента откройте 10050 только с адреса сервера/прокси. Пример проверки с сервера:
zabbix_get -s 192.0.2.20 -k agent.ping
Ожидание: 1. Таймаут — файрвол или агент не слушает. См. также проверку порта.
Активный агент
Агент сам забирает список items и шлёт данные на 10051/tcp сервера. Файрвол открываете на сервере, не на каждом хосте.
ServerActive=192.0.2.10
Hostname=web-01
Hostname должен совпасть с именем узла в Zabbix. В интерфейсе у items тип Zabbix agent (active).
Agent 2 и шифрование
На новых контурах берите Zabbix Agent 2, если ваш набор items его покрывает. PSK или сертификат включают в конфиге агента и в узле Zabbix: без этого трафик агента в открытом виде. Не оставляйте Server=0.0.0.0/0.
Что выбрать
| Пассивный | Активный | |
|---|---|---|
| Кто инициирует соединение | Сервер или прокси | Агент |
| Порт | 10050 открыт на узле | 10051 открыт на сервере |
| Узел за NAT или в чужой сети | Сложно: нужен проброс порта | Подходит: исходящее соединение |
| Много узлов | Нагрузка на пулы опроса сервера | Нагрузка распределена на агентов |
Журналы (log[]) |
Не поддерживаются | Поддерживаются |
Быстрая проверка zabbix_get |
Работает | Не применим |
Практика: для типовых серверов в одной сети удобен пассивный режим за простоту диагностики, для удалённых площадок, журналов и авторегистрации (автоматическая регистрация) — активный. Оба режима в одном шаблоне можно сочетать.
Прокси
На удалённых площадках ставят Zabbix proxy: агенты отправляют данные ему, а он передаёт серверу. В конфигурации агента ServerActive указывает на прокси. Так наружу из площадки нужен один исходящий канал.
Типичные сообщения и причины
| Сообщение в журнале агента | Что проверить |
|---|---|
no active checks on server |
Узла нет в Zabbix или имя Hostname не совпадает |
host [web-01] not found |
Имя узла в интерфейсе отличается от Hostname агента |
connection refused / timeout на 10051 |
Firewall между агентом и сервером |
Get value from agent failed у сервера |
Пассивный режим: Server= не содержит адрес сервера или закрыт 10050 |
sudo tail -n 50 /var/log/zabbix/zabbix_agent2.log
sudo ss -tn state established '( dport = :10051 )'
Как проверить
sudo ss -lntup | grep -E ':10050|:10051'
zabbix_get -s 192.0.2.20 -k agent.version
# активные: Latest data узла, items не в состоянии «не поддерживается»
Пассивный: 10050 слушает, zabbix_get отвечает. Активный: на сервере 10051 принимает, в Latest data свежие значения.
Источники
- Zabbix documentation, current. URL: https://www.zabbix.com/documentation/current — разделы passive/active checks и Agent 2.


















