Documentation
Table of Contents
3. Агент 2
Обзор
Zabbix агент 2 — это новое поколение Zabbix агента, написанное на языке Go (с частичным использованием кода на C из Zabbix агента). Zabbix агент 2 разработан для:
- уменьшения количества TCP-соединений;
- улучшения параллельности проверок;
- лёгкого расширения при помощи плагинов, которые обеспечивают простые проверки с минимальным кодом и поддерживают сложные проверки, состоящие из длительно выполняемых скриптов и автономного сбора данных с периодической отправкой данных;
- функционирования в качестве замены Zabbix агента, поддерживая все предыдущие функции.
Пассивные и активные проверки
Zabbix агент 2 поддерживает пассивные и активные проверки, аналогично Zabbix агенту. Кроме того, активные проверки Zabbix агента 2 поддерживают переменные интервалы / интервалы по расписанию и параллелизм проверок в пределах одного активного сервера.
По умолчанию, после перезапуска Zabbix агент 2 будет планировать первый сбор данных по активным проверкам в случайное время в течение интервала обновления элемента данных, во избежание скачков в использовании ресурсов. Чтобы активные проверки, у которых отсутствует интервал обновления По расписанию, были выполнены сразу после перезапуска агента, укажите в файле конфигурации параметр ForceActiveChecksOnStart (глобальный уровень) или Plugins.<ИмяПлагина>.System.ForceActiveChecksOnStart (влияет только на проверки из конкретного плагина). Параметр уровня плагина, если задан, переопределяет собой глобальный параметр.
Параллелизм проверок
Проверки из разных плагинов могут выполняться параллельно. Количество параллельных проверок в пределах одного плагина ограничено настройкой производительности плагина. Каждый плагин может иметь жёстко зашитую в код настройку производительности (по умолчанию, 1000), значение которой можно уменьшить, указав настройку Plugins.<ИмяПлагина>.System.Capacity=N в параметрах конфигурации плагина.
Поддерживаемые платформы
Поддерживаемые платформы смотрите на странице Требования.
Агент 2 на UNIX-подобных системах
Zabbix агент 2 на UNIX-подобных системах запускается на отслеживаемом хосте.
Установка
Zabbix агент 2 на системах на базе Linux может быть установлен одним из следующих способов:
- Пакеты Zabbix — выберите компонент Агент 2 (после выбора версии Zabbix, дистрибутива ОС и версии ОС) и следуйте предоставленным инструкциям.
- Исходный код Zabbix — загрузите исходный код и скомпилируйте Zabbix агент, сконфигурировав исходный код с указанием опции конфигурации
--enable-agent2. Обратите внимание, что для сборки агента Zabbix 2 требуется настроенная среда Go с поддерживаемой в настоящее время версией Go.
Начиная с Zabbix 7.0.5, пакеты Zabbix агента 2 больше не доступны для RHEL 6 из-за несовместимости Go 1.22 (и новее) с GCC 4.4.7, предоставляемым RHEL 6, что приводит к ошибкам компиляции. Однако следует отметить, что пакеты Zabbix агента по-прежнему поддерживаются.
При установке как пакет
Zabbix агент 2 работает как процесс переднего плана (т.е. без перехода в фоновый режим — прим. переводчика) и полагается на внешний менеджер служб (например, systemd) для фонового выполнения; Zabbix агент 2 не имеет встроенной поддержки демонизации в Linux.
Агент можно запустить, выполнив:
Чтобы остановить, перезапустить или проверить состояние Zabbix агента 2, используйте следующие команды:
Запуск вручную
Вы можете запустить Zabbix агент, найдя бинарный файл zabbix_agent2 и запустив его напрямую; например:
Агент 2 в системах Windows
Агент Zabbix 2 работает как автономный процесс; однако его также можно запустить как службу Windows.
Установка
Zabbix агент 2 может быть установлен на Windows одним из следующих способов:
- Предварительно скомпилированные бинарные файлы Zabbix агента — загрузите пакет установщика MSI Zabbix агента и следуйте инструкциям на странице Установка агента Windows из MSI.
- Исходный код Zabbix — загрузите исходный код и следуйте инструкциям на странице Сборка Zabbix агента 2 на Windows. Обратите внимание, что для сборки Zabbix агента 2 требуется настроенная среда Go с поддерживаемой в настоящее время версией Go.
Возможности мониторинга Zabbix агента 2 можно расширить с помощью плагинов.
В то время как встроенные плагины доступны «из коробки», подгружаемые плагины в Windows должны быть установлены отдельно. Для более подробной информации смотрите Подгружаемые плагины Zabbix агента 2.
Дополнительные сведения об установке Zabbix агента 2 (из ZIP-архива) в качестве службы Windows смотрите на странице Агент Zabbix в Microsoft Windows.
Опции
Следующие параметры командной строки могут быть использованы с Zabbix агентом 2:
| Параметр | Описание |
|---|---|
| Агенты UNIX and Windows | |
| -c --config <файл-конфигурации> | Путь к файлу конфигурации. Вы можете использовать данную опцию, чтобы указать файл конфигурации, отличный от заданного по умолчанию. В UNIX путь по умолчанию /usr/local/etc/zabbix_agent2.conf или как задано во время компиляции переменными --sysconfdir или --prefix В Windows путь по умолчанию C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf |
| -f --foreground | Запуск Zabbix агента без перехода в фоновый режим (по умолчанию: true). |
| -p --print | Вывод известых элементов данных и выход. Обратите внимание: Чтобы также получить результаты пользовательских параметров, вам необходимо указать файл конфигурации (если он отличается от заданного по умолчанию). |
| -t --test <ключ элемента данных> | Тестирование указанного элемента данных и выход. Обратите внимание: Чтобы также получить результат пользовательских параметров, вам необходимо указать файл конфигурации (если он отличается от заданного по умолчанию). |
| -T --test-config | Проверка файла конфигурации и выход. |
| -h --help | Вывод справочной информации и выход. |
| -v --verbose | Вывод отладочной информации. Используйте эту опцию совместно с опциями -p и -t. |
| -V --version | Вывод номера версии агента и информации о лицензии. |
| -R --runtime-control <опция> | Выполнение административных функций. Смотрите управление работой. |
| Только Windows агент | |
| -m --multiple-agents | Использование нескольких экземпляров агента (с опциями -i, -d, -s, -x). Для уникальности имён экземпляров служб, каждое имя службы будет включать значение Hostname из указанного файла конфигурации. |
| -S --startup-type <значение> | Установить тип запуска службы Windows агента Zabbix. Допустимые значения:automatic — (по умолчанию) автоматический запуск службы при старте Windows;delayed — задержка запуска службы до завершения запуска автоматически запускаемых служб;manual — ручной запуск службы (пользователем или приложением);disabled — служба отключена, во избежание запуска пользователем или приложением.Эту опцию можно использовать совместно с опцией -i либо отдельно для модификации типа запуска уже установленной службы. |
| -i --install | Установка Zabbix агента как службы Windows . |
| -d --uninstall | Удаление службы Windows Zabbix агента. |
| -s --start | Запуск службы Windows Zabbix агента. |
| -x --stop | Останов службы Windows Zabbix агента. |
Отдельные примеры использования параметров командной строки:
- отображение всех встроенных элементов данных с их значениями
- тестирование пользовательского параметра с ключом «mysql.ping», заданном в указанном файле конфигурации
- установка службы «Zabbix Agent» в Windows с использованием пути по умолчанию до файла конфигурации C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf
- модификация типа запуска установленной службы «Zabbix Agent» в Windows с использованием файла конфигурации zabbix_agent2.conf, расположенного в той же папке, что и бинарный файл агента
zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayedУправление работой
Управление работой агента предоставляет некоторые опции для удалённого управления агентом.
| Опция | Описание |
|---|---|
| log_level_increase | Увеличение уровня журналирования. |
| log_level_decrease | Уменьшение уровня журналирования. |
| metrics | Список доступных метрик. |
| version | Отображение версии агента. |
| userparameter_reload | Загрузка заново значений параметров UserParameter и Include из текущего файла конфигурации. |
| help | Отображение справочной информации о функции управления работой. |
Примеры:
- увеличение уровня журналирования агента 2
- вывод опций управления работой
Начиная с версии Zabbix 7.0.17, команды управления работой агента 2 пишут вывод в stdout (стандартный вывод) вместо stderr (стандартного вывода ошибок).
Файл конфигурации
Параметры конфигурации агента 2 большей частью совместимы с Zabbix агентом, за несколькими исключениями.
| Новые параметры | Описание |
|---|---|
| ControlSocket | Путь к сокету управления работой. Агент 2 использует управляющий сокет для административных команд. |
| EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod |
Эти параметры используются для настройки постоянного хранилища агента 2 для активных элементов данных. |
| ForceActiveChecksOnStart | Параметр определяет, должен ли агент выполнить активные проверки немедленно после перезапуска агента или равномерно распределить их по времени. |
| Plugins | Плагины могут иметь свои собственные параметры, в формате Plugins.<Имя плагина>.<Параметр>=<значение>. Общий параметр плагинов — System.Capacity, задаёт ограничение количества проверок, которые могут быть выполнены одновременно. |
| StatusPort | Агент 2 будет слушать этот порт для запросов HTTP состояния и отображать список настроенных плагинов и некоторые внутренние параметры. |
| Исключённые параметры | Описание |
| AllowRoot, User | Не поддерживается, так как режим демона не поддерживается. |
| LoadModule, LoadModulePath | Подгружаемые модули не поддерживаются. |
| StartAgents | Этот параметр использовался в Zabbix агенте для увеличения параллелизма пассивных проверок или для их отключения. В Агенте 2 параллелизм настраивается на уровне плагинов и может быть ограничен настройкой производительности. Между тем, полное отключение пассивных проверок в настоящее время не поддерживается. |
| HostInterface, HostInterfaceItem | Ещё не поддерживается. |
Для получения подробной информации смотрите параметры файла конфигурации для zabbix_agent2.
Коды завершения
Zabbix агент 2 также может быть скомпилирован с более старыми версиями OpenSSL (1.0.1, 1.0.2).
В этом случае Zabbix предоставляет мьютексы для блокировки в OpenSSL. Если блокировка или разблокировка мьютекса не удалась, то в стандартный поток ошибок (STDERR) выводится сообщение об ошибке, и агент 2 завершает работу, возвращая код 2 или 3 соответственно.