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

В этом документе приводится пример настройки выгрузки метрик WAF‑ноды в систему мониторинга Nagios (рассматривается редакция Nagios Core, однако этот документ подойдет для любой редакции Nagios) с помощью утилиты collectd-nagios.

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

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

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

• Хост, на котором установлен Nagios, доступен по IP‑адресу 10.0.30.30.

• Для выполнения команд на удаленном хосте используется плагин NRPE. Плагин состоит из двух компонентов:

  • Сервиса nrpe, который устанавливается на машину, мониторинг которой необходимо осуществлять. Работает на стандартном для NRPE порту 5666/TCP.
  • Nagios‑плагина NRPE check_nrpe, который устанавливается на хост Nagios и позволяет Nagios выполнять команды на удаленном хосте, на котором установлен сервис nrpe.

• NPRE будет использоваться для вызова утилиты collectd_nagios, которая предоставляет метрики collectd в Nagios‑совместимом формате.

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

Чтобы настроить выгрузку метрик WAF‑ноды, выполните следующие действия:

1. Настройте сервис NRPE для коммуникации с хостом Nagios¶

Для этого на хосте с WAF‑нодой:

1. Откройте конфигурационный файл NRPE (по умолчанию /usr/local/nagios/etc/nrpe.cfg).

2. Добавьте в директиву allowed_hosts файла IP‑адрес или полное доменное имя хоста Nagios. Например, если хост Nagios имеет IP‑адрес 10.0.30.30:

   allowed_hosts=127.0.0.1,10.0.30.30
   

3. Перезапустите сервис NRPE, выполнив одну из следующих команд:

   Ubuntu 14.04Другие поддерживаемые дистрибутивы

   sudo service nrpe restart
   

   sudo systemctl restart nrpe
   

2. Установите Nagios‑плагин NRPE на хост Nagios¶

Для этого на хосте Nagios:

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

2. Перейдите в директорию с исходными файлами плагина, соберите его и установите Nagios‑плагин.

   Минимальная последовательность действий такова:
   

   ./configure
   make all
   make install-plugin
   

3. Убедитесь, что Nagios‑плагин NRPE успешно взаимодействует с сервисом NRPE¶

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

/usr/local/nagios/libexec/check_nrpe -H node.example.local

В случае успешного функционирования NRPE в выводе команды должна содержаться версия NRPE (например, NRPE v3.2.1).

4. На хосте Nagios определите команду check_nrpe для запуска Nagios‑плагина NRPE с одним аргументом¶

Для этого добавьте в файл /usr/local/nagios/etc/objects/commands.cfg следующие строки:

define command{
    command_name check_nrpe
    command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$
 }

5. Установите утилиту collectd_nagios на хосте с WAF‑нодой¶

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

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

sudo yum install collectd-utils

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

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

1. С помощью утилиты visudo добавьте следующую строку в файл /etc/sudoers:

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

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

   Запуск collectd-nagios с правами суперпользователя

   Утилита должна запускаться с правами суперпользователя, поскольку она использует сокет collectd (сокет домена Unix) для получения данных. Доступ к этому сокету есть только у суперпользователя.

2. Убедитесь, что пользователь nagios может получать значения метрик от collectd, выполнив следующую тестовую команду на WAF‑ноде:

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

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

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

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

3. Добавьте в файл конфигурации сервиса NRPE префикс для запуска команд с помощью утилиты sudo:

   command_prefix=/usr/bin/sudo
   

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

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

command[check_wallarm_nginx_attacks]=/usr/bin/collectd-nagios -s /var/run/collectd-unixsock -n curl_json-wallarm_nginx/gauge-attacks -H node.example.local

После того, как в файл конфигурации сервиса NRPE добавлены все необходимые команды, перезапустите сервис NRPE, выполнив одну из следующих команд:

sudo service nrpe restart

sudo systemctl restart nrpe

8. На хосте Nagios задайте с помощью конфигурационных файлов хост с WAF‑нодой и набор сервисов, мониторинг которых необходимо осуществлять¶

Например, это можно сделать следующим образом:

1. Создайте файл /usr/local/nagios/etc/objects/nodes.cfg со следующим содержимым:

   define host{
    use linux-server
    host_name node.example.local
    address 10.0.30.5
   }
   
   define service {
     use generic-service
     host_name node.example.local
     check_command check_nrpe!check_wallarm_nginx_attacks
     max_check_attempts 5
     service_description wallarm_nginx_attacks
   }
   

   Этот файл определяет хост node.example.local с IP‑адресом 10.0.30.5, и команду для проверки состояния сервиса wallarm_nginx_attacks, что эквивалентно получению метрики curl_json-wallarm_nginx/gauge-attacks с WAF‑ноды (см. описание команды check_wallarm_nginx_attacks).

2. Добавьте в конфигурационный файл Nagios (по умолчанию, /usr/local/nagios/etc/nagios.cfg) следующую строку:

   cfg_file=/usr/local/nagios/etc/objects/nodes.cfg
   

   Это необходимо для того, чтобы Nagios начал использовать данные из созданного ранее файла nodes.cfg при следующем запуске.

3. Перезапустите сервис Nagios, выполнив одну из следующих команд:

   Ubuntu 14.04Другие поддерживаемые дистрибутивы

   sudo service nagios restart
   

   sudo systemctl restart nagios
   

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

Теперь Nagios осуществляет мониторинг сервиса, связанного с конкретной метрикой WAF‑ноды. При необходимости вы можете определить другие команды и сервисы для проверки интересующих вас метрик.