ecstasy

Ecstasy

Python Code style: black codecov CI

celery

Веб-приложение для взаимодействия с сетевым оборудованием

Позволяет отображать информацию о сетевых устройствах в удобном для чтения формате без ввода консольных команд.

img.png

Структура

img.png

Web-console позволит подключаться к оборудованию через терминал в браузере

Чтобы запустить и настроить web-console нужно следовать инструкции.

Возможности:

Кроме того, Ecstasy предоставляет дополнительные функции для визуализации и поиска сетевой информации:

Поддержка производителей оборудования:

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

Запуск

Склонируйте проект:

git clone https://github.com/ig-rudenko/ecstasy

Для выбора стабильной версии желательно переходить по тегам, смотрите релизы. Тег указывается без пробельных символов.

git checkout v20.0.4

Docker

Рекомендуемым и простым способом является запуск через docker compose.

Для начала скопируйте файл .env.example в .env и укажите свои данные в нём.

cp .env.example .env

Создайте папки для хранения данных и смените владельца на пользователя в контейнере.

mkdir logs static media configurations db-backup ssh_data
chown 1000:1001 logs static media configurations db-backup ssh_data

Теперь запустите контейнеры.

docker compose build;
docker compose up -d;

Далее создайте суперпользователя.

docker compose exec backend python manage.py createsuperuser;

Удобный поиск оборудования

img.png

Просмотр загруженности интерфейсов оборудований

img.png

При выборе оборудования показывается его информация:

img.png

При выборе конкретного порта открывается его информация: Описание, конфигурация, счетчик ошибок, диагностика состояния кабеля, список MAC адресов.

img_1.png

Для станционных терминалов GPON OLT возможен следующий вывод информации об интерфейсе (указан ниже).

img.png

Карты

Реализована возможность отображать и создавать интерактивные карты:

Интерактивные карты со слоями из Zabbix группы отображают доступность оборудования с описанием проблемы в Zabbix.

img.png

Топология VLAN

Построение топологии VLAN по оборудованию.

img.png

Топология прохождения MAC адреса

Определение маршрута MAC адреса между оборудованиями.

img.png

Поиск по описанию порта

img.png

Технические данные GPON подключений

img.png

Кастомные команды

import_from_zabbix

# python manage.py import_from_zabbix

Импорт узлов сети из zabbix

options:
  -h, --help            show this help message and exit
  -g GROUPS, --groups GROUPS
                        Имена Zabbix групп через запятую
  -a AUTH, --auth AUTH  Имя группы авторизации для узла сети
  -s, --save            Сохранить в базу узлы сети
  --change-group CHANGE_GROUP
                        Имя группы Ecstasy, которая будет использоваться для всех узлов сети. Если не указана, то будет использована оригинальная группа Zabbix
  --all-status          Импортируем также узлы сети, которые деактивированы в Zabbix
  --interface-scan {telnet,ssh,snmp}
                        Протокол для сбора интерфейсов узла сети. (по умолчанию ssh)
  --snmp-community SNMP_COMMUNITY
                        SNMP Community (необязательно)
  --cli-protocol {telnet,ssh}
                        Протокол для выполнения команд узла сети. (по умолчанию ssh)
  --name-pattern NAME_PATTERN
                        Паттерн для имени узлов сети. Если совпадает, то будет импортирован. (необязательно)
  --ip-pattern IP_PATTERN
                        Паттерн для IP узла сети. Если совпадает, то будет импортирован. (необязательно)
  --server SERVER       URL сервера Zabbix (необязательно)
  --user USER           Имя пользователя Zabbix (необязательно)
  --password PASSWORD   Пароль пользователя Zabbix (необязательно)
  --debug               Выводить дополнительную информацию
  --version             Show program's version number and exit.
  -v {0,1,2,3}, --verbosity {0,1,2,3}
                        Verbosity level; 0=minimal output, 1=normal output, 2=verbose output, 3=very verbose output
  --settings SETTINGS   The Python path to a settings module, e.g. "myproject.settings.main". If this isn't provided, the DJANGO_SETTINGS_MODULE environment variable will be used.
  --pythonpath PYTHONPATH
                        A directory to add to the Python path, e.g. "/home/djangoprojects/myproject".
  --traceback           Raise on CommandError exceptions.
  --no-color            Don't colorize the command output.
  --force-color         Force colorization of the command output.
  --skip-checks         Skip system checks.

[!NOTE] По умолчанию используются данные авторизации Zabbix хранимые в базе. Указывается через панель администратора: Settings -> Zabbix API Чтобы не сохранять в базу данных, а только протестировать какие узлы будут учитываться нужно выполнять команды без параметра --save.

Примеры:

Импорт активных узлов сети из Zabbix группы devs в новую группу devs ecstasy, с указанием группы авторизации creds-1, а также использование telnet как способа подключения к оборудованию:

python manage.py import_from_zabbix --save -g devs -a creds-1 --interface-scan=telnet --cli-protocol=telnet

Импорт активных узлов сети из диапазона 172.30.0.0/24 Zabbix группы devs в новую группу devs ecstasy, с указанием группы авторизации creds-1, а также использование ssh (По умолчанию SSH) как способа подключения к оборудованию:

python manage.py import_from_zabbix --save -g devs -a creds-1 --ip-pattern='172\.30\.0\.\d+'

Создание связей моделей

python manage.py graph_models -a --rankdir LR --dot -g -o ./docs/models.dot
dot -Tsvg ./docs/models.dot -o ./docs/models.svg
This site is open source. Improve this page.