Описание Zabbix passive
Сборщик используется для получения данных от Zabbix агентов, работающих в пассивном режиме. Пассивный режим работы Zabbix агента означает, что ALEPIZ инициирует сбор данных с Zabbix агента, подключаясь на его IP адрес и порт и запрашивая требуемые данные.
Throttling
Для того, чтобы уменьшить нагрузку на ALEPIZ и не засорять базу данных, в сборщике реализована система пропусков для одинаковых или похожих значений. Например, если состояние Windows сервиса длительное время раз в 30 секунд возвращает 0 (запущен), то сборщик может не отправлять все эти значения в ALEPIZ, а отправлять только часть из них, пропуская промежуточные данные. Как только значение поменяется на 6 (остановлен), это значение сразу же будет отправлено в систему. Кроме точного сравнения значений для пропуска, можно использовать так же отклонения, когда следующее значение почти такое же, как и предыдущее (параметр "Values deviation for skip 0-100%. 0 - values must be equal (throttling)"). Например, если объем свободной памяти за 30 секунд изменился не более чем на 5%, значение тоже не будет передано в ALEPIZ.
Массив значений
Если коллектор вернул массив значений (например, в случае обработки данных в формате Zabbix LLD - Low Level Discovery), происходит следующее:
- Весь полученный массив значений преобразуется в текст JSON и сохраняется в базу с историей значений
- Если у счетчика есть зависимые счетчики, то ALEPIZ будет вызывать их столько раз, сколько значений получено в массиве и каждый раз передавать в качестве переменной %:PARENT_VALUE:% новое значение из массива значений.
То есть если, например, был получен массив со списком сервисов, работающих на платформе, в базу будет записан весь этот список в формате JSON, а каждый из зависимых счетчиков будет запущен столько раз, сколько сервисов присутствует в массиве и ему по очереди будут переданы сервисы этого массива.
LLD (Low Level Discovery)
Технология LLD была разработана компанией Zabbix SIA и предназначена для обработки данных, полученных в виде массива. Подробное описание технологии можно посмотреть на сайте разработчика Zabbix LLD - Low Level Discovery. Смысл технологии заключается в том, что zabbix-agent передает серверу текстовый JSON с описанием массива данных. Далее, если в счетчике установлен ключ "returns LLD (Low Level Discovery)", производится преобразование текста JSON в объект. После чего он обрабатывается в соответствии с правилами обработки массивов ALEPIZ, т.е. в зависимые счетчики через переменную %:PARENT_VALUE:% будут переданы по очереди все элементы этого массива.
Параметры
- Zabbix agent IP address - IPv4 или IPv6 адрес или имя хоста, с которого требуется получить данные.
- Zabbix agent TCP PORT - TCP порт Zabbix агента
- Zabbix item key - ключ Zabbix агента. Информацию о ключах Zabbix агента можно получить на сайте компании Zabbix SIA
- Parameters for Zabbix item key - параметры ключа Zabbix агента. Информацию о параметрах Zabbix агента можно получить на сайте компании Zabbix SIA
- Source IP address or host name - IPv4 или IPv6 адрес, с которого требуется установить соединение к агенту (необязательный параметр)
- returns LLD (Low Level Discovery) data - По данному ключу будет возвращен JSON объект в виде Low Level Discovery. Технология разработана компанией Zabbix SIA и используется для обнаружения объектов мониторинга.
- Parse CSV and return LLD data - При включении этого параметра сборщик преобразует данные, полученные в CSV формате, в объект LDD
- Return only numeric values - Указывает сборщику, что необходимо принимать только данные в виде числовых значений. Все остальные значения, возвращаемые Zabbix агентом, будут игнорироваться.
- Number of values that can be skipped (throttling) - Максимальное количество похожих значений, которые не будут передаваться в ALEPIZ. Если 0, то пропуск значений отключается для этого счетчика.
- Time interval when values can be skipped (throttling) - Максимальный интервал времени (в миллисекундах), в течение которого похожие значения не будут передаваться в ALEPIZ. Если 0, то пропуск значений отключается для этого счетчика.
- Values deviation for skip 0-100%. 0 - values must be equal (throttling) - процент отклонений, для значений. Если следующее полученное значение отличается от предыдущего не более, чем на этот процент и включен пропуск значений, то значение не будет передано в ALEPIZ.
Пример параметров счетчика, используемого для сбора данных о свободной памяти сервера:
![](./images/help.parameters1.png)
Пример параметров счетчика, используемого для сбора данных о сервисах, работающих на сервере:
![](./images/help.parameters2.png)
Возвращаемое значение
Сборщик возвращает данные, которые вернул Zabbix агент. Подробную информацию о возвращаемых данных и об объектах LDD можно получить на сайте компании Zabbix SIA
О Zabbix
Zabbix agent разрабатывается компанией Zabbix SIA, выпускающей решения для мониторинга. Zabbix агент можно скачать как с сайта компании Zabbix SIA, так и специально адаптированный пакет под ALEPIZ со страницы https://alepiz.com/download/.