Zabbix Agent Not Available — одна из самых распространённых ошибок в Zabbix, при которой сервер мониторинга не может получить данные от агента на хосте. В результате узел становится недоступным, метрики перестают обновляться, а в интерфейсе появляется сообщение о недоступности агента.
Чаще всего проблема связана с сетью, firewall, неправильной конфигурацией агента или ошибками в настройке hostname. Иногда причиной становятся DNS, SELinux или проблемы совместимости версий.
В этом руководстве разберём, что вызывает ошибку Zabbix Agent Not Available, как диагностировать проблему и какие способы помогают быстро восстановить работу мониторинга.
Что означает ошибка Zabbix Agent Not Available
Ошибка появляется, когда сервер Zabbix не может подключиться к агенту или получить от него данные.
Обычно это означает:
- агент не запущен;
- порт 10050 закрыт;
- неверно настроен параметр Server;
- hostname не совпадает;
- firewall блокирует подключение;
- возникли проблемы с DNS.
По умолчанию Zabbix Agent использует порт 10050/TCP.
Быстрая диагностика
Если Zabbix Agent стал unavailable, проверьте в первую очередь:
- Запущен ли zabbix-agent
- Открыт ли порт 10050
- Совпадает ли Hostname
- Указан ли правильный Server
- Есть ли соединение между сервером и агентом
Проверка работы Zabbix Agent
Первое, что необходимо проверить — запущен ли агент.
Linux
systemctl status zabbix-agentЕсли служба остановлена:
sudo systemctl start zabbix-agent
sudo systemctl enable zabbix-agentWindows
Откройте:
services.mscНайдите службу Zabbix Agent и убедитесь, что она находится в состоянии Running.
Проверка порта 10050
Zabbix Agent должен слушать TCP-порт 10050.
Linux
ss -tulnp | grep 10050или:
netstat -tulnp | grep 10050Если порт не отображается — агент либо не запущен, либо неправильно настроен.
Проверка подключения с сервера Zabbix
telnet HOST_IP 10050или:
nc -zv HOST_IP 10050Если соединение не устанавливается — проблема обычно связана с firewall или сетью.
Firewall блокирует подключение
Очень часто ошибка появляется из-за закрытого порта.
UFW
sudo ufw allow 10050/tcpfirewalld
sudo firewall-cmd --permanent --add-port=10050/tcp
sudo firewall-cmd --reloadiptables
iptables -A INPUT -p tcp --dport 10050 -j ACCEPTПроверка параметра Server
В конфигурации агента должен быть указан IP-адрес сервера Zabbix.
Файл конфигурации обычно находится здесь:
/etc/zabbix/zabbix_agentd.confПроверьте параметры:
Server=192.168.1.10Если используется Active Agent:
ServerActive=192.168.1.10После изменений перезапустите агент:
systemctl restart zabbix-agentПроблемы с Hostname
Очень частая причина ошибки — несовпадение hostname.
Параметр:
Hostname=web-server-01должен совпадать с именем хоста в веб-интерфейсе Zabbix.
Если названия различаются — сервер не сможет корректно связать данные агента с узлом мониторинга.
Проблемы с DNS
Если вместо IP используется hostname:
Server=zabbix.localубедитесь, что DNS работает корректно.
Проверка:
ping zabbix.local
nslookup zabbix.localSELinux блокирует Zabbix Agent
На некоторых Linux-системах SELinux может блокировать подключения агента.
Проверка статуса:
getenforceДля теста можно временно отключить SELinux:
setenforce 0Если после этого агент заработал — потребуется настройка SELinux policies.
Таблица причин и способов решения
| Проблема | Причина | Решение |
|---|---|---|
| Host unavailable | Агент остановлен | Запустить zabbix-agent |
| Connection refused | Закрыт порт 10050 | Открыть порт в firewall |
| Timeout | Проблемы сети | Проверить маршрутизацию и firewall |
| Agent unavailable | Неверный Server | Указать IP сервера Zabbix |
| No data | Hostname не совпадает | Синхронизировать hostname |
| Cannot resolve hostname | Ошибка DNS | Проверить DNS-записи |
Как проверить агент вручную
На сервере Zabbix можно выполнить:
zabbix_get -s HOST_IP -k system.hostnameЕсли агент отвечает — вы получите hostname сервера.
Пример:
web-server-01Если ответа нет — проблема в соединении или конфигурации агента.
Проверка логов Zabbix Agent
Логи помогают быстро определить источник ошибки.
Linux
tail -f /var/log/zabbix/zabbix_agentd.logWindows
Логи обычно находятся здесь:
C:\Program Files\Zabbix Agent\zabbix_agentd.logЧасто встречающиеся ошибки:
connection refused
cannot resolve hostname
active check configuration update failedРазмещение Zabbix в облаке
Для стабильной работы мониторинга важно использовать надёжную серверную инфраструктуру. Развернуть сервер Zabbix можно как на выделенном VPS, так и в облаке.
Например, Serverspace позволяет быстро создать облачный сервер под Zabbix с Linux, Docker или контейнерной инфраструктурой. Это удобно для развёртывания monitoring stack, настройки резервирования и масштабирования системы мониторинга без сложной ручной настройки железа.
Как избежать ошибки Zabbix Agent Not Available
Чтобы проблема появлялась реже:
- используйте шаблоны конфигурации;
- автоматизируйте настройку через Ansible или Terraform;
- контролируйте firewall;
- следите за hostname;
- мониторьте сам Zabbix Agent.
Пример триггера:
nodata(/host/system.uptime,5m)=1FAQ
Почему Zabbix Agent становится unavailable периодически?
Чаще всего проблема связана с нестабильной сетью, firewall, высокой нагрузкой на сервер или перезапуском агента.
Какой порт использует Zabbix Agent?
По умолчанию:
- Zabbix Agent — 10050/TCP;
- Zabbix Server — 10051/TCP.
Что лучше — Active или Passive checks?
Active checks удобнее для серверов за NAT и firewall, поскольку агент сам отправляет данные серверу.
Может ли проблема быть связана с Docker?
Да. Если агент работает в контейнере, нужно проверить проброс портов, network mode и доступность сервера Zabbix из контейнера.
Нужно ли открывать порт 10050 в интернет?
Нет. Лучше ограничить доступ только IP-адресом сервера мониторинга.
Заключение
Ошибка Zabbix Agent Not Available обычно связана с сетью, firewall или неправильной конфигурацией агента. В большинстве случаев проблема решается проверкой работы службы, доступности порта 10050, параметров Server и Hostname, а также анализом логов.
Последовательная диагностика позволяет быстро восстановить мониторинг и избежать повторного появления проблемы в инфраструктуре Zabbix.