Выгрузка метрик с помощью утилиты collectd-nagios в Zabbix¶

В этом документе приводится пример настройки выгрузки метрик WAF‑ноды в систему мониторинга Zabbix с помощью утилиты collectd-nagios.

Схема работы примера¶

В этом документе используется следующая схема развертывания:

• WAF‑нода Вебмониторэкс развернута на хосте, доступном по IP‑адресу 10.0.30.5 и полному доменному имени node.example.local.

  На хосте также развернут Zabbix‑агент версии 4.0 LTS, который:

  • Получает значения метрик WAF‑ноды, используя утилиту collectd-nagios.
  • Слушает входящие соединения на порту 10050/TCP (пассивные проверки с помощью Zabbix Appliance).
  • Передает значения метрик в Zabbix Appliance.

• На отдельном хосте с IP‑адресом 10.0.30.30 (далее — «хост Docker») развернут Zabbix Appliance версии 4.0 LTS в виде Docker‑контейнера.

  Zabbix Appliance включает в себя:

  • Сервер Zabbix, который периодически опрашивает Zabbix‑агент, установленный на хосте с WAF‑нодой, на предмет изменения значений метрик.
  • Веб-интерфейс для управления сервером Zabbix, доступный на порту 80/TCP.

Настройка выгрузки метрик в Zabbix¶

Развертывание Zabbix¶

Для развертывания Zabbix Appliance 4.0 LTS выполните на хосте Docker следующую команду:

docker run --name zabbix-appliance -p 80:80 -d zabbix/zabbix-appliance:alpine-4.0-latest

Теперь у вас есть работающая система мониторинга Zabbix.

Развертывание Zabbix‑агента¶

Установите Zabbix‑агент 4.0 LTS на хост с WAF‑нодой:

1. Подключитесь к WAF‑ноде (например, с помощью протокола SSH). Убедитесь, что вы работаете под аккаунтом root или другим аккаунтом с правами суперпользователя.

2. Подключите репозитории Zabbix (используйте пункт «Install Zabbix repository» инструкции, соответствующей используемой операционной системе).

3. Установите Zabbix‑агент, выполнив одну из следующих команд в зависимости от используемой операционной системы:

   DEB-based дистрибутивыRPM‑based дистрибутивы

   sudo apt install zabbix-agent
   

   sudo yum install zabbix-agent
   

4. Настройте Zabbix‑агент для работы с Zabbix Appliance. Для этого внесите следующие изменения в файл конфигурации агента /etc/zabbix/zabbix_agentd.conf:

   Server=10.0.30.30                  # IP‑адрес Zabbix 
   Hostname=node.example.local        # Полное доменное имя хоста с WAF‑нодой 
   

Настройка сбора метрик с помощью Zabbix‑агента¶

Подключитесь к WAF‑ноде (например, с помощью протокола SSH) и настройте сбор метрик с помощью Zabbix‑агента. Для этого выполните следующие действия на хосте с WAF‑нодой:

1. Установите утилиту collectd_nagios.¶

Для этого выполните следующую команду:

sudo apt install --no-install-recommends collectd-utils

sudo yum install collectd-utils

2. Добавьте возможность запускать утилиту collectd-nagios с повышенными привилегиями от имени пользователя zabbix¶

Для этого с помощью утилиты visudo добавьте следующую строку в файл /etc/sudoers:

zabbix ALL=(ALL:ALL) NOPASSWD:/usr/bin/collectd-nagios

Это позволит пользователю zabbix запускать утилиту collectd-nagios с правами суперпользователя с помощью утилиты sudo без ввода пароля.

3. Убедитесь, что пользователь zabbix может получать значения метрик от collectd¶

Для этого выполните следующую тестовую команду на WAF‑ноде:

sudo -u zabbix sudo /usr/bin/collectd-nagios -s /var/run/wallarm-collectd-unixsock -n curl_json-wallarm_nginx/gauge-abnormal -H node.example.local

Эта команда позволяет пользователю zabbix получить значение метрики [curl_json-wallarm_nginx/gauge-abnormal][doc-gauge-abnormal] (количество обработанных запросов) для хоста node.example.local с WAF‑нодой.

Пример вывода команды:

OKAY: 0 critical, 0 warning, 1 okay | value=0.000000;;;;

4. Добавьте в файл конфигурации Zabbix‑агента на WAF‑ноде пользовательские параметры для получения требуемых вам метрик¶

Например, чтобы создать пользовательский параметр wallarm_nginx-gauge-abnormal, который будет соответствовать метрике curl_json-wallarm_nginx/gauge-abnormal для WAF‑ноды с полным доменным именем node.example.local, добавьте в файл конфигурации следующую строку:

UserParameter=wallarm_nginx-gauge-abnormal, sudo /usr/bin/collectd-nagios -s /var/run/wallarm-collectd-unixsock -n curl_json-wallarm_nginx/gauge-abnormal -H node.example.local | sed -n "s/.*value\=\(.*\);;;;.*/\1/p"

5. После того, как в файл конфигурации Zabbix‑агента добавлены все необходимые команды, перезапустите агент¶

Для этого выполните одну из следующих команд:

sudo service zabbix-agent restart

sudo systemctl restart zabbix-agent

Настройка завершена¶

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