Интерактивная карта коммутаторов, отображаемая в браузере с функцией автообнаружения по LLDP.
Для конечного пользователя это будет выглядеть как простая страница с картой и ничего более. Зеленым цветом отображаются устройства которые доступны (отвечают на SNMP-запросы), красным цветом те, которые недоступны.
При наведении указателя мыши на какую-то из точек показывается дополнительная информация: ip-адрес и модель.
Сервис в фоновом режиме постоянно сканирует сеть (диапазон ip-адресов задается в конфиге) и при обнаружении новых устройств добавляет их на карту.
Все до безобразия просто:
- В
docker-compose.yml
указать:- SNMP-comunity в параметре
READ_COMMUNITY
- блоки сетей из которых опрашивать устройства в парметре
NETWORKS_TO_DISCOVER
(через запятую) - период через который будут запускаться задачи обнаружения хостов в параметре
SCHEDULE_TIME
в секундах
- SNMP-comunity в параметре
- Запустить контейнеры с помощью
docker-compose up -d --scale worker=3
.
Демон берет из конфига диапазон ip-адресов и методично начинает проверять каждый ip-адрес путем посылки SNMP-запроса на получение локального LLDP ChassisID. Если ответ получен, то шлет дополнительные запросы, что бы определить модель устройства.
Отдельная задача выбирает все хосты из БД и для каждого из них получает LLDP соседей, занося информацию о их ChassisID в БД. Таким образом, имея на руках информацию LLDP с каждого устройства мы может построить карту сети. Делается это отдельной задачей, которая формирует файлик с хостами и связями в виде JSON.
На web-интерфейсе файлик с JSON разбирается небольшим скриптом на JS и с помощью D3.js отрисовывается на страничке.
Все построено на базе Celery и упаковано в Docker. Система состоит из следующих сервисов:
- beat - шедулер, который запускает команды на выполнение
- worker - код, который непосредственно исполняет команды
- rabbitmq - брокер для сообщений
- mongo - инстанс MongoDb для хранения информации о хостах
- web - контейнер с nginx и страничкой для отображения карты, слушает на порту 8080
- flower - web-интерфейс для наблюдения за состоянием исполнения задач