Маршрутизаторы, коммутаторы и контроллеры

Все сетевые устройства в одном окне

NetPulse получает данные через свой агент, SNMP, внешние агенты или маячок в прошивке коммутатора. Подходящий источник зависит от программного обеспечения устройства.

Совместимость

Как подключается каждая платформа

Здесь перечислены поддерживаемые семейства и возможности каждого источника. Точный набор данных зависит от модели и прошивки.

Источники данных, возможности и требования по платформам
Платформа Источник данных Доступные данные Требования и ограничения
OpenWrt и GL.iNet Собственный агент на маршрутизаторе Система, WiFi, клиенты и порты Установка из NetPulse на поддерживаемых версиях
MikroTik RouterOS 7+ Внешний Go-отправитель Хосты, точки доступа и порты Пользователь только для чтения и машина для supervisor
Asuswrt / Asuswrt-Merlin Зонды и отправитель на маршрутизаторе Система, WiFi, клиенты и порты Доступ SSH и постоянное место в /jffs
Другие интеграции Опросчик локального API BBox и beacon RTLPlayground BBox: система, WAN, хосты и скорости портов. RTL: состояние портов, скорости и FDB BBox: локальный API и машина для supervisor. RTL: продвинутый уровень, замена прошивки с копией для восстановления
UniFi Внешний опросчик контроллера Шлюзы, коммутаторы, точки доступа и клиенты одной площадки Без облака ui.com, CPU и температуры
Управляемые коммутаторы SNMP из NetPulse Порты, скорости и соседи LLDP-MIB Доступные MIB зависят от устройства
netpulse-integrations

Внешние агенты

MikroTik, Asuswrt и UniFi опрашивают маршрутизаторы или контроллеры и передают данные в NetPulse по HTTPS. Последняя карточка объединяет дополнительные источники с собственным транспортом.

MikroTik RouterOS 7+

Опрашивает RouterOS и отправляет хосты, точки доступа и порты.

  • Пользователь только для чтения и машина для supervisor
  • Бинарный API на порту 8728, REST как запасной вариант
  • WiFi Wave2 использует интерфейс wifi, а не capsman

Asuswrt и Asuswrt-Merlin

Отправитель работает на маршрутизаторе и использует переносимые зонды NetPulse. Его можно разместить в /jffs.

  • Доступ SSH и постоянное место в /jffs
  • Клиенты, радиомодули, каналы и порты Ethernet
  • Возможности зависят от прошивки и установленных утилит

UniFi

Читает шлюзы, коммутаторы, точки доступа и клиенты одной площадки на вашем контроллере.

  • Консоли UniFi OS и автономные контроллеры на вашем хостинге
  • Пользователь контроллера только для чтения
  • Без облачных учетных записей ui.com, CPU и температуры

и другие интеграции

Два дополнительных источника с разными требованиями.

  • BBox: опрашивает локальный API и отправляет систему, WAN, активные хосты и скорости портов.
  • RTLPlayground: beacon в прошивке для коммутаторов RTL8372/8373, передает состояние портов, скорости и FDB.
Прошивка для опытных

Маячок внутри коммутатора

Web-управляемые коммутаторы Realtek не могут запускать Go-агент. Форк RTLPlayground добавляет маячок, отправляющий данные прямо в приемник NetPulse.

Что получает NetPulse

  • Состояние и скорость канала каждые 30 секунд
  • Скорости трафика, вычисленные по счетчикам октетов каждого порта
  • Таблица FDB каждые пять минут для поиска клиентов по MAC-адресу

Что требуется

  • Модель из списка устройств RTLPlayground
  • Собрать форк для своей машины и задать идентификатор коммутатора
  • Заменить прошивку и иметь резервную копию flash и способ восстановления

Маячок использует UDP с открытым токеном в доверенной LAN. Он не использует подписанный HTTPS-транспорт внешних агентов.

Только внешние агенты

Почему отдельный репозиторий

RouterOS, Asus, BBox и UniFi используют отдельный репозиторий. NetPulse поддерживает контракт приема данных, а каждая интеграция следует циклу релизов производителя.

Отдельные жизненные циклы

Интеграция выпускает исправления под своим тегом, не ожидая релиза сервера.

Изолированные учетные данные

Пароль маршрутизатора или контроллера остается в настройках интеграции. NetPulse получает токен агента.

Только чтение

Эти интеграции опрашивают устройства и отправляют данные. Они не меняют их настройки из NetPulse.

Только то, что включаете

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

Транспорт внешних агентов

Подписанный контракт

Агент подписывает каждый снимок с помощью HMAC-SHA256 в заголовке X-Agent-Signature и отправляет его в приемник NetPulse со своим токеном. Устройство отображается как внешнее.

  • NetPulse, доступный по HTTPS оттуда, где работает агент
  • Токен маршрутизатора, созданный в приложении
  • Пользователь только для чтения на маршрутизаторе или контроллере

Собрать supervisor

git clone https://github.com/gnacho/netpulse-integrations cd netpulse-integrations go build -o netpulse-integrations ./cmd/integrations-supervisor

Репозиторий публикует статические двоичные файлы amd64 и arm64 с SHA-256. Пример модуля systemd прилагается.

Важные ограничения

  • Внешние агенты не настраивают маршрутизаторы и контроллеры.
  • Для OpenWrt и GL.iNet по-прежнему рекомендуется собственный агент.
  • Маячок не сообщает CPU, RAM или температуру и не отправляет таблицу LLDP.
  • Коммутатор с данными от маячка не может добавить SNMP как второй источник в NetPulse.
  • Маячок форка не входит в исходный проект RTLPlayground.

Начните со своего устройства

Установите NetPulse и следуйте руководству для своей платформы.

Внешний вид
Тема