Установка видеоаналитики¶
Видеоаналитика обнаруживает объекты в видеопотоке и создает эпизоды для просмотра и поиска в 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
На странице Стримеры проверьте доступность обоих узлов. Если соединение не установлено, проверьте адреса, порты, ключи и сетевой доступ между службами.
Затем включите нужный детектор на тестовой камере: распознавание лиц или распознавание автомобильных номеров. Проверьте появление эпизодов на странице События и оцените нагрузку сервера. Зеленый индикатор службы подтверждает соединение, но не заменяет проверку результатов на видео.
Порядок обновления см. в разделе Обновление видеоаналитики.