Ноды и флот

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

Нода — сервер, который забирает видео с камер, раздаёт его зрителям и пишет архив. Plane сам видео не передаёт: он хранит конфигурацию, раздаёт права и собирает телеметрию, а браузер оператора обращается за потоком напрямую к ноде. Поэтому состояние нод — первое, что смотрят при жалобах на видео.

Раздел Узлы (/admin/infrastructure/nodes) доступен только суперадмину. Админ организации и оператор пункта меню не видят, а прямой переход даёт «Страница не найдена». Рядом, на той же странице, вкладка «Туннельные агенты» — это отдельная сущность для камер за NAT, см. Камеры за NAT: туннели.

Список узлов#

Вверху четыре плитки: «Узлов во fleet» (настроенные медиасерверы), «Доступны» (из скольких настроенных), «Профилей в эфире» (активные основные и дополнительные профили) и «Требуют внимания» (недоступны, отключены или сообщают об ошибках).

Клик по строке открывает карточку узла. Кнопка в шапке — «Добавить ноду».

Этот список — не обычная таблица консоли: поиска, фильтров, экспорта CSV и массовых действий здесь нет, потому что нод во флоте единицы или десятки, а не тысячи.

Состояние и телеметрия обновляются живым потоком, без перезагрузки страницы. Если поток оборвался, появляется чип «Показаны последние известные данные узлов» — цифры на экране в этот момент устарели. Пока ни одной ноды не заведено, страница показывает «Медиаузлы ещё не настроены» и «Добавьте узел, чтобы получить готовую конфигурацию запуска.».

Добавление ноды#

Порядок обязателен: сначала нода создаётся в Plane, и только потом ставится на сервер. Подсказка формы говорит об этом прямо — «Сначала создайте логическую ноду. Fleet сгенерирует полный конфигурационный файл, который надо положить на сервер.».

После «Создать ноду» появляется тост «Нода создана. Скопируйте её конфигурацию на сервер.» и окно с готовым файлом node.conf. Полная процедура установки, спаривания и лицензирования — на странице Установка с нуля: Node.

Конфигурация ноды#

Окно «Конфигурация {имя}» открывается сразу после создания и в любой момент — кнопкой «Посмотреть конфигурацию» в карточке узла, раздел «Базовая конфигурация». В окне видно «Поколение» и весь текст node.conf; его можно скопировать в буфер или скачать файлом.

Инструкция под текстом: «Скопируйте весь файл на сервер ноды и запустите hastreamer-cctv-node, передав путь к нему. Листенеры, TLS и тюнинг можно менять локально; стримы и хранилища синхронизирует plane.». Это и есть граница ответственности: системную часть файла правят на сервере руками, рабочую нагрузку приводит в соответствие Plane. Разбор всех директив — node.conf — все директивы.

Карточка узла#

Адрес — /admin/infrastructure/nodes/<UUID>. Вверху имя ноды, версия и короткий идентификатор, состояние и возраст телеметрии. Шесть вкладок; каждая имеет собственный адрес через ?tab=.

Обзор#

Четыре плитки: «Доступность» (возраст телеметрии), «CPU хоста», «Память хоста» и «Время работы». Ниже блок «Стримы и сессии» со счётчиками: «Всего», «Live», «Ожидают», «Подключаются», «Деградация», «Ошибки», «Сессии».

Затем четыре графика за последние минуты: «CPU процесса» (с подписью «{n} из {m} сконфигурированных worker-ядер»), «RSS процесса», «CPU хоста» и «Память хоста». Под ними «Ядра CPU» — тепловая карта по каждому логическому ядру, «Наведите на ядро для текущей загрузки».

Внизу — «Runtime и состояние сети»: «Открытые FD», «Ошибки UDP», «Потери ядра», «Потери очереди», «RX в очереди». Растущие «Потери ядра» и «Потери очереди» означают, что нода не успевает разбирать входящий трафик: это ищут в Производительности, а не в настройках камеры.

Сессии#

Кто смотрит видео с этой ноды: «Стрим», «Протокол», «Клиент», «Субъект», «Исходящий трафик», «Потери», «Джиттер», «Отставание». Есть поиск по стриму, клиенту или пользователю. Подписи «Текущая страница обновляется live» и «Видимые строки обновляются каждые 2 секунды» объясняют, почему числа меняются на глазах: обновляются только видимые строки — так список остаётся дешёвым даже под нагрузкой.

Если в колонке «Субъект» стоит Share · …, поток смотрят по выданной ссылке доступа, а не под учётной записью.

Хранилища#

Список хранилищ ноды с занятостью, скоростями чтения и записи, IOPS, порогом вытеснения и состоянием холодного уровня S3. Здесь же добавляют диски и выполняют обязательную инициализацию — всё это описано на отдельной странице Хранилища DVR.

Логи#

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

sudo journalctl -u hastreamer-cctv-node --since '2 hours ago' --no-pager

Лицензия#

Что нода сообщает о своей лицензии: «Владелец», «Email», «Макс. потоков», «Истекает», «Обновления до», «HWID». Если нода недоступна или не ответила, показывается «Лицензия недоступна — нода недоступна или не сообщила о ней.».

HWID берут именно отсюда — код активации выпускается под него. Лезть за ним в журнал сервиса не нужно; это остаётся запасным способом для ноды, до которой Plane не достучался. Сам код активации кладётся файлом на сервер ноды — Лицензирование.

Лицензируется именно нода, а не Plane. Нелицензированная нода спаривается, видна в списке и отвечает на запросы, но не отдаёт ни одного кадра видео — при этом над консолью висит красный баннер лицензии. Подробности — Лицензирование.

Сеть и TLS#

Карточки раздела:

• «Адреса ноды» — «Публичный путь воспроизведения и приватный путь управления» плюс кнопка «Изменить».
• «TLS / сертификаты» — кнопка «Управлять TLS».
• «Базовая конфигурация» — кнопка «Посмотреть конфигурацию».
• «Рабочие ядра».
• «Опасные действия» — кнопка «Отключить».

Адреса ноды#

Кнопка «Изменить» в карточке «Адреса ноды» открывает форму «Сетевые адреса ноды» с двумя полями.

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

TLS ноды#

Кнопка «Управлять TLS» открывает окно «TLS / сертификаты». Ключевой выбор — «Владелец сертификата»:

Второй вариант годится только когда Plane и нода стоят на одном сервере. Состояние синхронизации показывается тут же: «Сертификаты Plane и Node совпадают» либо «Синхронизация сертификата требует внимания» с пояснением «Основной сертификат Node не совпадает с активным сертификатом Plane. Проверьте локальный синхронизатор.».

Ниже — «Активный сертификат Node»: имена сертификата (SAN), центр сертификации, срок действия, серийный номер, SHA-256 fingerprint и «Осталось дней: {n}». Блок «HTTPS и параметры ACME» задаёт «Порт HTTPS», «Каталог ACME» и «Контакт ACME», а «Управляемые сертификаты» позволяет добавить сертификат через «Настроить ACME» либо «Загрузить сертификат» (поля «Имена в сертификате», «Сертификат PEM», «Приватный ключ PEM», «Цепочка CA PEM (необязательно)»).

Проверить, что нода отдаёт именно ожидаемый сертификат, проще всего снаружи:

echo | openssl s_client -connect node.example.com:443 -servername node.example.com 2>/dev/null \
  | openssl x509 -noout -issuer -dates

Рабочие ядра#

Карточка «Рабочие ядра» задаёт, сколько ядер CPU нода отдаёт медиапроцессам. Значение записывается в node.conf директивой cores.

Изменение применяется не сразу: «Применяется при следующей загрузке конфигурации и перезапуске ноды — число ядер задаётся системно-локально.». После сохранения (тост «Число рабочих ядер обновлено») перезапустите службу на сервере ноды:

sudo systemctl restart hastreamer-cctv-node

Вывод из эксплуатации#

Кнопка «Отключить» в блоке «Опасные действия» переводит ноду в состояние «Выведен из эксплуатации».

Диагностика#

Более широкий разбор симптомов — Диагностика неисправностей. Всё то же самое через API — Ноды и хранилища.