Агент

Обзор

Агент Zabbix развертывается на контролируемом объекте для активного мониторинга локальных ресурсов и приложений (жесткие диски, память, статистика процессора и т. д.).

Агент собирает эксплуатационную информацию локально и передает данные на сервер Zabbix для дальнейшей обработки. В случае сбоев (например, переполнения жесткого диска или аварийного завершения процесса службы) сервер Zabbix может активно оповещать администраторов конкретной машины, сообщившей о сбое.

Агенты Zabbix отличаются высокой эффективностью благодаря использованию системных вызовов ОС для сбора статистической информации.

На узле сети можно запустить несколько экземпляров агента.

Пассивные и активные проверки

Zabbix агенты могут выполнять пассивные и активные проверки:

  • Пассивные проверки — Zabbix агент отвечает на запрос от Zabbix сервера (или прокси). Например, запрашивает данные (к примеру, загрузку CPU), и агент возвращает результат.

  • Активные проверки — Zabbix агент собирает и отправляет данные, не дожидаясь запроса от сервера Zabbix (или прокси). Сначала он получает с сервера список отслеживаемых элементов данных (загрузка CPU, доступная память и т. д.), затем собирает требуемые данные и периодически отправляет на сервер новые значения.

Выбор между пассивной и активной проверкой осуществляется при выборе соответствующего типа элемента данных. Zabbix агент обрабатывает элементы данных типов Zabbix агент и Zabbix агент (активный).

Поддерживаемые платформы

Список поддерживаемых платформ см. на странице Требования.

Агент в Unix-подобных системах

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

Установка

Агент Zabbix можно установить на системах на базе Linux одним из следующих способов:

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

Предварительно скомпилированные двоичные файлы агента Zabbix доступны для загрузки для macOS, IBM AIX, FreeBSD, OpenBSD и Solaris. Устаревшие двоичные файлы, совместимые с текущей версией сервера/прокси Zabbix, доступны для NetBSD и HP-UX.

При установке из пакета

Zabbix агент работает как демон. Агента можно запустить, выполнив:

systemctl start zabbix-agent

Эта команда будет работать на большинстве систем GNU/Linux. На других системах вам, возможно, потребуется выполнить:

/etc/init.d/zabbix-agent start

Для остановки/перезапуска/просмотра состояния используйте следующие команды:

systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
Запуск вручную

Вы можете запустить Zabbix агент, найдя бинарный файл zabbix_agentd и запустив его напрямую; например:

zabbix_agentd

Агент в системах Windows

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

Установка

Агент Zabbix можно установить в Windows одним из следующих способов:

См. страницу Агент Zabbix в Microsoft Windows для получения дополнительных сведений об установке агента Zabbix (из ZIP-архива) в качестве службы Windows.

Параметры

Следующие параметры командной строки можно использовать с агентом Zabbix:

Parameter Description
Агент UNIX и Windows
-c --config <config-file> Путь к файлу конфигурации.
Этот параметр можно использовать, чтобы указать файл конфигурации, отличный от файла по умолчанию.
-f --foreground Запускать агент Zabbix в режиме переднего плана (по умолчанию: true).
-p --print Вывести известные элементы данных и выйти.
Обратите внимание: чтобы также вернуть результаты пользовательского параметра, необходимо указать файл конфигурации (если он не находится в расположении по умолчанию).
-t --test <item key> Проверить указанный элемент данных и выйти.
Обратите внимание: чтобы также вернуть результаты пользовательского параметра, необходимо указать файл конфигурации (если он не находится в расположении по умолчанию).
-T --test-config Проверить файл конфигурации и выйти.
-h --help Показать справочную информацию.
-V --version Показать номер версии.
Только агент UNIX
-R --runtime-control <option> Выполнить административные функции. См. управление во время выполнения.
Только агент Windows
-m --multiple-agents Использовать несколько экземпляров агента (с параметрами -i, -d, -s, -x).
Чтобы различать имена служб экземпляров, каждое имя службы будет включать значение Hostname из указанного файла конфигурации.
-S --startup-type <value> Установить тип запуска службы агента Zabbix для Windows. Допустимые значения:
automatic - (по умолчанию) запускать службу автоматически при старте Windows;
delayed - отложить запуск службы до завершения запуска служб, которые стартуют автоматически (доступно в Windows Server 2008/Vista и более поздних версиях);
manual - запускать службу вручную (пользователем или приложением);
disabled - отключить службу, чтобы ее нельзя было запустить пользователем или приложением.
Этот параметр можно использовать вместе с параметром -i или отдельно, чтобы изменить тип запуска уже установленной службы.
-i --install Установить агент Zabbix для Windows как службу.
-d --uninstall Удалить службу агента Zabbix для Windows.
-s --start Запустить службу агента Zabbix для Windows.
-x --stop Остановить службу агента Zabbix для Windows.

Примеры использования параметров командной строки:

  • Вывод всех встроенных элементов данных агента со значениями.
  • Проверка пользовательского параметра с ключом mysql.ping, определенным в указанном файле конфигурации.
  • Установка службы Zabbix Agent для Windows с использованием пути по умолчанию к файлу конфигурации C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.
  • Установка службы Zabbix Agent [Hostname] для Windows с использованием файла конфигурации zabbix_agentd.conf, расположенного в той же папке, что и исполняемый файл агента, и обеспечение уникальности имени службы путем добавления значения Hostname из файла конфигурации.
  • Изменение типа запуска установленной службы Zabbix Agent для Windows с использованием файла конфигурации zabbix_agentd.conf, расположенного в той же папке, что и исполняемый файл агента.
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Управление работой

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

Опция Описание Цель
log_level_increase[=<цель>] Увеличение уровня журналирования.
Действует на все процессы, если цель не указана.		 Цель можно указать как:
тип процесса — все процессы указанного типа (например: listener)
Смотрите весь список типов процессов агента.
тип процесса,N — тип процесса и номер (например: listener,3)
pid — идентификатор процесса (от 1 до 65535). В случае значений PID больше 65535 укажите цель в виде «тип процесса,N».
log_level_decrease[=<цель>] Уменьшение уровня журналирования.
Действует на все процессы, если цель не указана.
userparameter_reload Загрузка заново значений параметров UserParameter и Include из текущего файла конфигурации.

Примеры:

  • Увеличение уровня журналирования всех процессов
  • Увеличение уровня журналирования третьего процесса listener
  • Увеличение уровня журналирования процесса с PID 1234
  • Уменьшение уровня журналирования для всех процессов активных проверок
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"

Выполнение административных функций не поддерживается в OpenBSD, NetBSD и Windows.

Типы процессов агента

Типы процессов агента следующие:

  • active checks - процесс для выполнения активных проверок;
  • collector - процесс для сбора данных;
  • listener - процесс для прослушивания пассивных проверок.

Файл журнала агента можно использовать для наблюдения за этими типами процессов.

Файл журнала агента создается с правами на чтение и запись только для владельца файла. Кроме того, файл доступен для чтения группе владельца. Все остальные права запрещены.

Пользователь процесса

Агент Zabbix в UNIX предназначен для работы от имени пользователя, не являющегося root. Он будет работать от имени того пользователя, не являющегося root, под которым был запущен. Поэтому вы можете запускать агент от имени любого пользователя, не являющегося root, без каких-либо проблем.

Если вы попытаетесь запустить его от имени root, он переключится на жестко заданного пользователя zabbix, который должен присутствовать в вашей системе. Вы можете запускать агент от имени root только в том случае, если соответствующим образом измените параметр AllowRoot в файле конфигурации агента.

Файл конфигурации

Путь по умолчанию к файлу конфигурации:

  • В UNIX по умолчанию используется /usr/local/etc/zabbix_agentd.conf или путь, заданный переменными время компиляции --sysconfdir или --prefix.
  • В Windows по умолчанию используется C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf.

Если на узле сети запущен один экземпляр агента, он может использовать файл конфигурации по умолчанию или файл конфигурации, указанный в командной строке. В случае нескольких экземпляров каждый экземпляр агента должен иметь собственный файл конфигурации (один из экземпляров может использовать файл конфигурации по умолчанию).

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

Локаль

Обратите внимание, что агенту требуется локаль UTF-8, чтобы некоторые текстовые элементы данных агента могли возвращать ожидаемое содержимое. На большинстве современных Unix-подобных систем локаль UTF-8 используется по умолчанию, однако на некоторых системах ее может потребоваться задать явно.

Код выхода

Агент Zabbix возвращает 0 в случае успешного завершения и 1 в случае ошибки.