Перейти к содержанию

Установка видеоаналитики

Видеоаналитика обнаруживает объекты в видеопотоке и создает эпизоды для просмотра и поиска в Watcher. Для ее работы нужны службы аналитики и модели. Прием и запись видео выполняет Watcher/watcher-streamer; аналитика подключается к этому контуру отдельно.

Модуль состоит из двух служб:

  • Inference — анализирует видеопотоки и обнаруживает объекты.
  • Identification — выполняет идентификацию и работает с данными персон.

Подготовка сервера

Выделите для аналитики отдельный сервер с доступом к Watcher, Central и видеопотокам камер. Нагрузка зависит от количества потоков, разрешения, частоты анализа и выбранных детекторов. Установка на сервер записи требует отдельной проверки запаса ресурсов.

Для проверки подключения можно использовать CPU. Для рабочей нагрузки подберите аппаратный ускоритель и объем памяти по результатам теста на ваших потоках; см. Расчет ресурсов аналитики. Драйвер ускорителя должен соответствовать используемому оборудованию и версии среды выполнения. Перед установкой проверьте совместимость выбранной ОС и оборудования с поставляемым комплектом аналитики.

В поставке Vision 26.11 предусмотрены варианты cpu, cuda, jetson и vulkan. Для CPU на x86-64 в поставке указана поддержка AVX2. Для выбранного варианта нужны соответствующие модели и runtime; совместимость конкретного оборудования проверяйте на их фактических версиях.

Контейнер Inference 26.11 основан на Ubuntu 22.04. Это окружение контейнера; ОС хоста и драйверы проверяются отдельно. Runtime CUDA собран с CUDA 11.5 для x86-64 и CUDA 10.2 для ARM64; сборка Jetson использует SDK L4T R32.7.5. Эти версии не задают универсальную совместимость всех GPU, Jetson и выпусков JetPack. Минимальную compute capability и объем памяти подбирайте по конкретным моделям и замерам.

Установка пакетов

Выполняйте команды с правами root. Подключите репозиторий стабильных пакетов Flussonic, если он еще не настроен; см. Установка Watcher.

apt update
apt-get -s install flussonic-vision
apt install flussonic-vision

Проверьте план установки перед подтверждением: комплект 26.11 включает vision-inference и vision-identification версии 26.11, а также пакет моделей vision-models. В этом релизе модели для разных вычислительных платформ поставляются единым пакетом.

Установщик создает конфигурационные файлы и примеры в /etc/vision/. Заполните рабочие файлы по инструкции ниже: установка пакетов не подключает камеры к аналитике автоматически.

Добавление аналитики в Watcher

Каждую службу зарегистрируйте отдельным узлом через административный API Watcher. Потребуются права администратора Watcher. Для каждой записи задайте уникальный hostname, роль и API URL службы. Если обе службы находятся на одном сервере, используйте разные порты.

Роль задается полем role при регистрации. В форме Стримеры → Добавить стример нет выбора Inference или Identification; эта форма создает обычный стример. Для служб аналитики выполните запросы ниже с авторизацией администратора.

Адреса и ключи в примерах — обозначения, которые нужно заменить значениями вашей установки. Не публикуйте заполненные запросы: api_url и cluster_key содержат ключ доступа к службе.

Добавление Inference

Отправьте PUT /watcher/admin-api/v3/streamers/inference1 с телом:

{
  "hostname": "inference1",
  "role": "inference",
  "api_url": "http://INFERENCE_API_KEY@vision.example.com:9030",
  "cluster_key": "INFERENCE_API_KEY"
}

INFERENCE_API_KEY замените ключом службы Inference: он должен совпадать с ее API_KEY. Имя inference1 потребуется в CONFIG_EXTERNAL.

Добавление Identification

Отправьте PUT /watcher/admin-api/v3/streamers/identification1 с телом:

{
  "hostname": "identification1",
  "role": "identification",
  "api_url": "http://IDENTIFICATION_API_KEY@vision.example.com:9050",
  "cluster_key": "IDENTIFICATION_API_KEY"
}

IDENTIFICATION_API_KEY должен совпадать с API_KEY службы Identification. Для подключения служб к Central используется отдельный ключ Central.

После настройки и запуска служб проверьте записи через GET /watcher/admin-api/v3/streamers/inference1 и GET /watcher/admin-api/v3/streamers/identification1: имена, роли и адреса должны соответствовать отправленным значениям. Доступность узлов также отображается на странице Стримеры.

Настройка служб

Следующие примеры предполагают доступность Central через адрес Watcher watcher.example.com. Замените имена узлов, адреса и ключи своими значениями. Указанные URL должны быть доступны именно с сервера аналитики.

Inference

Заполните /etc/vision/vision-inference.conf:

HTTP_PORT=9030
API_KEY=INFERENCE_API_KEY
HW=cpu
CONFIG_EXTERNAL=http://CENTRAL_API_KEY@watcher.example.com/central/api/v3/streamers/inference1/streams

Параметры:

  • HTTP_PORT — порт службы; он должен совпадать с портом в ее API URL в Watcher.
  • API_KEY — ключ доступа к службе Inference.
  • HW — вычислительная платформа. Пример, создаваемый пакетом 26.11, содержит HW=cpu. Доступны следующие варианты:

    • cpu — обработка на CPU.
    • cuda — обработка на настроенном устройстве NVIDIA CUDA.
    • jetson — вариант для совместимого NVIDIA Jetson.
    • vulkan — обработка через совместимый Vulkan runtime.
  • CONFIG_EXTERNAL — адрес получения конфигурации камер из Central. inference1 должен совпадать с именем зарегистрированного узла Inference.

CENTRAL_API_KEY возьмите из конфигурации вашего Central. Если Central установлен пакетами на этом сервере, его настройки находятся в /etc/central/central.conf.

Один процесс Inference использует одно устройство. Для нескольких GPU запускайте отдельные экземпляры службы с разными конфигурационными файлами, портами и DEVICEID; в пакетной установке для этого предусмотрен шаблон vision-inference@.service.

Identification

Заполните /etc/vision/vision-identification.conf:

HTTP_PORT=9050
API_KEY=IDENTIFICATION_API_KEY
CENTRAL_URL=http://CENTRAL_API_KEY@watcher.example.com/central/api/v3

Параметры:

  • HTTP_PORT — порт службы Identification, совпадающий с ее API URL в Watcher.
  • API_KEY — ключ доступа к этой службе.
  • CENTRAL_URL — адрес API Central с ключом для доступа к данным, необходимым для идентификации.

Запуск и проверка

Примените конфигурацию:

systemctl restart vision-inference vision-identification
systemctl status vision-inference vision-identification
journalctl -u vision-inference -u vision-identification -n 100 --no-pager

На странице Стримеры проверьте доступность обоих узлов. Если соединение не установлено, проверьте адреса, порты, ключи и сетевой доступ между службами.

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

Порядок обновления см. в разделе Обновление видеоаналитики.