Установка LibreNMS в Docker

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

Как установить LibreNMS

LibreNMS предоставляет два основных метода установки. Первый включает ручную установку и настройку LibreNMS и всех ее зависимостей, включая экземпляр MySQL / MariaDB и обратный прокси-сервер Nginx.

Этот первый метод подробно и ясно описан в документации по установке LibreNMS.

Второй метод заключается в использовании Docker Compose для совместного развертывания LibreNMS и ее зависимостей в наборе сетевых контейнеров Docker. Этот метод обеспечивает простой и доступный способ начать работу с LibreNMS.

В этом руководстве описывается второй метод, использующий Docker Compose. В следующих разделах вы узнаете все необходимые шаги для запуска LibreNMS с Docker Compose в вашей системе.

Установите Docker и создайте Docker Compose

Сначала вам необходимо установить Docker и Docker Compose, чтобы иметь возможность запускать LibreNMS, как описано в этом руководстве.

Следующие наборы шагов покажут вам, как установить Docker с помощью плагина Docker Compose в системах Debian и Ubuntu, CentOS и Fedora. Для получения информации о других операционных системах и дистрибутивах обратитесь к официальным инструкциям по установке Docker Engine вместе с плагином Docker Compose.

В Debian и Ubuntu

1. Удалите все существующие установки Docker.sudo apt remove docker docker-engine docker.io containerd runc
2. Установите необходимые пакеты для добавления репозитория Docker в диспетчер пакетов APT.sudo apt install ca-certificates curl gnupg lsb-release
3. Добавьте ключ GPG для репозитория Docker в диспетчер пакетов APT. Замените debian в URL-адресе в этой команде на ubuntu, если вы используете дистрибутив Ubuntu.sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
4. Добавьте репозиторий Docker в диспетчер пакетов APT. Опять же, замените debian в URL-адресе команды на ubuntu, если вы используете дистрибутив Ubuntu.echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
5. Обновите индексы APT и установите движок Docker Engine вместе с плагином Docker Compose.sudo apt update sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

CentOS и Fedora

1. Удалите все существующие установки Docker.sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux docker-engine-selinux docker-engine
2. Установите основные плагины для менеджера пакетов DNF. Они предоставляют вам доступ к инструментам для управления репозиториями DNF.sudo dnf -y install dnf-plugins-core
3. Добавьте репозиторий Docker в диспетчер пакетов DNF. Замените centos в URL-адресе в этой команде на fedora, если вы используете дистрибутив Fedora.sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
4. Установите движок Docker вместе с плагином Docker Compose.sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginВам может быть предложено подтвердить ключ GPG, и вы должны увидеть следующий ключ в списке.060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35

Завершите установку

Следуя любому пути установки, вы можете убедиться, что демон Docker запущен, используя приведенную ниже команду:

sudo systemctl status docker

● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2023-02-16 20:38:07 UTC; 1s ago
     Docs: https://docs.docker.com

Если он не запущен (active), включите и запустите демон Docker с помощью следующих команд:

sudo systemctl enable docker
sudo systemctl start docker

Установите LibreNMS через Docker Compose

Установив требования к Docker, вы можете собрать программу установки LibreNMS и начать запускать контейнеры LibreNMS в своей системе.

1. Создайте каталог для установки LibreNMS Docker и перейдите в этот каталог. В этом руководстве создается librenms-docker каталог в домашнем каталоге текущего пользователя.mkdir ~/librenms-docker/ cd ~/librenms-docker/
2. Загрузите репозиторий LibreNMS Docker в виде zip-архива и разархивируйте этот архив.Возможно, сначала потребуется установить wget и unzip инструменты. Оба варианта обычно доступны из менеджера пакетов в большинстве дистрибутивов Linux.wget https://github.com/librenms/docker/archive/refs/heads/master.zip unzip master.zip
3. (Необязательно) В этом руководстве используется стандартная настройка Docker Compose для LibreNMS. Как правило, настройка по умолчанию охватывает множество вариантов использования и особенно полезна для начинающих с LibreNMS.Однако именно здесь вы можете настроить развертывание Docker Compose перед запуском вашего экземпляра LibreNMS. Вы могли бы сделать это, изменив librenms.env и docker-compose.yml файлы в docker-master/examples/compose/ каталоге. Обратитесь к документации librenms / docker для подробного описания поддерживаемых переменных среды и параметров конфигурации.
4. Перейдите в каталог, содержащий конфигурацию Docker Compose — docker-master/examples/compose — и запустите docker compose up команду, чтобы запустить LibreNMS.cd docker-master/examples/compose sudo docker compose up -d
5. Чтобы разрешить внешний доступ к интерфейсу LibreNMS, вы должны открыть порт 8000 на брандмауэре вашей системы. Обратитесь к нашему руководству по настройке и защите вычислительного экземпляра для получения информации об управлении брандмауэрами.Следуйте этому руководству, чтобы проверить, какое средство брандмауэра использует ваша система, и убедиться, что средство активно. Затем используйте приведенные ниже команды, чтобы открыть порт 8000.
   • Debian и Ubuntu обычно включают инструмент UFW. Используя его, вы можете открыть порт с помощью следующей команды:sudo ufw allow 8000/tcp
   • CentOS, Fedora и аналогичные дистрибутивы обычно включают инструмент firewalld. Используя его, вы можете открыть порт с помощью следующих команд:sudo firewall-cmd --zone=public --add-port=8000/tcp --permanent sudo firewall-cmd --reload

Как использовать LibreNMS

Ваш экземпляр LibreNMS теперь запущен на порту вашей системы8000. Откройте интерфейс в вашем веб-браузере, перейдя к этому порту по общедоступному IP-адресу вашей системы.

Например, если общедоступный IP-адрес вашей системы 192.0.2.0, вы должны перейти к 192.0.2.0:8000 в своем веб-браузере.

Интерфейс указывает вам выполнить начальную настройку при первом доступе к нему. Следуйте следующему разделу, чтобы ознакомиться с этой настройкой, а затем читайте дальше для получения подробной информации об использовании LibreNMS для мониторинга и навигации по ней.

Завершите настройку

При первом доступе к интерфейсу LibreNMS предоставляет вам форму для создания пользователя-администратора для экземпляра. Сделайте это, указав имя пользователя-администратора, пароль и адрес электронной почты для пользователя-администратора в экземпляре.

Оттуда установите флажок в верхней части страницы, чтобы перейти к последнему шагу настройки. Укажите функции, которые вы хотели бы использовать, и нажмите кнопку Завершить установку, чтобы завершить начальную настройку.

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

Развертывание агента LibreNMS

Чтобы начать мониторинг, вам сначала понадобится агент, совместимый с LibreNMS, в системе, которую вы хотите отслеживать.

В этом разделе руководства показано, как настроить агента. В частности, в этом разделе рассказывается об установке SNMP в вашей системе и развертывании distro агента LibreNMS для получения информации о дистрибутиве.

Проще всего начать с этой системы под управлением LibreNMS, что и предполагается в данном руководстве. Однако вы также можете выполнить эти шаги и в другой системе, чтобы подготовить ее к мониторингу LibreNMS.

После этого перейдите к следующему разделу, чтобы подключиться к устройству из LibreNMS.

1. Установите SNMP в свою систему. Этот протокол позволяет LibreNMS получать информацию о системе.
   • В Debian и Ubuntu установите инструменты SNMP с помощью следующей команды:sudo apt install snmp snmpd
   • В CentOS, Fedora и аналогичных дистрибутивах установите SNMP tools с помощью следующей команды:sudo dnf install net-snmp net-snmp-utils
2. Настройте конфигурацию SNMP, расположенную по адресу /etc/snmp/snmpd.conf. Для этого руководства вам следует заменить конфигурацию по умолчанию на пример конфигурации, который вы можете найти в репозитории LibreNMS.sudo mv /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf.old sudo curl -o /etc/snmp/snmpd.conf https://raw.githubusercontent.com/librenms/librenms/master/snmpd.conf.example
3. Откройте этот файл конфигурации и замените RANDOMSTRINGGOESHERE именем сообщества для экземпляра SNMP. Для установки Docker по умолчанию используется значение librenmsdocker, что и предполагается в этом руководстве. Но вы можете использовать любое название сообщества, которое пожелаете.
4. Замените информацию в строках syslocation и syscontact на информацию, которую вы хотели бы связать с системой. Пример конфигурации включает описательные значения-заполнители для руководства, но вы можете изменить эти поля по своему усмотрению.
5. Загрузите distro двоичный файл, который предоставляет информацию о распространении через SNMP, и сделайте двоичный файл исполняемым.sudo curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro sudo chmod +x /usr/bin/distro
6. Загрузите librenms-agent репозиторий. Возможно, сначала вам потребуется установить Git через системный менеджер пакетов.git clone https://github.com/librenms/librenms-agent.git
7. Скопируйте check_mk агент из репозитория в путь к вашей системе и предоставьте ему права на выполнение.sudo cp librenms-agent/check_mk_agent /usr/bin/check_mk_agent sudo chmod +x /usr/bin/check_mk_agent
8. Скопируйте check_mk службу в расположение службы systemd.sudo cp librenms-agent/check_mk@.service check_mk.socket /etc/systemd/system
9. Создайте каталог для check_mk файлов скриптов и плагинов агента.sudo mkdir -p /usr/lib/check_mk_agent/local /usr/lib/check_mk_agent/plugins
10. Агент LibreNMS включает в себя ряд сценариев мониторинга, которые может использовать check_mk агент. Эти сценарии расположены в agent-local/ каталоге репозитория агента.Переместите те скрипты, которые вы хотите использовать, в /usr/lib/check_mk_agent/local/ каталог и предоставьте им права на выполнение. В этом примере копируются все файлы скриптов агента.sudo cp librenms-agent/agent-local/* /usr/lib/check_mk_agent/local/ sudo rm /usr/lib/check_mk_agent/local/README sudo chmod +x /usr/lib/check_mk_agent/local/*
11. Включите и запустите snmpd службу и check_mk агент LibreNMS.sudo systemctl enable snmpd sudo systemctl enable check_mk.socket sudo systemctl start snmpd sudo systemctl start check_mk.socket

Добавление устройства в LibreNMS

После того, как у вас есть SNMP и агент, развернутый в системе, которую вы хотите отслеживать, вы можете добавить эту систему в интерфейс LibreNMS.

1. Получите доступ к интерфейсу LibreNMS, как описано выше.
2. Перейдите к Устройствам > Добавить устройство в меню вверху страницы. Это приведет вас к форме для добавления нового устройства в LibreNMS.
3. Заполните форму для добавления нового устройства, указав следующую информацию.
   • Введите общедоступный IP-адрес системы в поле Имя хоста или IP.
   • Введите librenmsdocker в поле Сообщество или любое другое значение сообщества, которое вы указали в конфигурации SNMP.
   • Оставьте все остальные настройки со значениями по умолчанию.
4. Нажмите кнопку Добавить устройство, чтобы добавить систему в ваш экземпляр LibreNMS.

Устройства мониторинга

Теперь вы должны иметь возможность просматривать информацию об устройстве в интерфейсе LibreNMS.

Откройте опцию Устройства> Все устройства в меню вверху страницы. Возможно, вам сначала придется обновить страницу или перейти на другую страницу.

На результирующей странице перечислены все устройства, которые вы подключили к экземпляру LibreNMS.

Выбрав устройство, вы попадете на страницу с подробной информацией о системе и ее производительности.

Вкладки предоставляют вам ряд областей для просмотра устройства. Настроив LibreNMS check_mk агент, вы сможете найти ряд автоматически обнаруживаемых приложений на вкладке Приложения.

Вы можете использовать значок шестеренки в правом верхнем углу страницы устройства для управления устройством в LibreNMS. Отсюда вы можете начать расширять свой мониторинг с помощью многих других функций LibreNMS.

Например, используйте вкладку Правила оповещения, чтобы добавить условия оповещения для устройства. LibreNMS предоставляет возможность настройки набора правил оповещений по умолчанию, но вы также можете создавать полностью пользовательские правила.

Заключение

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

Источник