Многофункциональная система видеоаналитики FindFace Multi

FindFace Multi — это многофункциональная мультиобъектная система видеоаналитики, в основе которой лежит FindFace Enterprise Server, передовая технология распознавания на базе искусственного интеллекта. FindFace Multi представляет собой готовый к использованию продукт, который может использоваться в таких областях, как транспорт, розничная торговля, банковское обслуживание, индустрия развлечений, спортивные мероприятия, организация мероприятий, сервисы знакомств, видеонаблюдение, общественная и корпоративная безопасность и др.

FindFace Multi может обнаруживать, идентифицировать и анализировать следующие объекты на видеоизображении:

Человеческие лица, вместе с распознаванием таких атрибутов, как пол, возраст, эмоции, наличие очков, бороды, медицинской маски и многих других. Интегрированная в FindFace Multi антиспуфинговая система гарантирует, что перед камерой находится живой человек, и исключает возможность мошенничества с использованием фотографии лица на бумаге или экране мобильного устройства.
Человеческие силуэты, вместе с распознаванием типа и цвета одежды.
Транспортные средства, вместе с распознаванием таких атрибутов, как марка, модель, тип кузова, цвет, номер и других.

За доли секунды после идентификации и анализа объекта FindFace Multi уведомляет ответственных лиц о его появлении. Дополнительная информация об объекте, такая как пол, возраст человека, ГРЗ транспортного средства и др., отображается в соответствующем событии распознавания.

FindFace Multi поддерживает интеграцию сторонних решений через HTTP API и вебхуки, так что вы с легкостью сможете усовершенствовать свою текущую систему или приложение, добавив в них функциональность распознавания объектов.

Ключевые функции

Платформа на основе AI.
Комплексная картотека, содержащая сборную информацию о человеке/транспортном средстве.
Быстрый и надежный мониторинг видео в реальном времени по картотеке.
Мультиобъектная идентификация и аналитика: лица, силуэты, транспортные средства.
Поддержка потокового видео и архивов, большинства видеоформатов и кодеков, которые могут быть декодированы FFmpeg.
Прогрессивное управление камерами, включая поддержку ONVIF, возможность изменения ориентации видео, точной настройки камеры под распознавание объектов каждого типа, видеозаписи (если активирована функция Видеомагнитофон).
Мультиобъектная верификация: лица, силуэты, транспортные средства.
AI-распознавание пола, возраста, эмоций, очков, бороды, медицинской маски и других атрибутов лица.
AI-детектор живых лиц (Liveness).
AI-распознавание конкретных персон и транспортных средств.
AI-распознавание типа и цвета одежды.
AI-распознавание специальных транспортных средств, марки, модели, типа кузова, цвета, номера ТС.
Поиск лиц, силуэтов, транспортных средств в базах данных.
Возможность подсчета лиц, силуэтов и транспортных средств на подключенных камерах и определения расстояния между силуэтами. Поддержка подсчета по одной и нескольким камерам.
Видеонаблюдение. Запись видео с камер (Видеомагнитофон).
Возможность отслеживания присутствия людей в определенных областях по заданным правилам и расписаниям мониторинга.
Автоматическая кластеризация объектов одного происхождения (изображения лица/силуэта, принадлежащие одному человеку; изображения одного и того же транспортного средства), обогащенная сквозной интеграцией с картотекой.

Среда развертывания

Удобный консольный инсталлятор и дружественный интерфейс.
Развертывание на одном или нескольких серверах.
Повышенная производительность и отказоустойчивость в высоконагруженных системах с большим количеством подключенных камер и клиентов.
Возможность лицензирования в открытых и закрытых системах.
CPU- и GPU-ускорение на ваш выбор.

Безопасность системы

Расширенное управление пользователями.
Аутентификация на основании пароля, сертификата и лица для гарантированной защиты системы.
Безопасность данных в картотеке.
Комплексный, удобный журнал действий пользователя с возможностью поиска.
Утилиты резервного копирования и восстановления.
Возможность мониторинга сессий пользователей и блокировки устройств без деактивации учетных записей пользователей.

Этика использования данных

Полная поддержка законов о защите персональных данных (GDPR и аналогичных).

Расширенное использование системы

Анализ социальных взаимодействий.
Анализ аудитории.
Детализированные отчеты на события распознавания лиц, эпизоды, события поиска, кластеры, камеры, карточки, журнал действий пользователей и аудиторию.
Детектор живых лиц (liveness) как автономный сервис.

Полезные мелочи

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

Интеграция

Интеграция через HTTP API и вебхуки.
Партнерские интеграции с популярными системами.
Интеграция с периферийными устройствами.

Новое в FindFace Multi 2.1

Новые функции:

Пересечение линий: отслеживайте пересечения людьми или транспортными средствами заранее заданных виртуальных линий.
Тревожный монитор: получайте уведомления о тревожных событиях в отдельное десктопное приложение или его веб-версию.
Аналитический сервис BI: инструмент для визуализации и исследования данных.
Настройте отправку детектов во внешние обработчики с помощью нового поля URL роутера в настройках камеры.
Контроль работоспособности счетчиков: теперь можно отфильтровать счетчики по их состоянию (наличию технических проблем).

Технические изменения:

Интеграция с Annex.

См. Тревожный монитор
Многоуровневое хранение данных: сохранение данных сначала в горячее хранилище и последующий их перенос в холодное хранилище обеспечивают сглаживание пиковых нагрузок на систему.

Улучшенные алгоритмы, интерфейс, удобство использования:

Графический конструктор вебхуков: создавайте вебхуки через интерфейс пользователя в визуальном режиме или посредством кода.
Улучшения функциональности умного клинера VMS.

См.:
Обогатите карточку фотографией из события.
Новые нейронные сети с улучшенными характеристиками.

См. Настройка нейронных сетей FindFace Multi

Новые нейронные сети:

Обнаружение транспортных средств: новая версия car.gustav_accurate.006 и новая модель car.gustav_normal.004 с улучшенными показателями точности в области обнаружения ТС.
Обнаружение силуэтов: новые модели нейронных сетей для обнаружения силуэтов: body.gustav_accurate.019 с улучшенными характеристиками и body.jasmine_fast_nomany.018 (только GPU модель), используемая при малом количестве (10-20) объектов на кадре.
Распознавание лиц: новые модели нейронных сетей для распознавания лиц nectarine_xs_320 и nectarine_m_160, работающие быстрее и точнее, чем предшествующие им модели.
Распознавание транспортных средств: новая модель нейронной сети bottas с улучшенными показателями точности в распознавании ТС.
Распознавание силуэтов: новая модель нейронной сети для распознавания силуэтов pedrec.durga, в которой значительно улучшилось качество распознавания для различных сценариев розничной торговли (магазины и торговые центры).
Распознавание атрибутов лиц: новая версия headpose.v3, более точная и быстрая.

Руководство системного администратора

Эта глава посвящена развертыванию и последующему обновлению и техническому обслуживанию FindFace во время эксплуатации.

Архитектура

Хотя взаимодействие с FindFace Multi происходит в основном через веб-интерфейс, не забудьте уделить немного времени изучению архитектуры программного комплекса. Эти знания необходимы для развертывания, интеграции, обслуживания и устранения проблем при работе FindFace Multi.

В этой главе:

Объекты распознавания. Процесс распознавания
Платформа на основе Docker
Архитектурные элементы
Развертывание на одиночном сервере или в кластере
Аппаратное ускорение на CPU и GPU

Объекты распознавания. Процесс распознавания 

FindFace Multi может распознавать следующие объекты и их атрибуты:

человеческие лица
человеческие силуэты
транспортные средства

FindFace Multi обнаруживает объект на фотографии или видеоизображении и подготавливает его изображение с помощью нормализации. Далее нормализованное изображение используется для извлечения вектора признаков объекта (n-мерного вектора числовых признаков, которые характеризуют объект). Векторы признаков объектов хранятся в базе данных и в дальнейшем используются для верификации и идентификации.

Платформа на основе Docker 

FindFace Multi разворачивается в Docker, наборе продуктов формата платформа как услуга (PaaS), которые используют виртуализацию на уровне операционной системы, чтобы поставлять программное обеспечение в пакетах, называемых контейнерами. Каждый сервис FindFace Multi работает в контейнере Docker.

Архитектурные элементы 

FindFace Multi состоит из следующих основных архитектурных элементов:

Ядро FindFace, передовая технология распознавания объектов на базе искусственного интеллекта, которая может использоваться в качестве отдельного продукта FindFace Enterprise Server.
FindFace Multi, готовый прикладной модуль к FindFace Enterprise Server.

Внутренняя архитектура ядра FindFace позволяет встроить дополнительную функциональность «Видеомагнитофон», которая позволяет записывать, хранить и проигрывать видеоданные с камер.

Схема архитектуры 

architecture_ru

Ядро FindFace 

Внутри ядра FindFace – отдельный продукт FindFace Enterprise Server. Он включает в себя следующие компоненты:

Компонент	Используемые порты	Описание	Поставщик
findface-extraction-api	18666	Сервис, использующий нейронные сети для обнаружения объекта на изображении и извлечения его вектора признаков. Он также распознает атрибуты объектов (например, пол, возраст, эмоции, борода, очки, медицинская маска для объектов типа лицо). CPU- или GPU-ускорение.	Собственная разработка NtechLab
findface-sf-api	18411	Сервис, реализующий HTTP API обнаружения и распознания объектов.
findface-tarantool-server	32001, порты шардов (по умолчанию 330xx, 81xx)	Сервис, обеспечивающий взаимодействие между сервисом `findface-sf-api` и базой данных векторов признаков (базой, в которой хранятся векторы признаков объектов) на основе Tarantool.
findface-upload	3333	Веб-сервер на базе NginX, используемый как хранилище исходных изображений, миниатюр объектов и нормализованных изображений объектов. Если установлен Видеомагнитофон, `findface-upload` также хранит видеоданные с камер.
findface-facerouter	18820	Сервис, который используется для задания правил обработки обнаруженных на видео объектов. В FindFace Multi функции `findface-facerouter` выполняются `findface-multi-legacy` (см. Прикладной модуль FindFace Multi).
findface-video-manager	18810, 18811	Сервис, являющийся частью модуля видеодетекции объектов, через который осуществляется управление детекцией объектов на видео, а именно задаются настройки и список видеопотоков для обработки.
findface-video-worker	18999	Сервис, часть модуля видеодетекции объектов, который распознает объекты на видео и отправляет их нормализованные изображения, соответствующие видеокадры и метаданные (такие как время обнаружения) в сервис `findface-facerouter` для дальнейшей обработки в соответствие с заданными правилами. Если включен Видеомагнитофон, `findface-video-worker` отправляет видео в сервис `findface-video-storage`. Обеспечивает распознавание живых лиц при соответствующих настройках. Поддерживается CPU- и GPU-ускорение.
findface-ntls	443 (TCP), 3133, 3185	Локальный сервер лицензий, который проверяет подлинность лицензии FindFace Multi, взаимодействуя с глобальным сервером лицензий NtechLab. Для закрытых систем поддерживается лицензирование через ключ аппаратной защиты и по слепку с оборудования. Поддерживается лицензирование через прокси-сервер.
findface-counter	18300	Сервис, используемый для дедупликации событий.
findface-liveness-api	18301	Помимо встроенной функциональности, предоставляемой `findface-video-worker,` распознавание живых лиц (liveness) также предоставляется автономным сервисом `findface-liveness-api`. Сервис берет определенное количество кадров из видеофрагмента и возвращает изображение лица наилучшего качества и результат liveness в десятичном виде, усредненный по взятым кадрам. Сервис `findface-liveness-api` также участвует в процессе аутентификации пользователя по лицу.
Tarantool	Порты шардов (по умолчанию 330xx, 81xx)	Стороннее программное обеспечение, на основе которого реализована база данных, хранящая извлеченные векторы признаков и события распознавания объектов. Системные данные, карточки, пользовательские аккаунты и настройки камер хранятся в PostgreSQL (часть прикладного модуля FindFace Multi).	Tarantool
etcd	2379	Стороннее программное обеспечение, реализующее распределенное хранилище ключей для компонента `findface-video-manager`. Используется в качестве координационной службы в распределенной системе, обеспечивая отказоустойчивость видеодетектора объектов.	etcd
NginX	80; SSL: 8002, 8003, 443, 80	Стороннее программное обеспечение, которое реализует веб-интерфейсы системы.	nginx
memcached	11211	Стороннее программное обеспечение, реализующее сервис кэширования данных в оперативной памяти на основе хеш-таблицы. Используется компонентом `findface-sf-api` для временного хранения извлеченных векторов признаков перед их записью в базу данных Tarantool.	memcached

Прикладной модуль FindFace Multi 

Прикладной модуль FindFace Multi включает в себя следующие компоненты:

Компонент	Используемые порты	Описание	Поставщик
findface-multi-legacy	Настраивается	Сервис, который служит шлюзом доступа к ядру FindFace. Обеспечивает взаимодействие между ядром FindFace и веб-интерфейсом, работой системы в целом, HTTP и веб-сокетом, мониторингом объектов, уведомлениями о событиях, эпизодами, вебхуками, кластеризацией объектов и счетчиками.	Собственная разработка NtechLab
findface-multi-pause	н/п	Внутренние сервисы, помогающие `findface-multi-legacy`. Сервис `findface-multi-audit` является заделом на будущее. Он станет полностью функциональными в следующих версиях. На данный момент он частично дублирует функциональность `findface-multi-legacy`. Используйте `findface-multi-legacy` для работы с ним. Сервис `findface-multi-identity-provider` служит для аутентификации и управления пользователями и ролевой моделью доступов.
findface-multi-audit	8012, 8013, 8014
findface-multi-identity-provider	8022, 8023, 8024
findface-onvif-discovery	н/п
findface-multi-file-mover	н/п	Сервис-перекладчик, используется для реализации многоуровневого хранения данных. Сервис служит для переноса изображений из кратковременного хранилища в долговременное.
findface-multi-ui	Настраивается	Основной веб-интерфейс, использующийся для взаимодействия с FindFace Multi. Функционирует на основе фреймворка Django. Позволяет работать с событиями распознавания объектов, искать объекты в базах данных, управлять камерами, пользователями, карточками и списками наблюдения, собирать статистику в реальном времени и многое другое.
NATS	4222	Стороннее программное обеспечение, которое реализует брокер сообщений внутри `findface-multi-legacy`.	NATS
etcd	2379	Стороннее программное обеспечение, реализующее блокировки в сервисе `findface-multi-legacy`, например блокировки в механизме проверки лицензии, отчетах, обработке видео, кластеризации объектов и т. д.	etcd
Pgbouncer	5439	Стороннее программное обеспечение, обеспечивающее облегченный пул соединений для PostgreSQL. Необязательный компонент, используется для увеличения производительности базы данных при высокой нагрузке.	PgBouncer
PostgreSQL	5432	Стороннее программное обеспечение, реализующее основную базу данных системы. В базе данных хранятся карточки людей и транспортных средств, а также данные для внутреннего использования, включая учетные записи пользователей и настройки камер. Векторы признаков объектов и события распознавания объектов хранятся в Tarantool (часть ядра FindFace).	PostgreSQL

Видеомагнитофон 

Видеомагнитофон является дополнительно устанавливаемой частью ядра FindFace. Видеомагнитофон включает в себя следующие компоненты:

Компонент	Используемые порты	Описание	Поставщик
findface-video-storage	18611	Сервис, реализующий управление видеофрагментами. Получает видеофрагменты от компонента `findface-video-worker`, помещает их в хранилище (`findface-upload`), записывает метаинформацию и сведения о местонахождении видеофрагментов в базу данных Видеомагнитофона (MongoDB). По запросу от `findface-multi-legacy` выдает информацию об имеющихся видеофрагментах в форме ссылок на Websocket-потоки. Сервис `findface-video-streamer` использует данные ссылки, чтобы передать видео пользователю для просмотра и скачивания.	Собственная разработка NtechLab
findface-video-streamer	9000	По запросу от `findface-multi-ui` данный сервис по Websocket извлекает требуемые видеофрагменты из хранилища `findface-video-storage` и `findface-video-worker` (только последний фрагмент, если он еще не записан в хранилище). Далее он склеивает видеофрагменты в единое видео и передает его пользователю для просмотра и скачивания.	Собственная разработка NtechLab
MongoDB	27017	Стороннее программное обеспечение, реализующее базу данных Видеомагнитофона. База данных хранит метаинформацию о видеофрагментах, включая сведения об их местонахождении. Сами видеофрагменты хранятся в компоненте `findface-upload`.	MongoDB

См.также

Хранилища данных FindFace Multi

Развертывание на одиночном сервере или в кластере 

Вы можете развернуть FindFace Multi как на одиночном сервере, так и в многосерверной среде. При выборе последнего варианта доступны следующие схемы развертывания:

Центральный сервер FindFace Multi, взаимодействующий с несколькими дополнительными серверами для обработки видео (серверами, на которых установлен только findface-video-worker).

См. раздел Развертывание FindFace Video Worker на удаленных серверах.
Полностью распределенная архитектура FindFace Multi. Может понадобиться балансировка нагрузки. Свяжитесь с нашими экспертами по адресу support@ntechlab.com для получения рекомендаций.

См. раздел Стандартное развертывание в многосерверной среде.

Аппаратное ускорение на CPU и GPU 

Сервисы findface-extraction-api и findface-video-worker могут использовать как CPU-, так и GPU-ускорение. Нужный тип ускорения выбирается во время установки из консольного инсталлятора.

Важно

Для выбора конфигурации оборудования см. Требования.

Важно

Если разрешение используемой камеры превышает 1280x720 пикселей, настоятельно рекомендуется использовать пакет findface-video-worker с ускорением на GPU.

Примечание

Liveness-детектор на CPU работает гораздо медленнее, чем на GPU.

Требования

В этой главе:

Системные требования для базовой конфигурации
Необходимые навыки администратора
Форматы видеофайлов
Требования к камерам видеонаблюдения
- Распознавание лиц
- Распознавание силуэтов и автомобилей

Системные требования для базовой конфигурации 

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

Совет

Сначала обязательно ознакомьтесь с архитектурой FindFace.

Важно

Если разрешение видео превышает 1280x720 пикселей, настоятельно рекомендуется использовать пакет с ускорением на GPU findface-video-worker-gpu.

Важно

На серверах с процессором AMD полная функциональность CPU-сервиса findface-extraction-api не гарантируется. Вместо него используйте GPU-сервис findface-extract-api-gpu вместе с версией нейронных сетей для GPU.

Примечание

В случае высоконагруженной системы обязательно используйте SSD.

	Минимальная	Рекомендуемая
CPU	Intel Core i5 CPU с 4+ физическими ядрами 3+ ГГц. Поддержка AVX2	Intel Xeon Silver/Gold c 6+ физическими ядрами
CPU	На собственные нужды FindFace требуется 2 ядра HT > 2.5 ГГц. Характеристики также зависят от количества одновременно обрабатываемых видеофайлов. Для одного файла `720p@25FPS` требуется 2 ядра >2.5 ГГц. Поддержка AVX2.
GPU (опционально)	GeForce® RTX 3060 12 Гб	NVIDIA A10
GPU (опционально)	Поддерживаемые устройства: NVIDIA, архитектура Pascal и выше. Примечание: видеокарты NVIDIA GeForce RTX 40 Series в настоящее время не поддерживаются.
RAM	16 Гб	32+ Гб
RAM	Потребление оперативной памяти зависит от: количества используемых алгоритмов, видеопотока, количества выбранных детекторов и атрибутов, количества обрабатываемых объектов и т.д. Для одного видеофайла `720p@25FPS` требуется 2 ГБ RAM. При установке дополнительных сервисов (Аналитического сервиса BI, VMS, Тревожного монитора и других) потребление оперативной памяти увеличивается. Пожалуйста, свяжитесь с нашей службой поддержки для получения более подробной информации (support@ntechlab.com).
HDD (SSD для лучшей производительности)	65 Гб	65+ Гб
HDD (SSD для лучшей производительности)	На собственные нужды FindFace требуется 65 ГБ. Суммарный объем определяется в зависимости от требуемой глубины архива событий в базе данных и в логе из расчета 1.5 Мб на 1 событие.
Операционная система	Ubuntu Server / Desktop от 18 до 22, только x64, RHEL, CentOS 7, Debian 11.

Примечание

Вы также можете использовать виртуальную машину на базе процессора Intel, если поддерживаются инструкции AVX2, а 8 физических ядер выделены исключительно виртуальной машине.

Совет

Для более точного подбора конфигурации свяжитесь с нашими техническими экспертами по адресу support@ntechlab.com.

Необходимые навыки администратора 

Администратор FindFace Multi должен обладать навыками работы с ОС, на которой развернут экземпляр продукта, на уровне продвинутого пользователя.

Форматы видеофайлов 

FindFace Multi поддерживает широкий спектр форматов файлов в зависимости от типа ускорения, CPU или GPU.

Инсталляции с ускорением CPU и GPU поддерживают все кодеки FFmpeg. Кроме того, поддерживаются следующие кодеки:

CPU-ускорение: FLV (как кодек, так и как контейнер), H263, H264, H265, MJPEG, VP8, VP9, MPEG1VIDEO, MPEG2VIDEO, MSMPEG4v2, MSMPEG4v3.
GPU-ускорение: MJPEG, H264, H265, VP9 и другие, в зависимости от списка кодеков, поддерживаемых используемой видеокартой. Кроме того, для инсталляций с video-worker-gpu, можно расширить количество поддерживаемых кодеков, включив декодирование видео на CPU, которое недоступно по умолчанию.

Чтобы включить декодирование видео на CPU для инсталляций на GPU-ускорении, выполните следующее:

Откройте файл /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.
```
sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml
```
Установите cpu: true в разделе video_decoder.
```
...
video_decoder:
  cpu: true
...
```
Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Требования к камерам видеонаблюдения 

Распознавание лиц 

К установке и характеристикам камер видеонаблюдения в системе распознавания лиц на основе FindFace Multi предъявляются следующие основные требования:

Для корректной детекции в видеопотоке установите камеру таким образом, чтобы в ее поле зрения обязательно появлялось лицо каждого человека, входящего в зону наблюдения.
Угол вертикального наклона видеокамеры не должен превышать 15°. Вертикальный наклон — это отклонение оптической оси видеокамеры от горизонтальной плоскости, расположенной на уровне середины лица человека среднего роста (160 см).
Угол горизонтального отклонения не должен превышать 30°. Горизонтальное отклонение — это отклонение оптической оси видеокамеры от вектора движения основного потока объектов распознавания.
Минимальная плотность пикселей для идентификации – 500 пикселей/м (примерно соответствует ширине лица 80 пикселей).
Фокусное расстояние объектива должно выбираться таким образом, чтобы при заданном расстоянии до объектов съемки обеспечивалась необходимая плотность пикселей. На рисунке ниже приведен пример расчета фокусного расстояния объектива от расстояния между камерой и объектами съемки. Для расчета фокусного расстояния для конкретной камеры требуется использовать калькуляторы или методологию, предоставляемые производителем камеры.
Экспозиция должна быть настроена таким образом, чтобы лица были резкими (“в фокусе”), не смазанными и равномерно освещенными (не засвеченными и не слишком темными).
В зависимости от условий освещения (яркая засветка, слишком яркое или слишком тусклое освещение) рекомендуется использовать камеры с аппаратным WDR (Wide Dynamic Range) или другими технологиями, обеспечивающими компенсацию встречной засветки и/или слабой освещенности (BLC, HLC, DNR, высокая светочувствительность, Smart ИК-подсветка, AGC и др.).
Сжатие видео: большинство видеоформатов и кодеков, которые могут быть декодированы FFmpeg.
Протоколы передачи видеопотока: RTSP, HTTP.

Совет

Для расчета точной конфигурации оборудования в соответствии с вашими целями обратитесь к нашим специалистам по адресу support@ntechlab.com.

Распознавание силуэтов и автомобилей 

Пожалуйста, свяжитесь с нашей службой технической поддержки (support@ntechlab.com), чтобы получить требования к установке и характеристикам камер видеонаблюдения для распознавания силуэтов и транспортных средств.

Развертывание и удаление FindFace Multi

Платформа на основе Docker

FindFace Multi 2.0+ использует для работу платформу Docker. Прежде чем приступить к развертыванию FindFace Multi, вам потребуется установить и запустить продукты Docker. Для вашего удобства данная глава содержит раздел Подготовка сервера Ubuntu, описывающий тонкости установки Docker в Ubuntu. Для других платформ см. документацию Docker.

Драйвер NVIDIA и NVIDIA Container Runtime (только для GPU)

Если вы собираетесь развернуть FindFace Multi с GPU-ускорением, вам потребуется установить драйвер NVIDIA и среду NVIDIA Container Runtime. Информацию об этом вы найдете в разделе Подготовка сервера Ubuntu.

Варианты развертывания

После завершения подготовки сервера настало время развернуть FindFace Multi. Здесь предоставляются следующие возможности:

Автоматическая установка односерверной конфигурации FindFace Multi. Будучи самым простым, данный тип установки отлично подходит для начала работы с FindFace Multi. Мы рекомендуем выбрать его, если вы только знакомитесь с системой. Подробнее см. Автоматическое односерверное развертывание FindFace Multi.
Автоматическая установка и настройка FindFace Multi для взаимодействия с удаленными экземплярами findface-video-worker. Данный тип установки предназначен для развертывания FindFace Multi в многосерверной среде. Он требует наличия определенных технических навыков и знаний об архитектуре продукта. Чтобы автоматически установить только FindFace Video Worker (findface-video-worker) на удаленном сервере, обратитесь к разделу Развертывание FindFace Video Worker на удаленных серверах.
Полностью настраиваемая установка, которая требует фундаментального понимания архитектуры продукта. См. Полностью настраиваемая установка.

Примечание

Если вы выберете тип установки № 3, не забудьте установить необходимые модели нейронных сетей вместе с компонентом findface-extraction-api.

Вопросы инсталлятора и автоматическое развертывание продукта из файла с параметрами установки

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

Для установки той же конфигурации FindFace Multi на другом сервере используйте автоматическое развертывание из файла с параметрами установки. В этом случае вам не придется снова отвечать на вопросы инсталлятора. Точный путь к файлу с параметрами установки отображается сразу после последнего вопроса инсталлятора, до начала активной фазы установки:

[I 2023-02-09 11:13:37,187 main:142] Your answers were saved to /tmp/findface-installer-p01n9sn3.json

Важно

Обязательно удалите поля *.config, exp_ip и int_ip перед установкой FindFace Multi на сервере с другим IP-адресом.

Для запуска автоматического развертывания из файла /tmp/<findface-installer-*>.json, выполните следующую команду:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

Процедуры и первичные инструкции после развертывания

Ознакомьтесь с разделом Процедуры и первичные инструкции после развертывания, чтобы узнать, как установить часовой пояс, активировать лицензию и настроить ведение логов. Данный раздел также обучит вас нескольким основным командам, которые помогут вам начать работу с контейнерами FindFace Multi, если вы новичок в Docker.

Важно

Первый после развертывания запуск сервисов c GPU-ускорением findface-extraction-api и findface-video-worker может занять продолжительное время из-за процесса кэширования (до 45 минут).

Важно

Хотя FindFace Multi предоставляет инструменты для защиты от несанкционированного доступа, они не заменяют правильно настроенный межсетевой экран. Обязательно используйте файрвол, чтобы усилить защиту сети FindFace Multi.

Удаление экземпляра продукта

Для удаления экземпляра FindFace Multi вам потребуется выполнить выполнить набор команд. См. раздел Удаление экземпляра продукта.

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

Для того чтобы подготовить сервер на Ubuntu для развертывания FindFace Multi, следуйте приведенным ниже инструкциям, соблюдая последовательность.

Примечание

Для других платформ обратитесь к следующим ресурсам:

В этом разделе:

GPU: Установка драйверов NVIDIA
Установка продуктов Docker
GPU: Установка NVIDIA Container Runtime

GPU: Установка драйверов NVIDIA 

Первым шагом подготовки сервера является установка драйвера NVIDIA. Данный шаг актуален только для конфигурации GPU. Если ваша конфигурация использует CPU-ускорение, можно переходить к установке Docker.

Для работы FindFace Multi с ускорением на GPU потребуется драйвер NVIDIA 530 или более поздней версии. Добавьте репозиторий NVIDIA и установите из него подходящий драйвер.

Предупреждение

Не рекомендуется использовать в качестве альтернативы установщик .run c сайта NVIDIA Driver Downloads, так как драйверы, установленные посредством запуска .run файла, могут конфликтовать с драйверами, установленными посредством пакетов.

Для установки драйвера 530 из репозитория выполните следующие действия:

Установите ключ подписи репозитория:

arch=$(uname -m); version=$(. /etc/os-release; echo $ID$VERSION_ID | sed -r 's/\.//g'); sudo bash -c \
"sudo apt-key adv --fetch-keys https://developer.download.nvidia.com/compute/cuda/repos/$ID$version/$arch/3bf863cc.pub \
&& apt update"

Установите aptitude:
```
sudo apt-get install aptitude
```
Выполните установку nvidia-driver-530:
```
sudo aptitude install nvidia-driver-530
```
Выполните перезагрузку:
```
sudo reboot
```

Установка продуктов Docker 

Продукты Docker должны быть установлены как на CPU-, так и на GPU-серверах. Выполните следующие действия:

Обновите индекс пакетов apt и установите пакеты, чтобы разрешить apt использовать репозиторий через HTTPS.
```
sudo apt-get update

sudo apt-get install \
  ca-certificates \
  curl \
  gnupg \
  lsb-release
```
Совет

При выполнении группы команд sudo apt-get install \ возможны следующие ошибки:
```
E: Could not get lock /var/lib/dpkg/lock-frontend - open (11: Resource temporarily unavailable)
E: Unable to acquire the dpkg frontend lock (/var/lib/dpkg/lock-frontend), is another process using it?
```
Существуют два способа разрешить их:
1. Принудительно завершите все процессы apt-get, запущенные в данный момент в системе.
  sudo killall apt apt-get
2. Если предыдущая команда не помогла, выполните приведенный ниже набор команд. Если некоторые из подлежащих удалению каталогов не существуют, просто перейдите к следующей команде.
  sudo rm /var/lib/apt/lists/lock sudo rm /var/cache/apt/archives/lock sudo rm /var/lib/dpkg/lock sudo rm /var/lib/dpkg/lock-frontend sudo dpkg --configure -a

Добавьте на сервер официальный ключ GPG для Docker (ключ GNU Privacy Guard).

sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Настройте репозиторий Docker.

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Повторно обновите индекс пакетов apt.
```
sudo apt-get update
```
Совет

Если вы получили ошибку GPG при выполнении данной команды, попробуйте предоставить разрешение на чтение для файла открытого ключа Docker перед обновлением индекса пакетов.
```
sudo chmod a+r /etc/apt/keyrings/docker.gpg
sudo apt-get update
```

Установите 24.* версии продуктов Docker.

sudo apt-get install docker-ce=5:24* docker-ce-cli=5:24* containerd.io docker-buildx-plugin

Проверьте успешность установки Docker. Следующая команда загружает тестовый образ и запускает его в контейнере. Когда контейнер запускается, он печатает подтверждающее сообщение и завершает работу.

sudo docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:aa0cc8055b82dc2509bed2e19b275c8f463506616377219d9642221ab53cf9fe
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
   (amd64)
3. The Docker daemon created a new container from that image which runs the
   executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
   to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/

Установите docker-compose.

sudo curl -SL https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Выполните процедуры после установки Docker Engine, чтобы упростить свою будущую работу с контейнерами Docker и FindFace Multi. Как только вы будете в состоянии управлять Docker как пользователь без полномочий root, вам больше не понадобится применять sudo в командах, связанных с Docker.
```
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
```

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети.

sudo su
BIP=10.$((RANDOM % 256)).$((RANDOM % 256)).1
cat > /etc/docker/daemon.json <<EOF
{
    "bip": "$BIP/24",
    "fixed-cidr": "$BIP/24"
}
EOF

GPU: Установка NVIDIA Container Runtime 

Для развертывания контейнеризованного FindFace Multi с ускорением на GPU, потребуется установить NVIDIA Container Runtime. Мы рекомендуем установить NVIDIA Container Toolkit, который включает данную среду выполнения. Выполните следующие действия:

Укажите репозиторий и установите из него NVIDIA Container Toolkit, выполнив следующие команды.

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
      && curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
      && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | \
            sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
            sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update
sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети и использования среды NVIDIA Container Runtime, установленной вместе с NVIDIA Container Toolkit.

sudo su
BIP=10.$((RANDOM % 256)).$((RANDOM % 256))
cat > /etc/docker/daemon.json <<EOF
{
   "default-address-pools":
        [
                {"base":"$BIP.0/16","size":24}
        ],
    "bip": "$BIP.1/24",
    "fixed-cidr": "$BIP.0/24",
    "runtimes": {
         "nvidia": {
             "path": "nvidia-container-runtime",
             "runtimeArgs": []
         }
    },
    "default-runtime": "nvidia"
}
EOF

Перезапустите Docker.
```
systemctl restart docker
```

Теперь все готово для установки FindFace Multi. См. следующие разделы:

Подготовка сервера CentOS 7

Для того чтобы подготовить сервер на CentOS 7 для развертывания FindFace Multi, следуйте приведенным ниже инструкциям, соблюдая последовательность.

Примечание

Для других платформ обратитесь к следующим ресурсам:

В этом разделе:

Установка обновлений
GPU: Установка драйверов NVIDIA
Установка продуктов Docker
GPU: Установка NVIDIA Container Runtime

Установка обновлений 

Запустите обновление системы и перезагрузите сервер.
```
sudo yum update
sudo reboot
```
Установите fuse с помощью следующей команды.
```
sudo yum -y install fuse
```

GPU: Установка драйверов NVIDIA 

Первым шагом подготовки сервера является установка драйвера NVIDIA. Данный шаг актуален только для конфигурации GPU. Если ваша конфигурация использует CPU-ускорение, можно переходить к установке Docker.

Для работы FindFace Multi с ускорением на GPU потребуется драйвер NVIDIA 530 или более поздней версии. Загрузите соответствующий установщик .run c сайта NVIDIA Driver Downloads.

Так как установка производится через установщик .run, необходимо установить следующие зависимости:

sudo yum install kernel-devel gcc kernel-headers

Установка продуктов Docker 

Продукты Docker должны быть установлены как на CPU-, так и на GPU-серверах. Выполните следующие действия:

Установите пакет yum-utils (который предоставляет утилиту yum-config-manager) и настройте репозиторий.
```
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
```

Установите 24.* версии продуктов Docker.

sudo yum install docker-ce-3:24* docker-ce-cli-1:24* docker-ce-rootless-extras-24* containerd.io docker-buildx-plugin docker-compose-plugin

Перезапустите Docker.

sudo systemctl start docker
sudo systemctl enable docker

Проверьте успешность установки Docker. Следующая команда загружает тестовый образ и запускает его в контейнере. Когда контейнер запускается, он печатает подтверждающее сообщение и завершает работу.

sudo docker run hello-world

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:aa0cc8055b82dc2509bed2e19b275c8f463506616377219d9642221ab53cf9fe
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
   (amd64)
3. The Docker daemon created a new container from that image which runs the
   executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
   to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/

For more examples and ideas, visit:
https://docs.docker.com/get-started/

Установите docker-compose.

sudo curl -SL https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Выполните процедуры после установки Docker Engine , чтобы упростить свою будущую работу с контейнерами Docker и FindFace Multi. Как только вы будете в состоянии управлять Docker как пользователь без полномочий root, вам больше не понадобится применять sudo в командах, связанных с Docker.
```
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
```

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети и использования devicemapper.

sudo su
BIP=10.$((RANDOM % 256)).$((RANDOM % 256)).1
cat > /etc/docker/daemon.json <<EOF
{
    "bip": "$BIP/24",
    "fixed-cidr": "$BIP/24",
    "storage-driver": "devicemapper"
}
EOF

GPU: Установка NVIDIA Container Runtime 

Для развертывания контейнеризованного FindFace Multi с ускорением на GPU, потребуется установить NVIDIA Container Runtime. Мы рекомендуем установить NVIDIA Container Toolkit, который включает данную среду выполнения. Выполните следующие действия:

Укажите репозиторий и установите из него NVIDIA Container Toolkit, выполнив следующие команды.

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
   && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.repo | sudo tee /etc/yum.repos.d/nvidia-container-toolkit.repo
sudo yum clean expire-cache
sudo yum install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети, использования devicemapper и среды NVIDIA Container Runtime, установленной вместе с NVIDIA Container Toolkit.

sudo su
BIP=10.$((RANDOM % 256)).$((RANDOM % 256))
cat > /etc/docker/daemon.json <<EOF
{
   "default-address-pools":
        [
                {"base":"$BIP.0/16","size":24}
        ],
    "bip": "$BIP.1/24",
    "fixed-cidr": "$BIP.0/24",
    "runtimes": {
         "nvidia": {
             "path": "nvidia-container-runtime",
             "runtimeArgs": []
         }
    },
    "default-runtime": "nvidia",
    "storage-driver": "devicemapper"
}
EOF

Перезапустите Docker.
```
systemctl restart docker
```

Теперь все готово для установки FindFace Multi. См. следующие разделы:

Подготовка сервера Debian 11

Для того чтобы подготовить сервер на Debian 11 для развертывания FindFace Multi, следуйте приведенным ниже инструкциям, соблюдая последовательность.

Примечание

Для других платформ обратитесь к следующим ресурсам:

В этом разделе:

Установка FUSE
GPU: Установка драйверов NVIDIA
Установка продуктов Docker
GPU: Установка NVIDIA Container Runtime

Установка FUSE 

Установите файловую систему в пользовательском окружении (FUSE) с помощью следующей команды.
```
sudo apt install fuse -y
```

GPU: Установка драйверов NVIDIA 

Первым шагом подготовки сервера является установка драйвера NVIDIA. Данный шаг актуален только для конфигурации GPU. Если ваша конфигурация использует CPU-ускорение, можно переходить к установке Docker.

Для работы FindFace Multi с ускорением на GPU потребуется драйвер NVIDIA 530 или более поздней версии. Загрузите соответствующий установщик .run c сайта NVIDIA Driver Downloads.

Так как установка производится через установщик .run, необходимо установить следующие зависимости:

sudo apt install linux-headers-$(uname -r)
sudo apt install build-essential

Установка продуктов Docker 

Продукты Docker должны быть установлены как на CPU-, так и на GPU-серверах. Выполните следующие действия:

Обновите индекс пакетов apt и установите пакеты, чтобы разрешить apt использовать репозиторий через HTTPS.
```
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
```

Добавьте на сервер официальный ключ GPG для Docker (ключ GNU Privacy Guard).

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Настройте репозиторий Docker.

echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Повторно обновите индекс пакетов apt.
```
sudo apt-get update
```

Установите 24.* версии продуктов Docker.

sudo apt-get install docker-ce=5:24* docker-ce-cli=5:24* containerd.io docker-buildx-plugin

Проверьте успешность установки Docker.
```
sudo docker run hello-world
```
Эта команда загружает тестовый образ и запускает его в контейнере. Когда контейнер запускается, он печатает подтверждающее сообщение и завершает работу.

Установите docker-compose.

sudo curl -SL https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Выполните процедуры после установки Docker Engine, чтобы упростить свою будущую работу с контейнерами Docker и FindFace Multi. Как только вы будете в состоянии управлять Docker как пользователь без полномочий root, вам больше не понадобится применять sudo в командах, связанных с Docker.
```
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
```

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети.

sudo su
BIP=10.$((RANDOM % 256)).$((RANDOM % 256)).1
cat > /etc/docker/daemon.json <<EOF
{
    "bip": "$BIP/24",
    "fixed-cidr": "$BIP/24"
}
EOF

GPU: Установка NVIDIA Container Runtime 

Для развертывания контейнеризованного FindFace Multi с ускорением на GPU, потребуется установить NVIDIA Container Runtime. Мы рекомендуем установить NVIDIA Container Toolkit, который включает данную среду выполнения. Выполните следующие действия:

Укажите репозиторий и установите из него NVIDIA Container Toolkit, выполнив следующие команды.

distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
      && curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
      && curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | \
            sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
            sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update
sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Переключитесь на учетную запись суперпользователя.
```
sudo su
```

Внесите изменения в конфигурационный файл сервиса Docker для настройки сети и использования среды NVIDIA Container Runtime, установленной вместе с NVIDIA Container Toolkit.

BIP=10.$((RANDOM % 256)).$((RANDOM % 256))
cat > /etc/docker/daemon.json <<EOF
{
   "default-address-pools":
        [
                {"base":"$BIP.0/16","size":24}
        ],
    "bip": "$BIP.1/24",
    "fixed-cidr": "$BIP.0/24",
    "runtimes": {
         "nvidia": {
             "path": "nvidia-container-runtime",
             "runtimeArgs": []
         }
    },
    "default-runtime": "nvidia"
}
EOF

Перезапустите Docker.
```
systemctl restart docker
```

Теперь все готово для установки FindFace Multi. См. следующие разделы:

Автоматическое односерверное развертывание FindFace Multi

Для автоматического односерверного развертывания FindFace Multi следуйте приведенным ниже инструкциям. Будучи самым простым, данный тип установки отлично подходит для начала работы с FindFace Multi. Перед процедурой обязательно учтите системные требования и подготовьте сервер.

Важно

Для успешного функционирования системы после установки из инсталлятора IP-адрес сервера должен быть статическим. Для того чтобы сделать IP-адрес статическим, откройте файл /etc/network/interfaces и измените текущую запись для основного сетевого интерфейса так, как показано в примере ниже. Не забудьте заменить адреса в примере на актуальные с учетом настроек сети.

sudo vi /etc/network/interfaces

iface eth0 inet static
address 192.168.112.144
netmask 255.255.255.0
gateway 192.168.112.254
dns-nameservers 192.168.112.254

Перезапустите сетевые интерфейсы.

sudo service networking restart

С осторожностью редактируйте файл etc/network/interfaces. Перед тем как приступить к редактированию, ознакомьтесь c инструкцией по настройке сетей Ubuntu.

Выполните следующие действия:

Загрузите файл инсталлятора findface-*.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.

Примечание

Вместо findface-* укажите актуальное имя файла.
```
chmod +x findface-*.run
```

Запустите файл .run.

sudo ./findface-*.run

Инсталлятор задаст вам несколько вопросов, после чего проверит, соответствует ли сервер системным требованиям. Ответьте на вопросы надлежащим образом, после ответа каждый раз нажимая Enter. Вопросы и ответы следующие:

В: Which product should be installed? (Какой продукт следует установить?)

О: 1

1. [multi   ]  FindFace Multi
2. [server  ]  FindFace Server
3. [video-worker]  FindFace Video Worker

(default: multi)
product> 1

В: Please choose installation type: (Пожалуйста, выберите тип установки:)

О: 1

-  1 [stand-alone ]  Single Server
-  2 [multi-worker]  Single Server, Multiple video workers
-  3 [images      ]  Don't install anything, just load the images
-  4 [custom      ]  Fully customized installation

(default: stand-alone)
type> 1

В: Directory to install into: (Директория установки:)

О: Укажите директорию установки FindFace Multi. По умолчанию установка выполняется в /opt/findface-multi. Нажмите Enter для подтверждения. В противном случае укажите нужную директорию и нажмите Enter.
```
Directory to install into:
(default: /opt/findface-multi)
dest_dir>
```
В: Do you want to install Video Recorder?(y/n) (Хотите ли вы установить Видеомагнитофон?)

О: y или n, в зависимости от ваших нужд.
```
Do you want to install Video Recorder?(y/n)
install_video_recorder> n
```
В: Found X interface(s). Which one should we announce as our external address? (Было найдено X сетевых интерфейсов. Какой интерфейс следует использовать в качестве внешнего IP-адреса?)

О: Выберите интерфейс, который вы собираетесь использовать в качестве IP-адреса FindFace.
```
Found 1 interface(s). Which one should we announce as our external address?

-  1 [lo      ]  127.0.0.1
-  2 [ens3    ]  192.168.112.254

(default: 192.168.112.254)
ext_ip.advertised> 2
```

В: Which variant of Video Worker should be installed? (Какой вариант Video Worker следует установить?)

О: Укажите тип пакета findface-video-worker, CPU или GPU.

Which variant of Video Worker should be installed?

-  1 [cpu]  CPU-based implementation, slower but doesn't require GPU
-  2 [gpu]  CUDA-based implementation of video detector, requires NVIDIA GPU

(default: cpu)
findface-video-worker.variant> 1

В: Which variant of Extraction API should be installed? (Какой вариант Extraction API следует установить?)

О: Укажите тип пакета findface-extraction-api, CPU или GPU.

Which variant of Extraction API should be installed?

-  1 [cpu]  CPU-only implementation, slower but doesn't require GPU
-  2 [gpu]  CUDA-based implementation, faster, requires NVIDIA GPU (supports both CPU and GPU models)

(default: cpu)
findface-extraction-api.variant> 1

В: Do you want to configure detectors and features right now?(y/n) (Хотите ли вы настроить детекторы и распознавание атрибутов объектов сейчас?)

О: Мы рекомендуем установить и настроить функциональность обнаружения объектов и распознавания атрибутов объектов на этапе установки. Ответьте y, чтобы начать процесс. Вы можете пропустить данный шаг, ответив n и выполнив необходимые действия позже, следуя инструкциям в разделах Распознавание лиц и их атрибутов, Распознавание транспортных средств и их атрибутов и Распознавание силуэтов и их атрибутов .
```
Do you want to configure detectors and features right now?(y/n)
configure> y
```
В: Please select detectors to install: (Пожалуйста, выберите детекторы для установки:)

О: Данный вопрос появляется после запроса на установку и настройку функций обнаружения объектов и распознавания атрибутов объектов. В форме множественного выбора детектор лиц отмечен по умолчанию. Введите соответствующий номер, чтобы выбрать невыбранный детектор и наоборот. Например, чтобы добавить в конфигурацию детектор силуэтов и детектор транспортных средств, введите 2 3. Введите done, чтобы продолжить.
```
Please select detectors to install:

-  1 [v]  Face
-  2 [ ]  Body
-  3 [ ]  Car

Enter keyword to select matching choices or -keyword to clear selection.
Enter "done" to save your selection and proceed to another step.
detectors>2 3
-  1 [v]  Face
-  2 [v]  Body
-  3 [v]  Car

Enter keyword to select matching choices or -keyword to clear selection.
Enter "done" to save your selection and proceed to another step.
detectors> done
```
В: Enable liveness and attempt to continue installation?(y/n) (Включить детектор витальности лиц liveness и продолжить установку?)

О: Данный вопрос появляется после запроса на установку и настройку функций обнаружения объектов и распознавания атрибутов объектов. Чтобы установить встроенный детектор витальности лиц, введите y. В противном случае введите n.
```
Enable liveness and attempt to continue installation?(y/n)
enable_liveness> y
```
В: Please select face features to install: (Пожалуйста, выберите атрибуты лиц для установки:)

О: Данный вопрос появляется после запроса на установку и настройку функций обнаружения объектов и распознавания атрибутов объектов. По умолчанию установке подлежат все атрибуты лиц. Ответьте done для подтверждения. Если определенный атрибут не нужен, вы можете ввести ключевое слово (порядковый номер), связанное с ним. Например, введите 7, чтобы исключить распознавание положения головы. Затем введите done.

Вопросы по распознаванию атрибутов силуэтов и транспортных средств будут аналогичны, с несколькими вариантами ответов в зависимости от запрашиваемого типа детектора.
```
Please select face features to install:

-  1 [v]  Age
-  2 [v]  Gender
-  3 [v]  Emotions
-  4 [v]  Beard
-  5 [v]  Glasses
-  6 [v]  Medicine masks
-  7 [v]  Headpose

Enter keyword to select matching choices or -keyword to clear selection.
Enter "done" to save your selection and proceed to another step.
face_features> done
```
Вопросы по распознаванию атрибутов силуэтов и транспортных средств будут аналогичны, с несколькими вариантами ответов в зависимости от запрашиваемого типа детектора.
В: Please set findface-multi admin password (Пожалуйста, установите пароль для администратора FindFace Multi)

О: Задайте пароль для Супер Администратора (superuser).
```
Please set findface-multi admin password
findface-multi-admin-password> admin
```
В: Do you want to install Analytics service?(y/n) (Хотите ли вы установить сервис аналитики?)

О: Ответив да, вы установите сервис, который будет обрабатывать данные FindFace Multi для дальнейшего их использования в аналитических целях. На данный момент аналитика работает только для пересечения линий.
```
Do you want to install Analytics service?(y/n)
enable_analytics> y
```
В: Do you want to install Superset BI?(y/n) (Хотите ли вы установить BI-систему Superset?)

О: Установка внешней BI-системы позволит вам просматривать данные FindFace Multi для пересечения линий в этой системе в виде графиков. FindFace Multi выступает в качестве источника данных, а внешняя BI-система помогает визуализировать данные. Отвечая y на этот вопрос, вы выбираете установку программного приложения с открытым исходным кодом Apache Superset. Для входа в систему используйте учетные данные по умолчанию admin | admin. Позже пароль можно изменить в веб-интерфейсе системы. Если вы предпочитаете собственную BI-систему, вы можете пропустить предложенную установку и ответить n.
```
Do you want to install Superset BI?(y/n)
install_superset> y
```

После ответа на последний вопрос вы увидите путь к файлу с параметрами установки:

Your answers were saved to /tmp/findface-installer-t8qk_isw.json

Инсталлятор извлечет образы FindFace Multi из реестра Ntechlab и запустит следующие сервисы в контейнерах Docker:

Сервис	Контейнер	Конфигурация
findface-multi-pause	findface-multi-findface-multi-pause-1	Запускается
nats-jetstream	findface-multi-nats-jetstream-1	Запускается
mongodb	findface-multi-mongodb-1	Устанавливается вместе с Видеомагнитофоном. Запускается
findface-ntls	findface-multi-findface-ntls-1	Запускается
nats	findface-multi-nats-1	Запускается
postgresql	findface-multi-postgresql-1	Запускается
memcached	findface-multi-memcached-1	Запускается
findface-upload	findface-multi-findface-upload-1	Запускается
etcd	findface-multi-etcd-1	Запускается
findface-sf-api	findface-multi-findface-sf-api-1	Запускается
findface-extraction-api	findface-multi-findface-extraction-api-1	Запускается (CPU/GPU-ускорение).
findface-tarantool-server-shard-*	findface-multi-findface-tarantool-server-shard-*-1	Запускается. Количество экземпляров (шардов) рассчитывается по формуле: `N = min(max(min(mem_mb // 2000, cpu_cores), 1), 16 * cpu_cores)`. Т. е. количество равно размеру оперативной памяти в Мб, разделенному на 2000, или количеству физических ядер процессора (но не менее 1 шарда), или же количеству физических ядер процессора, умноженному на 16, если первое полученное значение больше.
findface-video-manager	findface-multi-findface-video-manager-1	Запускается
findface-counter	findface-multi-findface-counter-1	Запускается
findface-video-streamer	findface-multi-findface-video-streamer-1	Устанавливается вместе с Видеомагнитофоном. Запускается
findface-video-storage	findface-multi-findface-video-storage-1	Устанавливается вместе с Видеомагнитофоном. Запускается
pgbouncer	findface-multi-pgbouncer-1	Запускается
findface-liveness-api	findface-multi-findface-liveness-api-1	Запускается
findface-video-worker	findface-multi-findface-video-worker-1	Запускается (CPU/GPU-ускорение).
findface-onvif-discovery	findface-multi-findface-onvif-discovery-1	Запускается
findface-multi-audit	findface-multi-findface-multi-audit-1	Запускается
findface-multi-identity-provider	findface-multi-findface-multi-identity-provider-1	Запускается
findface-multi-legacy	findface-multi-findface-multi-legacy-1	Запускается
findface-multi-ui	findface-multi-findface-multi-ui-1	Запускается
findface-multi-line-crossing-analytics	findface-multi-findface-multi-line-crossing-analytics-1	Запускается
redis	findface-multi-redis-1	Запускается
rabbitmq	findface-multi-rabbitmq-1	Запускается
timescaledb	findface-multi-timescaledb-1	Запускается
findface-image-crop	findface-multi-findface-image-crop-1	Запускается
backend_api	findface-multi-backend_api-1	Запускается
service_notifier_ws	findface-multi-service_notifier_ws-1	Запускается
service_notifier_tg	findface-multi-service_notifier_tg-1	Запускается
backend_provider	findface-multi-backend_provider-1	Запускается
service_alarmer	findface-multi-service_alarmer-1	Запускается
superset-worker	findface-multi-superset-worker-1	Запускается
superset-init	findface-multi-superset-init-1	Запускается
superset-worker-beat	findface-multi-superset-worker-beat-1	Запускается
superset	findface-multi-superset-1	Запускается
findface-multi-sync	findface-multi-findface-multi-sync-1	Запускается
alarm-web-app	findface-multi-alarm-app-1	Запускается
findface-multi-file-mover	findface-multi-findface-multi-file-mover-1	Запускается

По завершении установки в консоль будет выведена информация, необходимая для использования FindFace Multi:

Совет

Обязательно сохраните эти данные: они вам понадобятся.

#############################################################################
#                       Installation is complete                            #
#############################################################################
- all configuration and data is stored in /opt/findface-multi
- upload your license to http://192.168.0.90/#/license/
- user interface: http://192.168.0.90/
superuser:      admin
documentation:  http://192.168.0.90/doc/
- superset BI:  http://192.168.0.90:8088/
2023/08/01 08:00:22 Installer finished

Выполните процедуры после развертывания.

Совет

Для установки той же конфигурации FindFace Multi на другом сервере используйте автоматическое развертывание из файла с параметрами установки. В этом случае вам не придется снова отвечать на вопросы инсталлятора. Точный путь к файлу с параметрами установки отображается сразу после последнего вопроса инсталлятора, до начала активной фазы установки:

[I 2023-08-01 07:56:36,323 main:142] Your answers were saved to /tmp/findface-installer-t8qk_isw.json

Обязательно удалите поля *.config, exp_ip и int_ip перед установкой FindFace Multi на сервере с другим IP-адресом.

Для запуска автоматического развертывания из файла /tmp/<findface-installer-*>.json, выполните следующую команду:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

Развертывание FindFace Video Worker на удаленных серверах

Вы можете установить экземпляры findface-video-worker отдельно от основного сервера FindFace Multi при создании многосерверной среды.

Важно

Прежде чем приступить к установке сервиса findface-video-worker на удаленных серверах, выполните следующие действия:

Разрешите доступ к лицензионному серверу findface-ntls с любого IP-адреса. Для этого откройте файл конфигурации /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml на сервере с findface-ntls и установите listen = 0.0.0.0:3133. Перезапустите контейнер findface-multi-findface-ntls-1.
```
sudo vi /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml

listen: 0.0.0.0:3133
```
```
sudo docker container restart findface-multi-findface-ntls-1
```
Разрешите доступ к сервису findface-video-manager с любого IP-адреса. Для этого откройте файл конфигурации /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml на сервере с findface-video-manager и установите listen: 0.0.0.0:18810 и rpc:listen: 0.0.0.0:18811. Перезапустите контейнер findface-multi-findface-video-manager-1.
```
sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

listen: 0.0.0.0:18810
...
rpc:
  listen: 0.0.0.0:18811
```
```
sudo docker container restart findface-multi-findface-video-manager-1
```
На сервере FindFace Multi откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и убедитесь, что параметр ROUTER_URL содержит внешний IP-адрес сервера FindFace Multi, а не localhost. Экземпляры findface-video-worker на удаленных серверах будут использовать данный адрес для отправки объектов.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...

'ROUTER_URL': 'http://192.168.0.12',

...
```

Для отдельной установки сервиса findface-video-worker выполните следующие действия:

Совет

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

Загрузите файл инсталлятора findface-*.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.

Примечание

Вместо findface-* укажите актуальное имя файла.
```
chmod +x findface-*.run
```
Запустите файл .run.
```
sudo ./findface-*.run
```
Инсталлятор задаст вам несколько вопросов, после чего проверит, соответствует ли сервер системным требованиям. Ответьте на вопросы надлежащим образом, после ответа каждый раз нажимая Enter. Вопросы и ответы следующие:
1. В: Which product should be installed? (Какой продукт следует установить?)
  
  О: 3
```
1. [multi   ]  FindFace Multi
2. [server  ]  FindFace Server
3. [video-worker]  FindFace Video Worker

(default: multi)
product> 3
```
2. В: Which variant of Video Worker should be installed? (Какой вариант Video Worker следует установить?)
  
  О: Укажите тип пакета findface-video-worker, CPU или GPU.
```
Which variant of Video Worker should be installed?

-  1 [cpu]  CPU-based implementation, slower but doesn't require GPU
-  2 [gpu]  CUDA-based implementation of video detector, requires NVIDIA GPU
```
3. В: Found X interface(s). Which one should we announce as our inter-service communication address? (Было найдено X сетевых интерфейсов. Какой интерфейс следует использовать в качестве адреса для межсервисной коммуникации?)
  
  О: Выберите интерфейс по умолчанию 2 для подключения к серверу FindFace Multi. Мы не рекомендуем использовать localhost.
```
Found 1 interface(s). Which one should we announce as our external address?

-  1 [lo      ]  127.0.0.1
-  2 [ens3    ]  192.168.112.254

(default: 192.168.112.254)
inter_ip.advertised> 2
```
4. В: Please enter FF.Multi or FF.Server IP address: (Пожалуйста, введите адрес сервера FindFace Multi или FindFace Enterprise Server)
  
  О: Укажите IP-адрес сервера FindFace Multi.
```
Please enter FF.Multi or FF.Server IP address:
server_addr> 192.168.112.25
```
После этого процесс установки будет автоматически запущен.

Выполните процедуры после установки.

Внесите изменения в файл findface-video-worker.yaml – заполните значения всех необходимых параметров. Убедитесь, что в секции models указаны detectors, normalizers и extractors, а в секции objects – соответствующие значения. Ниже приведен пример того, как должна выглядеть секция. Ее содержимое может отличаться в зависимости от выбранных объектов распознавания.

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  cache_dir: /var/cache/findface/models_cache
  detectors:
    face:
      fnk_path: /usr/share/findface-data/models/detector/face.jasmine_fast.003.cpu.fnk
      min_size: 60
    body:
      fnk_path: /usr/share/findface-data/models/detector/body.jasmine_fast.018.cpu.fnk
      min_size: 60
    car:
      fnk_path: /usr/share/findface-data/models/detector/car.jasmine_fast.005.cpu.fnk
      min_size: 60
  normalizers:
    face_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/crop2x.v2_maxsize400.cpu.fnk
    face_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/crop1x.v2_maxsize400.cpu.fnk
    body_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    body_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    car_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    car_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
  extractors:
    face_quality:
      fnk_path: /usr/share/findface-data/models/faceattr/quality_fast.v1.cpu.fnk
      normalizer: face_norm_quality
    body_quality:
      fnk_path: /usr/share/findface-data/models/pedattr/pedattr.quality.v0.cpu.fnk
      normalizer: body_norm_quality
    car_quality:
      fnk_path: /usr/share/findface-data/models/carattr/carattr.quality.v0.cpu.fnk
      normalizer: car_norm_quality
  objects:
    face:
      normalizer: face_norm
      quality: face_quality
      track_features: ''
    body:
      normalizer: body_norm
      quality: body_quality
      track_features: ''
    car:
      normalizer: car_norm
      quality: car_quality
      track_features: ''

Перезапустите контейнер findface-multi-findface-video-worker-1.

sudo docker container restart findface-multi-findface-video-worker-1

Важно

Если вы решили установить findface-ntls и/или findface-video-manager на серверах, отличных от серверов с findface-multi-legacy, укажите их IP-адреса в файле конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml после установки.

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

В параметре ntls-addr укажите IP-адрес сервера findface-ntls.

ntls_addr: 127.0.0.1:3133

В параметре mgr-static укажите IP-адрес сервера findface-video-manager, который будет обеспечивать findface-video-worker настройками и списком видеопотоков для обработки.

mgr:
  static: 127.0.0.1:18811

Совет

Чтобы установить экземпляр findface-video-worker на другом сервере, используйте автоматическое развертывание из файла с параметрами установки. В этом случае вам не придется повторно отвечать на вопросы инсталлятора. Точный путь к файлу с параметрами установки отображается сразу после последнего вопроса инсталлятора, перед началом активной фазы установки:

[I 2023-02-09 11:13:37,187 main:142] Your answers were saved to /tmp/findface-installer-p01n9sn3.json

Для запуска автоматического развертывания из файла /tmp/<findface-installer-*>.json, выполните следующую команду:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

Если ваш экземпляр findface-video-worker развернут в среде с несколькими GPU, то вам придется вручную настроить файл /opt/findface-multi/docker-compose.yaml.

В файле /opt/findface-multi/docker-compose.yaml в секции services укажите конфигурацию findface-video-worker для каждого запущенного экземпляра findface-video-worker. В параметре environment укажите правильный идентификатор GPU для CUDA_VISIBLE_DEVICES. Придерживайтесь приведенного ниже примера:

sudo vi /opt/findface-multi/docker-compose.yaml

services:
  ...
  findface-video-worker:
    command: [--config=/etc/findface-video-worker.yaml]
    environment: [CUDA_VISIBLE_DEVICES=0]
    image: docker.int.ntl/ntech/universe/video-worker-gpu:ffserver-9.230407.1
    logging: {driver: journald}
    network_mode: host
    restart: always
    runtime: nvidia
    volumes: ['./configs/findface-video-worker/findface-video-worker.yaml:/etc/findface-video-worker.yaml:ro',
      './models:/usr/share/findface-data/models:ro', './cache/findface-video-worker/models:/var/cache/findface/models_cache',
      './cache/findface-video-worker/recorder:/var/cache/findface/video-worker-recorder']
  findface-video-worker-1:
    command: [--config=/etc/findface-video-worker-1.yaml]
    environment: [CUDA_VISIBLE_DEVICES=1]
    image: docker.int.ntl/ntech/universe/video-worker-gpu:ffserver-9.230407.1
    logging: {driver: journald}
    network_mode: host
    restart: always
    runtime: nvidia
    volumes: ['./configs/findface-video-worker/findface-video-worker-1.yaml:/etc/findface-video-worker-1.yaml:ro',
      './models:/usr/share/findface-data/models:ro', './cache/findface-video-worker/models:/var/cache/findface/models_cache',
      './cache/findface-video-worker/recorder:/var/cache/findface/video-worker-recorder']

В этой же секции укажите переменные окружения для каждого экземпляра findface-video-worker. Придерживайтесь приведенного ниже примера:
```
findface-video-worker:
  image: docker.int.ntl/ntech/universe/video-worker-gpu:ffserver-9.230407.1
  ...
  environment:
    - CFG_MGR_STATIC=vm:18811
    - CFG_NTLS_ADDR=ntls:3133
    - CFG_STREAMER_PORT=9999
    - CFG_STREAMER_URL=127.0.0.1:9999
    - CFG_STREAMER_TRACKS=true
    #- CFG_RESOLUTIONS=1920x1080
```
Важно

Для корректной работы несколько экземпляров findface-video-worker не должны ссылаться на один и тот же CFG_STREAMER_PORT. Убедитесь, что вы указали уникальный CFG_STREAMER_PORT для каждого экземпляра findface-video-worker.
Выполните пересборку контейнеров FindFace Multi из директории /opt/findface-multi.
```
cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d
```

Пошаговое развертывание Видеомагнитофона

Существуют следующие способы развертывания Видеомагнитофона:

Автоматически при развертывании FindFace Multi из консольного инсталлятора. Подробнее см. в Автоматическое односерверное развертывание FindFace Multi.
Пошагово. Рекомендуется в многосерверной среде.

Данный раздел посвящен пошаговому развертыванию Видеомагнитофона. Выполните приведенные ниже инструкции, придерживаясь заданного порядка.

Совет

Сначала обязательно ознакомьтесь с архитектурой FindFace Multi.

В этом разделе:

Установка apt-репозитория
Установка основных компонентов

Установка apt-репозитория 

Прежде всего установите apt-репозиторий FindFace следующим образом:

Загрузите файл инсталлятора findface-*.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.
```
chmod +x findface-*.run
```
Запустите файл .run.
```
sudo ./findface-*.run
```

Инсталлятор задаст вам несколько вопросов, после чего проверит, соответствует ли сервер системным требованиям. Ответьте на вопросы надлежащим образом, после ответа каждый раз нажимая Enter. Вопросы и ответы следующие:
B: Which product should be installed? (Какой продукт следует установить?)

O: 1
Which product should be installed?

  1. [multi   ]  FindFace Multi
  2. [server  ]  FindFace Server
  3. [video-worker]  FindFace Video Worker

(default: multi)
product> 1
B: Please choose installation type: (Пожалуйста, выберите тип установки:)

O: 3
-  1 [stand-alone ]  Single Server
-  2 [multi-worker]  Single Server, Multiple video workers
-  3 [images      ]  Don't configure or start anything, just load the images and copy the models
-  4 [custom      ]  Fully customized installation

(default: stand-alone)
type> 3
B: Directory to install into: (Директория установки:)

О: Укажите директорию установки FindFace Multi. По умолчанию установка выполняется в /opt/findface-multi. Нажмите Enter для подтверждения. В противном случае укажите нужную директорию и нажмите Enter.
Directory to install into:
(default: /opt/findface-multi)
dest_dir>
В: Select models to install. Note that you will need to accordingly edit extraction-api and tntapi configuration files. At least one of recognition models has to be enabled. (Выберите модели для установки. Обратите внимание, что вам нужно будет отредактировать файлы конфигурации extraction-api и tntapi. Должна быть включена хотя бы одна из моделей распознавания.)

О: По умолчанию все модели нейронных сетей подлежат установке. Вы можете оставить все выбранные модели, введя done, или выбрать конкретные модели. Для этого отмените выбор всех моделей из списка, введя -* в командной строке, затем выберите необходимые модели, введя их порядковые номера (keyword): например, 1 3 4. Введите done, чтобы сохранить выбранный вами вариант и перейти к следующему шагу. Если FindFace Multi был развернут ранее, модели устанавливать не нужно.
Select models to install.
Note that you will need to accordingly edit extraction-api and tntapi configuration files.
At least one of recognition models has to be enabled.

-  1 [ ] ./models/carattr/carattr.categories.v0.cpu.fnk
...
- 91 [ ] ./models/pedrec/pedrec.clio.gpu.fnk

Enter keyword to select matching choices or -keyword to clear selection.
Enter "done" to save your selection and proceed to another step.
findface-data.models> done
После этого apt-репозиторий FindFace будет автоматически установлен.

Установка основных компонентов 

Для того чтобы установить компоненты Видеомагнитофона, выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/docker-compose.yaml. Добавьте findface-video-storage и findface-video-streamer сервисы.

sudo vi /opt/findface-multi/docker-compose.yaml

...
findface-video-storage:
  command: [--config=/etc/findface-video-storage.conf]
  depends_on: [mongodb]
  image: docker.int.ntl/ntech/universe/video-storage:ffserver-9.230407.1
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-video-storage/findface-video-storage.yaml:/etc/findface-video-storage.conf:ro']
findface-video-streamer:
  command: [--config=/etc/findface-video-streamer-cpu.ini]
  depends_on: [findface-ntls, mongodb]
  image: docker.int.ntl/ntech/universe/video-streamer-cpu:ffserver-9.230407.1
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-video-streamer/findface-video-streamer.yaml:/etc/findface-video-streamer-cpu.ini:ro',
    './cache/findface-video-streamer:/var/cache/findface/video-streamer']

Создайте директории.

sudo mkdir -p /opt/findface-multi/configs/findface-video-storage/ /opt/findface-multi/configs/findface-video-streamer/

Создайте файл конфигурации /opt/findface-multi/configs/findface-video-storage/findface-video-storage.yaml и добавьте в него следующее:

sudo vi /opt/findface-multi/configs/findface-video-storage/findface-video-storage.yaml

listen: :18611
debug: false
external-address: http://ip_address:18611/
streamer:
  endpoints:
  - 127.0.0.1:9000
chunk-storage:
  type: webdav
  webdav:
    timeouts:
      connect: 5s
      response_header: 30s
      overall: 35s
      idle_connection: 10s
    max-idle-conns-per-host: 20
    keepalive: 24h0m0s
    trace: false
    upload-url: http://127.0.0.1:3333/uploads/video_storage
  s3:
    endpoint: ''
    bucket-name: ''
    access-key: ''
    secret-access-key: ''
    secure: true
    region: ''
    public-url: ''
    operation-timeout: 30
  localfs:
    directory: ''
meta-storage:
  mongo-uri: mongodb://127.0.0.1
  database: video-storage
  timings:
    connect: 3s

Примечание

В разделе external-address необходимо вставить ip-адрес FindFace Multi.

Создайте файл конфигурации /opt/findface-multi/configs/findface-video-streamer/findface-video-streamer.yaml и добавьте следующее:

sudo vi /opt/findface-multi/configs/findface-video-streamer/findface-video-streamer.yaml

streamer:
  port: 9000
  max_backpressure: 33554432
  io_buffer_size: 524288
video_storage:
  url: http://127.0.0.1:18611
  timeout: 6
cache:
  dir: /var/cache/findface/video-streamer

Запустите контейнеры FindFace Multi:
```
cd /opt/findface-multi/
docker-compose up -d
```

На этом развертывание Видеомагнитофона будет завершено. Для того чтобы настроить Видеомагнитофон после развертывания, следуйте инструкции.

Полностью настраиваемая установка

Консольный инсталлятор FindFace Multi предоставляет несколько вариантов установки, в том числе полностью настраиваемый вариант (установку отдельно выбранных пакетов). Данный вариант в основном используется при развертывании FindFace Multi в сильно распределенной среде и требует определенного уровня знаний и опыта.

Для запуска полностью настраиваемой установки выполните следующие действия:

Загрузите файл инсталлятора findface-*.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.

Примечание

Вместо findface-* укажите актуальное имя файла.
```
chmod +x findface-*.run
```
Запустите файл .run.
```
sudo ./findface-*.run
```
Инсталлятор задаст вам несколько вопросов, после чего проверит, соответствует ли сервер системным требованиям. Ответьте на вопросы надлежащим образом, после ответа каждый раз нажимая Enter. Вопросы и ответы следующие:
1. В: Which product should be installed? (Какой продукт следует установить?)
  
  О: 1
```
Which product should be installed?

  1. [multi   ]  FindFace Multi
  2. [server  ]  FindFace Server
  3. [video-worker]  FindFace Video Worker

(default: multi)
product> 1
```
2. В: Please choose installation type: (Пожалуйста, выберите тип установки:)
  
  О: 4
```
Please choose installation type:

-  1 [stand-alone ]  Single Server
-  2 [multi-worker]  Single Server, Multiple video workers
-  3 [images      ]  Don't configure or start anything, just load the images and copy the models
-  4 [custom      ]  Fully customized installation

(default: stand-alone)
type> 4
```
3. В: Directory to install into: (Директория установки:)
  
  О: Укажите директорию установки FindFace Multi. По умолчанию установка выполняется в /opt/findface-multi. Нажмите Enter для подтверждения. В противном случае укажите нужную директорию и нажмите Enter.
```
Directory to install into:
(default: /opt/findface-multi)
dest_dir>
```
4. В: Please enter path to docker-compose binary: (Пожалуйста, введите путь к бинарному файлу docker-compose)
  
  О: Укажите фактический путь к бинарному файлу docker-compose. По умолчанию предлагается /usr/local/bin/docker-compose, и это тот путь, который вы получите при установке docker-compose согласно инструкциям. Нажмите Enter для подтверждения. В противном случае укажите другой путь и нажмите Enter.
```
Please enter path to docker-compose binary
(default: /usr/local/bin/docker-compose)
docker_compose>
```
5. В: Found X interface(s). Which one should we announce as our external address? (Было найдено X сетевых интерфейсов. Какой интерфейс следует использовать в качестве внешнего IP-адреса?)
  
  О: Выберите интерфейс, который вы собираетесь использовать в качестве IP-адреса FindFace.
```
Found 1 interface(s). Which one should we announce as our external address?

-  1 [lo      ]  127.0.0.1
-  2 [ens3    ]  192.168.112.254

(default: 192.168.112.254)
ext_ip.advertised> 2
```
6. В: Found X interface(s). Which one should we announce as our inter-service communication address? (Было найдено X сетевых интерфейсов. Какой интерфейс следует использовать в качестве адреса для межсервисной коммуникации?)
  
  О: Выберите интерфейс для межсервисного взаимодействия.
```
Found 1 interface(s). Which one should we announce as our inter-service communication address?

-  1 [lo      ]  127.0.0.1
-  2 [ens3    ]  192.168.112.254

(default: 192.168.112.254)
inter_ip.advertised> 2
```
7. В: Please select FindFace Multi components to install: (Пожалуйста, выберите компоненты FindFace Multi для установки:)
  
  О: Выберите компоненты FindFace для установки. По умолчанию установке подлежат все компоненты. Вы можете оставить все как есть, введя done, или выбрать определенные компоненты. Для того чтобы выбрать нужные, сначала снимите выделение со всех компонентов, введя в командной строке -*, затем введите порядковые номера нужных компонентов через пробел, например: 1 7 13 и т. д. Введите done для сохранения выбора и перехода к следующему шагу.
  
  Предупреждение
  
  Не рекомендуется исключать компонент pause из установки, так как оставшиеся компоненты останутся без сетевого идентификатора (namespace), к которому можно подключиться.
  
  Если вы исключаете компонент pause намеренно, вам потребуется отредактировать файл /opt/findface-multi/docker-compose.yaml и указать имя хоста для каждого сервиса в параметре network_mode.
```
Please select FindFace Multi components to install:

-  1 [v]  findface-data        - Face recognition models
...
...

Enter keyword to select matching choices or -keyword to clear selection.
Enter "done" to save your selection and proceed to another step.
components> done
```
8. Конкретные вопросы, связанные с выбранными компонентами: тип ускорения, необходимое количество экземпляров компонента, модели нейронных сетей и т. д. Если вы затрудняетесь с ответом, попробуйте найти его в этой документации или отправьте свой вопрос по адресу support@ntechlab.com.
9. В: Please set findface-multi admin password (Пожалуйста, установите пароль для администратора FindFace Multi)
  
  О: Задайте пароль для Супер Администратора (superuser).
```
Please set findface-multi admin password
findface-multi-admin-password> admin
```
Инсталлятор извлечет образы FindFace Multi из реестра Ntechlab и запустит ассоциированные сервисы в контейнерах Docker.
Выполните процедуры после развертывания.

Совет

Для установки той же конфигурации FindFace Multi на другом сервере используйте автоматическое развертывание из файла с параметрами установки. В этом случае вам не придется снова отвечать на вопросы инсталлятора. Точный путь к файлу с параметрами установки отображается сразу после последнего вопроса инсталлятора, до начала активной фазы установки:

[I 2023-02-09 11:13:37,187 main:142] Your answers were saved to /tmp/findface-installer-p01n9sn3.json

Обязательно удалите поля *.config, exp_ip и int_ip перед установкой FindFace Multi на сервере с другим IP-адресом.

Для запуска автоматического развертывания из файла /tmp/<findface-installer-*>.json, выполните следующую команду:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

Стандартное развертывание в многосерверной среде

Данный раздел посвящен развертыванию FindFace Multi в многосерверной среде.

Совет

Если после прочтения данного раздела у вас остались вопросы, не стесняйтесь задать их нашим экспертам по адресу support@ntechlab.com.

Важно

В данном разделе не рассматривается развертывание функционала Видеомагнитофон. Вы можете найти соответствующую пошаговую инструкцию здесь.

Развертывание FindFace Multi на нескольких серверах может быть необходимо по следующим причинам:

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

Примечание

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

См.также

Привязка группы камер к экземпляру findface-video-worker
Необходимость в распределении высокой нагрузки при извлечении векторов признаков.
В поиске задействовано большое количество объектов, что требует реализации распределенной базы данных.

Перед тем как приступить к развертыванию, постройте архитектурную схему с учетом будущей нагрузки системы и выделенных под нее аппаратных ресурсов (см. Требования). Наиболее распространенной схемой является следующая:

Центральный сервер с установленными компонентами findface-ntls, findface-security, findface-sf-api, findface-video-manager, findface-upload, findface-video-worker, findface-extraction-api, findface-tarantool-server, pause, а также сторонним программным обеспечением.
Несколько дополнительных серверов для обработки видео с установленным компонентом findface-video-worker.
(При необходимости) Несколько дополнительных серверов для извлечения векторов признаков (т. н. серверы экстракции) с установленным компонентом findface-extraction-api.
(При необходимости) Дополнительные серверы базы данных с несколькими шардами Tarantool на каждом.

Инструкции в настоящем разделе приведены для описанной выше наиболее часто встречающейся схемы многосерверного развертывания. В высоконагруженных системах также может потребоваться распределить обработку API-запросов, т. е. организовать несколько серверов findface-sf-api и findface-video-manager. Данная процедура требует высокого уровня знаний и дополнительного программирования. Пожалуйста, не стесняйтесь обращаться к нашим экспертам за помощью по этому вопросу (support@ntechlab.com).

Развертывание FindFace Multi в многосерверной среде состоит из следующих этапов:

Развертывание центрального сервера
Развертывание серверов обработки видео
Развертывание серверов экстракции
Распределение нагрузки между серверами экстракции
Развертывание дополнительных серверов базы данных
Настройка сетевого взаимодействия

Развертывание центрального сервера 

Для развертывания центрального сервера FindFace Multi выполните следующие действия:

На выделенном физическом сервере установите FindFace Multi из инсталлятора следующим образом (до развертывания FindFace Multi не забудьте подготовить сервер):
- Устанавливаемый продукт: FindFace Multi.
- Тип установки: Single server, multiple video workers. В этом случае FindFace Multi будет установлен в качестве центрального сервера и настроен на взаимодействие с дополнительными удаленными экземплярами findface-video-worker.
- Тип ускорения findface-video-worker (на центральном сервере): CPU или GPU, в зависимости от конфигурации оборудования.
- Тип ускорения findface-extraction-api (на центральном сервере): CPU или GPU, в зависимости от конфигурации оборудования.
По завершении установки в консоль будет выведена информация, необходимая для использования FindFace Multi:
```
#############################################################################
#                       Installation is complete                            #
#############################################################################
- all configuration and data is stored in /opt/findface-multi
- upload your license to http://172.20.77.17/#/license/
- user interface: http://172.20.77.17/
  superuser:      admin
  documentation:  http://172.20.77.17/doc/
```
Загрузите файл лицензии FindFace Multi через основной веб-интерфейс http://<IP_адрес_сервера>/#/license. Для доступа в веб-интерфейс используйте логин и пароль пользователя superuser, выведенные в консоли.

Примечание

IP-адрес сервера в ссылках на веб-интерфейсы FindFace имеет вид 127.0.0.1 или <IP_адрес_в_сети>, в зависимости от того, принадлежит ли сервер к сети.

Важно

Не передавайте данные superuser (Супер Администратора) третьим лицам. Для администрирования системы создайте назначаемого администратора. Отличие назначаемого администратора от Супер Администратора в том, что последний не может лишиться прав администратора даже при смене роли.
Разрешите лицензируемым сервисам обращаться к серверу лицензирования findface-ntls с любого IP-адреса. Для этого, откройте файл конфигурации /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml и установите listen: 0.0.0.0:3133. Перезапустите контейнер findface-multi-findface-ntls-1.
```
sudo vi /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml

listen: 0.0.0.0:3133
```
```
sudo docker container restart findface-multi-findface-ntls-1
```
Разрешите доступ к сервису findface-video-manager с любого IP-адреса. Для этого откройте файл конфигурации /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml и установите listen: 0.0.0.0:18810 и rpc:listen: 0.0.0.0:18811. Перезапустите контейнер findface-multi-findface-video-manager-1.
```
sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

listen: 0.0.0.0:18810
...
rpc:
  listen: 0.0.0.0:18811
```
```
sudo docker container restart findface-multi-findface-video-manager-1
```

Развертывание серверов обработки видео 

На дополнительном сервере для обработки видео установите экземпляр findface-video-worker, руководствуясь пошаговыми инструкциями. Ответьте на вопросы инсталлятора следующим образом:

Устанавливаемый продукт: FindFace Video Worker.
Тип ускорения findface-video-worker: CPU или GPU, в зависимости от конфигурации оборудования.
FindFace Multi IP address: IP-адрес центрального сервера.

После этого процесс установки будет автоматически запущен. Ответы на вопросы инсталлятора будут сохранены в файл /tmp/<findface-installer-*>.json. Используйте данный файл, чтобы установить FindFace Video Worker на других серверах, не отвечая на вопросы инсталлятора повторно. Для этого запустите инсталлятор командой:

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json
Примечание

Если findface-ntls и/или findface-video-manager установлены на серверах, отличных от сервера findface-security, укажите их IP-адреса после установки в файле конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.
sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml
В параметре ntls-addr укажите IP-адрес сервера findface-ntls.
ntls-addr: 127.0.0.1:3133
В параметре mgr -> static укажите IP-адрес сервера findface-video-manager, который будет обеспечивать findface-video-worker настройками и списком видеопотоков для обработки.
static: 127.0.0.1:18811

Развертывание серверов экстракции 

На дополнительном сервере экстракции установите экземпляр findface-extraction-api из консольного инсталлятора. Ответьте на вопросы инсталлятора следующим образом:

Устанавливаемый продукт: FindFace Multi.
Тип установки: Fully customized installation.
Устанавливаемые компоненты FindFace Multi: findface-extraction-api, findface-data и pause. Для того чтобы их выбрать, сначала снимите выделение со всех компонентов, введя в командной строке -*, затем введите порядковые номера findface-extraction-api, findface-data и pause через пробел. Введите done для сохранения выбора и перехода к следующему шагу.

Примечание

Компонент pause хранит информацию о сетевых идентификаторах (namespaces) других компонентов. Обязательно установите его.
Тип ускорения findface-extraction-api: CPU или GPU.
Необходимость в изменении файла конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml: укажите IP-адрес сервера findface-ntls.
Модели нейронных сетей для установки: CPU/GPU-модели для биометрии лиц (обязательно) и (опционально) CPU/GPU-модели для распознавания атрибутов лица, транспортных средств и их атрибутов, силуэтов и их атрибутов. Удостоверьтесь, что для каждой модели вы указали правильный тип ускорения: CPU или GPU. Он должен совпадать с типом ускорения findface-extraction-api. Обратите внимание, что findface-extraction-api на CPU может работать только с CPU-моделями, в то время как findface-extraction-api на GPU поддерживает как GPU-, так и CPU-модели.

Совет

Подробнее см. Обзор моделей нейронных сетей, Распознавание лиц и их атрибутов, Распознавание транспортных средств и их атрибутов, Распознавание силуэтов и их атрибутов.
Чтобы переместить основной экземпляр findface-extraction-api на другой хост, в файле конфигурации /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml укажите IP-адрес хоста сервера экстракции и установите listen: 0.0.0.0:18411.
```
listen: 0.0.0.0:18411
extraction-api:
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 10s
  max-idle-conns-per-host: 20
  keepalive: 24h0m0s
  trace: false
  extraction-api: http://172.20.77.19:18666
```

После этого процесс установки будет автоматически запущен. Ответы на вопросы инсталлятора будут сохранены в файл /tmp/<findface-installer-*>.json. Используйте данный файл, чтобы установить findface-extraction-api на других серверах, не отвечая на вопросы инсталлятора повторно.

sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json

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

Распределение нагрузки между серверами экстракции 

Распределение нагрузки между несколькими серверами экстракции выполняется через балансировщик нагрузки. Приведенная ниже пошаговая инструкция демонстрирует балансировку нагрузки с помощью nginx в режиме round-robin для 3-х экземпляров findface-extraction-api, расположенных на различных физических серверах. Один экземпляр установлен на центральном сервере FindFace Multi (172.168.1.9), 2 других на дополнительных удаленных серверах (172.168.1.10, 172.168.1.11). Если в системе присутствует большее количество серверов экстракции, балансировка нагрузки выполняется по аналогии.

Совет

Вы можете использовать любой удобный вам балансировщик нагрузки. Руководство по его использованию ищите в соответствующей справочной документации.

Для балансировки нагрузки между экземплярами findface-extraction-api выполните следующие действия:

Назначьте т. н. сервер шлюза для балансируемой группы серверов экстракции. Им может стать центральный сервер FindFace Multi (рекомендуется) или любой другой сервер с включенным сервисом findface-sf-api.

Важно

Вам нужно будет указать IP-адрес шлюза при настройке распределенной сети FindFace Multi.
На сервере с включенным сервисом findface-sf-api создайте в каталоге /opt/findface-multi/configs/ папку nginx, содержащую файл extapi.conf. Убедитесь, что файл extapi.conf содержит информацию, как в примере ниже. В директиве upstream (upstream extapibackends) замените примерные IP-адреса на актуальные IP-адреса серверов экстракции. В директиве server в параметре listen укажите номер слушающего порта сервера шлюза. Вам потребуется указать данный порт при настройке FindFace Multi network.
```
upstream extapibackends {
        server 172.168.1.9:18666; ## ``findface-extraction-api`` on principal server
        server 172.168.1.10:18666; ## 1st additional extraction server
        server 127.168.1.11:18666; ## 2nd additional extraction server
}
server {
        listen 18667;
        server_name extapi;
        client_max_body_size 64m;
        location / {
                proxy_pass http://extapibackends;
                proxy_next_upstream error;
        }
        access_log /var/log/nginx/extapi.access_log;
        error_log /var/log/nginx/extapi.error_log;
}
```

Обозначьте сервис Nginx в файле docker-compose.yaml. Для этого внесите в файл docker-compose.yaml запись о контейнере с образом Nginx:

sudo vi /opt/findface-multi/docker-compose.yaml

nginx:
  image: nginx:latest
  ports:
    - 18667:18667
  volumes:
    - ./configs/nginx/extapi.conf:/etc/nginx/conf.d/default.conf:ro

В конфигурационном файле findface-sf-api укажите адрес распределителя:

sudo vi /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml

listen: 0.0.0.0:18411
...
extraction-api: http://172.168.1.9:18667

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

cd /opt/findface-multi/
sudo docker-compose down
sudo docker-compose up -d

На центральном сервере и каждом из дополнительных серверов экстракции откройте файл конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml. Замените адрес localhost в параметре listen на адрес, который вы указали до этого в директиве upstream extapibackends файла конфигурации Nginx (/opt/findface-multi/configs/nginx/extapi.conf). В нашем примере адрес 1-го дополнительного сервера экстракции должен быть заменен на следующий:
```
sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

listen: 172.168.1.10:18666
```
Перезапустите контейнер findface-multi-findface-extraction-api-1 на центральном сервере и каждом дополнительном сервере экстракции.
```
sudo docker container restart findface-multi-findface-extraction-api-1
```

Балансировка нагрузки успешно настроена. Не забудьте указать актуальный IP-адрес и слушающий порт сервера шлюза при настройке распределенной сети FindFace Multi.

Развертывание дополнительных серверов базы данных 

Компонент findface-tarantool-server соединяет базу данных векторов признаков на основе Tarantool и компонент findface-sf-api, передавая результаты поиска от базы данных в findface-sf-api для дальнейшей обработки.

Чтобы увеличить скорость поиска, можно выделить несколько дополнительных серверов под базу данных векторов признаков и создать множество сегментов (шардов) findface-tarantool-server на каждом из них. Параллельное функционирование многочисленных шардов приведет к значительному увеличению производительности, поскольку каждый шард может обрабатывать приблизительно до 10 000 000 векторов признаков.

Чтобы развернуть дополнительные серверы базы данных, выполните следующие действия:

Установите компонент findface-tarantool-server на первом выделенном под базу данных сервере. Компонент pause должен быть уже установлен на сервере. В противном случае установите компонент pause вместе с компонентом findface-tarantool-server. Ответьте на вопросы инсталлятора следующим образом:
- Устанавливаемый продукт: FindFace Multi.
- Тип установки: Fully customized installation.
- Устанавливаемые компоненты FindFace Multi: findface-tarantool-server, pause. Для того чтобы их выбрать, сначала снимите выделение со всех компонентов, введя в командной строке -*, затем введите порядковый номер findface-tarantool-server, pause (keyword). Введите done для сохранения выбора и перехода к следующему шагу.
После этого процесс установки будет автоматически запущен.

В результате установки шарды findface-tarantool-server будут автоматически установлены в количестве N = min(max(min(mem_mb // 2000, cpu_cores), 1), 16 * cpu_cores). Т. е. количество равно размеру оперативной памяти в Мб, разделенному на 2000, или количеству физических ядер процессора (но не менее 1 шарда), или же количеству физических ядер процессора, умноженному на 16, если первое полученное значение больше.
Используйте созданный файл /tmp/<findface-installer-*>.json, чтобы установить findface-tarantool-server на других серверах, не отвечая на вопросы инсталлятора повторно. Для этого выполните следующую команду:
```
sudo ./<findface-*>.run -f /tmp/<findface-installer-*>.json
```

Обязательно укажите IP-адреса и порты шардов при настройке распределенной сети FindFace Multi. Для того чтобы узнать номера портов, на каждом сервере базы данных выполните команду:

sudo cat /opt/findface-multi/docker-compose.yaml | grep -E "CFG_LISTEN_PORT"

Будет возвращен следующий результат:

CFG_LISTEN_PORT=8101, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8102, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8103, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8104, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8105, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8106, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8107, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
CFG_LISTEN_PORT=8108, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]

Здесь номера портов: 8101, 8102 и т. д.

На сервере с установленным компонентом findface-tarantool-server внесите изменения в конфигурацию каждого шарда в файле /opt/findface-multi/docker-compose.yaml. Укажите адрес сервера лицензий findface-ntls в параметре CFG_NTLS. Установите CFG_LISTEN_HOST=0.0.0.0.

sudo vi /opt/findface-multi/docker-compose.yaml

findface-tarantool-server-shard-001:
  depends_on: []
  environment: ['TT_LISTEN=127.0.0.1:32001', TT_WORK_DIR=/var/lib/tarantool/FindFace,
    TT_WAL_DIR=xlogs, TT_MEMTX_DIR=snapshots, TT_MEMTX_MEMORY=2147483648, TT_CHECKPOINT_INTERVAL=14400,
    TT_CHECKPOINT_COUNT=3, TT_FORCE_RECOVERY=true, 'CFG_NTLS=172.23.218.110:3133', CFG_LISTEN_HOST=0.0.0.0,
    CFG_LISTEN_PORT=8101, CFG_EXTRA_LUA=loadfile("/tnt_schema.lua")()]
  image: docker.int.ntl/ntech/universe/tntapi:ffserver-9.230407.1
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./data/findface-tarantool-server/shard-001:/var/lib/tarantool/FindFace',
    './configs/findface-tarantool-server/tnt-schema.lua:/tnt_schema.lua:ro']

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

cd /opt/findface-multi/
sudo docker-compose down
sudo docker-compose up -d

Откройте файл конфигурации /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml и установите listen: 0.0.0.0:3133. Перезапустите контейнер findface-multi-findface-ntls-1.
```
sudo vi /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml

listen: 0.0.0.0:3133
license_dir: /ntech/license
proxy: ''
ui: 0.0.0.0:3185
```
```
sudo docker container restart findface-multi-findface-ntls-1
```

Внесите изменения в файл конфигурации /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml. Установите listen: 0.0.0.0:18411 и обозначьте шарды. Перезапустите контейнер findface-multi-findface-sf-api-1.

sudo vi /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml

listen: 0.0.0.0:18411
extraction-api:
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 10s
  max-idle-conns-per-host: 20
  keepalive: 24h0m0s
  trace: false
  extraction-api: http://127.0.0.1:18666
storage-api:
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 10s
  max-idle-conns-per-host: 20
  keepalive: 24h0m0s
  trace: false
  shards:
  - master: http://172.20.77.19:8101/v2/
    slave: ''
  - master: http://172.20.77.19:8102/v2/
    slave: ''

sudo docker container restart findface-multi-findface-sf-api-1

Перезапустите контейнер findface-multi-findface-multi-legacy-1, чтобы применились миграции.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Настройка сетевого взаимодействия 

После развертывания компонентов FindFace Multi настройте их взаимодействие по сети. Выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml:

sudo vi /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml

Задайте следующие параметры:

Параметр	Описание
`extraction-api` -> `extraction-api`	IP-адрес и слушающий порт сервера, являющегося шлюзом для серверов экстракции с настроенной балансировкой нагрузки.
`storage-api` -> `shards` -> `master`	IP-адрес и порт мастера шарда `findface-tarantool-server`. Остальные шарды прописываются по аналогии.
`upload_url`	Путь в WebDAV nginx, по которому в компонент `findface-upload` будут отправляться исходные изображения, миниатюры и нормализованные изображения объектов.

...
extraction-api:
  extraction-api: http://172.168.1.9:18667

...
webdav:
  upload-url: http://127.0.0.1:3333/uploads/

...
storage-api:
  ...
  shards:
  - master: http://172.168.1.9:8101/v2/
    slave: ''
  - master: http://172.168.1.9:8102/v2/
    slave: ''
  - master: http://172.168.1.12:8101/v2/
    slave: ''
  - master: http://172.168.1.12:8102/v2/
    slave: ''
  - master: http://172.168.1.13:8102/v2/
    slave: ''
  - master: http://172.168.1.13:8102/v2/
    slave: ''

Перезапустите контейнер findface-multi-findface-sf-api-1.

sudo docker container restart findface-multi-findface-sf-api-1

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

Задайте следующие параметры:

Параметр	Описание
`SERVICE_EXTERNAL_ADDRESS`	IP-адрес или URL FindFace Multi, являющимся приоритетным для Genetec и вебхуков. Если параметр не задан, система использует для работы с данным функционалом `EXTERNAL_ADDRESS`. Для использования Genetec и вебхуков обязательно укажите по крайней мере один из параметров `SERVICE_EXTERNAL_ADDRESS`/ `EXTERNAL_ADDRESS`.
`EXTERNAL_ADDRESS`	(Опционально) IP-адрес или URL, который используется для доступа к веб-интерфейсу FindFace Multi. Если параметр не задан, система автоматически определяет его как внешний IP-адрес. Для доступа в FindFace Multi вы можете использовать оба IP-адреса: как автоопределенный, так и указанный в `EXTERNAL_ADDRESS`.
`VIDEO_DETECTOR_TOKEN`	Придумайте токен и укажите его в данном параметре, чтобы авторизовать модуль видеодетекции объектов.
`VIDEO_MANAGER_ADDRESS`	IP-адрес сервера `findface-video-manager`.
`NTLS_HTTP_URL`	IP-адрес сервера `findface-ntls`.
`ROUTER_URL`	Внешний IP-адрес сервера `findface-security`, который будет получать обнаруженные объекты от экземпляра(ов) `findface-video-worker`.
`SF_API_ADDRESS`	IP-адрес сервера `findface-sf-api`.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...
# SERVICE_EXTERNAL_ADDRESS is prioritized for FFSecurity webhooks and Genetec plugin.
SERVICE_EXTERNAL_ADDRESS = 'http://localhost'
EXTERNAL_ADDRESS = 'http://127.0.0.1'


...
FFSECURITY = {
    'VIDEO_DETECTOR_TOKEN': '7ce2679adfc4d74edcf508bea4d67208',
    ...
    'VIDEO_MANAGER_ADDRESS': 'http://127.0.0.1:18810',
    ...
    'NTLS_HTTP_URL': 'http://127.0.0.1:3185',
    'ROUTER_URL': 'http://172.168.1.9',
    ...
    'SF_API_ADDRESS': 'http://127.0.0.1:18411',
    ...
}

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

На этом установка FindFace Multi в многосерверной среде будет завершена.

Важно

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

Для отключения автоматического обновления Ubuntu выполните следующие команды:

sudo apt-get remove unattended-upgrades
sudo systemctl stop apt-daily.timer
sudo systemctl disable apt-daily.timer
sudo systemctl disable apt-daily.service
sudo systemctl daemon-reload

Важно

Сервисы FindFace Multi логируют большой объем данных, что в конечном итоге может привести к чрезмерной загрузке диска. Чтобы этого не произошло, рекомендуется отключить сервис rsyslog из-за его неоптимальной схемы ротации логов и вместо него использовать правильно настроенный сервис systemd-journal. См. пошаговые инструкции в разделе Логирование.

Установка моделей нейронных сетей

Для обнаружения и распознавания объектов и их атрибутов findface-extraction-api использует нейронные сети.

Если необходим ручной запуск установки моделей, используйте консольный инсталлятор следующим образом:

Запустите файл findface-*.run.

Примечание

Вместо findface-* укажите актуальное имя файла.
```
sudo ./findface-*.run
```
Устанавливаемый продукт: FindFace Multi
Тип установки: Fully customized installation.
Выберите устанавливаемый компонент FindFace Multi: findface-data. Для этого сначала снимите выделение со всех компонентов, введя в командной строке -*, затем введите порядковый номер компонента. Введите done для сохранения выбора и перехода к следующему шагу.
Выберите модели для установки. После этого процесс установки будет автоматически запущен.

Вы можете найти установленные модели для распознавания объектов и их атрибутов в директории /opt/findface-multi/models/. См. Обзор моделей нейронных сетей.

Процедуры и первичные инструкции после развертывания

После завершения развертывания FindFace Multi выполните описанные ниже процедуры.

В этом разделе:

Задание временной зоны
Лицензирование экземпляра продукта
Настройка логирования
Полезные команды Docker

Задание временной зоны 

Временная зона определяет время в отчетах, логах, именах артефактов FindFace Multi, таких как полные кадры, миниатюры событий и т. п.

Временная зона указывается в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py в формате Регион/Страна/Город или Etc/GMT+H. Лучший способ сделать это — скопировать и вставить часовой пояс из таблицы в Википедии.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

# time zone
TIME_ZONE = 'America/Argentina/Buenos_Aires'

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Лицензирование экземпляра продукта 

FindFace Multi предоставляет несколько вариантов лицензирования. Какой бы вариант вы ни выбрали, вам потребуется загрузить файл лицензии FindFace Multi через основной веб-интерфейс http://<Host_IP_address>/#/license. Для доступа к веб-интерфейсу используйте учетные данные superuser.

Важно

Не передавайте данные superuser (Супер Администратора) третьим лицам. Для администрирования системы создайте назначаемого администратора. Отличие назначаемого администратора от Супер Администратора в том, что последний не может лишиться прав администратора даже при смене роли.

Обратитесь к разделу Лицензирование, чтобы узнать о доступных вариантах лицензирования.

Настройка логирования 

По умолчанию процессы FindFace Multi регистрируются в логах контейнеров Docker, доступ к которым можно получить с помощью команд docker logs и docker service logs. Кроме этого, Docker использует драйвер перевода логов в json-файлы, который кэширует логи контейнеров в формате JSON. Вы можете настроить Docker на использование другого драйвера логов, выбрав из множества доступных механизмов логирования. См. Логирование, чтобы узнать, как это сделать.

Полезные команды Docker 

Для быстрого и эффективного администрирования FindFace Multi вы должны обладать обширными знаниями и навыками работы с Docker. Если вы новичок в Docker, начните с приведенных ниже команд. Затем изучите документацию Docker для получения дополнительных навыков.

Просмотр всех контейнеров Docker, включая остановленные:
```
docker ps -a
```
Чтобы получить более компактный и понятный вывод, используйте следующую команду:
```
docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.State}}"
```
Чтобы расширить предыдущий вывод, пригодится следующая команда:
```
docker ps --format='{{json .}}' | jq
```
Перезапуск Docker:
```
sudo systemctl restart docker
```
Просмотр логов контейнера, если включен драйвер перевода логов в journald:
```
journalctl CONTAINER_NAME=findface-multi-findface-multi-legacy-1 -f
```

Остановка контейнера Docker:

sudo docker container stop <container_name>/<container_id>

Остановка всех контейнеров Docker:

sudo docker container stop $(sudo docker ps -a -q)

Запуск контейнера Docker:

sudo docker container start <container_name>/<container_id>

Запуск всех контейнеров Docker:

sudo docker container start $(sudo docker ps -a -q)

Просмотр файла конфигурации docker-compose.yaml для FindFace Multi:
```
cat /opt/findface-multi/docker-compose.yaml
```
Файлы конфигурации FindFace Multi можно найти здесь:
```
cd /opt/findface-multi/configs/
```
После внесения изменений в файл конфигурации перезапустите соответствующий контейнер, выполнив команду:
```
sudo docker container restart <container_name>/<container_id>
```
Вход в работающий контейнер Docker для выполнения в нем команды:
```
sudo docker container exec -it <container_name> /bin/bash
```
Остановка и удаление всех контейнеров FindFace Multi:
```
cd /opt/findface-multi
sudo docker-compose down
```
Сборка, воссоздание и запуск контейнеров FindFace Multi:
```
cd /opt/findface-multi
sudo docker-compose up -d
```

Удаление экземпляра продукта

Если вы выбрали автоматическое односерверное развертывание FindFace Multi, то для удаления экземпляра продукта воспользуйтесь скриптом uninstall.sh, встроенным в файл инсталлятора.

Важно

Обязательно создайте резервную копию вашего экземпляра перед его удалением, если вы планируете позже восстановить FindFace Multi и его данные.

Запустите скрипт:

cd /opt/findface-multi/
sudo /opt/findface-multi/uninstall.sh /opt/findface-multi/

Вам будет задан вопрос:

В: This script will remove all docker containers, images, volumes, config files and directory "/opt/findface-multi/?". Do you want to proceed(y/n)?:

Ответьте y, чтобы удалить экземпляр продукта.

В случае если развертывание FindFace Multi было нестандартным, и вы не можете воспользоваться скриптом для удаления экземпляра продукта, удалите все компоненты вручную. Следующая команда повторяет поведение скрипта uninstall.sh и должна выполняться на каждом задействованном хосте:

sudo docker-compose -f /opt/findface-multi/docker-compose.yaml down -v --rmi all
sudo rm -rf /opt/findface-multi

Администрирование и основная конфигурация

Лицензирование

В этой главе:

Принцип лицензирования
Просмотр и обновление лицензии
Лицензирование через USB-ключ аппаратной защиты
Лицензирование по слепку с оборудования

Принцип лицензирования 

FindFace Multi лицензируется по следующим критериям:

Общее количество извлеченных векторов признаков, независимо от типа объекта (лицо, силуэт, транспортное средство).

Примечание

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

Схема лицензирования выглядит следующим образом:
- События: 1 событие распознавания объекта на видео = 1 объект в лицензии.
- Картотека: 1 фотография в карточке = 1 объект в лицензии.
- Кластеры: 1 человек = 1 объект в лицензии.
- Пользователи: 1 фотография пользователя = 1 объект в лицензии.
Количество источников видеоизображения, используемых в данный момент времени (т. е. количество активных на данный момент задач на обработку видео с камер и из архивов).
Количество экземпляров моделей, используемых findface-extraction-api.
Распознавание атрибутов лица: пол/возраст/эмоции/очки/борода/медицинская маска/др.
Распознавание атрибутов силуэтов: цвет/тип одежды/др.
Распознавание атрибутов автомобилей: марка/модель/цвет/тип кузова/др.
Распознавание номера транспортного средства.
Определение витальности лиц (Liveness).
Видеозапись.
Интеграции с партнерами.
Интеграции с внешними VMS.

Вы можете выбрать между следующими методами лицензирования:

Онлайн-лицензирование выполняется через Глобальный менеджер лицензий NtechLab license.ntechlab.com и требует наличия стабильного интернет-соединения, DNS и открытого порта 443 TCP. После отключения от интернета система продолжит работать в автономном режиме в течение четырех часов.

Примечание

Уведомите своего менеджера, если требуется продлить данный период (до 2-х дней).

Для лицензирования в закрытой сети через USB-ключ необходимо наличие USB-порта на физическом сервере с компонентом findface-ntls (сервер лицензирования в составе ядра FindFace).
Для лицензирования в закрытой сети по слепку с оборудования необходимо наличие установленных драйверов Sentinel на физическом сервере с компонентом findface-ntls.

Важно

Для обеспечения функционирования системы достаточно одного экземпляра findface-ntls. Если ваша система нуждается в большем количестве серверов лицензирования, заблаговременно сообщите об этом своему менеджеру NtechLab, чтобы предотвратить блокировку системы.

Просмотр и обновление лицензии 

После установки FindFace Multi загрузите в систему полученный от менеджера файл лицензии. Для этого перейдите в Настройки -> Лицензия.

Используйте ту же вкладку для просмотра текущей информации по лицензии и обновления лицензии.

Лицензирование через USB-ключ аппаратной защиты 

Для того чтобы реализовать лицензирование через USB-ключ, выполните следующие действия:

Сообщите своему менеджеру о том, что намерены использовать данный метод лицензирования, и запросите свой USB-ключ и файл лицензии.
Откройте файл конфигурации /opt/findface-multi/docker-compose.yaml.
```
sudo vi /opt/findface-multi/docker-compose.yaml
```

Добавьте строку privileged: true. Смонтируйте каталог /dev в контейнер findface-multi-findface-ntls-1, указав его в томах (volumes) секции findface-ntls. В результате секция будет выглядеть следующим образом:

findface-ntls:
    command: [--config=/etc/findface-ntls.cfg]
    image: docker.int.ntl/ntech/universe/ntls:ffserver-8.221216
    network_mode: service:pause
    privileged: true
    restart: always
    user: root
    volumes: ['./configs/findface-ntls/findface-ntls.yaml:/etc/findface-ntls.cfg:ro',
      './data/findface-ntls:/ntech/license', '/dev:/dev']

Создайте новое правило udev.
1. Загрузите файл 95-grdnt.rules в любой каталог, например, в /home/username/tmp/.
2. Скопируйте файл 95-grdnt.rules в каталог /etc/udev/rules.d/.
```
sudo cp /home/username/tmp/95-grdnt.rules /etc/udev/rules.d/
```

Выполните пересборку контейнеров FindFace Multi.

cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d

Вставьте USB-ключ в USB-порт.
Загрузите файл лицензии на вкладке Лицензия.

Лицензирование по слепку с оборудования 

Примечание

Sentinel — вид офлайн лицензий, которые, в отличие от guardant лицензий, не требуют физического носителя для своей работы.

Словарь:

Sentinel — система защиты ПО и лицензирования от Thales. Она позволяет реализовать офлайновое лицензирование без доступа к глобальному серверу.
Файл C2V — это файл со слепком с оборудования клиентской машины, который служит для привязки лицензии только в этой машине. Этот файл генерируется библиотекой Sentinel у клиента на той машине, где впоследствии будет устанавливаться лицензионный ключ.

Для того чтобы реализовать лицензирование по слепку, выполните следующие действия:

Сообщите своему менеджеру о том, что намерены использовать данный метод лицензирования, и запросите свой уникальный идентификатор лицензии. Менеджер также предоставит вам пакет findface-sentinel-lib_*.deb`, необходимый для интеграции FindFace Multi с Sentinel.
Установите драйверы Sentinel на физическом сервере с компонентом findface-ntls.

Выполните следующие действия:
1. Загрузите драйверы Sentinel с официального сайта.
2. Разархивируйте скачанный архив и перейдите в него.
  tar -xvzf Sentinel_LDK_Linux_Runtime_Installer_script.tar.gz cd Sentinel_LDK_Linux_Runtime_Installer_script/
3. Внутри архива есть еще архив aksusbd-8.31.1.tar.gz. Разархивируйте его и перейдите в полученную директорию.
  tar -xvzf aksusbd-8.31.1.tar.gz cd aksusbd-8.31.1/
4. Выполните команду установки.
  sudo ./dinst
5. Запустите и проверьте статусы сервисов Sentinel.
  sudo systemctl start aksusbd.service hasplmd.service sudo systemctl status aksusbd.service hasplmd.service
Смонтируйте каталоги /var/hasplm и /etc/hasplm в контейнер findface-multi-findface-ntls-1. Для этого откройте файл конфигурации /opt/findface-multi/docker-compose.yaml и перечислите их в томах (volumes) секции findface-ntls.
```
sudo vi /opt/findface-multi/docker-compose.yaml

findface-ntls:
  ...
  volumes: ['./configs/findface-ntls/findface-ntls.yaml:/etc/findface-ntls.cfg:ro', './data/findface-ntls:/ntech/license', '/var/hasplm:/var/hasplm', '/etc/hasplm:/etc/hasplm']
```

Выполните пересборку контейнеров FindFace Multi.

cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d

Поместите пакет findface-sentinel-lib_*.deb, полученный от своего менеджера, в любой каталог на этом же сервере. Установите пакет.
```
sudo dpkg -i /path/to/findface-sentinel-lib_*.deb
```
В веб-интерфейсе FindFace Multi перейдите на вкладку Настройки -> Лицензия. Снимите слепок с оборудования (файл C2V), нажав на кнопку Скачать C2V для активации.
Совет

Если вы предпочитаете работать с консолью, можно вместо этого отправить следующий API-запрос в findface-ntls:
```
curl <findface-ntls-server-ip>:3185/c2v  >my_pc.c2v
```
Отправьте идентификатор лицензии и файл C2V своему менеджеру и получите в ответном письме файл лицензии.
Загрузите файл лицензии на вкладке Лицензия.

Основные настройки

Основные настройки FindFace Multi определяют работу системы и потребление ресурсов. Доступны следующие настройки:

yниверсальный порог срабатывания
качество JPEG миниатюр
расписание автоматического удаления старых событий и эпизодов

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

Для изменения основных настроек перейдите Настройки -> Основные. После внесения изменений нажмите Обновить.

По умолчанию настройки очистки VMS отключены в основных настройках. Чтобы начать работать с настройками очистки VMS из веб-интерфейса, следуйте этой инструкции Включение настроек очистки VMS в веб-интерфейсе.

Подробное описание каждой настройки приведено ниже.

В этом разделе:

Универсальный порог срабатывания
Качество JPEG миниатюр
Автоматическое удаление старых событий и эпизодов
Глобальные настройки очистки VMS

Универсальный порог срабатывания 

FindFace Multi принимает решение о совпадении объектов (например, о том, что лица принадлежат одному человеку) на основании предустановленного порога срабатывания. По умолчанию установлено оптимальное пороговое значение. При необходимости вы можете изменить его.

Примечание

Чем выше порог, тем меньше шансов на положительную ложную верификацию человека, однако некоторые подходящие фотографии могут также не пройти верификацию.

Совет

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

Важно

Для большинства случаев распознавания лиц значение, установленное по умолчанию для универсального порога срабатывания, является оптимальным. Не рекомендуется самостоятельно менять его. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).

Качество JPEG миниатюр 

В зависимости от качества JPEG, файлы миниатюр могут в конечном счете занять значительную часть дискового пространства. Используйте вкладку Основные для настройки параметра.

Автоматическое удаление старых событий и эпизодов 

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

Важно

Если вы хотите отключить удаление событий для одного из параметров, укажите 0 (ноль) Часов для этого параметра. Система будет вести себя так, как будто этого параметра не существует.

Например, чтобы отключить удаление событий с совпадениями для определенного объекта, укажите 0 (ноль) в параметре Удалять события с совпадениями старше. Затем нажмите Обновить.

Глобальные настройки очистки VMS 

После того, как настройки очистки VMS появились в веб-интерфейсе, можно настраивать регулярную очистку видео непосредственно из него.

Доступны следующие настройки:

Удалять интервалы между треками: удалять промежутки видео между треками, не содержащие событий распознавания.
Сохранять события: сохранять события для выбранного объекта (лица, силуэта, транспортного средства).
Добавить отступы к треку: промежуток видео в секундах до и после трека с событиями, который добавляется к треку.
Порог очистки: минимальный промежуток между треками в секундах. Если промежуток между треками ниже порога, видео не будет удалено. Минимальное значение для это поля — 360 секунд.
Удалять интервалы между треками через: временной период (в днях), в течение которого хранится весь видеоархив. По истечении этого периода начнется очистка интервалов между треками так, как она задана в настройках. Значение может быть больше либо равно нулю.
Очищать архив: включить очищение всего видеоархива.
Удалять данные старше: количество дней, в течение которых видеоархив хранится в системе. По истечении этого срока видеоархив удаляется.

Настройки очистки VMS в разделе основных настроек применяются глобально для всей системы. Чтобы настроить очистку видео для отдельной камеры, перейдите к пользовательским настройкам очистки VMS.

Управление пользователями и безопасность системы

Важно

Хотя FindFace Multi предоставляет инструменты для защиты от несанкционированного доступа, они не заменяют правильно настроенный межсетевой экран. Обязательно используйте файрвол, чтобы усилить защиту сети FindFace Multi.

Управление ролями и пользователями

В этой главе:

Предустановленные роли
Создание новой роли в веб-интерфейсе
Основная и дополнительная роль пользователя
Создание пользовательского аккаунта вручную
Работа с ролями и пользователями в консоли
Интеграция с Active Directory для автоматического создания пользователей
Деактивация или удаление пользователей

Предустановленные роли 

Для работы с FindFace Multi предусмотрены следующие предустановленные роли:

Администратор: предоставляется полный доступ к функциональности FindFace Multi, интеграционным и административным инструментам.

Важно

Супер Администратор не может лишиться прав администратора даже при смене роли.
Оператор: предоставляется полный доступ к функциональности FindFace Multi.
Пользователь: обладает правами на работу с событиями и эпизодами, а также на изменение данных в своем профиле. Остальные функции доступны в режиме чтения.

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

Создание новой роли в веб-интерфейсе 

Для создания новой роли в веб-интерфейсе выполните следующие действия:

Перейдите Настройки -> Роли.
Нажмите + Новая роль.
На вкладке Сведения задайте название роли. Сохраните роль.
После сохранения роли вы увидите, что рядом с вкладкой Сведения появились следующие вкладки:
- Списки наблюдения: права роли на определенные списки наблюдения
- Группы камер: права роли на определенные группы камер
- Права доступа: привилегии роли на работу с системными функциями и сущностями
Задайте права роли в соответствии со своими потребностями. Обратите внимание на разницу между правами на определенный список наблюдения/группу камер и правами на системную сущность watchlist/cameragroup. Например, если вы установите Отсутствует для определенной группы камер на вкладке Группы камер, пользователи с соответствующей ролью не смогут работать с данной группой камер. Снятие всех флажков для сущности cameragroup на вкладке Права доступа не позволит пользователям просматривать и работать со всеми группами камер.

Полный список сущностей FindFace Multi, которые используются в текущей версии:
- all_own_sessions: все сессии текущего пользователя на разных устройствах
  
  Примечание
  
  Если для данной сущности установлены соответствующие разрешения, пользователи смогут просматривать (Просмотр) и закрывать (Удалить) все свои сессии на разных устройствах. В противном случае пользователям будет разрешено только просматривать и закрывать свою сессию на текущем устройстве. Работа с сессиями производится на вкладке Сессии (Настройки).
- bodycluster: кластер силуэтов
- bodyevent: событие распознавания силуэта
- bodyobject: фотография в карточке человека в полный рост
- camera: камера
- cameragroup: группа камер
- carcard: карточка транспортного средства
- carcluster: кластер изображений транспортного средства
- carepisode: эпизод с транспортным средством
- carevent: событие распознавания транспортного средства
- carobject: фотография транспортного средства в карточке
- counter: счетчики
- deviceblacklistrecord: список блокировок
- facecluster: кластер лиц
- faceevent: событие распознавания лица
- faceobject: фотография лица в карточке
- humancard: карточка человека
- humanepisode: эпизод с человеком
- report: отчеты
- upload: элемент (фото) в пакетной загрузке
- uploadlist: список фотографий в пакетной загрузке
- user: пользователь
- videoarchive: идентификация объектов в видеофайлах
- watchlist: список наблюдения
- webhook: вебхук
Вы также можете включать и отключать права на следующую функциональность:
- batchupload_cards: пакетная загрузка фотографий
- change_runtimesetting: изменение основных настроек FindFace Multi
- view_auditlog: просмотр и работа с аудит логами.
- configure_ntls: конфигурация сервера лицензий findface-ntls
- view_runtimesetting: просмотр основных настроек FindFace Multi
Сохраните изменения.

Основная и дополнительная роль пользователя 

Вы можете назначить пользователю привилегии, используя следующие роли:

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

Все пользователи, принадлежащие к определенной основной роли, автоматически получают доступ к группам камер (и архивам внутри группы) и спискам наблюдения (и карточкам в этих списках), созданным пользователем с той же основной ролью, с учетом привилегий, определенных их дополнительными ролями.

См.также

Создание пользовательского аккаунта вручную

Создание пользовательского аккаунта вручную 

Для создания пользовательского аккаунта вручную выполните следующие действия:

Перейдите Настройки -> Пользователи.
Нажмите + Новый пользователь.
На вкладке Сведения введите данные пользователя, такие как название, имя пользователя и пароль. При необходимости добавьте комментарий.
Примечание

При установке пароля учитывайте требования к паролю:
- содержит не менее 8 символов
- содержит не только цифры
- не входит в список 20000 распространенных паролей
- не похож на другие атрибуты пользователя
- может содержать только буквы латинского алфавита, цифры и специальные символы
Из раскрывающегося списка Роли выберите одну или несколько пользовательских ролей. Назначьте одну из них основной.
На вкладке Фотографии прикрепите фотографию пользователя.
Сохраните аккаунт пользователя.

Работа с ролями и пользователями в консоли 

В случае если предустановленные роли были удалены из системы, используйте следующую команду, для того чтобы создать их:

sudo docker exec -it findface-multi-findface-multi-identity-provider-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py create_groups

Для создания пользователя с правами Супер Администратора (superuser) выполните следующую команду (обратите внимание, что password является обязательным аргументом):

sudo docker exec -it findface-multi-findface-multi-identity-provider-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py create_default_user --password <password>

Интеграция с Active Directory для автоматического создания пользователей 

При большом количестве пользователей в FindFace Multi создание их аккаунтов по одному может быть неудобным. Одним из способов облегчить создание пользователей является использование интеграции FindFace Multi с Active Directory. Для настройки интеграции руководствуйтесь приведенными ниже пошаговыми инструкциями, соблюдая последовательность действий.

Создание файла Keytab 

Войдите на сервер Active Directory и выполните следующие действия:

Создайте новый аккаунт пользователя в домене Active Directory для использования в качестве сервисного аккаунта.

Выполните следующие действия:
1. Откройте Active Directory. Нажмите Пуск -> Средства администрирования -> Пользователи и компьютеры Active Directory.
2. Нажмите на имя домена, а затем разверните содержимое. Щелкните правой кнопкой мыши Пользователи, выберите Создать -> Пользователь. Отобразится форма создания пользователя.
3. Заполните поля формы на свое усмотрение. На второй вкладке поставьте флажок Срок действия пароля не ограничен.
4. Нажмите Далее. Проверьте введенные данные и, если все верно, нажмите Готово.
5. Щелкните правой кнопкой мыши по созданному аккаунту пользователя, а затем перейдите Свойства -> Член групп -> Добавить.
6. Добавьте в список группы Администраторы домена и Пользователи домена, а затем нажмите «ОК».
7. Нажмите OK для завершения.
Зарегистрируйте имя субъекта-службы (Service Principal Name, SPN) для созданного сервисного аккаунта. Для этого откройте PowerShell от имени администратора и выполните следующую команду, указав фактическое имя пользователя (вместо SERVICE USER NAME) и домен. В примере ниже имя домена testntl.local.
```
setspn -A HTTP/<SERVICE USER NAME>.testntl.local@TESTNTL.LOCAL <SERVICE USER NAME>
```
В том же окне PowerShell сгенерируйте keytab-файл, выполнив приведенную ниже команду с фактическим именем сервисного пользователя SERVICE USER NAME, доменом и желаемым именем файла вместо KEYTAB FILE NAME.
```
ktpass.exe -princ HTTP/<SERVICE USER NAME>.testntl.local@TESTNTL.LOCAL -mapuser <SERVICE USER NAME> -crypto ALL -ptype KRB5_NT_PRINCIPAL -pass * -out c:\<KEYTAB FILE NAME>.keytab
```
Чтобы проверить результат, перейдите в корневую директорию диска C. В ней вы увидите keytab-файл с соответствующим именем.
Переместите созданный файл keytab на сервер FindFace Multi.

Настройка томов для Kerberos и файла keytab 

Для успешного установления связи между FindFace Multi и Active Directory необходимо включить поддержку Kerberos в контейнере findface-multi-findface-multi-ui-1 на основном сервере FindFace Multi. Выполните следующие действия:

Смонтируйте файл /opt/findface-multi/configs/kerberos/krb5.conf и директорию /opt/findface-multi/configs/keytab в контейнер findface-multi-findface-multi—ui-1. Для этого откройте файл конфигурации /opt/findface-multi/docker-compose.yaml и перечислите их в томах (volumes) секции findface-multi-ui.
```
sudo vi /opt/findface-multi/docker-compose.yaml

findface-multi-ui:
  ...
  volumes: ['./configs/findface-multi-ui/nginx-site.conf:/etc/nginx/conf.d/default.conf:ro',
    './data/findface-multi-legacy/uploads:/var/lib/findface-security/uploads',
    './configs/kerberos/krb5.conf:/etc/krb5.conf:ro',
    './data/findface-multi-ui/keytab/:/keytab/']
```
Создайте директории для смонтированных томов: /opt/findface-multi/configs/kerberos/ и /opt/findface-multi/data/findface-multi-ui/keytab/. Скопируйте файл конфигурации Kerberos из контейнера findface-multi-findface-multi-ui-1 в директорию /opt/findface-multi/configs/kerberos/.
```
sudo mkdir -p /opt/findface-multi/data/findface-multi-ui/keytab/
sudo mkdir /opt/findface-multi/configs/kerberos/
sudo docker cp findface-multi-findface-multi-ui-1:/etc/krb5.conf /opt/findface-multi/configs/kerberos/
```
Откройте файл конфигурации /opt/findface-multi/configs/kerberos/krb5.conf. Укажите realm Active Directory в секции libdefaults. Имя realm должно совпадать с доменным именем Active Directory, но быть написано в верхнем регистре (TESTNTL.LOCAL в приведенном ниже примере). Также укажите домен Active Directory в секции realms по аналогии с примером ниже.
```
sudo vi /opt/findface-multi/configs/kerberos/krb5.conf

[libdefaults]
        default_realm = TESTNTL.LOCAL
...
[realms]
TESTNTL.LOCAL = {
  kdc = testntl.local
  default_domain = testntl.local
}
```
Скопируйте файл keytab в директорию /opt/findface-multi/data/findface-multi-ui/keytab/.
Добавьте следующую строку в файл /etc/hosts: <IP-адрес сервера Active Directory> <имя домена Active Directory>.
```
vi /etc/hosts

...
192.168.0.5 testntl.local
```

Настройка NGINX на сервере FindFace Multi для поддержки Active Directory 

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf. Найдите раздел location /users/me/ad и раскомментируйте его. Заполните секцию по аналогии с примером ниже, указав свои актуальные переменные в строки с комментариями (#).

Переменные, которые необходимо указать, следующие:

auth_gss_realm: имя realm в Kerberos
auth_gss_keytab: путь к keytab-файлу.
auth_gss_service_name: полное имя сервисного пользователя, включая имя домена, к которому он принадлежит

sudo vi /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf

location /users/me/ad {
      proxy_pass http://127.0.0.1/auth/ad_login/; # e.g http://127.0.0.1/auth/ad_login/;
      proxy_method POST;

      proxy_set_header   X-Real-IP $remote_addr;
      proxy_set_header   Host $http_host;
      proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header  Authorization $http_authorization;
      proxy_pass_header Authorization;
      proxy_no_cache 1;
      proxy_cache_bypass 1;

      auth_gss on;
      auth_gss_realm TESTNTL.LOCAL; # e.g. TESTNTL.LOCAL;
      auth_gss_keytab /keytab/user.keytab; # e.g. /var/lib/web.keytab
      auth_gss_service_name HTTP/user.testntl.local; # e.g. HTTP/web.testntl.local;
      auth_gss_allow_basic_fallback on;
}

Завершение настройки FindFace Multi 

Чтобы завершить интеграцию FindFace Multi с Active Directory, выполните на стороне FindFace Multi следующие действия по настройке:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

В разделе SERVICES установите "active_directory": True.

SERVICES = {
        ...
        "active_directory": True,
        ...
    }
}

Заполните раздел ACTIVE_DIRECTORY_CONFIG следующим образом:
- AUTH_LDAP_SERVER_URI: ldap: <IP-адрес сервера Active Directory>
- AUTH_LDAP_BIND_DN: имя сервисного пользователя, созданного в Active Directory
- AUTH_LDAP_BIND_PASSWORD: пароль сервисного пользователя
- SEARCH_GROUPS: организационные единицы Active Directory, в которых FindFace Multi будет выполнять поиск аккаунтов пользователей
```
# Specify server credentials
ACTIVE_DIRECTORY_CONFIG = {
    'AUTH_LDAP_SERVER_URI': 'ldap://192.168.0.5',
    # Domain Administrator user
    'AUTH_LDAP_BIND_DN': '<SERVICE USER NAME IN ACTIVE DIRECTORY>',
    # Domain Administrator user password
    'AUTH_LDAP_BIND_PASSWORD': 'SERVICE USER NAME PASSWORD',
    # Specify organization units where users search will be executed.
    # Follow pattern (e.g. OU=DEV,DC=domain,DC=com)
    'SEARCH_GROUPS': 'OU=DEV,DC=testntl,DC=local',
}
```
Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py и повторите предыдущие шаги.

Выполните пересборку контейнеров FindFace Multi.

cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d

Управление пользователями FindFace Multi через Active Directory 

Если интеграция FindFace Multi с Active Directory включена, вы сможете задать одну из групп Active Directory для создаваемой или редактируемой роли.

Как только пользователь из выбранной группы Active Directory впервые войдет в FindFace Multi, он будет автоматически добавлен в список пользователей FindFace Multi.

Чтобы войти в FindFace с помощью Active Directory, пользователь должен нажать кнопку Войти при помощи Active Directory в окне аутентификации, указать свои учетные данные Active Directory и нажать Sign in.

Деактивация или удаление пользователей 

Для того чтобы деактивировать пользователя, выключите переключатель Активность в списке пользователей (Настройки -> Пользователи).

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

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

Аутентификация и мониторинг сессии пользователя

В этом разделе:

Типы аутентификации
Настройка аутентификации и мониторинга сессии
Принудительный вывод всех пользователей из системы

Типы аутентификации 

В FindFace Multi возможны следующие типы аутентификации:

password: стандартная аутентификация посредством логина и пароля. Включена по умолчанию.
face: аутентификация возможна только по лицу пользователя.
face_or_password: аутентификация возможна по лицу или с логином/паролем.
face_and_password: двухфакторная аутентификация. После успешного распознавания лица пользователь должен ввести свои логин и пароль.

Важно

Для всех типов аутентификации, основанных на распознавании лиц, необходима следующая конфигурация:

автономный сервис liveness (findface-liveness-api)
HTTPS

Важно

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

Примечание

Вы можете включить мониторинг рабочей сессии для типов аутентификации face и face_or_password. В этом случае система будет периодически возобновлять сессию после проверки, что лицо человека на рабочем месте совпадает с лицом вошедшего в систему пользователя (подробнее см. в Настройка аутентификации и мониторинга сессии).

Совет

FindFace Multi также предоставляет независимо настраиваемую аутентификацию на основании сертификата. Обратитесь к нашим экспертам за консультацией (support@ntechlab.com).

Настройка аутентификации и мониторинга сессии 

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

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Найдите секции FFSECURITY и FFSECURITY_AUTH_CONFIG.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    # auth config
    # available options: face, password, face_and_password, face_or_password
    'AUTH_TYPE': 'face_or_password',
    # 180 days by default
    'MAXIMUM_SESSION_LENGTH': 15552000,
    ...
    }

...
# - FindFace Security authorization configuration dictionary -

FFSECURITY_AUTH_CONFIG = {
    'FACE_AUTH_CONFIDENCE': 0.740,  # FAR = 2.5E-09  # model: [kiwi_320]
    # 3 settings below are for front-end only
    # session renew works only with face or face_or_password authorization type
    'NEED_SESSION_RENEW': False,
    'RENEW_SESSION_INTERVAL': 0,
    'MAXIMUM_RENEW_ATTEMPTS': 2,
}

В разделе FFSECURITY задайте следующие параметры аутентификации:
- AUTH_TYPE: тип аутентификации. Доступные варианты: face, password, face_and_password, face_or_password.
- MAXIMUM_SESSION_LENGTH: максимальная продолжительность сессии пользователя в секундах. По истечении времени сессии происходит принудительный вывод пользователя из системы при условии, что сессия не была предварительно возобновлена.
В разделе FFSECURITY_AUTH_CONFIG задайте следующие параметры аутентификации и мониторинга сессии:
- FACE_AUTH_CONFIDENCE: после того как лицо на видео с вебкамеры распознано как живое, система сравнивает его с фотографиями пользователей, используя для верификации данную пороговую степень схожести.
- NEED_SESSION_RENEW: если True, сессия пользователя может быть возобновлена и продлена на время, равное MAXIMUM_SESSION_LENGTH, после проверки, что лицо человека на рабочем месте совпадает с лицом вошедшего в систему пользователя.
- RENEW_SESSION_INTERVAL: период в секундах до ожидаемого времени завершения сессии, в течение которого система попытается возобновить сессию, активировав вебкамеру для верификации лица пользователя.
- MAXIMUM_RENEW_ATTEMPTS: количество попыток верификации пользователя. Попытки выполняются одна за другой в течение интервала возобновления сессии.
Примечание

Попытка верификации занимает приблизительно 3 секунды.

Совет

Мы рекомендуем настроить параметры мониторинга таким образом, что величина MAXIMUM_RENEW_ATTEMPTS, умноженная на продолжительность попытки, была меньше значения RENEW_SESSION_INTERVAL. В противном случае система увеличит интервал возобновления сессии в 2, 3 и более раз, в зависимости от количества попыток.
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Принудительный вывод всех пользователей из системы 

Для того чтобы принудительно вывести всех пользователей из системы, выполните следующую команду в консоли центрального сервера FindFace Multi:

sudo docker container exec -it findface-multi-findface-multi-identity-provider-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py logout_all_users

Совет

Данная команда пригодится при массовом переходе к другому типу аутентификации.

Настройка шифрования данных

Для обеспечения безопасности данных включите SSL-шифрование. Выполните следующие действия:

На хосте создайте директорию с конфигурацией nginx, включающую каталог для хранения информации о SSL-шифровании:
```
sudo mkdir -p /etc/nginx/ssl/
```
Создайте ключ и сертификат SSL. Если будет использоваться самоподписанный сертификат, выполните следующую команду:
```
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/nginx/ssl/my-example-domain.com.key -out /etc/nginx/ssl/my-example-domain.com.crt
```
Для заполнения полей сертификата вам будет предложено несколько вопросов. Ответьте на них, уделив особое внимание строке Common Name. В ней нужно ввести имя или публичный IP-адрес домена, связанного с сервером. Созданные файлы ключа my-example-domain.com.key и сертификата my-example-domain.com.crt будут сохранены в каталоге /etc/nginx/ssl/.

Если используется подтвержденный сертификат, то нужно добавить путь сертификата в volumes для сервиса findface-video-worker, добавить установку ca-certificates и обновить корневое хранилище сертификатов в контейнере сервиса.

Откройте файл docker-compose.yaml:

sudo vi /opt/findface-multi/docker-compose.yaml

Найдите раздел findface-video-worker и отредактируйте его, чтобы он выглядел так, как показано ниже.

Для CPU:

findface-video-worker:
    entrypoint: ["sh", "-c", "apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install --no-install-recommends --yes ca-certificates && update-ca-certificates && exec /tini -- /findface-video-worker-cpu --config=/etc/findface-video-worker.yaml"]
    depends_on: [findface-video-manager, findface-ntls, mongodb]
    image: docker.int.ntl/ntech/universe/video-worker-cpu:ffserver-8.221216
    logging: {driver: journald}
    network_mode: service:pause
    restart: always
    volumes: ['./configs/findface-video-worker/findface-video-worker.yaml:/etc/findface-video-worker.yaml:ro',
      './models:/usr/share/findface-data/models:ro', './cache/findface-video-worker/models:/var/cache/findface/models_cache',
      './cache/findface-video-worker/recorder:/var/cache/findface/video-worker-recorder',
      '/etc/nginx/ssl/my-example-domain.crt:/usr/local/share/ca-certificates/my-example-domain.crt:ro']

Для GPU достаточно будет добавить путь до сертификата и обновить корневое хранилище:

findface-video-worker:
    entrypoint: ["sh", "-c", "update-ca-certificates && exec /tini -- /findface-video-worker-gpu --config=/etc/findface-video-worker.yaml"]
    depends_on: [findface-video-manager, findface-ntls, mongodb]
    environment: [CUDA_VISIBLE_DEVICES=0]
    image: docker.int.ntl/ntech/universe/video-worker-gpu:ffserver-8.221216
    logging: {driver: journald}
    network_mode: service:pause
    restart: always
    runtime: nvidia
    volumes: ['./configs/findface-video-worker/findface-video-worker.yaml:/etc/findface-video-worker.yaml:ro',
      './models:/usr/share/findface-data/models:ro', './cache/findface-video-worker/models:/var/cache/findface/models_cache',
      './cache/findface-video-worker/recorder:/var/cache/findface/video-worker-recorder',
      '/etc/nginx/ssl/my-example-domain.crt:/usr/local/share/ca-certificates/my-example-domain.crt:ro']

Важно

Для CPU версии настройка требует доступ к интернету. Если он отсутствует, обратитесь к нашими техническим специалистам (support@ntechlab.com).

Предупреждение

Для CPU версии вырастет время запуска контейнера findface-video-worker на ~15 секунд.

Выполните пересборку контейнеров FindFace Multi.
```
cd /opt/findface-multi/
docker-compose down
docker-compose up -d
```

Настройте nginx для использования SSL. Откройте файл конфигурации nginx /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf. Внесите в файл следующие изменения:

Добавьте новый раздел server {...}, содержащий правило замены URL. В строке rewrite ^(.*) https://… замените ip_address_server_ffmulti IP-адресом сервера, на котором установлен экземпляр FindFace Multi.
```
server {
        listen 80;
        server_name my-example-domain.com www.my-example-domain.com;
        rewrite ^(.*) https://ip_address_server_ffmulti$1 permanent;
        access_log off;
}
```
Закомментируйте следующие строки в существующем разделе server {...}:
```
# listen 80 default_server;
# listen [::]:80 default_server;
```

Добавьте следующие строки, включая пути к сертификату и ключу, в существующий раздел server {...}:

listen 443 ssl;

ssl_certificate     /etc/nginx/ssl/my-example-domain.com.crt;
ssl_certificate_key /etc/nginx/ssl/my-example-domain.com.key;

Пример файла конфигурации /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf с корректно заданными настройками SSL показан в примере ниже:

upstream ffsecurity {
        server 127.0.0.1:8002;
}

upstream ffsecurity-ws {
        server 127.0.0.1:8003;
}

upstream ffsecurity-django {
        server 127.0.0.1:8004;
}

upstream audit {
        server 127.0.0.1:8012;
}

upstream identity-provider {
        server 127.0.0.1:8022;
}

map $http_upgrade $ffsec_upstream {
        default "http://ffsecurity-ws";
        "" "http://ffsecurity";
}


server {
        listen 80;
        server_name my-example-domain.com www.my-example-domain.com;
        rewrite ^(.*) https://my-example-domain.com$1 permanent;
        access_log off;
}

server {
        # listen 80 default_server;
        # listen [::]:80 default_server;

        listen 443 ssl;
        ssl_certificate /etc/nginx/ssl/my-example-domain.com.crt;
        ssl_certificate_key /etc/nginx/ssl/my-example-domain.com.key;

        root /var/lib/findface-security;

        autoindex off;

        server_name _;

        location = / {
                alias /usr/share/findface-security-ui/;
                try_files /index.html =404;
        }
        location /static/ {
        }
        location /uploads/ {
                # internal; # uncomment if you intend to enable OVERPROTECT_MEDIA
                add_header 'Access-Control-Allow-Origin' '*';
                add_header 'Access-Control-Allow-Methods' '*';
                add_header 'Access-Control-Allow-Headers' '*';
                add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
                add_header 'Access-Control-Max-Age' 2592000;

                location ~ /card/(?<card_type>[a-zA-Z]+)/(?<card_id>[0-9]+)/attachments/(.*)$ {
                        add_header 'Access-Control-Allow-Origin' '*';
                        add_header 'Access-Control-Allow-Methods' '*';
                        add_header 'Access-Control-Allow-Headers' '*';
                        add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
                        add_header 'Access-Control-Max-Age' 2592000;
                        add_header 'Content-Disposition' 'attachment';
                        add_header 'Content-Security-Policy' 'sandbox';
                }
        }
        location /ui-static/ {
                alias /usr/share/findface-security-ui/ui-static/;
        }
        location /doc/ {
                alias /opt/findface-security/doc/;
        }
        location /api-docs {
                alias /opt/findface-security/rapidoc;
                index index.html;
        }
        location /api-docs/ {
                alias /opt/findface-security/rapidoc/;
                try_files $uri index.html =404;
        }
        location ~ /videos/(?<video_id>[0-9]+)/upload/(.*)$ {
                client_max_body_size 15g;

                proxy_set_header Host $http_host;
                proxy_set_header X-Forwarded-For $remote_addr;
                proxy_set_header X-Forwarded-Proto $scheme;
                proxy_pass http://ffsecurity;
        }
        location @django {
                internal;
                client_max_body_size 1g;
                proxy_set_header Host $http_host;
                proxy_set_header X-Forwarded-For $remote_addr;
                proxy_set_header X-Forwarded-Proto $scheme;
                proxy_http_version 1.1;
                proxy_read_timeout 5m;
                proxy_pass http://ffsecurity-django;
        }

#      location /v1/video-liveness {
#          add_header Access-Control-Allow-Headers "*" always;
#          add_header Access-Control-Allow-Methods "*" always;
#          add_header Access-Control-Allow-Origin  "*" always;
#
#          if ($request_method = 'OPTIONS') {
#              return 204;
#          }
#
#          client_max_body_size 300m;
#          proxy_set_header Host $http_host;
#          proxy_set_header X-Forwarded-For $remote_addr;
#          proxy_set_header X-Forwarded-Proto $scheme;
#          proxy_pass http://127.0.0.1:18301;
#          proxy_read_timeout 5m;
#      }

        location / {
                client_max_body_size 1g;
                proxy_set_header Host $http_host;
                proxy_set_header X-Forwarded-For $remote_addr;
                proxy_set_header X-Forwarded-Proto $scheme;
                proxy_http_version 1.1;
                proxy_set_header Upgrade $http_upgrade;
                proxy_set_header Connection "upgrade";
                proxy_pass $ffsec_upstream;
                proxy_read_timeout 5m;

                location ~ ^/(cameras|videos|vms|external-vms).*/stream/?$ {
                        proxy_set_header Host $http_host;
                        proxy_set_header X-Forwarded-For $remote_addr;
                        proxy_set_header X-Forwarded-Proto $scheme;
                        proxy_pass http://ffsecurity;
                }

                location ~ ^/streams/(.*)$ {
                        internal;
                        proxy_pass $1$is_args$args;
                }

                location /audit-logs {
                        proxy_pass http://audit;
                }

                location ~ ^/(auth|ad_groups|cproauth|groups|permissions|sessions|users|user-face|device-blacklist-records) {
                        proxy_pass http://identity-provider;
                }
        }
#       location /users/me/ad {
#
#                 proxy_pass <FFmulti_address>/auth/ad_login/; e.g http://127.0.0.1/auth/ad_login/;
#                 proxy_method POST;
#
#                 proxy_set_header   X-Real-IP $remote_addr;
#                 proxy_set_header   Host $http_host;
#                 proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
#                 proxy_set_header  Authorization $http_authorization;
#                 proxy_pass_header Authorization;
#                 proxy_no_cache 1;
#                 proxy_cache_bypass 1;
#
#                 auth_gss on;
#                 auth_gss_realm <REALM>; # e.g. TESTNTL.LOCAL;
#                 auth_gss_keytab <path/to/file.keytab>; # e.g. /var/lib/web.keytab
#                 auth_gss_service_name <service_name>; # e.g. HTTP/web.testntl.local;
#                 auth_gss_allow_basic_fallback on;
#         }

}

Скопируйте общий файл конфигурации nginx nginx.conf из контейнера findface-multi-findface-multi-ui-1 в директорию /etc/nginx/:
```
sudo docker cp findface-multi-findface-multi-ui-1:/etc/nginx/nginx.conf /etc/nginx/nginx.conf
```
В общем файле конфигурации /etc/nginx/nginx.conf найдите раздел SSL Settings и добавьте в его конец следующие строки:
```
ssl_session_cache   shared:SSL:10m;
ssl_session_timeout 1h;
```

В файле /opt/findface-multi/docker-compose.yaml добавьте (смонтируйте) каталог, хранящий данные SSL-шифрования /etc/nginx/ssl/ и файл конфигурации /etc/nginx/nginx.conf системы-хоста в контейнер findface-multi-findface-multi-ui-1:
1. Откройте файл docker-compose.yaml:
  sudo vi /opt/findface-multi/docker-compose.yaml
2. Найдите раздел findface-multi-ui и отредактируйте его, чтобы он выглядел так, как показано в примере ниже:
  findface-multi-ui: depends_on: [findface-multi-legacy] image: docker.int.ntl/ntech/multi/multi/ui:ffmulti-2.1.0 network_mode: service:pause restart: always volumes: ['./configs/findface-multi-ui/nginx-site.conf:/etc/nginx/conf.d/default.conf:ro', './data/findface-multi-legacy/uploads:/var/lib/findface-security/uploads', '/etc/nginx/ssl:/etc/nginx/ssl', '/etc/nginx/nginx.conf:/etc/nginx/nginx.conf:ro']
Отредактируйте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
1. В параметрах ROUTER_URL и IMAGE_CROP_URL замените префикс http:// на https://.
  sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py ... 'ROUTER_URL': 'https://127.0.0.1', 'IMAGE_CROP_URL': 'https://127.0.0.1', ...
2. При использовании подтвержденного сертификата необходимо в ROUTER_URL указать домен, по которому был создан сертификат:
  'ROUTER_URL': 'https://my-example-domain.com'
3. Добавьте адрес https://my-example-domain.com в параметр EXTERNAL_ADDRESS:
  ... EXTERNAL_ADDRESS = 'https://my-example-domain.com' ...
На сервере с установленным FindFace Multi откройте файл /etc/hosts и добавьте следующую строку:
```
sudo vi /etc/hosts

...
127.0.0.1 my-example-domain.com
```
В системе, где вы используете браузер для взаимодействия с FindFace Multi, откройте файл hosts. Добавьте IP-адрес сервера, на котором установлен FindFace Multi, вместо ip_address_server_ffmulti. Замените my-example-domain.com адресом вашего домена — так же, как вы делали в предыдущих шагах.
1. Для операционной системы Linux выполните следующее:
```
sudo vi /etc/hosts

...
*ip_address_server_ffmulti* my-example-domain.com
```
2. Если вы используете операционную систему Windows, откройте файл C:\Windows\System32\drivers\etc\hosts от имени администратора. Добавьте следующую строку в файл hosts:
```
*ip_address_server_ffmulti* my-example-domain.com
```

Перезапустите контейнеры:

cd /opt/findface-multi/
sudo docker-compose down
sudo docker-compose up -d

При использовании самоподписанного сертификата для работы камер и загруженных видеоархивов нужно отключать проверку SSL-сертификата:
1. Перейдите на вкладку Источники видео -> Камеры или Загрузки.
2. Нажмите на камеру или загруженный видеоархив.
3. На вкладке Дополнительные снимите флажок Проверить SSL-серnификат.

Предупреждение

Если среда будет сильно распределена при полностью настраиваемой установке и компонент pause будет исключен из установки, то могут возникнуть проблемы с получением скриншотов в камерах и в работе с видеоплеером. Для решения этой проблемы можно добавить следующие строки в файл /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:

USE_X_FORWARDED_HOST = True
SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker restart findface-multi-findface-multi-legacy-1

Включение защиты картотеки

Если защита картотеки отключена, фотографии и вложения карточек будут доступны по прямой ссылке независимо от прав пользователя. Для того чтобы повысить безопасность картотеки, настройте FindFace Multi на выполнение всех медиа-запросов через приложение DJANGO для дополнительной проверки ACL.

Важно

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

Важно

Чтобы проверка ACL выполнялась правильно, необходимо установить разрешение на просмотр загруженных в карточки фотографий лиц, силуэтов и транспортных средств. Для этого перейдите Настройки → Роли →нужная роль → Права доступа и установите Просмотр для сущностей faceobject, bodyobject и carobject, в зависимости от того, фотографии каких объектов есть в карточках. Подробнее см. Создание новой роли в веб-интерфейсе.

См.также

Картотека

Для включения защиты картотеки выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Найдите параметр OVERPROTECT_MEDIA и установите его в значение True.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...

'OVERPROTECT_MEDIA': True,
```
Сделайте то же самое в файле конфигурации /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py : найдите параметр OVERPROTECT_MEDIA и установите его в значение True.
```
sudo vi /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py

...

'OVERPROTECT_MEDIA': True,
```
Откройте файл конфигурации nginx /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf. Раскомментируйте параметр internal в разделе location /uploads.
```
sudo vi /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf

location /uploads/ {
   internal; # Uncomment if you intend to enable OVERPROTECT_MEDIA
   ...
}
```

Перезапустите контейнеры findface-multi-findface-multi-legacy-1, findface-multi-findface-multi-identity-provider-1 и findface-multi-findface-multi-ui-1.

sudo docker container restart findface-multi-findface-multi-legacy-1
sudo docker container restart findface-multi-findface-multi-identity-provider-1
sudo docker container restart findface-multi-findface-multi-ui-1

После применения новой политики безопасности вошедшие в систему пользователи должны пройти повторную аутентификацию. Для того чтобы они сделали это, принудительно выведите их из системы командой:
```
sudo docker container exec -it findface-multi-findface-multi-identity-provider-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py logout_all_users
```

Отключение ACL

Постоянные проверки разрешений потребляют большой объем системных ресурсов. При необходимости ACL FindFace Multi можно отключить.

Выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```
Установите ENABLE_ACL = False.
```
...

ENABLE_ACL = False
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Список сессий пользователей. Блокировки

В этой главе:

Предоставление разрешений для работы с сессиями
Просмотр сессий пользователей
Блокировка устройства

FindFace Multi позволяет увидеть текущие пользовательские сессии и узнать связанные с ними данные, такие как UUID подключенного устройства, тип пользовательского интерфейса, IP-адрес, время последнего соединения и т. д.

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

Предоставление разрешений для работы с сессиями 

Доступ пользователей к списку сессий зависит от предоставленных разрешений:

Администратор: может просматривать и закрывать сессии всех пользователей
Пользователь с разрешениями all_own_sessions: может просматривать/закрывать все сессии со своего логина
Пользователь без разрешений all_own_sessions: может просмотреть/закрыть только свою текущую сессию

Просмотр сессий пользователей 

Для просмотра списка пользователей перейдите Настройки -> Сессии.

Каждая запись сессии содержит следующие данные:

UUID устройства
логин
тип пользовательского интерфейса (мобильный/веб)
информация об устройстве
IP-адрес
статус (онлайн, офлайн, заблокировано)
время последнего соединения

Используйте панель фильтров сверху, чтобы задать условия поиска в списке сессий.

Для закрытия сессии выберите ее в списке и нажмите x.

Блокировка устройства 

Список заблокированных устройств доступен на вкладке Блокировки.

Вы можете заблокировать устройство на вкладке Сессии. Блокировка устройства приводит к автоматическому выводу пользователя из системы.

Для блокировки устройства выполните следующие действия:

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

Разрешенные расширения файлов в карточках

По умолчанию вы можете прикрепить к карточке файл с любым расширением. Существует возможность повысить безопасность системы, создав список разрешенных расширений файлов. Это предотвратит загрузку пользователями файлов нежелательных форматов, в том числе тех, которые могут включать скрытый вредоносный код, например, .js, .swf и других.

Для того чтобы создать список разрешенных расширений файлов, выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```
В разделе FFSECURITY найдите параметр CARD_ATTACHMENTS_FILENAME_REGEXP. Задайте выражение, описывающее разрешенные файловые расширения. Подойдет любое действительное регулярное выражение Python.

Примеры:
- r'.*\.png': разрешает только файлы с расширением .png
- r'.*\(png|jpg)': разрешает только расширения .png и .jpg
- r'.*': разрешает все расширения
- None: разрешает все расширения
- 'XXXXXX': загрузка файлов с любым расширением запрещена
```
FFSECURITY = {
   ...
   'CARD_ATTACHMENTS_FILENAME_REGEXP': r'.*\.txt',
   ...

   }
```
Совет

Если закомментировать параметр CARD_ATTACHMENTS_FILENAME_REGEXP, это также разрешит все расширения.
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Группы камер

Группы камер — это системные объекты, которые используются для классификации источников видео. После обработки видео система отнесет полученные события распознавания объектов к назначенной группе камер. Это значительно упрощает дальнейшую обработку событий и поиск.

Для создания группы камер выполните следующие действия:

Перейдите Настройки -> Группы камер.
Нажмите + Новая группа камер.
На вкладке Сведения, задайте имя группы. При необходимости добавьте комментарий.
Если вам нужно выделить определенный экземпляр findface-video-worker для обработки видеопотоков с данной группы камер, создайте или выберите из уже созданных одну или несколько меток.

Примечание

Чтобы завершить выделение, перечислите метки в файле конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml. Подробнее см. Привязка группы камер к экземпляру findface-video-worker.
Если события от камер, принадлежащих одной группе, требуется дедуплицировать, т. е. исключить одинаковые события, поставьте флажок Убрать дубли событий с интервалом и задайте в секундах интервал дедупликации (интервал, с которым события проверяются на уникальность).

Предупреждение

Используйте дедупликацию очень осторожно. Если камеры из одной группы наблюдают разные сцены, некоторые объекты могут быть пропущены. Подробнее см. Дедупликация событий.
По умолчанию на всех группах камер в системе используется универсальный порог срабатывания. Для того чтобы установить индивидуальный порог для группы камер, включите Порог срабатывания и укажите нужное пороговое значение.
Сохраните изменения.
На вкладке Права доступа назначьте права на работу с группой камер, указав, пользователям с какими ролями разрешено изменять/просматривать ее настройки.
Нажмите Сохранить.
Активируйте группу камер.

Привязка группы камер к экземпляру `findface-video-worker`

Часто в распределенной архитектуре обработку видеоизображения с группы камер требуется выполнять локально, не обращаясь к центральному серверу и не перераспределяя видеопотоки между удаленными экземплярами findface-video-worker.

Примечание

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

В этом случае группу камер привязывают к локально установленному экземпляру findface-video-worker.

Выполните следующие действия:

Перейдите на вкладку Настройки. Выберите Группы камер.
Откройте настройки группы камер.
В поле Ярлыки создайте или выберите из уже созданных одну или несколько меток для привязки группы камер к экземпляру findface-video-worker. Сохраните изменения.

Существует два способа задать указанные метки:

с помощью конфигурационного файла findface-video-worker.yaml
с помощью конфигурационного файла docker-compose.yaml

Примечание

Используйте одинаковые названия меток в findface-video-worker и в веб-интерфейсе, в противном случае камеры не могут обрабатывать видео.

Выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml и перечислите указанные ранее метки в формате словаря (метки MyLabel1, MyLabel2 в примере ниже).
```
sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

labels: {"MyLabel1": "true", "MyLabel2": "true"}
```
Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

В качестве альтернативного способа вы можете использовать конфигурацию файла docker-compose.yaml:

Откройте файл конфигурации /opt/findface-multi/docker-compose.yaml и укажите метки в разделе findface-video-worker, добавив переменные окружения:

sudo vi /opt/findface-multi/docker-compose.yaml

...
  findface-video-worker:
    command: [--config=/etc/findface-video-worker.yaml]
    depends_on: [findface-video-manager, findface-ntls, mongodb]
    environment:
      - CUDA_VISIBLE_DEVICES=0
      - CFG_LABLES=MyLabel1=true;MyLabel2=true
    image: docker.int.ntl/ntech/universe/video-worker-cpu:ffserver-9.230407.1
    logging: {driver: journald}
    network_mode: service:pause
   ...

Перезапустите все контейнеры FindFace Multi.

cd /opt/findface-multi
sudo docker-compose down
sudo docker-compose up -d

Примечание

Если камере присвоена метка, то видеопоток с нее может обрабатываться как экземпляром findface-video-worker с аналогичной меткой, так и экземпляром findface-video-worker без меток.

Предупреждение

Если камера с меткой обрабатывается экземпляром findface-video-worker без меток и появляется свободный экземпляр с меткой, камера автоматически на него не переключится. Перезапустите камеру с меткой.

Списки наблюдения

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

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

Вы можете создать столько пользовательских списков наблюдения, сколько необходимо: розыск, подозреваемые и т. д. — в зависимости от потребностей.

В этом разделе:

Мониторинг незарегистрированных лиц
Создание списка наблюдения
Удаление списка наблюдения

Мониторинг незарегистрированных лиц 

Базовая конфигурация FindFace Multi уже содержит предустановленный список наблюдения, предназначенный для мониторинга событий, для которых отсутствуют совпадения с картотекой. Данный список наблюдения не может быть удален из системы. Для редактирования настроек списка, перейдите на вкладку Настройки. Выберите Списки наблюдения и щелкните Unmatched.

Создание списка наблюдения 

Для создания пользовательского списка наблюдения выполните следующие действия:

Перейдите Настройки -> Списки наблюдения.
Нажмите + Новый список наблюдения.
На вкладке Сведения задайте имя списка наблюдения.
Из палитры Цвет выберите цвет уведомлений для данного списка.
При необходимости опишите назначение списка наблюдения в комментарии.
По умолчанию ко всем спискам наблюдения в системе применяется универсальный порог срабатывания. Для того чтобы задать индивидуальный порог для списка наблюдения, поставьте флажок Порог срабатывания и укажите нужное значение.

Важно

Для большинства случаев распознавания значение порога срабатывания, установленное по умолчанию, является оптимальным. Не рекомендуется самостоятельно менять его. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).
Поставьте флажок Требовать подтверждения событий, если для данного списка оператор должен в обязательном порядке подтвердить принятие события.
Поставьте флажок Не создавать события, чтобы не создавать событие, если был обнаружен объект из данного списка.
Поставьте флажок Включить звуковые оповещения, чтобы включить звук при появлении события для данного списка.
На вкладке Права доступа назначьте права на список наблюдения, указав роли пользователей, которые смогут изменять/просматривать его настройки.
Активируйте и сохраните список наблюдения.

Удаление списка наблюдения 

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

Списки наблюдения Default Watch List и Unmatched не могут быть удалены из системы.

Настройка сохранения изображений в отчетах

При создании отчетов предоставляется возможность выбрать способ представления в нем изображений: в виде ссылок, миниатюр или полных кадров. Вы можете настроить параметры изображений. Для этого откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и измените заданные по умолчанию качество JPEG и максимальную высоту миниатюр и полных кадров в зависимости от свободного дискового пространства.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

# reports image saving options
'REPORT_THUMBNAIL_JPEG_QUALITY': 75,
'REPORT_THUMBNAIL_MAX_HEIGHT': 100,
'REPORT_FULLFRAME_JPEG_QUALITY': 75,
'REPORT_FULLFRAME_MAX_HEIGHT': 250,

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Дедупликация событий

В этом разделе:

Включение дедупликации
Алгоритм работы дедупликации

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

Включение дедупликации 

Для того чтобы активировать функцию дедупликации, выполните следующие действия:

Для каждой камеры в группе включите буферный режим детектирования объектов. См. подробнее Добавление камеры.
Перейдите на вкладку Настройки. Выберите Группы камер.
Откройте настройки группы камер.
Поставьте флажок Убрать дубли событий с интервалом и задайте в секундах интервал дедупликации.

Алгоритм работы дедупликации 

Алгоритм дедупликации работает следующим образом. В буферном режиме сервер получает один лучший кадр с объектом за всю сессию отслеживания.

Примечание

Сессия отслеживания продолжается до момента исчезновения объекта из поля зрения камеры.

Если в пределах группы камер произошло несколько сеансов отслеживания на одной или нескольких камерах в течение указанного интервала дедупликации, FindFace Multi обработает полученные изображения объектов следующим образом:

Если в течение предшествующего периода, равного интервалу дедупликации, есть совпадение с карточкой, FindFace Multi отбрасывает вновь полученное изображение. В противном случае изображение сохраняется в базе данных.
Для объектов без совпадений при выполнении дедупликации FindFace Multi учитывает как сходство между объектами, так и качество кадров. В результате FindFace Multi удаляет все изображения похожих объектов в пределах интервала дедупликации, если они более низкого качества, чем первое в данном интервале. Если новое изображение объекта более высокого качества, оно сохраняется. Это гарантирует, что система дедуплицирует события, не пропуская высококачественные изображения, необходимые для последующей видеоаналитики.

Включение защиты персональных данных

В FindFace Multi реализована поддержка законов, связанных с обработкой персональных данных физических лиц (GDPR и аналогичные).

Для того чтобы применить к системе защиту персональных данных, выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py .
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

Отключите сохранение событий без совпадений, установив 'IGNORE_UNMATCHED': True.

...

FFSECURITY = {
    ...

    # do not save unmatched events (GDPR support)
    'IGNORE_UNMATCHED': True,

    ...

}

Для событий с совпадениями включите размытие в полных кадрах всех объектов, для которых совпадения не были найдены. Для этого установите 'BLUR_UNMATCHED_OBJECTS: True. При желании вы можете изменить установленное по умолчанию для данных кадров качество JPEG.
```
...

FFSECURITY = {
    ...
    # blur all unmatched objects on the full frame of the matched event (GDPR support)
    'BLUR_UNMATCHED_OBJECTS': True,

    # full frame jpeg quality when `BLUR_UNMATCHED_OBJECTS` is enabled
    'BLURRED_FULLFRAME_JPEG_QUALITY': 85,
    ...

}
```
Включите размытие на видеостене всех объектов, для которых совпадения не были найдены. Для этого установите "gdpr": True в секции FFSECURITY_UI_CONFIG -> video_player .
```
FFSECURITY_UI_CONFIG = {
    ...

   "video_player": {
      "overlay": {
       ...
        "gdpr": True
      }
   }
    ...
}
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

См.также

Видеостена

Настройка Видеомагнитофона

Внутренняя архитектура Ядра FindFace позволяет встроить дополнительную функциональность «Видеомагнитофон», которая позволяет записывать, хранить и проигрывать видеоданные с камер.

Данный раздел посвящен настройке Видеомагнитофона.

В этом разделе:

Включение Видеомагнитофона
Особенности отключения Видеомагнитофона

Включение Видеомагнитофона 

Для активации Видеомагнитофона выполните следующие действия:

Включите возможность передачи видеофрагментов от findface-video-worker в сервис findface-video-storage.

Важно

Данная настройка делает функциональность Видеомагнитофона доступной через HTTP API. Она также обязательна, если вы собираетесь использовать Видеомагнитофон в составе веб-интерфейса FindFace Multi.

Выполните следующие действия:
1. Откройте файл конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml для включения сервиса findface-video-worker, который будет поставлять видео в Видеомагнитофон.
```
sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml
```
2. Установите enabled: true в разделе recorder.
```
recorder:
  enabled: true
  ...
```
3. Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Настройте Видеомагнитофон для работы в составе веб-интерфейса FindFace Multi.

Примечание

Пропустите следующие шаги, если вам не нужно, чтобы инструменты Видеомагнитофона отображались в веб-интерфейсе FindFace Multi.

Выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

Найдите раздел FFSECURITY_UI_CONFIG -> vms.

Список параметров для включения элементов видеомагнитофона в интерфейсе FindFace Multi:

Параметр	Описание
`vms` -> `"enabled"`	Установите `True`, чтобы добавить флажок Включить запись в настройки камер.
`vms` -> `"video_player"`	Установите `True`, чтобы включить отображение видеоплеера в уведомлениях о событиях и предварительном просмотре камеры (вместо статических кадров). Данная настройка требует установленного `"enabled": True`.

Найдите раздел FFSECURITY_UI_CONFIG -> video_player.

Список параметров для настройки параметров видеоплеера:

Параметр	Описание
`"overlay"` -> `"objects"`	Определяет настройки для отображения рамок и данных по атрибутам для лиц, силуэтов и транспортных средств соответственно. Установите `True` или `False` чтобы включить/выключить их отображение.
`"overlay"` -> `"gdpr"`	Установите `True`, чтобы включить размытие на видеоплеере всех объектов без совпадений. Для того чтобы в полном объеме выполнить требования законов о защите персональных данных, руководствуйтесь данной инструкцией.
`"timeline"` -> `"min_zoom"`	Определяет самый крупный возможный масштаб на временной шкале видеоплеера, секунды/пиксель.
`"timeline"` -> `"max_zoom"`	Определяет самый мелкий возможный масштаб на временной шкале, секунды/пиксель.
`"timeline"` -> `"objects"` -> `"events"` `"faces"` -> `"enabled"`	Установите `True`, чтобы отмечать на временной шкале все события с лицами в виде маркеров.
`"timeline"` -> `"objects"` -> `"events"` `"faces"` -> `"limit"`	Максимальное количество событий с лицами, одновременно отмеченных на временной шкале. Если событий с лицами больше, вам будет предложено увеличить масштаб.
`"timeline"` -> `"objects"` -> `"events"` `"faces"` -> `"matchedColor"`	Цвет событий с лицами с совпадением.
`"timeline"` -> `"objects"` -> `"events"` `"faces"` -> `"unmatchedColor"`	Цвет событий с лицами без совпадений.
`"timeline"` -> `"objects"` -> `"events"` `"bodies"` -> `"enabled"`	Установите `True`, чтобы отмечать на временной шкале все события с силуэтами в виде маркеров.
`"timeline"` -> `"objects"` -> `"events"` `"bodies"` -> `"limit"`	Максимальное количество событий с силуэтами, одновременно отмеченных на временной шкале. Если событий с силуэтами больше, вам будет предложено увеличить масштаб.
`"timeline"` -> `"objects"` -> `"events"` `"bodies"` -> `"matchedColor"`	Цвет событий с силуэтами с совпадением.
`"timeline"` -> `"objects"` -> `"events"` `"bodies"` -> `"unmatchedColor"`	Цвет событий с силуэтами без совпадений.
`"timeline"` -> `"objects"` -> `"events"` `"cars"` -> `"enabled"`	Установите `True`, чтобы отмечать на временной шкале все события с транспортными средствами в виде маркеров.
`"timeline"` -> `"objects"` -> `"events"` `"cars"` -> `"limit"`	Максимальное количество событий с транспортными средствами, одновременно отмеченных на временной шкале. Если событий с транспортными средствами больше, вам будет предложено увеличить масштаб.
`"timeline"` -> `"objects"` -> `"events"` `"cars"` -> `"matchedColor"`	Цвет событий с транспортными средствами с совпадением.
`"timeline"` -> `"objects"` -> `"events"` `"cars"` -> `"unmatchedColor"`	Цвет событий с транспортными средствами без совпадений.
`"timeline"` -> `"objects"` -> `"episodes"` `"humans"` -> `"enabled"`	Установите `True`, чтобы отмечать на временной шкале все эпизоды с людьми в виде маркеров.
`"timeline"` -> `"objects"` -> `"episodes"` `"humans"` -> `"limit"`	Максимальное количество эпизодов с людьми, одновременно отмеченными на временной шкале. Если эпизодов с людьми больше, вам будет предложено увеличить масштаб.
`"timeline"` -> `"objects"` -> `"episodes"` `"humans"` -> `"matchedColor"`	Цвет эпизодов с людьми с совпадением.
`"timeline"` -> `"objects"` -> `"episodes"` `"humans"` -> `"unmatchedColor"`	Цвет эпизодов с людьми без совпадений.
`"timeline"` -> `"objects"` -> `"episodes"` `"cars"` -> `"enabled"`	Установите `True`, чтобы отмечать на временной шкале все эпизоды с транспортными средствами в виде маркеров.
`"timeline"` -> `"objects"` -> `"episodes"` `"cars"` -> `"limit"`	Максимальное количество эпизодов с транспортными средствами, одновременно отмеченных на временной шкале. Если эпизодов с транспортными средствами больше, вам будет предложено увеличить масштаб.
`"timeline"` -> `"objects"` -> `"episodes"` `"cars"` -> `"matchedColor"`	Цвет эпизодов с транспортными средствами с совпадением.
`"timeline"` -> `"objects"` -> `"episodes"` `"cars"` -> `"unmatchedColor"`	Цвет эпизодов с транспортными средствами без совпадений.

FFSECURITY_UI_CONFIG = {

"video_player": {
 "overlay": {
     "objects": {
         "faces": {
           "bbox": True,
           "info": True
         },
         "bodies": {
           "bbox": True,
           "info": True
         },
         "cars": {
           "bbox": True,
           "info": True
         }
     },
     "gdpr": False
 },
 "timeline": {
     "min_zoom": 0.2,
     "max_zoom": 200,
     "objects": {
         "events": {
             "faces": {
                 "enabled": True,
                 "limit": 500,
                 "matchedColor": "rgba(6,193,103,0.8)",
                 "unmatchedColor": "rgba(232,92,74,0.8)",
             },
             "bodies": {
                 "enabled": False,
                 "limit": 500,
                 "matchedColor": "rgba(6,193,103,0.8)",
                 "unmatchedColor": "rgba(232,92,74,0.8)",
             },
             "cars": {
                 "enabled": False,
                 "limit": 500,
                 "matchedColor": "rgba(6,193,103,0.8)",
                 "unmatchedColor": "rgba(232,92,74,0.8)",
             },
         },
         "episodes": {
             "humans": {
                 "enabled": False,
                 "limit": 500,
                 "matchedColor": "rgba(6,193,103,0.8)",
                 "unmatchedColor": "rgba(232,92,74,0.8)",
             },
             "cars": {
                 "enabled": False,
                 "limit": 500,
                 "matchedColor": "rgba(6,193,103,0.8)",
                 "unmatchedColor": "rgba(232,92,74,0.8)",
             },
         },
     },
 },
},
"vms": {
   "enabled": True,
   "video_player": True,
},

Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Особенности отключения Видеомагнитофона 

Если Видеомагнитофон работает и записывает видео на выбранных камерах, а вам нужно отключить его, обязательно сначала отключите запись видео на данных камерах. Только после этого можно перейти к изменению файлов конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.

Удаление видеозаписей

См.также

Настройка Видеомагнитофона

В системе доступно два метода очистки видеоархива:

Регулярная очистка
Ручная очистка посредством консольной команды

В этом разделе:

Регулярная очистка видео
Ручная очистка видео
Включение настроек очистки VMS в веб-интерфейсе

Регулярная очистка видео 

Для настройки регулярной очистки видео выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

Найдите секцию SERVICES и установите "vms_cleanup": True.

SERVICES = {
    "ffsecurity": {
        ...
        "vms_cleanup": True,
    }
}

Найдите секцию VMS_CLEANUP_SETTINGS и укажите, какие именно фрагменты видео должны быть удалены, используя следующие параметры:
- 'CLEANUP_BETWEEN_TRACKS': установите True для удаления промежутков видео, не содержащих событий распознавания.
- 'CLEANUP_ARCHIVE': установите True для удаления всего видеоархива старше заданного количества дней.
- 'ARCHIVE_CLEANUP_AGE': максимальный возраст видеоархива в системе, дни. Параметр актуален, если 'CLEANUP_ARCHIVE': True.
- 'BETWEEN_TRACKS_CLEANUP_START_AGE': период времени (дни), в течение которого весь видеоархив хранится в системе. По истечении этого периода система начинает очистку между треками в соответствии с настройками CLEANUP_BETWEEN_TRACKS.
- 'KEEP_EVENT_TYPES'': типы событий, которые будут сохранены в видеоархиве, в форме словаря, например, [face, body, car].
- 'KEEP_EVENT_BEFORE_AFTER': промежуток до и после трека с событиями, который не будет удален в целях сохранения связанной с ними значимой информации, секунды. Значение должно быть меньше CLEANUP_THRESHOLD.
- 'CLEANUP_THRESHOLD': минимальный промежуток между треками с событиями, секунды. Если интервал между треками короче, он не будет удален.
```
'VMS_CLEANUP_SETTINGS': {
    'CLEANUP_BETWEEN_TRACKS': True,
    'CLEANUP_ARCHIVE': True,
    'ARCHIVE_CLEANUP_AGE': 30,  # days
    'BETWEEN_TRACKS_CLEANUP_START_AGE': 0,  # days
    'KEEP_EVENT_TYPES': ['face', 'body', 'car'],
    # Add `safe_time_interval` in seconds to each `track` subject to delete
    # Prevents deletion of essential data.
    # Should be lower than CLEANUP_THRESHOLD
    'KEEP_EVENT_BEFORE_AFTER': 10,  # minimal allowed value
    # Threshold between `intervals` in seconds.
    # If duration between `tracks` < `CLEANUP_THRESHOLD`
    # interval between tracks will not be added to deletion tasks
    'CLEANUP_THRESHOLD': 360,  # minimal allowed value
},
```
Найдите параметр 'VMS_CLEANUP_SERVICE_SCHEDULE' и задайте рекуррентное правило (RRULE), по которому будет выполняться очистка архива.

Совет

См. калькулятор RRULE.
```
# rrule (recurrence rule) for scheduling `vms_cleanup` service
'VMS_CLEANUP_SERVICE_SCHEDULE': 'RRULE:FREQ=HOURLY;INTERVAL=3;WKST=MO',
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Ручная очистка видео 

Вы можете вручную удалить видеофрагменты старше заданного количества дней, выполнив приведенную ниже команду. Для задания количества дней используйте аргумент --vms-videos-max-age.

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup_vms --vms-videos-max-age=30

Включение настроек очистки VMS в веб-интерфейсе 

По умолчанию настройки очистки VMS отключены в веб-интерфейсе. Чтобы работать с настройками очистки VMS из веб-интерфейса, настройте параметр "vms" в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.

В секции FFSECURITY_UI_CONFIG найдите параметр "vms" и установите "enabled": True.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY_UI_CONFIG = {
    ...
    "vms": {
        "enabled": True,
        ...
    },
}

Убедитесь, что в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py включен сервис очистки VMS. Найдите секцию SERVICES и установите "vms_cleanup": True.
```
SERVICES = {
    "ffsecurity": {
        ...
        "vms_cleanup": True,
    }
}
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Пользовательские вкладки, поля и фильтры в карточке

См.также

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

Для добавления пользовательских вкладок и полей в карточки людей и транспортных средств выполните следующие действия:

Подготовьте список пользовательских вкладок и полей для добавления в карточки.
Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```
Настройте карточки людей. Для этого раскомментируйте секцию FFSECURITY -> CUSTOM_FIELDS -> human_card и измените ее примерное содержимое с учетом следующих правил:
- 'items': список полей в карточке. Опишите каждое поле следующими параметрами:
  - 'name': внутреннее имя поля, string.
  - default: значение по умолчанию. Если значение по умолчанию больше 1e14 – 1, то его следует записывать в виде строки, т. е. “123123..” вместо 123123...
  - 'label': название поля в карточке, string.
  - 'tab': вкладка, на которой располагается поле.
  - 'display': формат отображения (form или list), string или array.
  - 'description': описание поля, string.
  - 'editable': редактируемость поля, boolean.
  - 'type': тип данных поля, string. Возможные значения:
    - list: требует задания items, дополнительного параметра для списков (см. ниже), ожидает объекты {id, name} в словарях;
    - valuelist: ожидает элементы примитивных типов.
    - objectlist: позволяет создавать массивы объектов нужного типа.
    - datetime: примитивный тип данных, отображаемый как список datetime.
    - date: примитивный тип данных, отображаемый как выбор даты.
    - boolean: примитивный тип данных, отображаемый как флажок.
    - string: примитивный тип данных string.
  - дополнительные параметры для списков (type=list, type=valuelist):
    - multiple: возможность выбора нескольких элементов в списке, boolean.
    - items: словарь, используемый как источник данных для списка.
    - allow_create: возможность добавления новых элементов в список, boolean.
    - custom_id: пользовательское поле для id (type=list).
  - дополнительные параметры для списков объектов (type=objectlist).
    - object: объекты, используемые как источник данных для списка объектов.
    - simple: указывает, что поле ожидает данные примитивного типа вместо объектов, например, ожидает строки с телефонными номерами.
- 'filters': список фильтров для поиска по пользовательским полям. Параметры:
  - 'name': внутреннее имя фильтра,
  - 'label': название фильтра в веб-интерфейсе,
  - 'field': связанное поле в формате [имя поля].
- 'tabs': список полей в карточке.
```
FFSECURITY = {

...

# -- Custom model fields --
# Edit CUSTOM_FIELDS -> `human_card` section to customize human card fields.
# Edit CUSTOM_FIELDS -> `car_card` section to customize car card fields.
...
  'CUSTOM_FIELDS': {
      'human_card': {
          'items': [
              {
                  'name': 'personid',
                  'default': '',
                  'label': 'PersonID',
                  'display': ['list', 'form'],
                  'description': 'Sigur person ID',
                  'editable': False
              },
              {
                  'name': 'firstname',
                  'default': '',
                  'label': 'First Name',
                  'display': ['list', 'form'],
                  'description': 'Sigur first name',
                  'editable': False
              },
              {
                  'name': 'lastname',
                  'default': '',
                  'label': 'Last Name',
                  'display': ['list', 'form'],
                  'description': 'Sigur last name',
                  'editable': False
              },
              {
                  'name': 'version',
                  'default': '',
                  'label': 'Version',
                  'display': ['list', 'form'],
                  'description': 'Sigur photo version',
                  'editable': False
              }
          ],
          'filters': [
              {
                  'name': 'personid',
                  'label': 'Sigur person ID filter',
                  'field': 'personid'
              }
          ]
      },
      'car_card': {}, # same fields are available
  },
}
```
Настройте карточки транспортных средств. Для этого продублируйте содержимое секции human_card в секцию car_card и измените его по аналогии.
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
Вы увидите, что в карточках появилось новое содержимое.

Пользовательские метаданные в Tarantool

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

В этом разделе:

Настройка метаполей для лиц
Настройка метаполей для силуэтов и транспортных средств

Настройка метаполей для лиц 

Для присвоения пользовательских метаданных лицам выполните следующие действия:

Подготовьте список пользовательских метаполей, которые будут присвоены лицам.
Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

В разделе FFSECURITY раскомментируйте секцию CUSTOM_FIELDS -> face_object и измените ее примерное содержимое с учетом следующих правил:

field_name: имя поля;
type: тип данных (uint, string или bool);
default: значение по умолчанию. Если значение по умолчанию больше ‘1e14 – 1’, то его следует записывать в виде строки, т. е. “123123..” вместо 123123...

FFSECURITY = {

...

    # -- Custom model fields --
    ...
    # Edit CUSTOM_FIELDS -> `face_object` section to customize face object fields.
    ...
    # 'CUSTOM_FIELDS': {
          ...
          'face_object': {
              'items': [
                  {
                      "field_name": "tag_name_1",
                      "type": "string",
                      "default": "change_me"
                  },
                  {
                      "field_name": "tag_name_2",
                      "type": "uint",
                      "default": 123
                  },
                  {
                      "field_name": "tag_name_3",
                      "type": "bool",
                      "default": True
                  },
              ]
          }
      },
}

Добавьте новые метаполя в структуру базы данных векторов признаков.
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
Вы можете работать с новыми метаполями через HTTP API, используя методы objects/faces/.

Настройка метаполей для силуэтов и транспортных средств 

Назначение пользовательских метаполей силуэтам и транспортным средствам выполняется по аналогии с лицами. Единственное отличие состоит в том, что вам потребуется вручную создать разделы CUSTOM_FIELDS -> body_object и CUSTOM_FIELDS -> car_object. Рекомендуется продублировать раздел CUSTOM_FIELDS -> face_object и использовать дубликат в качестве отправной точки для дальнейших изменений.

FFSECURITY = {

...

    # -- Custom model fields --
    ...
    # Edit CUSTOM_FIELDS -> `face_object` section to customize face object fields.
    ...
    # 'CUSTOM_FIELDS': {
          ...
          'body_object': {
              'items': [
                  {
                      "field_name": "tag_name_1",
                      "type": "string",
                      "default": "change_me"
                  },
                  {
                      "field_name": "tag_name_2",
                      "type": "uint",
                      "default": 123
                  },
                  {
                      "field_name": "tag_name_3",
                      "type": "bool",
                      "default": True
                  },
              ]
          }
          'car_object': {
              'items': [
                  {
                      "field_name": "tag_name_1",
                      "type": "string",
                      "default": "change_me"
                  },
                  {
                      "field_name": "tag_name_2",
                      "type": "uint",
                      "default": 123
                  },
                  {
                      "field_name": "tag_name_3",
                      "type": "bool",
                      "default": True
                  },
              ]
          }
      },
}

Аналогично, вы можете работать с новыми метаполями, используя методы objects/bodies/ и objects/cars/ HTTP API.

Примечание

Назначение пользовательских метаполей для событий лиц, силуэтов и транспортных средств выполняется по аналогии с объектами (лицами, силуэтам и транспортными средствами). Вам также потребуется вручную создать разделы CUSTOM_FIELDS -> face_event, CUSTOM_FIELDS -> body_event и CUSTOM_FIELDS -> car_event аналогичным образом.

См.также

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

Пакетная загрузка карточек через консоль

Помимо веб-интерфейса для пакетной загрузки фотографий в картотеку можно использовать консольную утилиту uploader.py. Рекомендуется предпочесть данную утилиту веб-интерфейсу, если количество загружаемых фотографий превышает 10 000.

Совет

Для вызова справки uploader.py выполните команду:

docker exec findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py --help

Usage: uploader.py [OPTIONS] COMMAND [ARGS]...

Options:
--job FILE        Job file (default: enroll-job.db)
--log-level TEXT  Log level
--fsync BOOLEAN   Call fsync() to prevent data loss on power failure
--help            Show this message and exit.

Commands:
add    Add items from CSV or TSV file to job
print  Print contents of job file as JSON
run    Run upload job

docker exec findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py add --help

Usage: uploader.py add [OPTIONS] FILES...

Options:
--format [csv|tsv]  Input file format - CSV or TSV
--delimiter TEXT    Field delimiter - by default it's "\t" for TSV and ","
                    for CSV

--help              Show this message and exit.

 docker exec findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py print --help

 Usage: uploader.py print [OPTIONS]

 Print contents of job file as JSON

 Options:
--failed  Show only failed images
--noface  Show only images without detection
--help    Show this message and exit.

docker exec findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py run --help

Usage: uploader.py run [OPTIONS]

Run upload job

Options:
--parallel INTEGER        Number of enroll threads (default: 10)
--api TEXT                API url (default: http://127.0.0.1:80/)
                          [required]

--user TEXT               API username  [required]
--password TEXT           API password  [required]
--watch-lists TEXT        Comma-separated list of card list ids  [required]
--inactive                Mark new cards as inactive
--failed                  Include failed images
--noface                  Include images without detection
--all-faces               Enroll all found faces on each image
--detect-timeout INTEGER  Request timeout for detect photos
--logging-delta INTEGER   Logging period delta
--help                    Show this message and exit.

Выполните следующие действия:

Подготовьте CSV- или TSV-файл со списком фотографий и метаданными.

Важно

В качестве источника метаданных файл должен иметь следующий формат: путь к фотографии | метаданные.

Для подготовки TSV-файла можно использовать скрипт, аналогичный данному, либо сгенерировать его с помощью python или другой утилиты.

Примечание

Как скрипт, так и команда в примерах создают файл images.tsv с данными в формате полный путь к файлу с фотографией | метаданные. В качестве метаданных будет создана строка с именем файла.

Для запуска скрипта на создание TSV-файла со списком фотографий из домашней директории (/home/ubuntu в примере) выполните следующую команду:
```
sudo docker run -it --rm --network host --volume ${PWD}:/home/ubuntu/create_cards --volume /home/ubuntu/photos:/home/ubuntu/photos docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 sh -c "cd /home/ubuntu/create_cards && /opt/findface-security/bin/python3 tsv_builder.py /home/ubuntu/photos"
```
где /home/ubuntu/photos путь с вашим фотографиями.

TSV файл может быть сгенерирован с помощью следующей команды:
```
python3 tsv_builder.py /home/ubuntu/photos/
```
Вы можете использовать файл images.tsv в качестве примера.
Создайте файл задания (job-файл) из CSV- или TSV-файла, используя следующую команду. В результате в текущем каталоге будет создан файл enroll-job.db.
```
sudo docker run -it --rm --network host --volume ${PWD}:/home/ubuntu/create_cards docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 sh -c "cd /home/ubuntu/create_cards && /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py add /home/ubuntu/create_cards/images.tsv"
```
Опции команды add утилиты:
- --format: формат файла, по умолчанию tsv,
- --delimiter: используемый разделитель, по умолчанию ”\t” для TSV-файла, ”,” для формата CSV.
Примечание

Файл job представляет собой sqlite-базу, которая может быть открыта в консоли sqlite3.
Выполните задание job, указав путь к фотографиям вместо (например, /home/ubuntu/photos) и передав необходимые аргументы:
```
sudo docker run -it --rm --network host --volume ${PWD}:/home/ubuntu/create_cards --volume /home/ubuntu/photos:/home/ubuntu/photos docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 sh -c "cd /home/ubuntu/create_cards && /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py run --user admin --password password --watch-lists 1"
```
Опции команды run утилиты:
- --parallel: количество потоков загрузки фотографий, по умолчанию 10. Чем больше потоков, тем быстрее будет завершена загрузка, однако также потребуется и большее количество ресурсов.
- --api: API URL, компонента findface-security, по умолчанию http://127.0.0.1:80/. Обязательная опция.
- --user: имя пользователя. Обязательная опция.
- --password: пароль. Обязательная опция.
- --watch-lists: перечень разделенных запятой id списков наблюдения, в которые нужно добавить фотографии. Обязательная опция.
- --inactive: отметить новые карточки как неактивные.
- --failed: в случае неудачи при обработке job-файла исправьте ошибку и повторите попытку с данной опцией.
- --noface: по умолчанию изображения, классифицированные как не имеющие лиц, получают статус NOFACE и автоматически исключаются из загрузки. Чтобы попытаться повторно обнаружить лица на таких изображениях, перезапустите job-задание с данной опцией. Если повторное обнаружение снова даст отрицательный результат, изображение будет пропущено, а в журнале загрузки появится соответствующая запись.
- --all-faces: загрузить все лица, если на фотографии их несколько.
- --detect-timeout: тайм-аут запросов на обнаружение фотографий.
- --logging-delta: частота логирования статуса загрузки.
(Опционально) Выведите в формате JSON результаты обработки задания job. При необходимости можно вывести только изображения, которые не удалось загрузить, и изображения без обнаруженных лиц. Используйте следующую команду:
```
sudo docker run -it --rm --network host --volume ${PWD}:/home/ubuntu/create_cards --volume /home/ubuntu/NTL_impersonated:/home/ubuntu/NTL_impersonated docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 sh -c "cd /home/ubuntu/create_cards && /opt/findface-security/bin/python3 /tigre_prototype/ffsecurity/uploader.py  print --noface --failed"
```
Опции команды print утилиты:
- --failed: вывести только изображения, которые не удалось загрузить.
- --noface: вывести только изображения без обнаруженных лиц.

Настройка нейронных сетей FindFace Multi

Обзор моделей нейронных сетей

В этом разделе вы найдете сводную информацию по моделям нейронных сетей, созданным в нашей лаборатории и используемым в FindFace Multi.

Установленные модели расположены в каталоге /opt/findface-multi/models/.

Важно

При чистой установке биометрической моделью по умолчанию является mango_320.

Обнаружение лиц, транспортных средств, силуэтов

ls /opt/findface-multi/models/detector/

body.gustav_accurate.019.cpu.fnk  body.jasmine_fast_nomany.018.gpu.fnk  car.gustav_normal.004.gpu.fnk
body.gustav_accurate.019.gpu.fnk  car.gustav_accurate.006.cpu.fnk       face.jasmine_fast.003.cpu.fnk
body.jasmine_fast.018.cpu.fnk     car.gustav_accurate.006.gpu.fnk       face.jasmine_fast.003.gpu.fnk
body.jasmine_fast.018.gpu.fnk     car.gustav_normal.004.cpu.fnk         headbodyface.alpha000_normal.001.gpu.fnk

Нормализация изображений лиц и силуэтов

ls /opt/findface-multi/models/facenorm/

bee.v3.cpu.fnk    bee_fast.gpu.fnk              crop2x.v2_maxsize400.cpu.fnk  crop2x.v2_no_maxsize.gpu.fnk  facenorm.multicrop_full_center_size400.cpu.fnk  facenorm.multicrop_full_crop2x_size400.gpu.fnk
bee.v3.gpu.fnk    crop1x.v2_maxsize400.cpu.fnk  crop2x.v2_maxsize400.gpu.fnk  cropbbox.v2.cpu.fnk           facenorm.multicrop_full_center_size400.gpu.fnk
bee_fast.cpu.fnk  crop1x.v2_maxsize400.gpu.fnk  crop2x.v2_no_maxsize.cpu.fnk  cropbbox.v2.gpu.fnk           facenorm.multicrop_full_crop2x_size400.cpu.fnk

Распознавание лиц

ls /opt/findface-multi/models/face/

mango_320.cpu.fnk  mango_320.gpu.fnk  nectarine_m_160.cpu.fnk  nectarine_m_160.gpu.fnk  nectarine_xs_320.cpu.fnk  nectarine_xs_320.gpu.fnk

Распознавание атрибутов лиц

ls /opt/findface-multi/models/faceattr/

age.v2.cpu.fnk    beard.v0.gpu.fnk     gender.v2.cpu.fnk    glasses3.v0.gpu.fnk  liveness.goodwin.cpu.fnk  liveness.pacs.v2.gpu.fnk  medmask3.v2.cpu.fnk      quality_fast.v1.gpu.fnk
age.v2.gpu.fnk    emotions.v1.cpu.fnk  gender.v2.gpu.fnk    headpose.v3.cpu.fnk  liveness.goodwin.gpu.fnk  liveness.web.v0.cpu.fnk   medmask3.v2.gpu.fnk
beard.v0.cpu.fnk  emotions.v1.gpu.fnk  glasses3.v0.cpu.fnk  headpose.v3.gpu.fnk  liveness.pacs.v2.cpu.fnk  liveness.web.v0.gpu.fnk   quality_fast.v1.cpu.fnk

Нормализация изображений транспортных средств

ls /opt/findface-multi/models/carnorm/

briacon.v0.cpu.fnk  briacon.v0.gpu.fnk

Распознавание транспортных средств

ls /opt/findface-multi/models/carrec/

bottas.cpu.fnk  bottas.gpu.fnk

Распознавание атрибутов транспортных средств

ls /opt/findface-multi/models/carattr/

carattr.categories.v0.cpu.fnk     carattr.license_plate.v7.gpu.fnk          carattr.orientation.v0.cpu.fnk  carattr.quality.v0.gpu.fnk          carattr.weight_types7.v0.cpu.fnk  description.v0.gpu.fnk
carattr.categories.v0.gpu.fnk     carattr.license_plate_quality.v1.cpu.fnk  carattr.orientation.v0.gpu.fnk  carattr.special_types11.v1.cpu.fnk  carattr.weight_types7.v0.gpu.fnk
carattr.license_plate.v7.cpu.fnk  carattr.license_plate_quality.v1.gpu.fnk  carattr.quality.v0.cpu.fnk      carattr.special_types11.v1.gpu.fnk  description.v0.cpu.fnk

Распознавание силуэтов

ls /opt/findface-multi/models/pedrec/

pedrec.durga.cpu.fnk  pedrec.durga.gpu.fnk

Распознавание атрибутов силуэтов

ls /opt/findface-multi/models/pedattr/

pedattr.age_gender.v0.cpu.fnk  pedattr.bags.v0.cpu.fnk  pedattr.clothes_type.v0.cpu.fnk  pedattr.color.v1.cpu.fnk  pedattr.protective.v1.cpu.fnk  pedattr.quality.v0.cpu.fnk
pedattr.age_gender.v0.gpu.fnk  pedattr.bags.v0.gpu.fnk  pedattr.clothes_type.v0.gpu.fnk  pedattr.color.v1.gpu.fnk  pedattr.protective.v1.gpu.fnk  pedattr.quality.v0.gpu.fnk

Распознавание лиц и их атрибутов

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

Распознавание лиц и их атрибутов можно автоматически включить и настроить в ходе установки FindFace Multi. Если этот шаг был пропущен при установке, можно впоследствии выполнить настройку вручную. Распознавание лиц и атрибутов лиц работает как на GPU-, так и на CPU-ускорении.

Распознавание объекта лицо включено по умолчанию. Если во время установки FindFace Multi вы удалили распознавание объекта лицо, можно добавить его позже, следуя пошаговой инструкции ниже. Если распознавание лица уже установлено, и вам нужно только включить распознавание атрибутов лица, перейдите к шагам 1.5, 1.6 и 4.1, 4.2. Другие шаги следует пропустить.

Чтобы включить распознавание лиц, выполните следующее:

В файле конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml укажите модели нейронных сетей для распознавания объекта лицо и его атрибутов.

Важно

Удостоверьтесь, что для каждой модели вы указали правильный тип ускорения CPU или GPU: он должен совпадать с типом ускорения findface-extraction-api. Обратите внимание, что findface-extraction-api на CPU может работать только с CPU-моделями, в то время как findface-extraction-api на GPU поддерживает как GPU-, так и CPU-модели.

Откройте файл конфигурации findface-extraction-api.yaml.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

Укажите модель детектора лиц в разделе detectors -> models, вставив следующий код:

GPU

detectors:

  ...
  models:
    ...
    face_jasmine:
      aliases:
      - face
      - nnd
      - cheetah
      model: detector/face.jasmine_fast.003.gpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048

  ...

CPU

detectors:

  ...
  models:
    ...
    face_jasmine:
      aliases:
      - face
      - nnd
      - cheetah
      model: detector/face.jasmine_fast.003.cpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048

  ...

Убедитесь, что раздел objects -> face содержит quality_attribute: face_quality и, в зависимости от вашего типа ускорения, base_normalizer: facenorm/crop2x.v2_maxsize400.gpu.fnk или base_normalizer: facenorm/crop2x.v2_maxsize400.cpu.fnk:

GPU
```
objects:
  ...
  face:
    base_normalizer: facenorm/crop2x.v2_maxsize400.gpu.fnk
    quality_attribute: face_quality
  ...
```
CPU
```
objects:
  ...
  face:
    base_normalizer: facenorm/crop2x.v2_maxsize400.cpu.fnk
    quality_attribute: face_quality
  ...
```

В разделе normalizers укажите модели нормализаторов лица, вставив следующий код:

GPU

normalizers:
  ...
  models:
    crop1x:
      model: facenorm/crop1x.v2_maxsize400.gpu.fnk
    crop2x:
      model: facenorm/crop2x.v2_maxsize400.gpu.fnk
    cropbbox:
      model: facenorm/cropbbox.v2.gpu.fnk
    multicrop_full_center:
      model: ''
    multicrop_full_crop2x:
      model: facenorm/facenorm.multicrop_full_crop2x_size400.gpu.fnk
    norm200:
      model: facenorm/bee.v3.gpu.fnk
  ...

CPU

normalizers:
  ...
  models:
    crop1x:
      model: facenorm/crop1x.v2_maxsize400.cpu.fnk
    crop2x:
      model: facenorm/crop2x.v2_maxsize400.cpu.fnk
    cropbbox:
      model: facenorm/cropbbox.v2.cpu.fnk
    multicrop_full_center:
      model: ''
    multicrop_full_crop2x:
      model: facenorm/facenorm.multicrop_full_crop2x_size400.cpu.fnk
    norm200:
      model: facenorm/bee.v3.cpu.fnk
  ...

Примечание

Необходимо выполнить этот шаг для включения распознавания атрибутов лица.

Для включения распознавания атрибутов лица выполните следующие действия:

В файле конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml укажите модели для экстракции векторов признаков в разделе extractors, как показано в примере ниже. Удостоверьтесь, что для каждой модели вы указали правильный тип ускорения CPU или GPU: он должен совпадать с типом ускорения findface-extraction-api.

GPU

extractors:
  ...
  models:
    face_age: faceattr/age.v2.gpu.fnk
    face_beard: faceattr/beard.v0.gpu.fnk
    face_beard4: ''
    face_countries47: ''
    face_emben: face/mango_320.gpu.fnk
    face_emotions: faceattr/emotions.v1.gpu.fnk
    face_eyes_attrs: ''
    face_eyes_openness: ''
    face_gender: faceattr/gender.v2.gpu.fnk
    face_glasses3: faceattr/glasses3.v0.gpu.fnk
    face_glasses4: ''
    face_hair: ''
    face_headpose: faceattr/headpose.v3.gpu.fnk
    face_headwear: ''
    face_highlight: ''
    face_liveness: faceattr/liveness.web.v0.gpu.fnk
    face_luminance_overexposure: ''
    face_luminance_underexposure: ''
    face_luminance_uniformity: ''
    face_medmask3: faceattr/medmask3.v2.gpu.fnk
    face_medmask4: ''
    face_mouth_attrs: ''
    face_quality: faceattr/quality_fast.v1.gpu.fnk
    face_scar: ''
    face_sharpness: ''
    face_tattoo: ''
    face_validity: ''

CPU

extractors:
  ...
  models:
    face_age: faceattr/age.v2.cpu.fnk
    face_beard: faceattr/beard.v0.cpu.fnk
    face_beard4: ''
    face_countries47: ''
    face_emben: face/mango_320.cpu.fnk
    face_emotions: faceattr/emotions.v1.cpu.fnk
    face_eyes_attrs: ''
    face_eyes_openness: ''
    face_gender: faceattr/gender.v2.cpu.fnk
    face_glasses3: faceattr/glasses3.v0.cpu.fnk
    face_glasses4: ''
    face_hair: ''
    face_headpose: faceattr/headpose.v3.cpu.fnk
    face_headwear: ''
    face_highlight: ''
    face_liveness: faceattr/liveness.web.v0.cpu.fnk
    face_luminance_overexposure: ''
    face_luminance_underexposure: ''
    face_luminance_uniformity: ''
    face_medmask3: faceattr/medmask3.v2.cpu.fnk
    face_medmask4: ''
    face_mouth_attrs: ''
    face_quality: faceattr/quality_fast.v1.cpu.fnk
    face_scar: ''
    face_sharpness: ''
    face_tattoo: ''
    face_validity: ''

Доступны следующие модели экстракторов:

Экстрактор	Ускорение	Настройка
возраст	CPU	`face_age: faceattr/age.v2.cpu.fnk`
возраст	GPU	`face_age: faceattr/age.v2.gpu.fnk`
борода	CPU	`face_beard: faceattr/beard.v0.cpu.fnk`
борода	GPU	`face_beard: faceattr/beard.v0.gpu.fnk`
вектор признаков объекта лицо	CPU	`face_emben: face/mango_320.cpu.fnk`
вектор признаков объекта лицо	GPU	`face_emben: face/mango_320.gpu.fnk`
пол	CPU	`face_gender: faceattr/gender.v2.cpu.fnk`
пол	GPU	`face_gender: faceattr/gender.v2.gpu.fnk`
эмоции	CPU	`face_emotions: faceattr/emotions.v1.cpu.fnk`
эмоции	GPU	`face_emotions: faceattr/emotions.v1.gpu.fnk`
очки	CPU	`face_glasses3: faceattr/glasses3.v0.cpu.fnk`
очки	GPU	`face_glasses3: faceattr/glasses3.v0.gpu.fnk`
положение головы	CPU	`face_headpose: faceattr/headpose.v3.cpu.fnk`
положение головы	GPU	`face_headpose: faceattr/headpose.v3.gpu.fnk`
витальность лица	CPU	`face_liveness: faceattr/liveness.web.v0.cpu.fnk`
витальность лица	GPU	`face_liveness: faceattr/liveness.web.v0.gpu.fnk`
медицинская маска	CPU	`face_medmask3: faceattr/medmask3.v2.cpu.fnk`
медицинская маска	GPU	`face_medmask3: faceattr/medmask3.v2.gpu.fnk`
качество изображения лица	CPU	`face_quality: faceattr/quality_fast.v1.cpu.fnk`
качество изображения лица	GPU	`face_quality: faceattr/quality_fast.v1.gpu.fnk`

Совет

Для того чтобы отключить модель распознавания, передайте в соответствующий параметр пустое значение ''. Не удаляйте сам параметр, поскольку в этом случае будет выполняться поиск модели по умолчанию.

extractors:
  face_age: ''
  face_beard: ''
  face_beard4: ''
  face_countries47: ''
  face_emben: ''
  face_emotions: ''
  face_eyes_attrs: ''
  face_eyes_openness: ''
  face_gender: ''
  face_glasses3: ''
  face_glasses4: ''
  face_hair: ''
  face_headpose: ''
  face_headwear: ''
  face_highlight: ''
  face_liveness: ''
  face_luminance_overexposure: ''
  face_luminance_underexposure: ''
  face_luminance_uniformity: ''
  face_medmask3: ''
  face_medmask4: ''
  face_mouth_attrs: ''
  face_quality: ''
  face_scar: ''
  face_sharpness: ''
  face_tattoo: ''
  face_validity: ''

Важно

Модель экстрактора для определения витальности лица liveness.web.v0 включена по умолчанию. Не выключайте ее, если используется аутентификация по лицу пользователя.

Перезапустите контейнер findface-multi-findface-extraction-api-1.
```
sudo docker container restart findface-multi-findface-extraction-api-1
```

Чтобы включить распознавание лиц, внесите изменения в конфигурационный файл /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.

В разделе models укажите модели нейронных сетей для объекта face по аналогии с примером:

GPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  ...
  detectors:
    ...
    face:
      fnk_path: /usr/share/findface-data/models/detector/face.jasmine_fast.003.gpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    face_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/crop2x.v2_maxsize400.gpu.fnk
    face_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/crop1x.v2_maxsize400.gpu.fnk
    ...
  extractors:
    ...
    face_quality:
      fnk_path: /usr/share/findface-data/models/faceattr/quality_fast.v1.gpu.fnk
      normalizer: face_norm_quality

CPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  ...
  detectors:
    ...
    face:
      fnk_path: /usr/share/findface-data/models/detector/face.jasmine_fast.003.cpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    face_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/crop2x.v2_maxsize400.cpu.fnk
    face_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/crop1x.v2_maxsize400.cpu.fnk
    ...
  extractors:
    ...
    face_quality:
      fnk_path: /usr/share/findface-data/models/faceattr/quality_fast.v1.cpu.fnk
      normalizer: face_norm_quality

Убедитесь, что добавлен раздел objects -> face:

objects:
  ...
  face:
    normalizer: face_norm
    quality: face_quality
    track_features: ''

Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Для включения распознавания лиц, откройте файл конфигурации /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml и убедитесь, что он содержит раздел face в detectors, аналогичный приведенному ниже.

sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

detectors:
  ...
  face:
    filter_min_quality: 0.5
    filter_min_size: 60
    filter_max_size: 8192
    roi: ''
    fullframe_crop_rot: false
    fullframe_use_png: false
    jpeg_quality: 95
    overall_only: true
    realtime_post_first_immediately: false
    realtime_post_interval: 1
    realtime_post_every_interval: false
    track_interpolate_bboxes: true
    track_miss_interval: 1
    track_overlap_threshold: 0.25
    track_max_duration_frames: 0
    track_send_history: false
    post_best_track_frame: true
    post_best_track_normalize: true
    post_first_track_frame: false
    post_last_track_frame: false
    tracker_type: simple_iou
    track_deep_sort_matching_threshold: 0.65
    track_deep_sort_filter_unconfirmed_tracks: true
    track_object_is_principal: false
    track_history_active_track_miss_interval: 0

Примечание

Необходимо выполнить этот шаг для включения распознавания атрибутов лица.

Включите распознавание атрибутов лица в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
1. В разделе FFSECURITY укажите атрибуты лица, которые требуется отображать в событиях распознавания.
```
# available features: age, beard, emotions, gender, glasses, headpose, medmask
'FACE_EVENTS_FEATURES': ['glasses', 'beard', 'age', 'gender', 'headpose', 'medmask', 'emotions'],
```
2. Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Распознавание положения головы

Функциональность распознавания положения головы — это возможность камеры обнаруживать и отслеживать положение и движение головы человека относительно камеры видеонаблюдения в реальном времени.

Предупреждение

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

Для распознавания положения головы (поворот и наклон) FindFace Multi использует параметры pitch и yaw.

Pitch — угол наклона головы вверх/вниз (т.е.относительно горизонтальной оси). Положительное значение pitch показывает, что голова наклонена вперед, а отрицательное указывает на наклон головы назад.
Yaw — угол поворота головы вправо/влево (т.е. относительно вертикальной оси). Положительное значение yaw указывает на то, что голова повернута направо, а отрицательное — налево.

Углы pitch и yaw измеряются относительно камеры и принимают значения от -90 до +90 градусов.

Вы можете увидеть значения углов поворота и наклона головы в разделе «Атрибуты» для событий и фильтровать события лиц по этим параметрам.

Возможные сценарии использования распознавания положения головы

Функциональность распознавания положения головы можно использовать в сценариях для улучшения точности и повышения безопасности, например:

Система контроля управления доступом (СКУД): улучшение системы контроля доступа сотрудников с помощью фиксации того, что лицо сотрудника совпадает с ожидаемым положением. Это значит, что если человек стоит рядом с камерой, поворачивает голову к камере, но не собирается проходить через СКУД, доступ не будет предоставлен благодаря установленному заранее значению положения головы.
Аналитика посетителей ТЦ: уменьшение количества созданных некачественных кластеров по лицам. При кластеризации событий по лицам учитываются события соответствующие заданным значениям углов поворота головы. Подробнее см. Кластеры.

Как настроить функциональность распознавания положения головы

Чтобы настроить пороговое значение для формирования кластеров лиц, выполните следующее:

Откройте конфигурационный файл /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```
Включите пороговое значение положения головы, установив 'FACE_CLUSTER_EVENT_HEADPOSE_THRESHOLDS_ENABLE': True,.

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

'FACE_CLUSTER_EVENT_YAW_ANGLE_LOWEST_THRESHOLD': -30,
'FACE_CLUSTER_EVENT_YAW_ANGLE_HIGHEST_THRESHOLD': 30,
'FACE_CLUSTER_EVENT_PITCH_ANGLE_LOWEST_THRESHOLD': -60,
'FACE_CLUSTER_EVENT_PITCH_ANGLE_HIGHEST_THRESHOLD': 60,

Перезапустите контейнер findface-multi-findface-multi-legacy-1 .
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Распознавание транспортных средств и их атрибутов

FindFace Multi может распознавать отдельные транспортные средства и их атрибуты.

Атрибуты ТС следующие:

номерной знак (для отдельных стран),

Примечание

Поддерживается распознавание номерных знаков для следующих стран:

Европа: Россия, Литва, Латвия, Эстония, Финляндия, Чехия, Сербия, Белоруссия, Украина, Молдавия, Грузия, Азербайджан, Армения.

Азия: ОАЭ, Казахстан, Кыргызстан, Таджикистан, Туркменистан, Узбекистан, Саудовская Аравия, Вьетнам, Индия, Пакистан, Таиланд.

Северная Америка: Мексика.

Южная Америка: Аргентина, Бразилия.
цвет,
марка,
модель,
тип кузова,
категория ТС,
ракурс (вид спереди, сзади или сбоку),
принадлежность к спецтранспорту (такси, маршрутный транспорт, каршеринг, скорая помощь, полиция, спасательные службы, газоспасательные и аварийно-спасательные службы, военная техника, техника дорожных служб, остальной спецтранспорт),
тип ТС по весу и размеру кузова.

Примечание

Распознавание спецтранспорта, так же как и распознавание ТС по весу и размеру кузова, работает только для некоторых стран. За дополнительной информацией обращайтесь к вашему менеджеру или в службу поддержки (support@ntechlab.com).

Распознавание транспортных средств вместе с выбором атрибутов распознавания можно настроить на уровне установки продукта. В этом разделе описывается как включить распознавание ТС и их атрибутов, если этот шаг был пропущен при установке.

Для включения распознавания транспортных средств и их атрибутов выполните следующие действия:

В файле конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml укажите модели нейронных сетей для распознавания транспортных средств и распознавания атрибутов транспортных средств.

Важно

Удостоверьтесь, что для каждой модели вы указали правильный тип ускорения: CPU или GPU. Он должен совпадать с типом ускорения findface-extraction-api. Обратите внимание, что findface-extraction-api на CPU может работать только с CPU-моделями, в то время как findface-extraction-api на GPU поддерживает как GPU-, так и CPU-модели.

Откройте файл конфигурации findface-extraction-api.yaml.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

Укажите модель детектора ТС в разделе detectors -> models, вставив следующий код:

GPU

detectors:

  ...
  models:
    ...
    gustav:
      aliases:
      - car
      - efreitor
      model: detector/car.gustav_accurate.006.gpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048
  ...

CPU

detectors:

  ...
  models:
    ...
    gustav:
      aliases:
      - car
      - efreitor
      model: detector/car.gustav_accurate.006.cpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048
  ...

Убедитесь, что раздел objects -> car содержит quality_attribute: car_quality и, в зависимости от вашего типа ускорения, base_normalizer: facenorm/cropbbox.v2.gpu.fnk или base_normalizer: facenorm/cropbbox.v2.cpu.fnk:

GPU
```
objects:
  ...
  car:
    base_normalizer: facenorm/cropbbox.v2.gpu.fnk
    quality_attribute: car_quality
  ...
```
CPU
```
objects:
  ...
  car:
    base_normalizer: facenorm/cropbbox.v2.cpu.fnk
    quality_attribute: car_quality
  ...
```

Укажите нормализаторы, необходимые для работы экстракторов. Например, если вам требуется настроить распознавание автомобильных номеров, укажите нормализатор carlicplate. Для остальных экстракторов укажите нормализатор cropbbox.

Нормализатор	Модель нормализатора	Используется для экстракторов
carlicplate	`carnorm/briacon.v0.gpu.fnk` `carnorm/briacon.v0.cpu.fnk`	`car_license_plate`
cropbbox	`facenorm/cropbbox.v2.gpu.fnk` `facenorm/cropbbox.v2.cpu.fnk`	`car_license_plate_quality`, `car_description`, `car_quality`, `car_special_types11`, `car_categories`, `car_orientation`, `car_weight_types7`

GPU

normalizers:
  ...

  models:
    ...
    carlicplate:
      model: carnorm/briacon.v0.gpu.fnk
    ...
    cropbbox:
      model: facenorm/cropbbox.v2.gpu.fnk
    ...

CPU

normalizers:
  ...

  models:
    ...
    carlicplate:
      model: carnorm/briacon.v0.cpu.fnk
    ...
    cropbbox:
      model: facenorm/cropbbox.v2.cpu.fnk
    ...

Укажите модели необходимых экстракторов в разделе extractors -> models:

GPU

extractors:
   ...
   models:
    car_categories: carattr/carattr.categories.v0.gpu.fnk
    car_color: ''
    car_container_number: ''
    car_description: carattr/description.v0.gpu.fnk
    car_emben: carrec/bottas.gpu.fnk
    car_license_plate: carattr/carattr.license_plate.v7.gpu.fnk
    car_license_plate_quality: carattr/carattr.license_plate_quality.v1.gpu.fnk
    car_license_plate_visibility: ''
    car_make: ''
    car_orientation: carattr/carattr.orientation.v0.gpu.fnk
    car_quality: carattr/carattr.quality.v0.gpu.fnk
    car_special_types: ''
    car_special_types11: carattr/carattr.special_types11.v1.gpu.fnk
    car_trash: ''
    car_weight_types7: carattr/carattr.weight_types7.v0.gpu.fnk

CPU

extractors:
   ...
   models:
    car_categories: carattr/carattr.categories.v0.cpu.fnk
    car_color: ''
    car_container_number: ''
    car_description: carattr/description.v0.cpu.fnk
    car_emben: carrec/bottas.cpu.fnk
    car_license_plate: carattr/carattr.license_plate.v7.cpu.fnk
    car_license_plate_quality: carattr/carattr.license_plate_quality.v1.cpu.fnk
    car_license_plate_visibility: ''
    car_make: ''
    car_orientation: carattr/carattr.orientation.v0.cpu.fnk
    car_quality: carattr/carattr.quality.v0.cpu.fnk
    car_special_types: ''
    car_special_types11: carattr/carattr.special_types11.v1.cpu.fnk
    car_trash: ''
    car_weight_types7: carattr/carattr.weight_types7.v0.cpu.fnk

Доступны следующие экстракторы:

Экстрактор	Настройка
вектор признаков отдельного ТС	`car_emben: carrec/bottas.cpu.fnk`
вектор признаков отдельного ТС	`car_emben: carrec/bottas.gpu.fnk`
номерной знак	`car_license_plate: carattr/carattr.license_plate.v7.cpu.fnk` `car_license_plate_quality: carattr/carattr.license_plate_quality.v1.cpu.fnk`
номерной знак	`car_license_plate: carattr/carattr.license_plate.v7.gpu.fnk` `car_license_plate_quality: carattr/carattr.license_plate_quality.v1.gpu.fnk`
набор атрибутов: марка / цвет / модель / тип кузова	`car_description: carattr/description.v0.cpu.fnk`
набор атрибутов: марка / цвет / модель / тип кузова	`car_description: carattr/description.v0.gpu.fnk`
качество изображения ТС	`car_quality: carattr/carattr.quality.v0.cpu.fnk`
качество изображения ТС	`car_quality: carattr/carattr.quality.v0.gpu.fnk`
спецтранспорт	`car_special_types: carattr/carattr.special_types11.v1.cpu.fnk`
спецтранспорт	`car_special_types: carattr/carattr.special_types11.v1.gpu.fnk`
категория ТС	`car_categories: carattr/carattr.categories.v0.cpu.fnk`
категория ТС	`car_categories: carattr/carattr.categories.v0.gpu.fnk`
тип ТС по весу и размеру кузова	`car_weight_types7: carattr/carattr.weight_types7.v0.cpu.fnk`
тип ТС по весу и размеру кузова	`car_weight_types7: carattr/carattr.weight_types7.v0.gpu.fnk`
ракурс ТС	`car_orientation: carattr/carattr.orientation.v0.cpu.fnk`
ракурс ТС	`car_orientation: carattr/carattr.orientation.v0.gpu.fnk`

Совет

Для того чтобы отключить модель, передайте в соответствующий параметр пустое значение. Не удаляйте сам параметр, поскольку в этом случае будет выполняться поиск модели по умолчанию.

extractors:
   ...
   models:
    car_categories: ''
    car_color: ''
    car_container_number: ''
    car_description: ''
    car_emben: ''
    car_license_plate: ''
    car_license_plate_quality: ''
    car_license_plate_visibility: ''
    car_make: ''
    car_orientation: ''
    car_quality: ''
    car_special_types: ''
    car_special_types11: ''
    car_trash: ''
    car_weight_types7: ''

Перезапустите контейнер findface-multi-findface-extraction-api-1.
```
sudo docker container restart findface-multi-findface-extraction-api-1
```

Внесите изменения в конфигурационный файл /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.

В разделе models укажите модели детектора, нормализатора и экстрактора для объекта car, как показано в примере ниже:

GPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  ...
  detectors:
    ...
    car:
      fnk_path: /usr/share/findface-data/models/detector/car.gustav_normal.004.gpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    car_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.gpu.fnk
    car_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.gpu.fnk
    ...
  extractors:
    ...
    car_quality:
      fnk_path: /usr/share/findface-data/models/carattr/carattr.quality.v0.gpu.fnk
      normalizer: car_norm_quality

CPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml


models:
  ...
  detectors:
    ...
    car:
      fnk_path: /usr/share/findface-data/models/detector/car.gustav_normal.004.cpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    car_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    car_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    ...
  extractors:
    ...
    car_quality:
      fnk_path: /usr/share/findface-data/models/carattr/carattr.quality.v0.cpu.fnk
      normalizer: car_norm_quality

Убедитесь, что добавлен раздел objects -> car:

objects:
  ...
  car:
    normalizer: car_norm
    quality: car_quality
    track_features: ''

Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Откройте файл конфигурации /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml и убедитесь, что он содержит раздел car в detectors, аналогичный приведенному ниже. Обратите внимание, что для параметра filter_min_quality по умолчанию установлено значение 0.65. Для получения более точных результатов с камер и других источников видео его можно увеличить. Рекомендованный порог равен 0.73.
```
sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

detectors:
  ...
  car:
    filter_min_quality: 0.65
    filter_min_size: 100
    filter_max_size: 8192
    roi: ''
    fullframe_crop_rot: false
    fullframe_use_png: false
    jpeg_quality: 95
    overall_only: true
    realtime_post_first_immediately: false
    realtime_post_interval: 1
    realtime_post_every_interval: false
    track_interpolate_bboxes: true
    track_miss_interval: 1
    track_overlap_threshold: 0.25
    track_max_duration_frames: 0
    track_send_history: false
    post_best_track_frame: true
    post_best_track_normalize: true
    post_first_track_frame: false
    post_last_track_frame: false
    tracker_type: simple_iou
    track_deep_sort_matching_threshold: 0.65
    track_deep_sort_filter_unconfirmed_tracks: true
    track_object_is_principal: false
    track_history_active_track_miss_interval: 0
```
Примечание

Настройка параметра filter_min_quality влияет только на результаты, получаемые от видеоисточников, и не влияет на результаты подсчета транспортных средств и качество изображений транспортных средств, используемых в карточках. Чтобы получить более точные результаты подсчета или карточки ТС с изображениями лучшего качества, отдельно настройте параметр MINIMUM_CAR_QUALITY в файле конфигурации findface-multi-legacy.py. Эта настройка будет описана ниже.
Включите распознавание транспортных средств и атрибутов распознавания в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Выполните следующие действия:
1. В разделе FFSECURITY установите 'ENABLE_CARS': True.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...
    # optional objects to detect
    'ENABLE_CARS': True,
    ...
```
2. В этом же разделе можно настроить параметр MINIMUM_CAR_QUALITY. По умолчанию для него установлено значение 0.65, что является рекомендуемым минимальным порогом качества изображения автомобиля, достаточным для создания карточки или для подсчета.
```
FFSECURITY = {
    ...
    # minimum car quality sufficient to add it to a card and use object in counter
    # p.s. set this parameter equals to `0.73` for more accurate results
    'MINIMUM_CAR_QUALITY': 0.65,  # model: [carattr.quality.v0]
    ...
```
  Если нужны более точные результаты подсчета или карточки автомобилей с изображениями лучшего качества, порог MINIMUM_CAR_QUALITY можно увеличить. Рекомендовано значение, равное 0.73.
3. В разделе FFSECURITY укажите атрибуты ТС, которые требуется отображать в событиях распознавания.
```
# available features are: category, description, license_plate, orientation, special_vehicle_type, weight_type
'CAR_EVENTS_FEATURES': ['license_plate', 'category', 'special_vehicle_type', 'description', 'weight_type', 'orientation'],
```
4. Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
В веб-интерфейсе перейдите на вкладку Источники видео. Выберите камеру на вкладке Камеры (либо загруженный файл на вкладке Загрузки, либо внешний детектор на соответствующей вкладке). Перейдите на вкладку Основные. Поставьте флажок ТС в разделе Детекторы.

Интерпретация результатов распознавания ТС

Результаты распознавания транспортных средств можно увидеть в веб-интерфейсе на вкладке Эпизоды и события.

В некоторых случаях в результатах распознавания транспортных средств отсутствуют атрибуты описания и их значения, либо отображается, что значение атрибута неизвестно.

Значение атрибута неизвестно. Если вы видите в результатах распознавания, что значение атрибута неизвестно, это означает, что достоверность распознавания атрибута ниже порога, указанного для атрибута в конфигурационном файле /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. В этом случае система не будет отображать распознанное значение. Оно будет утеряно.

Порог для атрибута транспортного средства можно настроить в файле конфигурации findface-multi-legacy.py.

Важно

Вышесказанное не относится к распознаванию регистрационных знаков (ГРЗ) транспортных средств. По умолчанию порог распознавания регистрационных знаков установлен на минимальное значение. Если вы видите в результатах распознавания, что регистрационный знак неизвестен, значит, на объекте он плохо различим или его совсем не видно. Распознавание страны, региона и цвета ГРЗ зависит от результатов распознавания регистрационного знака. Если ГРЗ не распознан, то и значения этих атрибутов будут отображаться как неизвестные.

Примечание

Регион и цвет регистрационного знака определяются только для Объединенных Арабских Эмиратов (ОАЭ). Для других стран значения этих атрибутов будут выводиться как неизвестные в результатах распознавания.
Отсутствие атрибутов описания и их значений. Если в результатах распознавания нет атрибутов описания (т.е. марки автомобиля, типа кузова, модели, цвета) и их значений, это происходит по следующим причинам:
- Распознавание категорий транспортных средств, а также распознавание ТС по весу и размеру кузова все еще находится в стадии разработки. FindFace Multi уверенно распознает автомобили категории B и их атрибуты. Что касается распознавания ТС по весу и размеру кузова, поддерживается распознавание легковых и грузовых автомобилей до 3.5 тонн и их атрибутов. Однако система может давать ложноположительные результаты по другим категориям и весовым классам транспортных средств и их атрибутам описания. Поэтому атрибуты описания и значения их распознавания отображаются только для легковых автомобилей, а если говорить о весовых категориях — только для легковых и грузовых автомобилей до 3.5 тонн. Для других категорий и весовых классов ТС атрибуты описания и результаты их распознавания скрыты. Достоверность распознавания атрибутов описания в данном случае не имеет значения: она может быть ниже или выше порога.
- То же самое происходит, если категория автомобиля неизвестна: атрибуты описания вместе со значениями распознавания не отображаются. Достоверность распознавания атрибутов описания в данном случае не является определяющим фактором.
При необходимости эту настройку можно изменить в разделе CAR_EVENTS_FEATURES_TO_NULL файла конфигурации findface-multi-legacy.py.

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

В этом разделе:

Настройка порога для атрибутов ТС
Настройка отображения атрибутов описания в результатах распознавания

Настройка порога для атрибутов ТС 

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

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. В разделе FFSECURITY измените пороговые значения для выбранных атрибутов:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...

    'CAR_DESCRIPTION_THRESHOLD': {
        'make': 0.5,
        'model': 0.5,
        'body': 0.5,
        'color': 0.5,
    },  # model: [description.v0]
    'SPECIAL_VEHICLE_TYPE_THRESHOLD': 0.5,  # model: [special_types11.v1]
    'CAR_CATEGORY_THRESHOLD': 0.6,  # model: [categories.v0]
    'CAR_WEIGHT_TYPE_THRESHOLD': 0.5,  # model: [weight-types7.v0]
    'CAR_ORIENTATION_THRESHOLD': 0.8,  # model  [orientation.v0]
    ...

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Настройка отображения атрибутов описания в результатах распознавания 

При необходимости можно включить отображение атрибутов описания для неподдерживаемых категорий транспортных средств или неизвестных транспортных средств. По умолчанию вывод атрибутов описания включен только для автомобилей категории B и для ТС весовых категорий B_light (легковой автомобиль массой до 3.5 тонн) и B_heavy (грузовой автомобиль массой до 3.5 тонн). Используйте информацию из таблиц, чтобы сопоставить транспортное средство и его категорию или класс в зависимости от веса.

Категории транспортных средств

Категория

Транспортное средство

A

мотоцикл (включая мопед), скутер, квадроцикл

B

легковой автомобиль

BE

легковой автомобиль с прицепом

C

грузовик

CE

грузовик с прицепом

D

автобус

DE

сочлененный автобус

other

ТС, которое не относится ни к одной из вышеперечисленных категорий

Весовые категории транспортных средств

Весовая категория

Транспортное средство

B_light

легковой автомобиль (до 3.5 т)

B_heavy

грузовик (до 3.5 т)

BE

легковой автомобиль с прицепом

C_light

грузовик (до 12 т)

C_heavy

тяжелый грузовик (свыше 12 т)

D_light

одиночный автобус

D_long

сочлененный автобус

other

ТС, которое не относится ни к одной из вышеперечисленных категорий

Предупреждение

Не рекомендуется менять значения, установленные по умолчанию. Прежде чем вносить какие-либо изменения, свяжитесь с нашими техническими специалистами (support@ntechlab.com).

Чтобы включить отображение атрибутов описания для неподдерживаемых категорий транспортных средств или для неизвестных ТС, откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. В разделе FFSECURITY найдите настройку CAR_EVENTS_FEATURES_TO_NULL:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...

    'CAR_EVENTS_FEATURES_TO_NULL': {
        'category': {
            # features, that will be nulled for all categories
            'default': ['make', 'body', 'model', 'color'],
            'unknown': ['make', 'body', 'model', 'color'],
            # categories with other behavior
            'B': [],
        },
        'weight_type': {
            # features, that will be nulled for all weight types
            'default': ['make', 'body', 'model', 'color'],
            # weight types with other behavior
            'B_light': [],
            'B_heavy': [],
        },
    },
    ...

Чтобы включить отображение атрибутов описания, удалите их из выбранного параметра. Например, если вы хотите включить распознавание атрибутов описания для всех категорий транспортных средств, кроме неизвестных транспортных средств, удалите их из параметра default. Обратите внимание, что неизвестные транспортные средства исключены из параметра default и настраиваются через параметр unknown.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...

    'CAR_EVENTS_FEATURES_TO_NULL': {
        'category': {
            # features, that will be nulled for all categories
            'default': [],
            'unknown': ['make', 'body', 'model', 'color'],
            # categories with other behavior
            'B': [],
        },
        'weight_type': {
            # features, that will be nulled for all weight types
            'default': [],
            # weight types with other behavior
            'B_light': [],
            'B_heavy': [],
        },
    },
    ...

Чтобы настроить вывод атрибутов описания для определенной категории транспортного средства или для транспортного средства определенной весовой категории, добавьте название категории или весовой категории в исключения в разделах categories with other behavior или weight types with other behavior. Используйте информацию из таблиц Категории транспортных средств и Весовые категории транспортных средств, чтобы сопоставить ТС и его категорию или класс по весу. Например, если вы хотите добавить в исключение автобусы (категория D) и одиночные автобусы (весовая категория D_light), сделайте следующее:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...

    'CAR_EVENTS_FEATURES_TO_NULL': {
        'category': {
            # features, that will be nulled for all categories
            'default': ['make', 'body', 'model', 'color'],
            'unknown': ['make', 'body', 'model', 'color'],
            # categories with other behavior
            'B': [],
            'D': [],
        },
        'weight_type': {
            # features, that will be nulled for all weight types
            'default': ['make', 'body', 'model', 'color'],
            # weight types with other behavior
            'B_light': [],
            'B_heavy': [],
            'D_light': [],
        },
    },
    ...

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Распознавание спецтранспорта

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

Примечание

Распознавание спецтранспорта работает только для некоторых стран. За дополнительной информацией обращайтесь к вашему менеджеру или в службу поддержки (support@ntechlab.com).

Поддерживается распознавание следующих типов транспортных средств:

Такси: такси, в том числе грузовое. В некоторых случаях грузовое такси может определяться как «остальной спецтранспорт».
Общественный маршрутный транспорт: автобусы, маршрутки, троллейбусы.
Каршеринг: поддерживаются следующие сервисы каршеринга: Ситидрайв, Яндекс.Драйв, Делимобиль, BelkaCar. Также могут распознаваться автомобили других операторов в случае сильной схожести с перечисленными выше.
Скорая помощь и автомобили реанимации (белые и желтые автомобили).
Полиция, в том числе автомобили ДПС.
Спасательные службы: автомобили МЧС, в том числе пожарные машины.
Газоспасательные и аварийно-спасательные службы: жёлтые и белые автомобили, в том числе с контрастными красными дверьми, характерными красными полосками и обозначением 04 / 104 на борту.
Военная техника, в том числе автомобили Росгвардии.
Техника дорожных служб: коммунальная (дорожная, поливомоечная и уборочная техника), строительная техника, автомобили ЦОДД.
Остальной спецтранспорт: спецтехника, которая не относится к вышеперечисленным типам.
Не спецтранспорт.

Распознавание силуэтов и их атрибутов

FindFace Multi позволяет распознавать отдельные человеческие силуэты и атрибуты силуэтов.

Атрибуты силуэтов следующие:

пол:
- мужской;
- женский;
возраст (по группам):
- 0-16 лет;
- 17-35 лет;
- 36-50 лет;
- 50+ лет;
тип одежды:
- обобщенная категория одежды верхней части тела: с длинными рукавами, с короткими рукавами, без рукавов;
- детализированный тип одежды верхней части тела: куртка, пальто, жилет без рукавов, толстовка, футболка, рубашка, платье;
- тип одежды нижней части тела: брюки, юбка, шорты, неопределенный;
- тип головного убора: шапка/шляпа/кепка, капюшон/платок, без головного убора;
цвет одежды (верх/низ);
наличие средств индивидуальной защиты (СИЗ):
- наименование СИЗ: жилет, каска;
- цвет СИЗ;
- точность распознавания СИЗ;
наличие сумки:
- на спине;
- в руке(-ах).

Распознавание силуэтов и атрибутов силуэтов можно настроить на уровне установки продукта. В этом разделе описывается как включить распознавание силуэтов и атрибутов силуэтов, если этот шаг был пропущен при установке.

Для включения распознавания силуэтов и их атрибутов выполните следующие действия:

В файле конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml укажите модели нейронных сетей для распознавания объектов типа силуэт и их атрибутов.

Важно

Удостоверьтесь, что для каждой модели вы указали правильный тип ускорения CPU или GPU: он должен совпадать с типом ускорения findface-extraction-api. Обратите внимание, что findface-extraction-api на CPU может работать только с CPU-моделями, в то время как findface-extraction-api на GPU поддерживает как GPU-, так и CPU-модели.

Откройте файл конфигурации findface-extraction-api.yaml.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

Укажите модель детектора силуэтов в разделе detectors -> models, вставив следующий код:

GPU

detectors:

  ...
  models:
    ...
    body_gustav:
      aliases:
      - body
      - edie
      - shiloette
      - glen
      model: detector/body.gustav_accurate.019.gpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048
  ...

CPU

detectors:

  ...
  models:
    ...
    body_gustav:
      aliases:
      - body
      - edie
      - shiloette
      - glen
      model: detector/body.gustav_accurate.019.cpu.fnk
      options:
        min_object_size: 32
        resolutions:
        - 256x256
        - 384x384
        - 512x512
        - 768x768
        - 1024x1024
        - 1536x1536
        - 2048x2048
  ...

Убедитесь, что раздел objects -> body содержит quality_attribute: body_quality и, в зависимости от вашего типа ускорения, base_normalizer: facenorm/cropbbox.v2.gpu.fnk или base_normalizer: facenorm/cropbbox.v2.cpu.fnk:

GPU
```
objects:
  ...
  body:
    base_normalizer: facenorm/cropbbox.v2.gpu.fnk
    quality_attribute: body_quality
  ...
```
CPU
```
objects:
  ...
  body:
    base_normalizer: facenorm/cropbbox.v2.cpu.fnk
    quality_attribute: body_quality
  ...
```
Убедитесь, что раздел normalizers содержит модель нормализатора cropbbox, как показано в примере ниже. Данный нормализатор требуется для работы экстракторов.

GPU
```
normalizers:
  ...

  models:
    ...
    cropbbox:
      model: facenorm/cropbbox.v2.gpu.fnk
    ...
```
CPU
```
normalizers:
  ...

  models:
    ...
    cropbbox:
      model: facenorm/cropbbox.v2.cpu.fnk
    ...
```

Укажите модели для экстракции векторов признаков в разделе extractors -> models, в зависимости от необходимых экстракторов:

GPU

extractors:
   ...
   models:
    body_action_base6: ''
    body_action_car: ''
    body_action_fights: ''
    body_age_gender: pedattr/pedattr.age_gender.v0.gpu.fnk
    body_bags: pedattr/pedattr.bags.v0.gpu.fnk
    body_clothes: pedattr/pedattr.clothes_type.v0.gpu.fnk
    body_clothes34671: ''
    body_color: pedattr/pedattr.color.v1.gpu.fnk
    body_emben: pedrec/pedrec.durga.gpu.fnk
    body_fall: ''
    body_handface: ''
    body_protective_equipment: pedattr/pedattr.protective.v1.gpu.fnk
    body_quality: pedattr/pedattr.quality.v0.gpu.fnk

CPU

extractors:
   ...
   models:
    body_action_base6: ''
    body_action_car: ''
    body_action_fights: ''
    body_age_gender: pedattr/pedattr.age_gender.v0.cpu.fnk
    body_bags: pedattr/pedattr.bags.v0.cpu.fnk
    body_clothes: pedattr/pedattr.clothes_type.v0.cpu.fnk
    body_clothes34671: ''
    body_color: pedattr/pedattr.color.v1.cpu.fnk
    body_emben: pedrec/pedrec.durga.cpu.fnk
    body_fall: ''
    body_handface: ''
    body_protective_equipment: pedattr/pedattr.protective.v1.cpu.fnk
    body_quality: pedattr/pedattr.quality.v0.cpu.fnk

Доступны следующие экстракторы:

Экстрактор	Настройка
возраст и пол	`body_age_gender: pedattr/pedattr.age_gender.v0.gpu.fnk`
возраст и пол	`body_age_gender: pedattr/pedattr.age_gender.v0.cpu.fnk`
наличие сумки	`body_bags: pedattr/pedattr.bags.v0.gpu.fnk`
наличие сумки	`body_bags: pedattr/pedattr.bags.v0.cpu.fnk`
тип одежды	`body_clothes: pedattr/pedattr.clothes_type.v0.gpu.fnk`
тип одежды	`body_clothes: pedattr/pedattr.clothes_type.v0.cpu.fnk`
цвет одежды	`body_color: pedattr/pedattr.color.v1.gpu.fnk`
цвет одежды	`body_color: pedattr/pedattr.color.v1.cpu.fnk`
вектор признаков объекта силуэт	`body_emben: pedrec/pedrec.durga.gpu.fnk`
вектор признаков объекта силуэт	`body_emben: pedrec/pedrec.durga.cpu.fnk`
наличие СИЗ	`body_protective_equipment: pedattr/pedattr.protective.v1.gpu.fnk`
наличие СИЗ	`body_protective_equipment: pedattr/pedattr.protective.v1.cpu.fnk`
качество изображения силуэта	`body_quality: pedattr/pedattr.quality.v0.gpu.fnk`
качество изображения силуэта	`body_quality: pedattr/pedattr.quality.v0.cpu.fnk`

Совет

Для того чтобы отключить модель, передайте в соответствующий параметр пустое значение ''. Не удаляйте сам параметр, поскольку в этом случае будет выполняться поиск модели по умолчанию.

Важно

Для того чтобы распознавание силуэтов работало корректно, для параметров body_emben и body_quality должны быть указаны соответствующие модели экстракторов.

GPU

extractors:
   ...
   models:
    body_action_base6: ''
    body_action_car: ''
    body_action_fights: ''
    body_age_gender: ''
    body_bags: ''
    body_clothes: ''
    body_clothes34671: ''
    body_color: ''
    body_emben: pedrec/pedrec.durga.gpu.fnk
    body_fall: ''
    body_handface: ''
    body_protective_equipment: ''
    body_quality: pedattr/pedattr.quality.v0.gpu.fnk

CPU

extractors:
   ...
   models:
    body_action_base6: ''
    body_action_car: ''
    body_action_fights: ''
    body_age_gender: ''
    body_bags: ''
    body_clothes: ''
    body_clothes34671: ''
    body_color: ''
    body_emben: pedrec/pedrec.durga.cpu.fnk
    body_fall: ''
    body_handface: ''
    body_protective_equipment: ''
    body_quality: pedattr/pedattr.quality.v0.cpu.fnk

Перезапустите контейнер findface-multi-findface-extraction-api-1.
```
sudo docker container restart findface-multi-findface-extraction-api-1
```

Внесите изменения в конфигурационный файл /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml.

В разделе models укажите модели нейронных сетей для объекта body по аналогии с примером:

GPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  ...
  detectors:
    ...
    body:
      fnk_path: /usr/share/findface-data/models/detector/body.jasmine_fast.018.gpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    body_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.gpu.fnk
    body_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.gpu.fnk
    ...
  extractors:
    ...
    body_quality:
      fnk_path: /usr/share/findface-data/models/pedattr/pedattr.quality.v0.gpu.fnk
      normalizer: body_norm_quality

CPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

models:
  ...
  detectors:
    ...
    body:
      fnk_path: /usr/share/findface-data/models/detector/body.jasmine_fast.018.cpu.fnk
      min_size: 60
    ...
  normalizers:
    ...
    body_norm:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    body_norm_quality:
      fnk_path: /usr/share/findface-data/models/facenorm/cropbbox.v2.cpu.fnk
    ...
  extractors:
    ...
    body_quality:
      fnk_path: /usr/share/findface-data/models/pedattr/pedattr.quality.v0.cpu.fnk
      normalizer: body_norm_quality

Убедитесь, что добавлен раздел objects -> body:

objects:
  ...
  body:
    normalizer: body_norm
    quality: body_quality
    track_features: ''

Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Откройте файл конфигурации /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml и убедитесь, что он содержит раздел body в detectors, аналогичный приведенному ниже.

sudo vi /opt/findface-multi/configs/findface-video-manager/findface-video-manager.yaml

detectors:
  ...
  body:
    filter_min_quality: 0.6
    filter_min_size: 70
    filter_max_size: 8192
    roi: ''
    fullframe_crop_rot: false
    fullframe_use_png: false
    jpeg_quality: 95
    overall_only: true
    realtime_post_first_immediately: false
    realtime_post_interval: 1
    realtime_post_every_interval: false
    track_interpolate_bboxes: true
    track_miss_interval: 1
    track_overlap_threshold: 0.25
    track_max_duration_frames: 0
    track_send_history: false
    post_best_track_frame: true
    post_best_track_normalize: true
    post_first_track_frame: false
    post_last_track_frame: false
    tracker_type: simple_iou
    track_deep_sort_matching_threshold: 0.65
    track_deep_sort_filter_unconfirmed_tracks: true
    track_object_is_principal: false
    track_history_active_track_miss_interval: 0

Включите распознавание силуэтов и атрибутов силуэтов в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Выполните следующие действия:
1. В разделе FFSECURITY установите 'ENABLE_BODIES: True.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...

    # optional objects to detect
    'ENABLE_BODIES': True,
    ...
```
2. Чтобы улучшить качество распознавания силуэтов, мы рекомендуем включить дополнительный анализ атрибутов. В этом случае система сравнивает не только векторы признаков двух силуэтов, но и их атрибуты. Вывод о совпадении силуэтов делается только в том случае, если совпадают как векторы признаков, так и атрибуты.
  
  Для дополнительного анализа вы можете использовать следующие атрибуты:
  - bottom_color: цвет одежды нижней части тела;
  - top_color: цвет одежды верхней части тела;
  - headwear: тип и наличие/отсутствие головного убора;
  - detailed_upper_clothes: детализированный тип одежды верхней части тела, например, куртка;
  - upper_clothes: обобщенная категория одежды верхней части тела: с длинными рукавами, с короткими рукавами, без рукавов;
  - lower_clothes: тип одежды нижней части тела, например, брюки;
  - helmet_type: включает такие характеристики, как цвет каски, определение ее видимости на человеке, отсутствие/наличие;
  - vest_type: включает такие характеристики, как цвет жилета, определение его видимости на человеке, отсутствие/наличие;
  - age_group: принадлежность к одной из четырех возрастных групп: 0-16, 17-35, 36-50, 50+ лет;
  - gender: пол: мужской, женский.
  Для того чтобы включить дополнительный анализ атрибутов, установите True в разделе FFSECURITY -> EXTRA_BODY_MATCHING для атрибутов, которые вы хотите сравнивать. Установите значение min_confidence в диапазоне от 0 до 1.
```
FFSECURITY = {
    # use additional features for extra confidence when matching body by emben
    'EXTRA_BODY_MATCHING': {
        'bottom_color': {'enabled': False, 'min_confidence': 0},
        'top_color': {'enabled': False, 'min_confidence': 0},
        'headwear': {'enabled': False, 'min_confidence': 0},
        'detailed_upper_clothes': {'enabled': False, 'min_confidence': 0},
        'upper_clothes': {'enabled': False, 'min_confidence': 0},
        'lower_clothes': {'enabled': False, 'min_confidence': 0},
        'helmet_type': {'enabled': False, 'min_confidence': 0},
        'vest_type': {'enabled': False, 'min_confidence': 0},
        'age_group': {'enabled': False, 'min_confidence': 0},
        'gender': {'enabled': False, 'min_confidence': 0},
    },
```
  Примечание
  
  Проконсультируйтесь с нашими техническими экспертами (support@ntechlab.com), чтобы установить оптимальное значение для min_confidence.
  
  Если вы решили, что дополнительный анализ атрибутов вам не нужен, пропустите эту настройку и переходите к следующему шагу.
3. В разделе FFSECURITY укажите атрибуты силуэтов, которые требуется отображать в событиях распознавания.
```
# available features: age_gender, bags, clothes, color, protective_equipment
'BODY_EVENTS_FEATURES': ['protective_equipment', 'age_gender', 'bags', 'color', 'clothes'],
```
4. Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
В веб-интерфейсе перейдите на вкладку Источники видео. Выберите камеру на вкладке Камеры (либо загруженный файл на вкладке Загрузки, либо внешний детектор на соответствующей вкладке). Перейдите на вкладку Основные. Поставьте флажок Силуэты в разделе Детекторы.

Включение определения витальности лиц

Детектор витальности лиц FindFace Multi отличает живые лица от изображений, таких как фото, видеозапись или маска. Детектор оценивает витальность лица с определенным уровнем достоверности и возвращает оценку достоверности вместе с бинарным результатом истинное лицо/изображение, в зависимости от предустановленного порога достоверности.

Детектор витальности лиц можно автоматически включить и настроить в ходе установки продукта. При пропуске данного шага можно впоследствии сделать это вручную, руководствуясь описанием в данном разделе.

Примечание

Детектор витальности лиц работает как на GPU-, так и на CPU-ускорении, однако на CPU он гораздо медленнее.

В этом разделе:

Включение детектора витальности лиц
Настройка порога Liveness

Включение детектора витальности лиц 

Для включения детектора витальности лиц выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml. В разделе liveness укажите модели нейронных сетей, как показано в примере:

GPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

liveness:
  fnk: /usr/share/findface-data/models/faceattr/liveness.pacs.v2.gpu.fnk
  norm: /usr/share/findface-data/models/facenorm/facenorm.multicrop_full_crop2x_size400.gpu.fnk
...

CPU

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

liveness:
  fnk: /usr/share/findface-data/models/faceattr/liveness.pacs.v2.cpu.fnk
  norm: /usr/share/findface-data/models/facenorm/facenorm.multicrop_full_crop2x_size400.cpu.fnk
...

Перезапустите контейнер findface-multi-findface-video-worker-1.
```
sudo docker container restart findface-multi-findface-video-worker-1
```

Настройка порога Liveness 

При необходимости вы можете настроить пороговое значение для liveness в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Детектор витальности лиц оценивает витальность лица с определенной степенью достоверности. В зависимости порогового значения достоверности, он возвращает бинарный результат истинное лицо или изображение.

Примечание

Значение по умолчанию является оптимальным. Перед изменением порога проконсультируйтесь у наших специалистов по адресу support@ntechlab.com.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...
    # feature specific confidence thresholds
    'LIVENESS_THRESHOLD': 0.674,  # model: [liveness.pacs.v2]
    ...

Перезапустите контейнер findface-multi-findface-multi-legacy-1, если вы меняли порог для liveness.

sudo docker container restart findface-multi-findface-multi-legacy-1

Миграция векторов признаков на другую модель нейронной сети

Совет

Не стесняйтесь обращаться к нашим специалистам по вопросам миграции по адресу support@ntechlab.com.

Важно

В случае если вы выполняете миграцию как часть обновления системы до новой версии, выполните сначала обновление. Только после этого приступайте к миграции.

Этот раздел посвящен миграции векторов признаков объектов на другую модель нейронной сети.

Выполните следующие действия:

Создайте резервную копию базы данных векторов признаков на основе Tarantool в любой выбранной директории, например, /etc/ffmulti_dump.

sudo docker exec -it findface-multi-findface-sf-api-1 bash -c "mkdir ffmulti_dump; cd ffmulti_dump && /storage-api-dump -config /etc/findface-sf-api.ini"
sudo docker cp findface-multi-findface-sf-api-1:/ffmulti_dump /etc

Создайте новые шарды, в которых будут храниться заново сгенерированные векторы признаков.
1. Перейдите в директорию /opt/findface-multi/data/findface-tarantool-server и подсчитайте количество шардов по количеству директорий.
  
  Примечание
  
  В примере ниже восемь шардов.
```
cd /opt/findface-multi/data/findface-tarantool-server

ls -l

shard-001
shard-002
shard-003
shard-004
shard-005
shard-006
shard-007
shard-008
```
2. Создайте директории, в которых будут храниться файлы новых шардов.
```
sudo mkdir -p shard-01{1..8}/{index,snapshots,xlogs}
```

Откройте файл конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml и замените модели extraction на новые в параметрах body_emben, car_emben и face_emben, в зависимости от мигрируемых типов объектов.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

extractors:
  ...
  models:
    ...
     body_emben: pedrec/<new_model_body>.cpu<gpu>.fnk
     ...
     car_emben: carrec/<new_model_car>.cpu<gpu>.fnk
     ...
     face_emben: face/<new_model_face>.cpu<gpu>.fnk
     ...

Перезапустите контейнер findface-multi-findface-extraction-api-1.

cd /opt/findface-multi/
sudo docker-compose restart findface-extraction-api

В файле docker-compose.yaml создайте новые сервисы для каждого нового шарда. Для этого скопируйте существующий сервис и замените имя шарда на новое, порты в CFG_LISTEN_PORT, TT_LISTEN, а также путь к шарду в volumes.

sudo vi docker-compose.yaml

services:
  ...
  findface-tarantool-server-shard-**011**:
    depends_on: [findface-ntls]
    environment: {CFG_EXTRA_LUA: loadfile("/tnt_schema.lua")(), CFG_LISTEN_HOST: 127.0.0.1,
      CFG_LISTEN_PORT: '8111', CFG_NTLS: '127.0.0.1:3133', TT_CHECKPOINT_COUNT: 3,
      TT_CHECKPOINT_INTERVAL: '14400', TT_FORCE_RECOVERY: 'true', TT_LISTEN: '127.0.0.1:32011',
      TT_MEMTX_DIR: snapshots, TT_MEMTX_MEMORY: '2147483648', TT_WAL_DIR: xlogs, TT_WORK_DIR: /var/lib/tarantool/FindFace}
    image: docker.int.ntl/ntech/universe/tntapi:ffserver-9.230407.1
    logging: {driver: journald}
    network_mode: service:pause
    restart: always
    volumes: ['./data/findface-tarantool-server/shard-**011**:/var/lib/tarantool/FindFace',
      './configs/findface-tarantool-server/tnt-schema.lua:/tnt_schema.lua:ro']
...

Запустите новые шарды, подняв контейнеры.
```
sudo docker-compose up -d
```

На основании приведенного ниже примера создайте файл конфигурации с настройками миграции migration.yaml.

sudo vi migration.yaml

extraction-api:
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 0s
  extraction-api: http://127.0.0.1:18666
storage-api-from: # current location of the gallery
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 10s
  max-idle-conns-per-host: 20
  shards:
    - master: http://127.0.0.1:8101/v2/
      slave: ''
    - master: http://127.0.0.1:8102/v2/
      slave: ''
    - master: http://127.0.0.1:8103/v2/
      slave: ''
    - master: http://127.0.0.1:8104/v2/
      slave: ''
    - master: http://127.0.0.1:8105/v2/
      slave: ''
    - master: http://127.0.0.1:8106/v2/
      slave: ''
    - master: http://127.0.0.1:8107/v2/
      slave: ''
    - master: http://127.0.0.1:8108/v2/
      slave: ''
storage-api-to:
  timeouts:
    connect: 5s
    response_header: 30s
    overall: 35s
    idle_connection: 10s
  max-idle-conns-per-host: 20
  shards:
    - master: http://127.0.0.1:8111/v2/
      slave: ''
    - master: http://127.0.0.1:8112/v2/
      slave: ''
    - master: http://127.0.0.1:8113/v2/
      slave: ''
    - master: http://127.0.0.1:8114/v2/
      slave: ''
    - master: http://127.0.0.1:8115/v2/
      slave: ''
    - master: http://127.0.0.1:8116/v2/
      slave: ''
    - master: http://127.0.0.1:8117/v2/
      slave: ''
    - master: http://127.0.0.1:8118/v2/
      slave: ''
workers_num: 3
objects_limit: 1000
extraction_batch_size: 8
normalized_storage:
  type: webdav
  enabled: True
  webdav:
    upload-url: http://127.0.0.1:3333/uploads/
  s3:
    endpoint: ''
    bucket-name: ''
    access-key: ''
    secret-access-key: ''
    secure: False
    region: ''
    public-url: ''
    operation-timeout: 30

В разделе storage-api-from укажите шарды, с которых осуществляется миграция.

storage-api-from: # current location of the gallery
  ...
  shards:
    - master: http://127.0.0.1:8101/v2/
      slave: ''
    - master: http://127.0.0.1:8102/v2/
      slave: ''
    - master: http://127.0.0.1:8103/v2/
      slave: ''
    - master: http://127.0.0.1:8104/v2/
      slave: ''
    - master: http://127.0.0.1:8105/v2/
      slave: ''
    - master: http://127.0.0.1:8106/v2/
      slave: ''
    - master: http://127.0.0.1:8107/v2/
      slave: ''
    - master: http://127.0.0.1:8108/v2/
      slave: ''
    ...

В разделе storage-api-to укажите новые шарды, в которых будут храниться данные после миграции.

storage-api-to:
  ...
  shards:
    - master: http://127.0.0.1:8111/v2/
      slave: ''
    - master: http://127.0.0.1:8112/v2/
      slave: ''
    - master: http://127.0.0.1:8113/v2/
      slave: ''
    - master: http://127.0.0.1:8114/v2/
      slave: ''
    - master: http://127.0.0.1:8115/v2/
      slave: ''
    - master: http://127.0.0.1:8116/v2/
      slave: ''
    - master: http://127.0.0.1:8117/v2/
      slave: ''
    - master: http://127.0.0.1:8118/v2/
      slave: ''
    ...

Скопируйте файл migration.yaml внутрь контейнера findface-multi-findface-sf-api-1. Запустите утилиту sf-api-migrate с опцией -config и укажите файл конфигурации migration.yaml.
```
sudo docker cp migration.yaml findface-multi-findface-sf-api-1:/
sudo docker exec findface-multi-findface-sf-api-1 ./sf-api-migrate -config migration.yaml
```
Примечание

Если в системе много событий и карточек, процесс миграции может занять значительное количество времени.
После завершения миграции удалите сервисы старых шардов из файла docker-compose.yaml и остановите используемые ими контейнеры.
```
sudo docker-compose up -d --remove-orphans
```

Откройте файл конфигурации /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml и измените порты шардов в зависимости от новых настроек. Перезапустите контейнер findface-multi-findface-sf-api-1.

sudo vi /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml

storage-api:
  shards:
  - master: http://127.0.0.1:8111/v2/
    slave: ''
  - master: http://127.0.0.1:8112/v2/
    slave: ''
  - master: http://127.0.0.1:8113/v2/
    slave: ''
  - master: http://127.0.0.1:8114/v2/
    slave: ''
  - master: http://127.0.0.1:8115/v2/
    slave: ''
  - master: http://127.0.0.1:8116/v2/
    slave: ''
  - master: http://127.0.0.1:8117/v2/
    slave: ''
  - master: http://127.0.0.1:8118/v2/
    slave: ''

sudo docker-compose restart findface-sf-api

Мигрируйте кластеры, если данная функция включена в системе. Для этого выполните следующую команду:

Примечание

Перечислите мигрируемые типы объектов в виде опций команды: --face, --body, --car.
```
sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py migrate_clusters --face --body --car --use-best-event --use-thumbnail --force-clustering
```
В результате система повторно сгенерирует векторы признаков для существующих кластерных событий и автоматически запустит запланированную кластеризацию для пересборки кластеров.

Деактивация сервиса `findface-liveness-api`, установленного вместе с FindFace Multi

Если вы не используете сервис findface-liveness-api, установленный вместе с FindFace Multi, и аутентификация по лицу не актуальна для вашей системы, рекомендуется деактивировать findface-liveness-api.

Выполните следующие действия:

Остановите контейнер findface-multi-findface-liveness-api-1 и отключите его автозагрузку, выполнив следующую последовательность команд:
```
sudo docker container stop findface-multi-findface-liveness-api-1
sudo docker update --restart=no findface-multi-findface-liveness-api-1
```
Откройте файл конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml.
```
sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml
```
Отключите модель нейронной сети, используемую сервисом findface-liveness-api, передав пустое значение '' в параметры multicrop_full_crop2x и face_liveness.

Примечание

Не удаляйте сам параметр, поскольку в этом случае будет выполняться поиск модели по умолчанию.
```
normalizers:
  models:
    ...
    multicrop_full_crop2x: ''
    ...

extractors:
  models:
    ...
    face_liveness: ''
    ...
```
Перезапустите контейнер findface-multi-findface-extraction-api-1.
```
sudo docker container restart findface-multi-findface-extraction-api-1
```

Обслуживание и устранение неисправностей

Обновление до FindFace Multi 2.1

Совет

Если вы используете наш продукт FindFace Security, развернутый в Ubuntu 18.04, сначала обновите его до FindFace Multi 1.2, а затем обновите до FindFace Multi 2.1.

Если вы используете FindFace Multi 2.0, обновите его до FindFace Multi 2.1 с помощью следующей инструкции.

В FindFace Multi 2.1 не реализована работа плагинов Происшествия и VNS. Для этого есть отдельный продукт - FindFace CIBR. Поэтому включать плагины ffsecurity_incidents, ffsecurity_vns и ffsecurity_puppeteer в файле конфигурации findface-multi-legacy.py после обновления не нужно.

Интеграция с Axxon Next в FindFace Multi 2.1 является частью интеграции с внешними VMS и настраивается через плагин интеграции с VMS.

Если в версии FindFace Multi 1.2 вы создавали карточки человека или автомобиля c кастомными метаполями, то, чтобы они продолжали отображаться в интерфейсе FindFace Multi 2.1, необходимо в шаге №2 скопировать секцию CUSTOM_FIELDS из старого конфигурационного файла и в шаге №8 перенести ее в новый конфигурационный файл.

В этой главе:

Обновление FindFace Multi 1.2 до FindFace Multi 2.1
Обновление FindFace Multi 2.0 / 2.0.1 до FindFace Multi 2.1

Обновление FindFace Multi 1.2 до FindFace Multi 2.1 

Важно

Перед началом обновления отключите все камеры.

Для обновления FindFace Multi 1.2 до версии FindFace Multi 2.1 выполните следующие действия:

Создайте резервную копию старой схемы базы данных Tarantool:
```
sudo cp /etc/findface-security/tnt_schema.lua /etc/findface-security/old_tnt_schema.lua
```
Начиная с версии 2.0, одним из самых существенных отличий FindFace Multi от предыдущих версий продукта является структура биометрической базы данных Tarantool (так называемая «метасхема»). В новой структуре выделено несколько пространств (spaces), тогда как в прежних версиях было только одно пространство (space) по умолчанию.

Откройте файл конфигурации /etc/findface-security/config.py. Сохраните значения параметров EXTERNAL_ADDRESS, SECRET_KEY, VIDEO_DETECTOR_TOKEN, ROUTER_URL, CUSTOM_FIELDS для последующего использования.

sudo vi /etc/findface-security/config.py

EXTERNAL_ADDRESS = "http://172.20.77.58"
...
# use pwgen -sncy 50 1|tr "'" "." to generate your own unique key
SECRET_KEY = 'c8b533847bbf7142102de1349d33a1f6'
FFSECURITY = {
'VIDEO_DETECTOR_TOKEN': '381b0f4a20495227d04185ab02f5085f',
...
'ROUTER_URL': 'http://172.20.77.58',
...
# -- Custom model fields --
# Edit CUSTOM_FIELDS -> `human_card` section to customize human card fields.
# Edit CUSTOM_FIELDS -> `face_object` section to customize face object fields.
# Below is an example with every field type possible.
# 'CUSTOM_FIELDS': {
#     'human_card': {
#         'items': [
#             {
#                 'name': 'personid',
#                 'default': '',
#                 'label': 'PersonID',
#                 'display': ['list', 'form'],
#                 'description': 'Sigur person ID',
#                 'editable': False
#             },
#             {
#                 'name': 'firstname',
#                 'default': '',
#                 'label': 'First Name',
#                 'display': ['list', 'form'],
#                 'description': 'Sigur first name',
#                 'editable': False
#             },
#             {
#                 'name': 'lastname',
#                 'default': '',
#                 'label': 'Last Name',
#                 'display': ['list', 'form'],
#                 'description': 'Sigur last name',
#                 'editable': False
#             },
#             {
#                 'name': 'version',
#                 'default': '',
#                 'label': 'Version',
#                 'display': ['list', 'form'],
#                 'description': 'Sigur photo version',
#                 'editable': False
#             }
#         ],
#         'filters': [
#             {
#                 'name': 'personid',
#                 'label': 'Sigur person ID filter',
#                 'field': 'personid'
#             }
#         ]
#     },
#     'face_object': {
#         'items': [
#             {
#                 "field_name": "tag_name_1",
#                 "type": "string",
#                 "default": "change_me"
#             },
#             {
#                 "field_name": "tag_name_2",
#                 "type": "uint",
#                 "default": 123
#             },
#             {
#                 "field_name": "tag_name_3",
#                 "type": "bool",
#                 "default": True
#             },
#         ]
#     }
# },
}

Остановите сервис findface-security.
```
sudo systemctl stop findface-security.service
```
Создайте резервную копию базы данных векторов признаков на основе Tarantool в любой выбранной директории, например, /etc/findface_dump.
```
sudo mkdir -p /etc/findface_dump
cd /etc/findface_dump
sudo findface-storage-api-dump -config /etc/findface-sf-api.ini
```

Перед установкой новой версии остановите и отключите все сервисы во избежание конфликта портов.

Примечание

В примере ниже восемь шардов. Если количество шардов в вашей системе отличается от количества шардов в примере, измените приведенную ниже команду соответствующим образом. Например, для системы с шестнадцатью шардами замените tarantool@shard-00{1..8}.service на tarantool@shard-0{01..16}.service. Список активных шардов можно посмотреть с помощью команды ls /etc/tarantool/instances.enabled/.

Можно остановить и отключить сервисы один за другим:

sudo systemctl stop postgresql.service
sudo systemctl stop postgresql@10-main
sudo systemctl stop findface-*.service
sudo systemctl stop pgbouncer.service
sudo systemctl stop tarantool@shard-00{1..8}.service
sudo systemctl stop nats-server.service
sudo systemctl stop etcd.service
sudo systemctl stop mongod.service
sudo systemctl stop mongodb.service
sudo systemctl stop memcached.service
sudo systemctl stop nginx.service

sudo systemctl disable postgresql.service
sudo systemctl disable postgresql@10-main
sudo systemctl disable pgbouncer.service
sudo systemctl disable findface-extraction-api.service
sudo systemctl disable findface-security.service
sudo systemctl disable findface-security-onvif.service
sudo systemctl disable findface-sf-api.service
sudo systemctl disable findface-ntls.service
sudo systemctl disable findface-video-manager.service
sudo systemctl disable findface-video-worker-cpu.service
sudo systemctl disable findface-video-worker-gpu.service
sudo systemctl disable findface-counter.service
sudo systemctl disable findface-liveness-api.service
sudo systemctl disable findface-video-streamer-cpu.service
sudo systemctl disable findface-video-streamer-gpu.service
sudo systemctl disable findface-video-storage.service
sudo systemctl disable tarantool@shard-00{1..8}.service
sudo systemctl disable nats-server.service
sudo systemctl disable etcd.service
sudo systemctl disable mongod.service
sudo systemctl disable mongodb.service
sudo systemctl disable memcached.service
sudo systemctl disable nginx.service

Или использовать более компактные команды:

sudo systemctl stop postgresql.service postgresql@10-main findface-*.service pgbouncer.service tarantool@shard-00{1..8}.service nats-server.service etcd.service mongod.service mongodb.service memcached.service nginx.service

sudo systemctl disable postgresql.service postgresql@10-main pgbouncer.service findface-extraction-api.service findface-security.service findface-security-onvif.service findface-sf-api.service findface-ntls.service findface-video-manager.service findface-video-worker-cpu.service findface-video-worker-gpu.service findface-counter.service findface-liveness-api.service findface-video-streamer-cpu.service findface-video-streamer-gpu.service findface-video-storage.service tarantool@shard-00{1..8}.service nats-server.service etcd.service mongod.service mongodb.service memcached.service nginx.service

Установите экземпляр FindFace Multi 2.1. Не забудьте предварительно подготовить сервер:

См.:
После установки продукта остановите все контейнеры FindFace Multi из директории /opt/findface-multi/.
```
cd /opt/findface-multi/

sudo docker-compose stop
```

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и вставьте сохраненные на шаге №2 значения для параметров EXTERNAL_ADDRESS, SECRET_KEY, VIDEO_DETECTOR_TOKEN, ROUTER_URL, и CUSTOM_FIELDS.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
...
# Use pwgen -sncy 50 1|tr "'" "." to generate your own unique key
SECRET_KEY = '002231ccb690586f4d33e98322c591bb'
...
SERVICE_EXTERNAL_ADDRESS = 'http://172.20.77.58'
# EXTERNAL_ADDRESS is used to access objects created inside FFSecurity via external links.
EXTERNAL_ADDRESS = 'http://172.20.77.58'
...
    # findface-video-worker authorization token
    'VIDEO_DETECTOR_TOKEN': '8977e1b0067d43f6c908d0bf60363255',
...
    # findface-video-worker face posting address,
    # it must be set to either FFSecurity EXTERNAL_ADDRESS (by default)
    # or findface-facerouter url (in some specific cases)
    'ROUTER_URL': 'http://127.0.0.1:80',

Откройте старую версию файла конфигурации findface-ntls, доступную по адресу /etc/findface-ntls.cfg, и сравните ее с новой версией /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml. Перенесите все пользовательские параметры из старой версии в новую. Сделайте то же самое для других компонентов, например, для findface-extract-api проверьте /etc/findface-extract-api.ini на соответствие /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml, для findface-sf-api проверьте /etc/findface-sf-api.ini на соответствие /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml и т. д.
```
sudo vi /etc/findface-ntls.cfg
sudo vi /opt/findface-multi/configs/findface-ntls/findface-ntls.yaml
sudo vi /etc/findface-extraction-api.ini
sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml
sudo vi /etc/findface-sf-api.ini
sudo vi /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml
```
Важно

Правила переноса параметров из старого файла конфигурации в новый:
- Если в новом конфигурационном файле на месте старой модели нейронной сети указана новая модель, замените новую модель на ту, которая использовалась ранее (при условии, что предыдущая модель все еще включена в FindFace Multi 2.1), а если предыдущая модель отсутствует в FindFace Multi 2.1, то ничего не меняйте. В этом случае вам придется выполнить миграцию на другую модель нейронной сети.
- Если параметр в старом файле конфигурации имел пустое значение, а в новом файле конфигурации он заполнен – сотрите это значение.
- Оставьте как есть параметры, не включенные в старый файл конфигурации, но присутствующие в новом файле конфигурации.

Измените структуру базы данных Tarantool, применив схему tnt_schema.lua из версии Findface Multi 2.1.

sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 make-tnt-schema | sudo tee /etc/findface-security/tnt_schema.lua

Удалите данные из каталогов, соответствующих активным шардам.
```
sudo rm /opt/ntech/var/lib/tarantool/shard-*/{index,snapshots,xlogs}/*
```

Скопируйте метасхему пространства (space) default из старого файла конфигурации old_tnt_schema.lua в новый файл tnt_schema.lua, чтобы старая метасхема продолжала быть доступной. Это можно сделать следующим простым способом:

12.1. В файле /etc/findface-security/old_tnt_schema.lua переименуйте следующие поля:

meta_scheme --> meta_scheme_default
meta_indexes --> meta_indexes_default

12.2. В новом файле конфигурации /etc/findface-security/tnt_schema.lua замените строки в начале файла:

cfg_spaces = {
  default = {
    meta_scheme = {
      -- internal.normalized_id:
      {
          default = '',
          field_type = 'string',
          id = 1,
          name = 'normalized_id',
      },
      -- internal.feat:
      {
          default = '',
          field_type = 'string',
          id = 2,
          name = 'feat',
      },
    },
    meta_indexes = {}
  },

на следующие:

dofile("/etc/findface-security/old_tnt_schema.lua")
spaces = {
 default = {
    meta_scheme=meta_scheme_default,
    meta_indexes=meta_indexes_default
  },

Перейдите в директорию с файлами конфигурации Tarantool /etc/tarantool/instances.available/. Импортируйте новую метасхему tnt_schema.lua в каждый файл конфигурации shard-00*.lua, как показано в примере.

sudo vi /etc/tarantool/instances.available/shard-00*.lua

dofile("/etc/findface-security/tnt_schema.lua")
FindFace = require("FindFace")
FindFace.start("127.0.0.1", 8104, {
    license_ntls_server="127.0.0.1:3133",
    replication = replication_master,
    spaces = spaces
 })

Удалите генерируемый пакетом findface-tarantool-server дефолтный конфигурационный файл FindFace.lua (он помешает сделать перезагрузку).
```
sudo rm -rf /etc/tarantool/instances*/FindFace.lua
```

Перезапустите шарды findface-tarantool-server.

TNT=$(ls /etc/tarantool/instances.enabled/ | cut -c 7,8,9)
for i in $TNT; do sudo systemctl restart tarantool@shard-$i.service ; done

После выполненных операций в шардах по-прежнему останутся старые галереи, созданные в пространстве default. При этом станут доступны новые пространства (например, ffsec_body_objects_space, ffsec_face_clusters_space и т. д.).

Восстановите в базе старые данные из резервной копии. Данные будут восстановлены в том виде, в котором они существовали в предыдущей версии: все галереи останутся в пространстве default.
```
sudo systemctl start findface-ntls.service
cd /etc/findface_dump
for x in *.json; do sudo findface-storage-api-restore -config /etc/findface-sf-api.ini < "$x"; done
```

Выполните миграцию галерей из пространства default на новые пространства:

sudo systemctl start findface-sf-api.service
sudo systemctl start nginx.service
sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py migrate_tnt_space

Выполните миграции базы данных PostgreSQL для совместимости с FindFace Multi 2.1. Сделайте следующее:

18.1. Перейдите в файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. В секции DATABASES -> default временно поменяйте пароль PASSWORD на старый, используемый в конфигурационном файле /etc/findface-security/config.py.

Важно

Обязательно сохраните пароль из файла конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Позже он понадобится.
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'DISABLE_SERVER_SIDE_CURSORS': True,
        'NAME': 'ffsecurity', 'HOST': '127.0.0.1', 'PORT': 5439, 'USER': 'ntech', 'PASSWORD': 'XXXXXXXXXXXXXXXX'
    }
}

18.2. В файле /etc/pgbouncer/pgbouncer.ini добавьте следующую строку в секцию databases:

ffsecurity_session = dbname=ffsecurity host=localhost port=5432 user=ntech pool_mode=session pool_size=10

18.3. Выполните миграции базы данных на хосте:

sudo systemctl start postgresql.service
sudo systemctl start pgbouncer.service
sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py migrate

18.4. Сделайте резервное копирование существующей базы данных с PostgreSQL, установленной на хост-системе.

cd /opt/findface-multi/
sudo -u postgres pg_dump --verbose --disable-triggers ffsecurity | sudo tee dump_ffsecurity.sql
sudo -u postgres pg_dump -t auth_group -t ffsecurity_adgroupguid -t ffsecurity_deviceblacklistrecord -t ffsecurity_ffsecauthsession -t ffsecurity_grouppermission -t ffsecurity_runtimesetting -t ffsecurity_user -t ffsecurity_user_groups -t ffsecurity_user_user_permissions -t ffsecurity_userkeyvalue -t knox_authtoken -t ffsecurity_watchlistpermission -t ffsecurity_cameragrouppermission --data-only --verbose --no-acl --no-owner --disable-triggers ffsecurity | sudo tee dump_identity_provider.sql

18.5. Сделайте резервное копирование прав доступа ролей.

sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py dump_permissions | sudo tee permissions.csv

18.6. Поменяйте обратно пароль, измененный на шаге №18.1

18.7. Остановите все сервисы.

sudo systemctl stop findface-sf-api.service nginx.service tarantool@shard-00{1..8}.service postgresql.service pgbouncer.service

18.8. Откройте файл /opt/findface-multi/docker-compose.yaml и сохраните значение POSTGRES_PASSWORD для использования в последующих командах.

18.9. Пересоздайте базу данных ffsecurity, чтобы очистить её от дефолтных данных. Вставьте значение {POSTGRES_PASSWORD}, которое вы ранее скопировали в шаге №18.8, в команду ниже:

sudo docker-compose up -d postgresql
sudo docker exec -it -u postgres findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} dropdb ffsecurity"
sudo docker exec -it -u postgres findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} createdb -O ntech --encoding=UTF-8 --lc-collate=C.UTF-8 --lc-ctype=C.UTF-8 --template=template0 ffsecurity"

18.10. Восстановите данные в только что созданную базу ffsecurity. Вставьте значение {POSTGRES_PASSWORD}, которое вы ранее скопировали в шаге №18.8, в команду ниже:

sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} psql --username postgres ffsecurity" < dump_ffsecurity.sql

18.11. Пересоздайте базу данных ffsecurity_identity_provider, чтобы очистить её от дефолтных данных. Вставьте значение {POSTGRES_PASSWORD}, которое вы ранее скопировали в шаге №18.8, в команду ниже:

sudo docker exec -it -u postgres findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} dropdb ffsecurity_identity_provider"
sudo docker exec -it -u postgres findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} createdb -O ntech --encoding=UTF-8 --lc-collate=C.UTF-8 --lc-ctype=C.UTF-8 --template=template0 ffsecurity_identity_provider"

18.12. Запустите миграции.

sudo docker-compose up -d pgbouncer
sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/identity-provider:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py migrate

18.13. Восстановите данные в базу ffsecurity_identity_provider. Вставьте значение {POSTGRES_PASSWORD}, которое вы ранее скопировали в шаге №18.8, в команду ниже:

sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} psql --username postgres ffsecurity_identity_provider" < dump_identity_provider.sql

18.14. Запустите все сервисы.

sudo docker-compose up -d

18.15. Запустите команду создания записей в таблице outbox для списков наблюдения и групп камер. Вставьте значение {POSTGRES_PASSWORD}, которое вы ранее скопировали в шаге №18.8, в команду ниже:

sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} pg_dump --username postgres -f cg_wl_permissions.sql -t ffsecurity_cameragrouppermission -t ffsecurity_watchlistpermission --data-only ffsecurity_identity_provider"
sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py create_outbox
sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} psql --username postgres -c 'TRUNCATE ffsecurity_cameragrouppermission, ffsecurity_watchlistpermission RESTART IDENTITY;' ffsecurity_identity_provider"
sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} psql --username postgres ffsecurity_identity_provider < cg_wl_permissions.sql"

18.16. Прежде чем восстановить права доступа ролей в сервис identity_provider, проверьте файл /opt/findface-multi/permissions.csv. Обязательно замените *_ffsecauthtoken на *_authtoken, если таковой имеется. Чаще всего это применимо к тем случаям, когда установка FindFace Multi 1.2 представляла собой обновление с более ранних версий продукта.

После этого восстановите права доступа ролей в сервис identity_provider.

sudo docker run --rm --network host -v /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py:/etc/findface-security/config.py:ro -v $(pwd)/permissions.csv:/var/permissions.csv:ro docker.int.ntl/ntech/multi/multi/identity-provider:ffmulti-2.1.0 /opt/findface-security/bin/python3 /tigre_prototype/manage.py load_permissions /var/permissions.csv

18.17. Скопируйте полные кадры, нормализованные изображения и лицензионный файл. Скопируйте файлы из папки /opt/ntech/license/ в папку /opt/findface-multi/data/findface-ntls/, из /var/lib/findface-security/uploads/ в /opt/findface-multi/data/findface-multi-legacy/uploads/, из /var/lib/ffupload/uploads/ в /opt/findface-multi/data/findface-upload/uploads/.

sudo cp -r /opt/ntech/license/* /opt/findface-multi/data/findface-ntls/
sudo cp -r /var/lib/findface-security/uploads/* /opt/findface-multi/data/findface-multi-legacy/uploads/
sudo cp -r /var/lib/ffupload/uploads/* /opt/findface-multi/data/findface-upload/uploads/
sudo chmod 777 -R /opt/findface-multi/data/findface-upload/uploads/
sudo chown www-data:www-data -R /opt/findface-multi/data/findface-upload/uploads/*

Также можно напрямую смонтировать указанные выше папки в соответствующие контейнеры через файл docker-compose.yaml, как показано в примере ниже:

sudo vi /opt/findface-multi/docker-compose.yaml

findface-upload:
  image: docker.int.ntl/ntech/universe/upload:ffserver-9.230407.1
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-upload/40-ffupload.sh:/docker-entrypoint.d/40-ffupload.sh:ro',
    '/var/lib/ffupload:/var/lib/ffupload']
findface-multi-identity-provider:
  depends_on: [pgbouncer, nats, findface-sf-api, findface-liveness-api, etcd]
  environment: {ADMIN_PASSWORD: <ADMIN_PASSWORD>}
  image: docker.int.ntl/ntech/multi/multi/identity-provider:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-identity-provider/findface-multi-identity-provider.py:/etc/findface-security/config.py:ro',
    '/var/lib/findface-security/uploads:/var/lib/findface-security/uploads']
findface-multi-legacy:
  depends_on: [pgbouncer, nats, findface-sf-api, findface-counter, findface-liveness-api, etcd]
  environment: {ADMIN_PASSWORD: <ADMIN_PASSWORD>}
  image: docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro',
    '/var/lib/findface-security/uploads:/var/lib/findface-security/uploads']
findface-multi-ui:
  depends_on: [findface-multi-legacy]
  image: docker.int.ntl/ntech/multi/multi/ui:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-ui/nginx-site.conf:/etc/nginx/conf.d/default.conf:ro',
    '/var/lib/findface-security/uploads:/var/lib/findface-security/uploads']
cleaner:
  command: [run-cleaner-service]
  depends_on: [pgbouncer, findface-sf-api, findface-multi-legacy]
  image: docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro',
    '/var/lib/findface-security/uploads:/var/lib/findface-security/uploads']
findface-multi-file-mover:
  command: [python3, /app/service.py, --config=/etc/config.yml]
  depends_on: [findface-multi-legacy, nats-jetstream]
  image: docker.int.ntl/ntech/multi/multi/file-mover:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
    '/var/lib/findface-security/uploads:/mnt/slow_storage/uploads']

18.18. Чтобы перенести данные Tarantool, выполните следующие действия:

Остановите все контейнеры FindFace Multi:
sudo docker-compose down
Запустите снова старые шарды и сервис findface-sf-api :
sudo systemctl start tarantool@shard-00{1..8}.service findface-sf-api.service
Создайте новую резервную копию базы данных векторов признаков:
sudo mkdir -p /etc/findface_dump_final
sudo findface-storage-api-dump -output-dir=/etc/findface_dump_final -config /etc/findface-sf-api.ini
Остановите остальные сервисы, очистите директорию instances.enabled, снова запустите контейнеры и выполните storage-api-restore:
sudo systemctl stop tarantool@shard-00{1..8}.service findface-sf-api.service findface-ntls.service
sudo rm /etc/tarantool/instances.enabled/*
sudo docker-compose up -d
sudo findface-storage-api-restore -config /opt/findface-multi/configs/findface-sf-api/findface-sf-api.yaml /etc/findface_dump_final/*.json

Обновление завершено, но в новой версии присутствуют новые модели нейронных сетей, поэтому необходимо также сделать миграцию векторов признаков на другую модель нейронной сети, либо можно использовать старые нейронные сети, перенеся их из директории /usr/share/findface-data/models/ в директорию /opt/findface-multi/models/, указав их в файле /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml.

Обратите внимание, что модели обнаружения объектов в FindFace Multi 1.2 хранятся в отдельных директориях, то есть модели обнаружения лиц хранятся в директории /usr/share/findface-data/models/facedet/, модели обнаружения автомобилей и силуэтов хранятся в директориях /usr/share/findface-data/models/cadet/ и /usr/share/findface-data/models/pedet/ соответственно. В то время как в FindFace Multi 2.1 все модели обнаружения объектов можно найти в одной директории /opt/findface-multi/models/detector/. При переносе старых моделей нейронных сетей из директории /usr/share/findface-data/models/ в директорию /opt/findface-multi/models/ поместите все модели обнаружения объектов (facedet, cadet, pedet) в директорию /opt/findface-multi/models/detector/.

См. для справки:

$ ls -lash /usr/share/findface-data/models
total 52K
0K drwxr-xr-x 13 root root 4.0K Jul 15 14:48 .
0K drwxr-xr-x  3 root root 4.0K Jul 15 14:48 ..
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 cadet
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 carattr
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 carnorm
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 carrec
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 face
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 faceattr
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 facedet
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 facenorm
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 pedattr
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 pedet
0K drwxr-xr-x  2 root root 4.0K Jul 15 14:48 pedrec


$ ls -lash /opt/findface-multi/models/
total 44K
0K drwxr-xr-x 11 root root 4.0K Jul 17 13:37 .
0K drwxr-xr-x  6 root root 4.0K Jul 19 15:31 ..
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:37 carattr
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:37 carnorm
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:36 carrec
0K drwxr-xr-x  2 root root 4.0K Jul 17 16:20 detector
0K drwxr-xr-x  2 root root 4.0K Jul 17 16:24 face
0K drwxr-xr-x  2 root root 4.0K Jul 17 16:24 faceattr
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:37 facenorm
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:37 pedattr
0K drwxr-xr-x  2 root root 4.0K Jul 17 13:37 pedrec

Важно

Настоятельно рекомендуется отключить автоматическое обновление Ubuntu, чтобы сохранить совместимость FindFace Multi со средой установки. В этом случае вы сможете обновлять ОС вручную, контролируя процесс обновления отдельных пакетов.

Для отключения автоматического обновления Ubuntu выполните следующие команды:

sudo apt-get remove unattended-upgrades
sudo systemctl stop apt-daily.timer
sudo systemctl disable apt-daily.timer
sudo systemctl disable apt-daily.service
sudo systemctl daemon-reload

Обновление FindFace Multi 2.0 / 2.0.1 до FindFace Multi 2.1 

Независимо от того, какую версию FindFace Multi: 2.0 или 2.0.1 вы обновляете до FindFace Multi 2.1, процесс обновления будет одинаковым. Выполните следующие действия:

В домашней директории пользователя создайте папку для резервного копирования данных FindFace Multi 2.0.1.
```
mkdir ~/201/
```
Создайте резервную копию конфигурационных файлов FindFace Multi и файла docker-compose.yaml, а затем перейдите в директорию /opt/findface-multi/.
```
sudo tar -cvzf ~/201/configs.tar.gz -C /opt/findface-multi/ configs
sudo cp /opt/findface-multi/docker-compose.yaml ~/201/

cd /opt/findface-multi/
```
Сделайте резервное копирование данных PostgreSQL.
```
sudo docker-compose cp postgresql:/bitnami/postgresql ~/201/pg_bkp
```

Сделайте резервное копирование данных Tarantool.

sudo docker exec -it findface-multi-findface-sf-api-1 bash -c "mkdir ffmulti_dump; cd ffmulti_dump && /storage-api-dump -config /etc/findface-sf-api.ini"
sudo docker cp findface-multi-findface-sf-api-1:/ffmulti_dump ~/201/

Для папки 201/, расположенной в домашней директории пользователя, выполните команду ls, чтобы просмотреть содержимое папки. Оно должно быть таким.
```
ls ~/201/

configs.tar.gz  docker-compose.yaml  ffmulti_dump  pg_bkp
```
Остановите все контейнеры FindFace Multi.
```
sudo docker-compose down
```

Удалите папки /opt/findface-multi/data/findface-tarantool-server/ и /opt/findface-multi/data/postgresql/.

sudo rm -r /opt/findface-multi/data/findface-tarantool-server/

sudo rm -r /opt/findface-multi/data/postgresql/

Установите экземпляр FindFace Multi 2.1 в директорию /opt/findface-multi.

Восстановите данные Tarantool из резервной копии.

Скопируйте папку ~/201/ffmulti_dump/ в контейнер findface-multi-findface-sf-api-1.
```
sudo docker cp  ~/201/ffmulti_dump/ findface-multi-findface-sf-api-1:/
```
Восстановите данные Tarantool.

sudo docker exec -it findface-multi-findface-sf-api-1 bash -c 'cd ffmulti_dump && for x in *.json; do /storage-api-restore -config /etc/findface-sf-api.ini < "$x"; done;'

В новых конфигурационных файлах замените пароль для NTECH USER на тот, который использовался в FindFace Multi 2.0.1. Старый пароль можно получить из файла configs/postgresql/40-init.sql, находящегося в архиве резервной копии configs.tar.gz. Пароль NTECH USER должен быть заменен в следующих конфигурационных файлах:
- findface-multi-legacy.py
- findface-multi-line-crossing-analytics.yaml
- findface-multi-identity-provider.py
- findface-multi-audit.py
- pgbouncer -> userlist.txt
- postgresql -> 40-init.sql
- findface-counter.yaml
В новом конфигурационном файле /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py замените значения SECRET_KEY в секции GENERAL SETTINGS и 'VIDEO_DETECTOR_TOKEN' в секции FINDFACE SECURITY SETTINGS на те, которые использовались в FindFace Multi 2.0.1. Старые значения можно получить из файла configs/findface-multi-legacy/findface-multi-legacy.py, находящегося в архиве резервной копии configs.tar.gz.
Сравните конфигурационные файлы версии 2.0.1 с файлами версии 2.1 для сервисов findface-ntls, findface-extract-api, findface-sf-api и т.д. Перенесите все пользовательские параметры из старой версии в новую. Возможно, потребуется внести изменения в файл docker-compose.yaml, если ранее вы добавляли или удаляли сервисы или вносили какие-либо другие изменения.
Важно

Правила переноса параметров из старого файла конфигурации в новый:
- Если в новом конфигурационном файле на месте старой модели нейронной сети указана новая модель, замените новую модель на ту, которая использовалась ранее (при условии, что предыдущая модель все еще включена в FindFace Multi 2.1), а если предыдущая модель отсутствует в FindFace Multi 2.1, то ничего не меняйте. В этом случае вам придется выполнить миграцию на другую модель нейронной сети.
- Если параметр в старом файле конфигурации имел пустое значение, а в новом файле конфигурации он заполнен – сотрите это значение.
- Оставьте как есть параметры, не включенные в старый файл конфигурации, но присутствующие в новом файле конфигурации.

В FindFace Multi 2.1 появились новые модели нейронных сетей для распознавания силуэтов и транспортных средств.

В файле /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml замените модель pedrec.clio на модель pedrec.durga для экстрактора body_emben.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

CPU

extractors:
  ...
  models:
    ...
    body_emben: pedrec/pedrec.durga.cpu.fnk
    ...

GPU

extractors:
  ...
  models:
    ...
    body_emben: pedrec/pedrec.durga.gpu.fnk
    ...

В том же файле конфигурации замените модель alonso на модель bottas для экстрактора car_emben.

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

CPU

extractors:
  ...
  models:
    ...
    car_emben: carrec/bottas.cpu.fnk
    ...

GPU

extractors:
  ...
  models:
    ...
    car_emben: carrec/bottas.gpu.fnk
    ...

Остановите все контейнеры FindFace Multi из директории /opt/findface-multi.
```
cd /opt/findface-multi

sudo docker-compose down
```
Скопируйте данные из директории ~/201/pg_bkp/data/ в директорию /opt/findface-multi/data/postgresql.
```
sudo cp -r ~/201/pg_bkp/data/ /opt/findface-multi/data/postgresql
```
Запустите все контейнеры FindFace Multi.
```
sudo docker-compose up -d
```

Примечание

Вы можете дополнительно развернуть Видеомагнитофон. См. Пошаговое развертывание Видеомагнитофона.

Резервное копирование и восстановление FindFace Multi и его данных

Вы можете создать резервную копию FindFace Multi перед его удалением, чтобы позже восстановить продукт и его данные.

В этом разделе:

Резервное копирование FindFace Multi
Восстановление FindFace Multi и его данных

Резервное копирование FindFace Multi 

Чтобы создать резервную копию вашего экземпляра FindFace Multi и его данных, выполните следующие команды:

sudo tar -cvzf ~/configs.tar.gz -C /opt/findface-multi/ configs
sudo tar -cvzf ~/data.tar.gz -C /opt/findface-multi/ data
sudo cp /opt/findface-multi/docker-compose.yaml ~/

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

Установите утилиту rsynk.
```
sudo apt install rsync
```
Принудительно перенесите изображения, скопировав их из горячего хранилища в холодное.

Примечание

ssd-path – это путь (директория) к вашему SSD, который будет использоваться для горячего хранения данных. Здесь и далее заменяйте ssd-path на директорию вашего SSD.
```
rsync -aP /ssd-path/event/ /opt/findface-multi/data/findface-multi-legacy/uploads/event/
```
Создайте резервную копию вашего экземпляра FindFace Multi и его данных, выполнив команды выше.

Восстановление FindFace Multi и его данных 

Чтобы восстановить FindFace Multi и его данные из резервной копии, выполните следующие действия:

Загрузите файл инсталлятора findface-*.run.
Поместите файл .run в любой каталог на сервере установки (например, /home/username).
Из данного каталога сделайте файл .run исполняемым.

Примечание

Вместо findface-* укажите актуальное имя файла.
```
chmod +x findface-*.run
```
Запустите файл .run.
```
sudo ./findface-*.run
```
Пройдите процесс установки, как описано здесь.
Чтобы восстановить FindFace Multi, его данные и конфигурационные файлы из резервной копии, после завершения установки остановите все контейнеры FindFace Multi.
```
cd /opt/findface-multi
sudo docker-compose stop
```
Удалите новые конфигурационные файлы и данные, сформированные и созданные инсталлером, и восстановите их из резервной копии.

Важно

Сравните старый файл ~/docker-compose.yaml, который вы сохранили в ходе резервного копирования, с новым файлом /opt/findface-multi/docker-compose.yaml. Возможно, потребуется внести изменения в старый файл ~/docker-compose.yaml, если ранее вы добавляли или удаляли сервисы или вносили какие-либо другие изменения. Вы должны полностью осознавать, что делаете, меняя новый файл docker-compose.yaml на старый.
```
sudo rm -r /opt/findface-multi/configs/*
sudo tar -xvf ~/configs.tar.gz -C /opt/findface-multi/
sudo rm -r /opt/findface-multi/data/*
sudo tar -xvf ~/data.tar.gz -C /opt/findface-multi/
sudo cp ~/docker-compose.yaml /opt/findface-multi/
```
Перезапустите контейнеры FindFace Multi.
```
cd /opt/findface-multi
sudo docker-compose up -d
```

Изменение структуры базы данных векторов признаков

В некоторых случаях вам может потребоваться применить новую структурную схему к базе данных векторов признаков Tarantool, например, при обновлении до последней версии продукта или если необходимо усовершенствовать структуру базы данных, добавив в нее дополнительные параметры, расширенные метаданные лиц и т. д.

В этом разделе:

О структуре биометрической базы данных
Изменение структуры

О структуре биометрической базы данных 

В FindFace Multi структура базы данных задается через файл /opt/findface-multi/configs/findface-tarantool-server/tnt-schema.lua.

Структура представляет собой набор пространств (spaces) и полей, каждое из которых описывается следующими параметрами:

id: id поля;
name: название поля, должно совпадать с названием соответствующего параметра объекта;
field_type: тип данных (unsigned|string|set[string]|set[unsigned]);
default: значение по умолчанию. Если значение по умолчанию больше 1e14 – 1, то его следует записывать в виде строки, т. е. “123123..” вместо 123123...

Используемый по умолчанию файл tnt-schema.lua доступен по ссылке.

Изменение структуры 

Для изменения структуры базы данных выполните следующие действия:

Создайте резервную копию базы данных векторов признаков на основе Tarantool в любой выбранной директории, например, /etc/ffmulti_dump.

sudo docker exec -it findface-multi-findface-sf-api-1 bash -c "mkdir ffmulti_dump; cd ffmulti_dump && /storage-api-dump -config /etc/findface-sf-api.ini"
sudo docker cp findface-multi-findface-sf-api-1:/ffmulti_dump /etc

Измените структуру базы данных, добавив новую схему в файл tnt-schema.lua.

sudo docker run --rm --network host --volume '/opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro' docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0 make-tnt-schema | sudo tee /opt/findface-multi/configs/findface-tarantool-server/tnt-schema.lua

Откройте файл docker-compose.yaml и убедитесь, что в каждом сервисе шарда Tarantool в разделе environment присутствует заполненная переменная CFG_EXTRA_LUA: loadfile("/tnt_schema.lua").
```
sudo vi /opt/findface-multi/docker-compose.yaml

...
findface-tarantool-server-shard-001:
    depends_on: [findface-ntls]
    environment: {CFG_EXTRA_LUA: loadfile("/tnt_schema.lua")()...
...
```
Удалите данные из каталогов, соответствующих активным шардам.
```
sudo rm /opt/findface-multi/data/findface-tarantool-server/shard-*/{index,snapshots,xlogs}/*
```

Перезапустите шарды findface-tarantool-server.

docker restart findface-multi-findface-tarantool-server-shard-001-1 findface-multi-findface-tarantool-server-shard-002-1 findface-multi-findface-tarantool-server-shard-003-1 findface-multi-findface-tarantool-server-shard-004-1 findface-multi-findface-tarantool-server-shard-005-1 findface-multi-findface-tarantool-server-shard-006-1 findface-multi-findface-tarantool-server-shard-007-1 findface-multi-findface-tarantool-server-shard-008-1

Восстановите базу данных Tarantool из резервной копии.
```
sudo docker exec -it findface-multi-findface-sf-api-1 bash -c 'cd ffmulti_dump && for x in *.json; do /storage-api-restore -config /etc/findface-sf-api.ini < "$x"; done;'
```
Важно

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

См.также

Пользовательские метаданные в Tarantool

Проверка статуса компонентов

Проверьте статус контейнеров, если вы столкнулись с проблемой в системе, используя следующие команды:

docker ps
sudo docker container inspect <container_id>/<container_name>
sudo docker container stats <container_id>/<container_name>

Логирование

Просмотр логов — это первое, что нужно сделать, чтобы определить причину проблемы. По умолчанию процессы FindFace Multi регистрируются в логах контейнеров Docker, доступ к которым можно получить, используя команды docker logs и docker service logs. Помимо этого Docker использует драйвер логирования в формате JSON, который кэширует логи контейнеров в данный формат. Вы можете настроить Docker на использование другого драйвера логирования, выбрав из множества доступных механизмов логирования.

Данный раздел посвящен настройке Docker на использование драйвера логирования journald, который отправляет логи контейнеров в журнал systemd. В этом случае записи журнала извлекаются с помощью команды journalctl, через journal API или команды docker logs. Следуя приведенным ниже инструкциям, вы также можете настроить журнал systemd.

В этом разделе:

Настройка Journald
Активация драйвера логирования journald
Просмотр логов

Настройка Journald 

Для настройки сервиса systemd-journal выполните следующие действия:

Проверьте наличие директории /var/log/journal. Если таковая отсутствует, создайте ее следующей командой:
```
sudo mkdir /var/log/journal
sudo chmod 2755 /var/log/journal
```
Откройте файл конфигурации /etc/systemd/journald.conf. Включите сохранение логов journald на жестком диске, раскомментировав параметр Storage и изменив его значение на persistent. Также отключите фильтрацию systemd-journal:
```
sudo vi /etc/systemd/journald.conf

[Journal]
...
Storage=persistent
...
RateLimitInterval=0
RateLimitBurst=0
...
```
При необходимости раскомментируйте и измените значение параметра SystemMaxUse. Данный параметр определяет максимальный объем логов на жестком диске. Укажите его значение в байтах или используйте K, M, G, T, P, E в качестве единиц для указанного размера (соответственно $1024$, $1024^2$, … байт).
```
...
SystemMaxUse=3G
```

Перезапустите сервис journald.

sudo systemctl restart systemd-journald.service

Активация драйвера логирования journald 

Для того чтобы разрешить Docker использовать драйвер логирования journald, выполните следующие действия:

Добавьте следующую строку в файл конфигурации /etc/docker/daemon.json.
Совет

Данный файл может отсутствовать в вашей системе. Проверьте, существует ли он, и если нет, сначала создайте каталог /etc/docker, а затем файл.
```
sudo mkdir /etc/docker
sudo touch /etc/docker/daemon.json
```
```
sudo vi /etc/docker/daemon.json

{
  "log-driver": "journald"
}
```
Остановите все контейнеры Docker.
```
sudo docker stop $(sudo docker ps -a -q)
```
Перезапустите сервис Docker.
```
sudo systemctl restart docker
```
Запустите все контейнеры Docker.
```
sudo docker start $(sudo docker ps -a -q)
```

Просмотр логов 

Используйте любой удобный способ работы с логами journald. Мы рекомендуем начать со следующих команд:

Отображение всех логов:
```
journalctl -fa
```
Отображение логов по ID контейнера:
```
journalctl CONTAINER_ID=<container_id> -f
```
Отображение логов по имени контейнера:
```
journalctl CONTAINER_NAME=<container-name> -f
```

См.также

Журнал действий пользователей

Устранение неполадок с лицензированием и `findface-ntls`

При устранении неполадок с лицензией и сервером findface-ntls (см. Лицензирование) первым шагом является получение информации о лицензии и статусе сервера. Это можно сделать, отправив API-запрос в findface-ntls. Действия по устранению неполадок предпринимаются с учетом содержания API-ответа.

Совет

По вопросам устранения неполадок обращайтесь к нашим специалистам по адресу support@ntechlab.com.

Примечание

Онлайн-лицензирование выполняется через Глобальный менеджер лицензий NtechLab license.ntechlab.com. Проверьте его доступность. Для онлайн-лицензирования необходимы стабильное интернет-соединение и DNS.

Для получения информации о лицензии FindFace и статусе findface-ntls, выполните в консоли сервера findface-ntls следующую команду:

curl http://localhost:3185/license.json -s | jq

Ответ будет возвращен в формате JSON. Одним из наиболее значимых параметров в ответе является last_updated. Он показывает в секундах, как давно в последний раз проверялась локальная лицензия.

Интерпретируйте значение параметра last_updated следующим образом:

[0, 5] — все работает отлично.

(5, 30] — возможно имеют место быть какие-то проблемы со связью, либо с локальным накопителем, где хранятся файлы лицензий.

(30; 120] — почти наверняка случилось что-то нехорошее.

(120; ∞) — не удается получить ответ от источника лицензирования в течение длительного времени. Необходимо вмешательство.

"valid" -> "value": false: связь с источником лицензирования так и не была установлена.

curl http://localhost:3185/license.json -s | jq
{
  "name": "NTLS",
  "time": 1565186356,
  "type": "online",
  "license_id": "61063ce4b86945e1b70c3bdbedea453b",
  "generated": 1514467939,
  "last_updated": 5,
  "valid": {
    "value": true,
    "description": ""
  },
  "source": "/opt/ntech/license/import_b68d7b7ec9a7310d18832035318cff0c9ddf11e3a9ab0ae962fbe48645e196d1.lic",
  "limits": [
    {
      "type": "time",
      "name": "end",
      "value": 1609161621
    },
    {
      "type": "number",
      "name": "faces",
      "value": 9007199254740991,
      "current": 0
    },
    {
      "type": "number",
      "name": "cameras",
      "value": 4294967295,
      "current": 0
    },
    {
      "type": "number",
      "name": "extraction_api",
      "value": 256,
      "current": 0
    },
    {
      "type": "boolean",
      "name": "gender",
      "value": true
    },
    {
      "type": "boolean",
      "name": "age",
      "value": true
    },
    {
      "type": "boolean",
      "name": "emotions",
      "value": true
    },
    {
      "type": "boolean",
      "name": "fast-index",
      "value": true
    },
    {
      "type": "boolean",
      "name": "sec-genetec",
      "value": false
    },
    {
      "type": "boolean",
      "name": "beard",
      "value": false
    },
    {
      "type": "boolean",
      "name": "glasses",
      "value": false
    },
    {
      "type": "boolean",
      "name": "liveness",
      "value": false
    }
  ],
  "services": [
    {
      "name": "video-worker",
      "ip": "127.0.0.1:53276"
    },
    {
      "name": "FindFace-tarantool",
      "ip": "127.0.0.1:53284"
    },
    {
      "name": "FindFace-tarantool",
      "ip": "127.0.0.1:53288"
    }
  ]
}

Ручная очистка базы данных от старых данных

Совет

Для настройки автоматического удаления старых данных см. Основные настройки.

Для ручного удаления старых данных из базы данных FindFace Multi используйте утилиту cleanup. Вы можете выборочно удалить следующие данные:

события с совпадениями (лица, силуэты, транспортные средства) и связанные эпизоды,
события без совпадений (лица, силуэты, транспортные средства) и связанные эпизоды,
полные кадры событий с совпадениями (лица, силуэты, транспортные средства),
полные кадры событий без совпадений (лица, силуэты, транспортные средства),
скриншоты счетчиков,
кластерные события (лица, силуэты, транспортные средства),
журнал действий пользователей,
события внешних VMS.

Утилита очистки работает в контейнере findface-multi-findface-multi-legacy-1. Для того чтобы вызвать справку cleanup, выполните следующую команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --help

usage: manage.py cleanup [-h] [--as-configured]
                         [--face-events-max-fullframe-unmatched-age FACE_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE]
                         [--face-events-max-fullframe-matched-age FACE_EVENTS_MAX_FULLFRAME_MATCHED_AGE]
                         [--face-events-max-unmatched-age FACE_EVENTS_MAX_UNMATCHED_AGE]
                         [--face-events-max-matched-age FACE_EVENTS_MAX_MATCHED_AGE]
                         [--body-events-max-fullframe-unmatched-age BODY_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE]
                         [--body-events-max-fullframe-matched-age BODY_EVENTS_MAX_FULLFRAME_MATCHED_AGE]
                         [--body-events-max-unmatched-age BODY_EVENTS_MAX_UNMATCHED_AGE]
                         [--body-events-max-matched-age BODY_EVENTS_MAX_MATCHED_AGE]
                         [--car-events-max-fullframe-unmatched-age CAR_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE]
                         [--car-events-max-fullframe-matched-age CAR_EVENTS_MAX_FULLFRAME_MATCHED_AGE]
                         [--car-events-max-unmatched-age CAR_EVENTS_MAX_UNMATCHED_AGE]
                         [--car-events-max-matched-age CAR_EVENTS_MAX_MATCHED_AGE]
                         [--car-cluster-events-max-age CAR_CLUSTER_EVENTS_MAX_AGE]
                         [--body-cluster-events-max-age BODY_CLUSTER_EVENTS_MAX_AGE]
                         [--face-cluster-events-max-age FACE_CLUSTER_EVENTS_MAX_AGE]
                         [--car-cluster-events-keep-best-max-age CAR_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE]
                         [--body-cluster-events-keep-best-max-age BODY_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE]
                         [--face-cluster-events-keep-best-max-age FACE_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE]
                         [--area-activations-max-age AREA_ACTIVATIONS_MAX_AGE]
                         [--audit-logs-max-age AUDIT_LOGS_MAX_AGE]
                         [--counter-records-max-age COUNTER_RECORDS_MAX_AGE]
                         [--external-vms-events-max-age EXTERNAL_VMS_EVENTS_MAX_AGE]
                         [--external-vms-send-events-status-max-age EXTERNAL_VMS_SEND_EVENTS_STATUS_MAX_AGE]
                         [--remote-monitoring-events-max-age REMOTE_MONITORING_EVENTS_MAX_AGE]
                         [--configuration CONFIGURATION] [--version]
                         [-v {0,1,2,3}] [--settings SETTINGS]
                         [--pythonpath PYTHONPATH] [--traceback] [--no-color]
                         [--force-color] [--skip-checks]

Delete FFSecurity entities

optional arguments:
  -h, --help            show this help message and exit
  --as-configured       Apply config age options for events, counter records
                        and clusters. Can't be used with other arguments.
  --face-events-max-fullframe-unmatched-age FACE_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE
                        face events max fullframe unmatched age to clean up
                        (in seconds)
  --face-events-max-fullframe-matched-age FACE_EVENTS_MAX_FULLFRAME_MATCHED_AGE
                        face events max fullframe matched age to clean up (in
                        seconds)
  --face-events-max-unmatched-age FACE_EVENTS_MAX_UNMATCHED_AGE
                        face events max unmatched age to clean up (in seconds)
  --face-events-max-matched-age FACE_EVENTS_MAX_MATCHED_AGE
                        face events max matched age to clean up (in seconds)
  --body-events-max-fullframe-unmatched-age BODY_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE
                        body events max fullframe unmatched age to clean up
                        (in seconds)
  --body-events-max-fullframe-matched-age BODY_EVENTS_MAX_FULLFRAME_MATCHED_AGE
                        body events max fullframe matched age to clean up (in
                        seconds)
  --body-events-max-unmatched-age BODY_EVENTS_MAX_UNMATCHED_AGE
                        body events max unmatched age to clean up (in seconds)
  --body-events-max-matched-age BODY_EVENTS_MAX_MATCHED_AGE
                        body events max matched age to clean up (in seconds)
  --car-events-max-fullframe-unmatched-age CAR_EVENTS_MAX_FULLFRAME_UNMATCHED_AGE
                        car events max fullframe unmatched age to clean up (in
                        seconds)
  --car-events-max-fullframe-matched-age CAR_EVENTS_MAX_FULLFRAME_MATCHED_AGE
                        car events max fullframe matched age to clean up (in
                        seconds)
  --car-events-max-unmatched-age CAR_EVENTS_MAX_UNMATCHED_AGE
                        car events max unmatched age to clean up (in seconds)
  --car-events-max-matched-age CAR_EVENTS_MAX_MATCHED_AGE
                        car events max matched age to clean up (in seconds)
  --car-cluster-events-max-age CAR_CLUSTER_EVENTS_MAX_AGE
                        car cluster events max age to clean up (in seconds)
  --body-cluster-events-max-age BODY_CLUSTER_EVENTS_MAX_AGE
                        body cluster events max age to clean up (in seconds)
  --face-cluster-events-max-age FACE_CLUSTER_EVENTS_MAX_AGE
                        face cluster events max age to clean up (in seconds)
  --car-cluster-events-keep-best-max-age CAR_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE
                        car cluster events keep best max age to clean up (in
                        seconds)
  --body-cluster-events-keep-best-max-age BODY_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE
                        body cluster events keep best max age to clean up (in
                        seconds)
  --face-cluster-events-keep-best-max-age FACE_CLUSTER_EVENTS_KEEP_BEST_MAX_AGE
                        face cluster events keep best max age to clean up (in
                        seconds)
  --area-activations-max-age AREA_ACTIVATIONS_MAX_AGE
                        area activations max age to clean up (in seconds)
  --audit-logs-max-age AUDIT_LOGS_MAX_AGE
                        audit logs max age to clean up (in seconds)
  --counter-records-max-age COUNTER_RECORDS_MAX_AGE
                        counter records max age to clean up (in seconds)
  --external-vms-events-max-age EXTERNAL_VMS_EVENTS_MAX_AGE
                        external vms events max age to clean up (in seconds)
  --external-vms-send-events-status-max-age EXTERNAL_VMS_SEND_EVENTS_STATUS_MAX_AGE
                        external vms send events status max age to clean up
                        (in seconds)
  --remote-monitoring-events-max-age REMOTE_MONITORING_EVENTS_MAX_AGE
                        remote monitoring events max age to clean up (in
                        seconds)
  --configuration CONFIGURATION
                        The name of the configuration class to load, e.g.
                        "Development". If this isn't provided, the
                        DJANGO_CONFIGURATION environment variable will be
                        used.
  --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.

Для полного удаления событий и эпизодов старше определенного количества дней используйте аргументы —*-events-max-matched-age/—*-events-max-unmatched-age. Например, для удаления событий с автомобилями без совпадений старше 5 дней (432000 секунд) выполните команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --car-events-max-unmatched-age 432000

Для удаления событий распознавания транспортных средств с совпадениями старше 5 дней (432000 секунд) выполните команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --car-events-max-matched-age 432000

Следующие команды удаляют только полные кадры событий распознавания силуэтов с совпадениями и без:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --body-events-max-fullframe-matched-age 432000
sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --body-events-max-fullframe-unmatched-age 432000

Для того чтобы удалить только скриншоты счетчиков, выполните команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --counter-records-max-age 432000

Для того чтобы удалить только кластерные события с лицами, выполните команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --face-cluster-events-max-age 432000

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

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py cleanup --audit-logs-max-age 432000

Важно

Должен быть задан хотя бы один аргумент из указанных.

Сброс пароля

Для того чтобы сбросить пользовательский пароль в веб-интерфейсе FindFace Multi, выполните следующую команду:

sudo docker exec -it findface-multi-findface-multi-identity-provider-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py changepassword <username>

Подключение S3-совместимого хранилища

S3 (Simple Storage Service) обеспечивает надежное и долговременное хранение неограниченного количества файлов и данных. Это позволяет избежать ограничений файловой системы при работе с большими объемами данных.

Настройка S3-совместимого хранилища

В этом разделе мы опишем как настроить S3-совместимое хранилище MinIO для работы с FindFace Multi. Если вы предпочитаете другое S3-совместимое хранилище, предполагается, что его настройку вы выполните самостоятельно.

Подготовьте сервер на Ubuntu.

Примечание

Работа MinIO была протестирована только на Ubuntu. Для получения информации о поддержке других ОС обратитесь к официальной документации MinIO.
Чтобы запустить контейнер с MinIO, выполните следующую команду, задав логин/пароль в параметрах MINIO_ROOT_USER и MINIO_ROOT_PASSWORD:
```
docker run -d \
-p 9003:9000 \
-p 9004:9001 \
-e "MINIO_ROOT_USER=admin" \
-e "MINIO_ROOT_PASSWORD=admin_admin" \
-v /path/to/storage_directory:/data \
quay.io/minio/minio server /data --console-address ":9001"
```
где /path/to/storage_directory – директория, выделенная для S3-совместимого хранилища.
Адрес веб-интерфейса MinIO будет зависеть от того, какой интерфейс вы выбрали при установке FindFace Multi на шаге #4.5. Используемый порт – 9004, например, 192.168.112.254:9004. Войдите в веб-интерфейс MinIO с учетными данными MINIO_ROOT_USER, MINIO_ROOT_PASSWORD, которые вы указали на предыдущем шаге.
В пользовательском интерфейсе MinIO создайте хранилище (bucket) (Buckets -> Create Bucket). Присвойте ему имя по умолчанию ffsec.storage.

Примечание

Мы советуем оставить название хранилища ffsec.storage, предлагаемое по умолчанию, поскольку оно соответствует параметру STORAGE_BUCKET_NAME в файлах конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и /opt/findface-multi/configs/findface-multi-legacy/findface-multi-identity-provider.py. Если вы используете другое имя для хранилища, не забудьте соответствующим образом изменить его в указанных выше файлах конфигурации.
Щелкните на хранилище (bucket), чтобы открыть его настройки.
Измените доступ к хранилищу на public для корректной обработки видеоархивов.
В разделе User -> Access Keys создайте ключ доступа. Запишите значения Access key и Secret key , поскольку они понадобятся вам позже для настройки FindFace Multi.

Примечание

Интерфейс MinIO может отличаться. В более ранних версиях настройка ключа доступа производится в разделе Identity -> Service Accounts -> Create service account.

Настройка FindFace Multi для работы S3-совместимого хранилища

В файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py перейдите в секцию EXTERNAL_STORAGE_CONFIG.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

EXTERNAL_STORAGE_CONFIG = {
    'STORAGE_TYPE': None,
    'STORAGE_BUCKET_NAME': 'ffsec.storage',
    'ACCESS_KEY_ID': 'access-key',
    'SECRET__KEY': 'secret-key',
    'REGION_NAME': 'eu-west-3',
    'LOCAL_S3_SETTINGS': {
        'CONNECTION_ADDRESS': 'localhost:9003',
    },
}
```
Настройте параметры EXTERNAL_STORAGE_CONFIG:
1. Параметр STORAGE_TYPE может принимать значения 'LOCAL', 'AWS', None:
  - None – локальная файловая система (по умолчанию)
  - 'LOCAL' – любое S3-совместимое хранилище (например, MinIO)
  - 'AWS' – хранилище Amazon S3.
  Измените параметр 'STORAGE_TYPE' на 'LOCAL', чтобы включить S3-совместимое хранилище.
2. Значения параметров 'STORAGE_BUCKET_NAME', 'ACCESS_KEY_ID' и 'SECRET__KEY' должны соответствовать аналогичным значениям этих параметров, заданным на этапе инициализации MinIO.
3. 'REGION_NAME' – значение по умолчанию eu-west-3. Его можно изменить в настройках MinIO.
4. В 'LOCAL_S3_SETTINGS' -> 'CONNECTION_ADDRESS' измените localhost на IP адрес хоста MinIO, например, 192.168.112.254.
Таким же образом отредактируйте файл /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py. Перейдите в секцию EXTERNAL_STORAGE_CONFIG и внесите изменения, аналогичные тем, которые были применены к файлу /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py на предыдущем шаге.
```
sudo vi /opt/findface-multi/configs/findface-multi-identity-provider/findface-multi-identity-provider.py

EXTERNAL_STORAGE_CONFIG = {
    'STORAGE_TYPE': None,
    'STORAGE_BUCKET_NAME': 'ffsec.storage',
    'ACCESS_KEY_ID': 'access-key',
    'SECRET__KEY': 'secret-key',
    'REGION_NAME': 'eu-west-3',
    'LOCAL_S3_SETTINGS': {
        'CONNECTION_ADDRESS': 'localhost:9003',
    },
}
```

Для того чтобы пользовательский интерфейс мог загружать содержимое (миниатюры, полные кадры и т.д.), внесите изменения в файл /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf. В секции server найдите параметр add_header Content-Security-Policy и добавьте адрес {ip_host_s3}:9003/, например:

sudo vi /opt/findface-multi/configs/findface-multi-ui/nginx-site.conf

...
server {
        listen 80 default_server;
        listen [::]:80 default_server;
...
        location / {
...
        }
        add_header Content-Security-Policy "default-src 'self' 192.168.112.254:9003/ ; img-src 'self' 192.168.112.254:9003/ blob: data:; media-src 'self' blob:; style-src 'self' 'unsafe-inline';";
...
}

Выполните пересборку контейнеров FindFace Multi из директории /opt/findface-multi.
```
cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d
```
Чтобы убедиться в том, что сервис FindFace Local S3 Storage запущен, изучите логи findface-multi-findface-multi-legacy-1:
```
sudo docker logs findface-multi-findface-multi-legacy-1
```

Команда для переноса данных

Для переноса данных в удаленное или локальное хранилище используйте следующую команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py transfer_data --to_local / --to_remote

Аргумент --to_remote переносит данные в удаленное хранилище.
Аргумент --to_local переносит данные в локальную файловую систему.

Перед выполнением указанной команды убедитесь, что вы настроили FindFace Multi для использования S3-совместимого хранилища.

Многоуровневое хранение данных

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

Эту проблему можно решить с помощью многоуровневого хранения данных, которое работает следующим образом: сначала FindFace Multi сохраняет изображения событий в быстрое (т.н. «горячее») хранилище – SSD-накопитель с ограниченным объемом, а затем перекладчик (сервис findface-multi-file-mover) переносит их в долговременное (т.н. «холодное») хранилище – обычный HDD. В горячее хранилище сохраняются только миниатюры и полнокадровые изображения. Остальные данные, включая видео, изображения картотеки, отчеты и т.д., сразу сохраняются в холодное хранилище и не требуют переноса. Чтобы начать пользоваться сервисом перемещения файлов, включите горячее хранилище.

Включение горячего хранилища

По умолчанию сохранение в горячее хранилище отключено. Сервис findface-multi-file-mover запускается вместе с другими сервисами, но при этом не функционирует. Чтобы включить сервис горячего хранения, выполните следующие действия:

Выделите SSD для горячего хранилища. Учитывайте объем SSD: он должен быть достаточно большим, чтобы хранить изображения при пиковой нагрузке до их перемещения в холодное хранилище.
В файле /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py настройте параметр FAST_MEDIA_ROOT. По умолчанию он имеет значение None.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FAST_MEDIA_ROOT = '/var/lib/fast-storage/uploads'
```

Откройте файл конфигурации /opt/findface-multi/docker-compose.yaml.

В файле /opt/findface-multi/docker-compose.yaml найдите сервис findface-multi-file-mover.

findface-multi-file-mover:
  command: [python3, /app/service.py, --config=/etc/config.yml]
  depends_on: [findface-multi-legacy, nats-jetstream]
  image: docker.int.ntl/ntech/multi/multi/file-mover:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
    './data/findface-multi-legacy/uploads:/mnt/slow_storage/uploads']

Настройте сервис findface-multi-file-mover. В томах (volumes) укажите 'ssd-path:/mnt/fast_storage/uploads' – директорию горячего хранилища, из которой файлы впоследствии будут перекладываться в холодное хранилище.

Примечание

ssd-path в приведенном ниже примере – это путь (директория) к вашему SSD, который будет использоваться для горячего хранения данных. Здесь и далее заменяйте ssd-path на директорию вашего SSD.
```
findface-multi-file-mover:
  ...
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
        './data/findface-multi-legacy/uploads:/mnt/slow_storage/uploads', 'ssd-path:/mnt/fast_storage/uploads']
```

В сервисах findface-multi-legacy и findface-multi-ui в томах (volumes) укажите директорию горячего хранилища 'ssd-path:/var/lib/fast-storage/uploads'. Это необходимо сделать для того, чтобы сервис findface-multi-legacy сохранял изображения событий в указанную директорию горячего хранилища. Также, это необходимо для сервиса findface-multi-ui: до того, как сервис findface-multi-file-mover переместит миниатюру и полнокадровое изображение события в холодное хранилище, сервис findface-multi-ui будет отображать их пользователю из указанного каталога горячего хранилища.

...
  findface-multi-legacy:
    depends_on: [pgbouncer, nats, findface-sf-api, findface-counter, findface-liveness-api,
      etcd, findface-multi-identity-provider]
    environment: {ADMIN_PASSWORD: admin}
    image: docker.int.ntl/ntech/multi/multi/legacy:ffmulti-2.1.0
    logging: {driver: journald}
    network_mode: service:pause
    restart: always
    volumes: ['./configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro',
      './data/findface-multi-legacy/uploads:/var/lib/findface-security/uploads', 'ssd-path:/var/lib/fast-storage/uploads']
...
  findface-multi-ui:
    depends_on: [findface-multi-legacy]
    image: docker.int.ntl/ntech/multi/multi/ui:ffmulti-2.1.0
    logging: {driver: journald}
    network_mode: service:pause
    restart: always
    volumes: ['./configs/findface-multi-ui/nginx-site.conf:/etc/nginx/conf.d/default.conf:ro',
      './data/findface-multi-legacy/uploads:/var/lib/findface-security/uploads', 'ssd-path:/var/lib/fast-storage/uploads']
...

Выполните пересборку контейнеров FindFace Multi из директории /opt/findface-multi.
```
cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d
```

Запуск нескольких экземпляров сервиса `findface-multi-file-mover`

Для обеспечения отказоустойчивости может потребоваться эксплуатация нескольких экземпляров сервиса findface-multi-file-mover. Для их запуска выполните следующие действия:

В файле /opt/findface-multi/docker-compose.yaml укажите конфигурацию findface-multi-file-mover столько раз, сколько экземпляров сервиса вы планируете использовать, например,

findface-multi-file-mover:
  command: [python3, /app/service.py, --config=/etc/config.yml]
  depends_on: [findface-multi-legacy, nats-jetstream]
  image: docker.int.ntl/ntech/multi/multi/file-mover:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
    './data/findface-multi-legacy/uploads:/mnt/slow_storage/uploads', 'ssd-path:/mnt/fast_storage/uploads']
findface-multi-file-mover2:
  command: [python3, /app/service.py, --config=/etc/config.yml]
  depends_on: [findface-multi-legacy, nats-jetstream]
  image: docker.int.ntl/ntech/multi/multi/file-mover:ffmulti-2.1.0
  logging: {driver: journald}
  network_mode: service:pause
  restart: always
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
    './data/findface-multi-legacy/uploads:/mnt/slow_storage/uploads', 'ssd-path:/mnt/fast_storage/uploads']

Выполните пересборку контейнеров FindFace Multi из директории /opt/findface-multi.
```
cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d
```

Примечание

Если включено сохранение в горячее хранилище, то миниатюры и полнокадровые изображения, которые не были перенесены в холодное хранилище, не будут сохранены при резервном копировании. Если вам нужно сохранить все изображения, скопируйте их из горячего хранилища в холодное с помощью утилиты rsync. См. Резервное копирование FindFace Multi.

Перенос данных на другой диск

Высокая нагрузка на диск может приводить к задержкам при поступлении событий. В тяжелых случаях возможна полная неработоспособность FindFace Multi. Одним из способов снижения нагрузки на диск является перенос хранилищ данных FindFace Multi на другой диск.

В этом разделе:

Подготовка диска
Миграция хранилища фотографий и видеофрагментов
Миграция основной базы данных (PostgreSQL)

Подготовка диска 

Для того чтобы подготовить диск к миграции данных, выполните следующие действия:

Создайте новую точку монтирования (в примере /mnt/ffdata).
```
sudo mkdir /mnt/ffdata
```

Создайте раздел.

sudo parted /dev/sdb
mklabel gpt
mkpart primary ext4 1MiB 100%
q
sudo mkfs.ext4 /dev/sdb1

Узнайте UUID раздела (для sdb1 в примере).

sudo blkid | grep sdb1
/dev/sdb1: LABEL="data" UUID="0638ebe0-853e-43ea-8f35-bfae305695d1" TYPE="ext4" PARTUUID="8cebaacc-77d7-4757-b4c6-14147e92646c"

Настройте автоматическое монтирование раздела при загрузке ОС, добавив запись в fstab.

sudo vi /etc/fstab
------------
#DATA mount
UUID=0638ebe0-853e-43ea-8f35-bfae305695d1 /mnt/ffdata/    ext4    auto,user,rw     0       2
-------------

Смонтируйте все файловые системы.
```
sudo mount -a
```

Миграция хранилища фотографий и видеофрагментов 

Примечание

Рекомендуем ознакомиться с разделом Хранилища данных FindFace Multi перед началом миграции хранилищ.

Для миграции хранилищ фотографий и видеофрагментов FindFace Multi выполните следующие действия:

Внутри точки монтирования создайте каталоги (например, /mnt/ffdata/ffupload и /mnt/ffdata/findface-security) для хранения фотографий и записанных видеофрагментов (если был развернут Видеомагнитофон). Затем переместите содержимое директорий /opt/findface-multi/data/findface-upload/uploads/ и /opt/findface-multi/data/findface-multi-legacy/uploads/ во вновь созданные каталоги.
```
sudo mkdir /mnt/ffdata/ffupload
sudo mkdir /mnt/ffdata/findface-security
sudo cp -ax /opt/findface-multi/data/findface-upload/uploads/ -R /mnt/ffdata/ffupload/
sudo cp -ax /opt/findface-multi/data/findface-multi-legacy/uploads/ -R /mnt/ffdata/findface-security/
sudo rm -r /opt/findface-multi/data/findface-multi-legacy/uploads/
sudo rm -r /opt/findface-multi/data/findface-upload/uploads/
```

Смонтируйте созданные каталоги (/mnt/ffdata/ffupload и /mnt/ffdata/findface-security в примере) в соответствующие контейнеры. Для этого откройте конфигурационный файл /opt/findface-multi/docker-compose.yaml и перечислите созданные каталоги в указанных в примере томах (volumes) разделов вместо каталогов по умолчанию.

sudo vi /opt/findface-multi/docker-compose.yaml

findface-upload:
  ...
  volumes: ['./configs/findface-upload/40-ffupload.sh:/docker-entrypoint.d/40-ffupload.sh:ro',
    '/mnt/ffdata/ffupload:/var/lib/ffupload']
...
findface-multi-identity-provider:
  ...
  volumes: ['./configs/findface-multi-identity-provider/findface-multi-identity-provider.py:/etc/findface-security/config.py:ro',
      '/mnt/ffdata/findface-security/uploads:/var/lib/findface-security/uploads']
...
findface-multi-legacy:
  ...
  volumes: ['./configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro',
      '/mnt/ffdata/findface-security/uploads:/var/lib/findface-security/uploads']
...
cleaner:
  ...
  volumes: ['./configs/findface-multi-legacy/findface-multi-legacy.py:/etc/findface-security/config.py:ro',
      '/mnt/ffdata/findface-security/uploads:/var/lib/findface-security/uploads']
...
findface-multi-ui:
  ...
  volumes: ['./configs/findface-multi-ui/nginx-site.conf:/etc/nginx/conf.d/default.conf:ro',
      '/mnt/ffdata/findface-security/uploads:/var/lib/findface-security/uploads']
...
findface-multi-file-mover:
  ...
  volumes: ['./configs/findface-multi-file-mover/findface-multi-file-mover.yaml:/etc/config.yml:ro',
      '/mnt/ffdata/findface-security/uploads:/mnt/slow_storage/uploads']

Выполните пересборку контейнеров FindFace Multi.

cd /opt/findface-multi

sudo docker-compose down

sudo docker-compose up -d

Миграция основной базы данных (PostgreSQL)

Для того чтобы мигрировать базу данных PostgreSQL, выполните следующие действия:

Остановите все контейнеры FindFace Multi:
```
cd /opt/findface-multi

sudo docker-compose down
```
Переместите каталог /opt/findface-multi/data/postgresql в каталог /mnt/ffdata.
```
sudo mv /opt/findface-multi/data/postgresql /mnt/ffdata
```
Укажите новый путь каталога postgresql (/mnt/ffdata/postgresql в примере) для монтирования в контейнер findface-multi-postgresql-1. Для этого в файле конфигурации /opt/findface-multi/docker-compose.yaml укажите его в томах (volumes) секции postgresql вместо каталога по умолчанию /opt/findface-multi/data/postgresql.
```
sudo vi /opt/findface-multi/docker-compose.yaml

postgresql:
...
  volumes: ['./configs/postgresql/40-init.sql:/docker-entrypoint-initdb.d/40-init.sql:ro',
    '/mnt/ffdata/postgresql:/bitnami/postgresql']
```
Запустите все контейнеры FindFace Multi.
```
sudo docker-compose up -d
```

Отключение сервисов

Существует возможность отключить следующие сервисы FindFace Multi, если вы ими не пользуетесь:

эпизоды
менеджер очередей обработки видеоархивов
вебхуки
Active Directory
очистка VMS

Для этого откройте файл конфигурации /opt/findface-multi/config/findface-multi-legacy/findface-multi-legacy.py и измените секцию SERVICES, установив False для сервисов, которые не будут использоваться. Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo vi /opt/findface-multi/config/findface-multi-legacy/findface-multi-legacy.py

# disable unused services to increase
# overall system performance in some cases.
SERVICES = {
    "ffsecurity": {
        "episodes": False,
        "webhooks": False,
        # use queue manager to prevent drops of video archive events
        "video_archive_events_manager": False,
        "active_directory": False,
        "vms_cleanup": False,
    }
}

sudo docker container restart findface-multi-findface-multi-legacy-1

В результате соответствующие разделы исчезнут из веб-интерфейса.

Примечание

Раздел останется, если в нем есть какие-либо объекты (например, на вкладке Вебхуки созданы вебхуки). Однако сервис перестанет работать и генерировать данные.

Скрытие пунктов меню

Для того чтобы скрыть определенные пункты меню, выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```

В разделе FFSECURITY_UI_CONFIG найдите секцию menu. Перечислите пункты меню, которые вы хотите скрыть.

FFSECURITY_UI_CONFIG = {
    "menu": {
        "disabled_items": [
            "areas",
            "player",
            "cases"
        ],
    },

Вы можете скрыть следующие пункты:

Пункт меню	Настройка
Поиск	`"search"`
Анализ взаимодействий	`"relations"`
Видеостена	`"video-wall"`
Счетчики	`"counters"`
Источники видео	`"data_sources"`
Эпизоды и события	`"events_episodes"`
Кластеры	`"clusters"`
Анализ аудитории	`"analytics"`
Настройки	`"settings"`
Картотека	`"cards"`
Видеоплеер	`"player"`
Сравнение	`"verify"`
Журнал действий	`"audit-logs"`
Отчеты	`"reports"`
Пользователи	`"users"`
Сессии	`"sessions"`
Блокировки	`"blocklistRecords"`
Группы камер	`"camera-groups"`
Списки наблюдения	`"watch-lists"`
Лицензия	`"license"`
Внешние VMS	`"external-vms"`
Вебхуки	`"hooks"`
Документация	`"documentation"`
API-документация	`"api_doc"`
пункты меню, появляющиеся при активации специализированных плагинов	Свяжитесь с нашей технической поддержкой, чтобы узнать подробнее о плагинах в своей системе.

Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Приложения

Хранилища данных FindFace Multi

В этом разделе:

Список хранилищ
Галереи базы данных векторов признаков

Список хранилищ 

FindFace Multi использует следующие хранилища данных:

База данных векторов признаков на основе Tarantool, в которой хранятся векторы признаков объектов и события распознавания: /opt/findface-multi/data/findface-tarantool-server
Основная база данных системы на основе PostgreSQL, в которой хранятся внутренние данные системы, карточки и учетные записи пользователей: /opt/findface-multi/data/postgresql
Каталог /opt/findface-multi/data/findface-upload/uploads, в котором хранятся загруженные в карточки фотографии, видеофайлы, полные кадры событий, а также миниатюры объектов.
Каталог, в котором хранятся такие артефакты событий, как нормализованные изображения объектов /opt/findface-multi/data/findface-multi-legacy/uploads

Примечание

В данном каталоге также хранятся видеофрагменты, если в системе активирована функция Видеомагнитофон.
(Только вместе с Видеомагнитофоном) Хранилище базы данных на основе MongoDB /opt/findface-multi/data/mongodb/, в котором хранится метаинформация о видеофрагментах, включая их точное местоположение в хранилище /opt/findface-multi/data/findface-multi-legacy/uploads.

Галереи базы данных векторов признаков 

В базе данных векторов признаков на основе Tarantool по умолчанию есть следующие галереи:

ffsec_body_events: векторы признаков, извлеченные из обнаруженных на видео силуэтов.
ffsec_body_objects: векторы признаков, извлеченные из загруженных в картотеку изображений силуэтов.
ffsec_body_clusters: центроиды кластеров силуэтов.
ffsec_car_events: векторы признаков, извлеченные из обнаруженных на видео транспортных средств.
ffsec_car_objects: векторы признаков, извлеченные из загруженных в картотеку изображений транспортных средств.
ffsec_car_clusters: центроиды кластеров транспортных средств.
ffsec_face_events: векторы признаков, извлеченные из обнаруженных на видео лиц.
ffsec_face_objects: векторы признаков, извлеченные из загруженных в картотеку изображений лиц.
ffsec_face_clusters: центроиды кластеров лиц.
ffsec_user_face: векторы признаков, извлеченные из фотографий пользователей FindFace Multi для аутентификации по лицу.

Руководство пользователя

В этой главе описывается, как работать с веб-интерфейсом FindFace, включая его расширенные возможности. Данные сведения будут интересны администраторам, операторам и другим пользователям.

Приступая к работе

После успешного развертывания и конфигурирования FindFace Multi пришло время открыть веб-интерфейс и начать работу. В этой главе вы найдете рекомендуемую последовательность шагов, следуя которой вы сможете задействовать весь спектр функциональных возможностей FindFace Multi.

В этой главе:

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

Подготовка к работе 

Выполните первичную настройку системы:

Войдите в систему.
Выберите язык и темную или светлую тему.

Добавление камер 

Создайте новую группу камер или используйте созданную по умолчанию. Группа камер — это системная сущность, которая позволяет группировать камеры с учетом их физического расположения. К примеру, камеры, расположенные на входе в здание, можно объединить в одну группу и работать с ними как с единым целым.
Добавьте камеры в созданную группу и проверьте их работу.

Дополнительно:

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

Создание списков наблюдения и картотеки 

Создайте новый список наблюдения или используйте созданный по умолчанию. Список наблюдения — это системная сущность, с помощью которой выполняется классификация объектов (лиц, силуэтов, транспортных средств) по произвольным критериям, например, нежелательные посетители, розыск, VIP, персонал и т. д.
Загрузите карточки и добавьте их в созданный список наблюдения вручную, пакетно через веб-интерфейс или используя функцию пакетной загрузки через консоль.

Дополнительно:

Настройте содержимое карточки. Создайте дополнительные поля, вкладки и поисковые фильтры.

Мониторинг объектов 

По умолчанию FindFace Multi отслеживает только незарегистрированные в системе объекты, т. е. объекты, для которых отсутствуют совпадения с картотекой. Для того чтобы включить отслеживание объектов из списка наблюдения, сделайте его активным. Вы также можете включить звуковое оповещение и сделать обязательным принятие вручную связанных со списком событий.

Дополнительно:

Включите автоматическую кластеризацию объектов одного происхождения: изображений лица/силуэта, принадлежащих одному и тому же человеку, изображений одного транспортного средства.
Включите поддержку законов, связанных с обработкой персональных данных (GDPR и аналогичные). Подробнее.

Организация видеонаблюдения 

Настройте раскладку камер для базового видеонаблюдения.

Дополнительно:

Для расширения функции видеонаблюдения используйте Видеомагнитофон.

Подсчет людей и транспортных средств. Измерение расстояния между людьми 

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

Работа в штатном режиме 

Идентифицируйте обнаруженные на видеоизображении объекты, проверяя их в реальном времени на совпадение с объектами из списков наблюдения. Работайте с историей событий, используя различные фильтры.
Работайте с эпизодами. Эпизод — это набор событий идентификации, в которых фигурируют объекты одного происхождения (изображения лица и силуэта, принадлежащие одному человеку, и изображения одного транспортного средства), обнаруженные в течение определенного периода времени. Поскольку информация о событиях отображается на вкладке События в произвольном порядке, обработка большого количества разнородных событий может быть делом затруднительным и неэффективным. С функцией Эпизоды, система использует искусственный интеллект для группировки входящих событий на основе времени обнаружения и схожести объектов. Это позволяет с легкостью обрабатывать разнородные события даже в больших количествах.
Ищите объекты в базе обнаруженных объектов и картотеке. Подробнее.
Ищите в архивных видео объекты из списков наблюдения.
Сравнивайте объекты вручную, чтобы проверить их на совпадение.
Стройте детализированные отчеты на события распознавания объектов, эпизоды, события поиска, кластеры, камеры, картотеку, аудиторию или журнал действий пользователей.

Базовое обслуживание системы 

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

Больше возможностей 

Настройте вебхуки для автоматической отправки уведомлений об определенных событиях, эпизодах и записях счетчика на заданный URL-адрес. При наступлении нужного события FindFace Multi отправит HTTP-запрос на URL-адрес, указанный в настройках вебхука. Вебхуки можно использовать для решения разнообразных задач, например, для уведомления пользователя об определенном событии, вызова определенных действий на целевом веб-сайте, при решении задач безопасности, таких как удаленное автоматическое управление доступом и др. Подробнее.
Задействуйте функции FindFace Multi через HTTP API.

См.также

Основы веб-интерфейса

Работа с FindFace Multi выполняется через веб-интерфейс. Для того чтобы отобразить веб-интерфейс, в адресной строке браузера введите базовый адрес веб-интерфейса и пройдите авторизацию.

Примечание

Базовый адрес задается при установке FindFace Multi.

Важно

Для первого входа в систему после развертывания FindFace Multi используйте учетную запись администратора, созданную при установке. Для создания других пользователей см. раздел Управление пользователями.

Совет

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

Язык веб-интерфейса и тема

Для переключения языка веб-интерфейса и выбора темы нажмите на на верхней панели.

Картотека

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

Для одновременного создания большого количества карточек используйте функциональность пакетной загрузки через консоль.

В этом разделе:

Создание карточки
Пакетная загрузка карточек
Фильтрация карточек
Очистка картотеки

Создание карточки 

Для создания карточки вручную выполните следующие действия:

Перейдите на вкладку Картотека.
Нажмите + Новая карточка.
Введите название карточки. При необходимости добавьте комментарий.
Из раскрывающегося списка Списки наблюдения выберите список, в который нужно добавить карточку (или несколько списков, по очереди).
Поставьте флажок Карточка активна. Если карточка неактивна, она не будет использоваться для мониторинга.
Сохраните карточку. В результате в ней появятся дополнительные вкладки.
На той же вкладке Сведения прикрепите связанные файлы.
Для карточек «Люди» на вкладке Лица прикрепите фотографии лица человека, а на вкладке Силуэты прикрепите фотографии силуэта человека. Поддерживаемые форматы: WEBP, JPG, BMP, PNG, HEIC.
Для карточек «Транспортные средства» на вкладке Транспортные средства прикрепите соответствующие фотографии.

Пакетная загрузка карточек 

Для создания большого количества карточек используйте функциональность пакетной загрузки. Выполните следующие действия:

Перейдите на вкладку Картотека.
Нажмите + Новая карточка -> Попробуйте пакетную загрузку карточек.
Выберите файлы или папку и перетащите их для загрузки.
Введите имя. При необходимости добавьте комментарий.
Нажмите Начать.

Фильтрация карточек 

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

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

Тип карточки: отобразить карточки по выбранному типу (люди или транспортные средства).
Списки наблюдения: отобразить карточки, включенные в выбранные списки наблюдения.
Лица: отфильтровать карточки по присутствию биометрических данных лица человека.
Силуэты: отфильтровать карточки по присутствию биометрических данных силуэта человека.
Транспортные средства: отфильтровать карточки по присутствию данных о транспортном средстве.
Регистрационный номер: фильтровать карточки по регистрационному номеру.
Заполнение: отобразить только пустые карточки, только заполненные или любые.
Название cсодержит: фильтровать карточки по имени.
ID: отобразить карточку с определенным ID.
Статус: фильтровать карточки по статусу.

Вы можете отсортировать карточки в списке по параметру ID.

Очистка картотеки 

Вы можете очистить картотеку целиком или по спискам наблюдения одним щелчком мыши. Выполните следующие действия:

Перейдите Настройки -> Списки наблюдения.
Выберите один или несколько списков наблюдения.
Нажмите Удалить связанные карточки.

Источники видео

Для настройки видеомониторинга объектов добавьте камеры в FindFace Multi, сгруппировав их c учетом расположения.

Примечание

Права на создание групп камер и камер настраиваются в разрешениях пользователя (см. Управление ролями и пользователями).

В этой главе:

Создание группы камер
Добавление камеры
Параметры обработки видео
Загрузка и обработка видеофайла
Внешние детекторы
Мониторинг работы камер

Создание группы камер 

Совет

В системе доступна группа камер по умолчанию.

Для создания группы камер выполните следующие действия:

Перейдите на вкладку Настройки. Выберите Группы камер.
Нажмите + Новая группа камер.
На вкладке Сведения, введите имя группы и при необходимости комментарий к ней.
Если вам нужно выделить определенный экземпляр findface-video-worker для обработки видеопотоков с данной группы камер, создайте или выберите из уже созданных одну или несколько меток.

Примечание

Для того чтобы завершить выделение, перечислите метки в файле конфигурации findface-video-worker.yaml. Подробнее см. Привязка группы камер к экземпляру findface-video-worker.
Если события от камер, принадлежащих одной группе, требуется дедуплицировать, т. е. исключить одинаковые события, поставьте флажок Убрать дубли событий с интервалом и задайте в секундах интервал дедупликации (интервал, с которым события проверяются на уникальность).

Предупреждение

Используйте дедупликацию очень осторожно. Если камеры из одной группы наблюдают разные сцены, некоторые объекты могут быть пропущены. Подробнее см. Дедупликация событий.
По умолчанию на всех группах камер в системе используется универсальный порог срабатывания. Для того чтобы установить индивидуальный порог для группы камер, поставьте флажок Порог срабатывания и укажите нужное пороговое значение.

Важно

Для большинства случаев распознавания лиц значение, установленное по умолчанию для универсального порога срабатывания, является оптимальным. Не рекомендуется самостоятельно менять его. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).
Нажмите Сохранить.
На вкладке Права доступа назначьте права на работу с группой камер, указав, пользователям с какими ролями разрешено изменять/просматривать ее настройки.
Нажмите Сохранить.

Добавление камеры 

Для добавления камеры выполните следующие действия:

Перейдите на вкладку Источники видео → Камеры.
Нажмите + Добавить камеры или + Добавить.
На вкладке Устройства введите URL потока и нажмите Дальше.
- Укажите название камеры.
- Добавьте камеру в группу.
- Поставьте флажки для тех детекторов, которые нужно активировать для данной камеры: лица, силуэты, транспортные средства.
- Нажмите Добавить и настроить. Вы увидите, как появятся дополнительные вкладки.
Нажмите на камеру в списке, чтобы открыть мастер настройки обработки. Настройте параметры обработки видео.
Если вы используете камеру ONVIF, выберите ее из списка обнаруженных устройств для автоматической загрузки доступных настроек и видеопотоков.

Параметры обработки видео 

Для каждой камеры предоставляется полная статистика: продолжительность текущей сессии обработки, количество отправленных объектов, количество объектов, обработанных с ошибками после последнего перезапуска job-задания, количество пропущенных кадров и другие данные. Для просмотра этих данных нажмите на камеру и перейдите на вкладку Сведения.
На вкладке Основные вы можете изменить имя камеры, группу камер и описание. Вы можете записать видео и включить liveness (витальность). Поставьте флажки для тех детекторов, которые нужно активировать для данной камеры: лица, силуэты, транспортные средства.
На вкладке Дополнительные выполните тонкую настройку камеры:
- При необходимости измените ориентацию видео.
  
  Важно
  
  Вращение потока выполняется на стороне сервера findface-multi-legacy средствами постобработки. Это может негативно сказаться на производительности. Рекомендуем по возможности делать вращение потока на стороне камеры.
- Таймаут: Время ожидания в миллисекундах отправки на сервер обнаруженных объектов.
- Проверить SSL-сертификат: Поставьте флажок, чтобы включить проверку подписи SSL-сертификата при взаимодействии по https видеодетектора объектов с сервером. Снимите флажок, если вы используете самоподписанный сертификат.
- Получать метки времени из потока: Поставьте флажок, чтобы отправлять на сервер временные метки, полученные из потока. Снимите флажок, чтобы отправлять текущие дату и время.
- Добавить к временным меткам: Прибавлять указанное количество секунд к временным меткам из потока.
- Параметры FFMPEG: Параметры FFmpeg для видеопотока. Задаются массивом строк ключ=значение, например, [“rtsp_transpotr=tcp”, “ss=00:20:00”].
- Ограничение скорости воспроизведения: Если меньше нуля, то скорость не ограничивается, в остальных случаях поток читается с заданной скоростью play_speed. Не применимо для потоков с камер видеонаблюдения.
- Формат ввода: Передать формат FFmpeg (mxg, flv, и т. д.), если он не может быть автоматически определен.
- Минимальная интенсивность движения: Минимальная интенсивность движения, которая будет регистрироваться детектором движения.
- Считывание кадров источника без пропусков: По умолчанию (false), если findface-video-worker не обладает достаточными ресурсами для обработки всех кадров с объектами, он будет пропускать некоторые из них. Если данная опция активна (true), findface-video-worker помещает лишние кадры в очередь, чтобы обработать из впоследствии. При обработке файлов как камер необходимо указать значение true.
- Обработать поток один раз до конца или до первой ошибки (single_pass): Если true, то не перезапускать обработку потока при обнаружении ошибки.
- URL роутера (router_url): IP адрес для отправки обнаруженных объектов во внешние видеообработчики из findface-video-worker. По умолчанию 'http://127.0.0.1'.
Укажите область отслеживания (Зоны) в поле зрения камеры и область интереса. Нажмите Сохранить.

Область отслеживания позволяет обнаруживать и отслеживать лица/силуэты и транспортные средства только внутри заданного прямоугольника. Используйте данную опцию, чтобы уменьшить нагрузку на видеодетектор объектов. Область интереса позволяет отправлять на сервер только объекты, обнаруженные в ее пределах.
На вкладках Лица, Силуэты и ТC укажите настройки детектора объектов каждого типа.
- Размер: Минимальный и максимальный размер отправляемых объектов, в пикселях.
- Качество: Минимальное пороговое значение качества изображения лица. Допустимый диапазон от 0 до 1. Базовое рекомендуемое значение 0,45 — соответствует удовлетворительному качеству изображения лица. Не меняйте значение по умолчанию без предварительной консультации с нашими техническими экспертами (support@ntechlab.com).
- Качество JPEG: Качество сжатия полного кадра для отправки.
- Полный кадр PNG: Отправлять полные кадры в формате PNG, а не в формате JPEG, как установлено по умолчанию. Не включайте этот параметр, не посоветовавшись с нашей командой, так как он может повлиять на работу всей системы.
- Коэффициент перекрытия границ распознанного объекта: Процент перекрытия границ между двумя последовательными кадрами, чтобы эти bbox’ы считались одним треком. Диапазон значений: от 0 до 1. Не меняйте значение по умолчанию без предварительной консультации с нашими техническими экспертами (support@ntechlab.com).
- Максимальная длительность трека: Максимальное приблизительное количество кадров в треке, по достижении которого трек будет принудительно закрыт. Включите опцию, чтобы автоматически завершать вечные треки, например, треки детектирования лиц с рекламных носителей.
- Интервал закрытия трека: Завершить трек, если в нем не было распознано новых изображений объекта в течение заданного времени (в секундах).
- Отправить историю трека: Отправлять массив координат границ объекта вместе с событием. Может быть применено для внешних интеграций, чтобы отобразить путь объекта.
- Обрезать полный кадр: Поставьте флажок если необходимо обрезать полный кадр по размеру ROT-области перед отправкой на распознавание. Размер полного кадра будет равен размеру ROT-области.
- Буферный режим: По умолчанию для обработки видео система использует буферный режим, т.е. отправляет по одному кадру наилучшего качества на трек для экономии места на диске. Отключите данный режим, чтобы получать больше кадров лица, если это необходимо. Если буферный режим включен, параметры режима реального времени не работают.
Параметры режима реального времени:

Примечание

Эти параметры не работают, если включен буферный режим.
- Интервал: Временной интервал в секундах (целое или десятичное число), в течение которого в режиме реального времени выбирается лучший кадр с объектом.
- Отправлять первый распознанный объект немедленно: Поставьте флажок, чтобы отправлять первый объект из трека сразу, как только фильтры по качеству/размеру/региону интереса пройдены, не дожидаясь окончания первого realtime_post_interval в режиме реального времени. Снимите флажок, чтобы отправлять первый объект из трека только после окончания первого realtime_post_interval.
- Отправлять первый кадр трека: При завершении трека в дополнение к overall-кадру трека будет дополнительно отправлен первый кадр трека. Может быть применимо для внешних интеграций.
- Отправлять в каждом интервале: Поставьте флажок, чтобы отправлять лучший кадр в каждом временном realtime_post_interval в режиме реального времени. Снимите флажок, чтобы отправлять лучший кадр, только если его качество улучшилось по сравнению с предыдущим отправленным кадром.
- Отправлять последний кадр трека: При завершении трека в дополнение к overall-кадру трека будет дополнительно отправлен последний кадр трека. Может быть применимо для внешних интеграций.
- Порог срабатывания: Порог срабатывания применяется для сопоставления обнаруженного объекта с объектом внутренней сущности.
(Опционально) На вкладке Геопозиция укажите географические координаты камеры.

Отключенная по умолчанию вкладка Настройки очистки VMS содержит настройки очистки видео для отдельной камеры. Следуйте инструкции Включение настроек очистки VMS в веб-интерфейсе, чтобы добавить вкладку.

Пользовательские настройки очистки VMS переопределяют глобальные настройки для отдельной камеры. Доступны следующие пользовательские настройки очистки VMS:

Удалять интервалы между треками
- Включить индивидуальные настройки: включить индивидуальные настройки удаления интервалов между треками. По умолчанию используются глобальные настройки.
- Удалять интервалы между треками: удалять промежутки видео между треками, не содержащие событий распознавания.
- Сохранять события: сохранять события для выбранного объекта (лица, силуэта, транспортного средства).
- Добавить отступы к треку: промежуток видео в секундах до и после трека с событиями, который добавляется к треку.
- Порог очистки: минимальный промежуток между треками в секундах. Если промежуток между треками ниже порога, видео не будет удалено. Минимальное значение для это поля — 360 секунд.
- Удалять интервалы между треками через: временной период (в днях), в течение которого хранится весь видеоархив. По истечении этого периода начнется очистка интервалов между треками так, как она задана в настройках. Значение может быть больше либо равно нулю.
Очищать архив
- Включить индивидуальные настройки: включить индивидуальные настройки очистки архива. По умолчанию используются глобальные настройки.
- Очищать архив: включить очищение всего видеоархива.
- Удалять данные старше: количество дней, в течение которых видеоархив хранится в системе. По истечении этого срока видеоархив удаляется.
Нажмите на Показать глобальные настройки, чтобы увидеть глобальные настройки очистки VMS.

См.также

Глобальные настройки очистки VMS

Загрузка и обработка видеофайла 

Для того чтобы загрузить и обработать видеозапись, выполните следующие действия:

Перейдите на вкладку Источники видео → Загрузки.
Нажмите + Загрузить файлы или + Загрузить.
Укажите URL или выберите файл. Нажмите Загрузка.
Назначьте группу камер, к которой система будет приписывать события с объектами из данного видео. Группа камер Video archive default Camera Group идеально подходит для этой задачи. Вы также можете создать новую группу камер с базовыми настройками специально для данного видео. Поставьте флажки для тех детекторов, которые нужно активировать для данного видео: лица, силуэты, транспортные средства.

Нажмите Добавить и настроить. В результате видеозапись будет загружена и добавлена в список.
Нажмите на видео в списке, чтобы открыть мастер настройки обработки. Настройте параметры обработки видео аналогичным образом, как и для камер.
- (Опционально) Выберите камеру в составе группы, чтобы более точно промаркировать события распознавания объектов из этого видео.
- (Опционально) Настройте метки времени для событий распознавания объектов.
В списке загрузок видео нажмите три точки → Обработать текущий, чтобы запустить идентификацию объектов. Вы можете просмотреть события идентификации объектов на вкладках События и Эпизоды, отфильтровав список событий по группе камер/ камере, ассоциированной с видео.

Внешние детекторы 

Вы также можете использовать объект типа камера для интеграции внешнего детектора.

При необходимости измените имя внешнего детектора. Укажите исходную группу камер и описание. При необходимости включите liveness.

Мониторинг работы камер 

Мониторинг работы камер выполняется на вкладке Камеры.

Статусы камер:

Зеленый: идет обработка видеопотока с камеры, проблем не обнаружено.
Желтый: камера работает менее 30 секунд или имеют место одна или несколько ошибок при отправке объектов.
Красный: камера не работает.
Серый: камера отключена.

Совет

Вы можете настроить отображение желтого и красного статусов на основании доли пропущенных кадров и доли неудачных отправок объектов на сервер. Для этого измените следующие параметры в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
   ...

   # max camera frames_dropped percent
   'MAX_CAMERA_DROPPED_FRAMES': {'yellow': 0.1, 'red': 0.3},
   # max camera objects failed percent
   'MAX_CAMERA_FAILED_OBJECTS': {'yellow': 0.1, 'red': 0.3},

   ...
   }

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Каждая камера связана с так называемым job-заданием, задачей на обработку видео, содержащей параметры конфигурации и данные видеопотока, которая назначается определенному экземпляру findface-video-worker. Данная задача может быть перезапущена.

Для перезапуска job-задания откройте настройки камеры и нажмите на кнопку Перезапустить. При этом количество ошибок будет обнулено.

При большом количестве камер в системе используйте следующие фильтры:

Название содержит,
Группы камер,
Статус функционирования (Любой / Активные / Неактивные),
Статус рабочего состояния (Любой / Серый / Зеленый / Красный / Желтый).

Пересечение линий

В этом разделе:

Настройка источников видео
Создание пересечения линий
Фильтрация пересечений линий
Мониторинг эпизодов и событий пересечения линий

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

Кроме того, функция пересечения линий позволяет собирать данные для последующего анализа потока посетителей в аналитическом сервисе BI и решать следующие задачи:

Контроль периметра и проникновения в зоны ограниченного доступа:
- проход/проезд в запрещенные зоны
- пересечение линии в запрещенном направлении
Маркетинговая аналитика – аналитика количества людей или автомобилей, пересекших линию в заданном направлении (в магазине/на парковке/на остановке общественного транспорта/при посещении парков и общественных мест). Например:
- анализ потока посетителей и определения наиболее популярных зон внутри магазина
- анализ нагрузки на транспортную сеть в зависимости от дня недели и времени суток и др.

Настройка источников видео 

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

Перейдите на вкладку Источники видео.
Нажмите на камеру или загруженное видео в списке, чтобы открыть мастер настройки обработки.
Перейдите на вкладку Лица, Силуэты или ТС в зависимости от выбранных детекторов.
Поставьте флажок Отправлять историю трека.
Установите для параметра Максимальная длительность трека значение, большее 1 (рекомендуемое значение 1000).
Нажмите Сохранить.

Совет

Если в видеопотоке много объектов, и они периодически начинают друг друга загораживать, из-за чего некоторые пересечения линий могут не быть зафиксированы, то можно повысить Коэффициент перекрытия границ распознанного объекта в настройках камеры для нужного детектора.

Совет

Если объекты находятся на достаточно дальнем расстоянии, и плохо или совсем не распознаются, то можно уменьшить значение min_size в файле findface-video-worker.yaml для нужного детектора, к примеру на значения 32 или 16.

sudo vi /opt/findface-multi/configs/findface-video-worker/findface-video-worker.yaml

...
models:
  cache_dir: /var/cache/findface/models_cache
  detectors:
    body:
      fnk_path: /usr/share/findface-data/models/detector/body.jasmine_fast.018.cpu.fnk
      min_size: 60
    face:
      fnk_path: /usr/share/findface-data/models/detector/face.jasmine_fast.003.cpu.fnk
      min_size: 60
    car:
      fnk_path: /usr/share/findface-data/models/detector/car.gustav_normal.004.cpu.fnk
      min_size: 60
...

Важно

При уменьшении значения min_size возрастает нагрузка на ресурсы сервера.

Создание пересечения линий 

Для создания пересечения линий, выполните следующие действия:

Перейдите на вкладку Пересечение линий.
Нажмите Создать линию.
На вкладке Сведения введите название линии. При необходимости добавьте описание.
Поставьте флажок Активность.
Укажите источник данных. На вкладке Камера или Видео выберите группу камер и камеру или видеоархив соответственно.
Задайте точку пересечения линии bbox’ом.
На вкладке Линия отметьте линию.
На вкладке BI Аналитика задайте атрибуты линии для Аналитического сервиса BI, при необходимости.
Нажмите Сохранить.
Вы увидите свой список линий на вкладке Пересечение линий.
Для каждого пересечения линии можно выполнить следующие действия, нажав на три точки:
- Отфильтровать события
- Деактивировать
- Удалить

Фильтрация пересечений линий 

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

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

Название содержит: отфильтровать линии по названию.
ID: отобразить пересечения линии с определенным ID.
Статус: отфильтровать пересечения линии по статусу.
Группа камер: отобразить пересечения линии по определенной группе камер.
Камеры: отобразить пересечения линии по определенной камере.
Видеоархив: отобразить пересечения линии по выбранному видеоархиву.

Для того чтобы построить отчет, нажмите Применить и создать отчет.

Мониторинг эпизодов и событий пересечения линий 

Для мониторинга эпизодов и событий пересечения линий перейдите на вкладку Эпизоды и события. Нажмите Эпизоды или События.

Вы можете перейти непосредственно на вкладку События, нажав три точки → Отфильтровать события с лицами/Отфильтровать события с силуэтами/Отфильтровать события с ТС в списке линий.

В карточке эпизода указываются пересечения, которые были во всех его событиях (AB или BA).

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

На полном кадре эпизода с пересечением линии отображается лучшее событие эпизода с bbox’ом объекта, а линия с треком отображаются из события, в котором произошло пересечение. Синим цветом показано начало трека, а красным – окончание трека. Если в эпизоде есть несколько событий с пересечением, то линия и трек будут отображаться из первого события с пересечением в эпизоде.

События и эпизоды распознавания объектов

Чтобы отслеживать результат работы системы по части идентификации объектов на видеоизображении в режиме реального времени перейдите на вкладку Эпизоды и События и используйте далее вкладки События и Эпизоды. Помимо работы с текущими событиями идентификации, данные вкладки также предоставляют доступ к истории событий.

Совет

Для идентификации объектов в архивных видео см. Загрузка и обработка видеофайла.

Работа с событиями

Данный раздел посвящен вкладке События.

Важно

Вы можете включить звуковые уведомления для событий, связанных с конкретными списками наблюдения. В некоторых браузерах для того чтобы воспроизводился звук, вкладка с событиями должна оставаться в фокусе. Чтобы выделить вкладку, откройте ее и щелкните в любом месте страницы.

В этой главе:

Просмотр событий
Карточка события. Принятие события
Карточка события. Поиск объекта
Создание или обогащение карточки из события
Отчеты о рабочем времени по событиям

Просмотр событий 

Как только объект будет обнаружен, вы увидите уведомление в одном из списков событий: Лица, Силуэты или Транспортные средства, в зависимости от типа объекта.

Уведомление может содержать разную информацию в зависимости от того, есть ли совпадение обнаруженного объекта с картотекой:

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

Важно

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

К событиям (уведомлениям) в списке можно применить следующие фильтры:

Примечание

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

Объект: отображать события только для лиц, силуэтов или транспортных средств.
Совпадения: отображать только события с совпадением объектов/без совпадения объектов или все события.
Списки наблюдения: отображать только события по определенному списку наблюдения.
Подтверждено: отображать только подтвержденные/неподтвержденные или все события.
Группы камер: отображать только события по определенной группе камер.
Камеры: отображать только события по определенной камере.
Дата и время: отображать только события, случившиеся в определенный период времени.
ID видеоархива: отобразить события из видеоархива с определенным ID.
Имя карточки: отобразить события с заданным именем карточки.
ID эпизода: отобразить события из эпизода с определенным ID.
ID события: отобразить событие с определенным ID.
Лучший кадр события: отображать все события трека, только события с кадрами в реальном времени, только одно событие с лучшим кадром по окончанию трека.
Линия: отображать события по определенной линии.
Направление пересечения линии: фильтровать события по направлению пересечения линии, любое, A → B, B → A.
Есть обратное пересечение: фильтровать события по наличию/отсутствию обратного пересечения.

Специальные фильтры для лиц

Возраст: отобразить события с людьми определенного возраста.
Борода: фильтровать события по наличию бороды.
Эмоции: отобразить события с заданными эмоциями.
Пол: отобразить события с людьми заданного пола.
Очки: фильтровать события по наличию очков на лице.
Витальность: фильтровать события по liveness лица.
Медицинская маска: фильтровать события по наличию медицинской маски.
Поворот: фильтровать события по углу поворота головы.
Наклон: фильтровать события по углу наклона головы.

Специальные фильтры для силуэтов

Пол по силуэту: отобразить события с людьми заданного пола.
Возраст по силуэту: отобразить события с людьми определенного возраста.
Головной убор: отображать только события с людьми в головном уборе заданного типа: шапка/шляпа/кепка, капюшон/платок, без головного убора.
Жилет: отображать только события с людьми, одетыми в жилет заданного цвета.
Каска: отображать только события с людьми, одетыми в каску заданного цвета.
Цвет верха одежды: отображать только события с людьми, одетыми в одежду заданного цвета (верх).
Цвет низа одежды: отображать только события с людьми, одетыми в одежду заданного цвета (низ).
Тип верха одежды: отображать только те события, в которых человек носит одежду верха заданного типа: куртка, пальто, жилет, толстовка, футболка, рубашка, платье.
Низ одежды: отображать только те события, в которых человек носит одежду низа заданного типа: брюки, юбка, шорты, неопределенный.
Верх одежды: отображать только те события, в которых человек носит одежду верха заданной обобщенной категории: с длинными рукавами, с короткими рукавами, без рукавов.
Сумка на спине: отображать только события с людьми с сумкой на спине/без сумки на спине.
Сумка в руке: отображать только события с людьми с сумкой в руке/без сумки в руке.

Специальные фильтры для транспортных средств

Марка: фильтровать события по марке транспортного средства.
Модель: фильтровать события по модели транспортного средства.
Тип кузова: отобразить события с транспортными средствами заданного типа кузова.
Цвет кузова: отобразить события с транспортными средствами заданного цвета кузова.
Страна: отобразить события с транспортными средствами, зарегистрированными в заданной стране.
Регистрационный номер: найти транспортное средство с заданным номером.
Регион: отобразить события с транспортными средствами, зарегистрированными в заданном регионе.
Цвет номера: отобразить события с заданным цветом регистрационного номера транспортного средства.
Спецтранспорт: отображать только события с транспортными средствами, принадлежащими заданному типу: полиция, автомобили МЧС и пожарные машины, газоспасательные и аварийно-спасательные службы, скорая помощь, военная техника, коммунальная, строительная техника, прочие.
Категория ТС: отображать только события с транспортными средствами, принадлежащими заданной категории: мотоцикл, скутер, легковой автомобиль с прицепом, грузовик, грузовик с прицепом, автобус, сочлененный автобус и прочие.
Вес и размер ТС: отобразить события с транспортными средствами заданного веса и размера кузова.
Ракурс ТС: отобразить события с транспортными средствами заданного ракурса (спереди, сзади, сбоку).

Примечание

Регион и цвет регистрационного знака определяются только для Объединенных Арабских Эмиратов (ОАЭ). Для других стран значения этих атрибутов будут выводиться как неизвестные в результатах распознавания.

Карточка события. Принятие события 

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

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

Совет

Если у обнаруженного объекта есть совпадения по картотеке, в соответствующую карточку можно перейти, щелкнув по имени в карточке события.

Совет

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

Примечание

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

Карточка события. Поиск объекта 

FindFace Multi позволяет искать обнаруженные объекты в списке событий и в картотеке. Для перехода на вкладку поиска из карточки события нажмите Поиск.

См.также

Поиск объектов в системе

Создание или обогащение карточки из события 

Можно обогатить карточку фотографией обнаруженного объекта, либо создать новую карточку из события.

В режиме подробной информации о событии щелкните на Использовать для карточки. Если обнаруженный объект имеет совпадение с картотекой, вы можете либо создать новую карточку из данного события, либо добавить фотографию обнаруженного объекта к существующей карточке.

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

Отчеты о рабочем времени по событиям 

См. Отчеты.

Эпизоды событий

Данный раздел посвящен вкладке Эпизоды.

См.также

Работа с событиями

Эпизод — это набор событий идентификации, в которых фигурируют объекты одного происхождения (изображения лица и силуэта одного и того же человека и изображения одного и того же транспортного средства), обнаруженные в течение определенного периода времени. Поскольку события на вкладке События отображаются в произвольном порядке, обработка большого количества разнородных событий может быть делом затруднительным и неэффективным. Функция эпизодов позволяет автоматически объединять входящие события на основе времени обнаружения и схожести объектов. Это позволяет с легкостью обрабатывать разнородные события даже в больших количествах.

В этой главе:

Об эпизодах
Назначение прав на эпизоды
Просмотр эпизодов
Принятие события и эпизода
Параметры эпизода

Об эпизодах 

В жизненном цикле эпизода существует два этапа:

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

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

Назначение прав на эпизоды 

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

Право на событие состоит из прав на соответствующие камеру и список наблюдения.

Примечание

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

Для управления правами на объект Эпизод перейдите в разрешения для соответствующей роли и настройте следующие разрешения:

humanepisode: эпизоды с людьми
carepisode: эпизоды с транспортными средствами

Совет

См. Управление ролями и пользователями.

Просмотр эпизодов 

Вы можете найти список эпизодов с фильтрами и статистикой на вкладке Эпизоды. Эпизоды сортируются по происхождению объекта: есть эпизоды с людьми и эпизоды с транспортными средствами.

Событие обнаружения объекта либо добавляется в существующий LIVE-эпизод, либо инициирует создание нового эпизода. Каждому эпизоду присваивается id, который впоследствии можно использовать для фильтрации событий и эпизодов.

К эпизодам в списке можно применить следующие фильтры:

Примечание

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

Объект: отобразить только эпизоды с людьми или только эпизоды с транспортными средствами.
Совпадения: лица: отобразить только эпизоды с совпадением лиц/без совпадения лиц/все эпизоды.
Совпадения: силуэты: отобразить только эпизоды с совпадением силуэтов/без совпадения силуэтов/все эпизоды.
Совпадения: отобразить только эпизоды с совпадением транспортных средств/без совпадения транспортных средств/все эпизоды.
Списки наблюдения: отобразить только эпизоды по определенному списку наблюдения.
Подтверждено: отобразить только подтвержденные/неподтвержденные или все эпизоды.
Группы камер: отобразить только эпизоды по определенной группе камер.
Камеры: отобразить только эпизоды по определенной камере.
Дата и время: отобразить только эпизоды, случившиеся в определенный период времени.
ID видеоархива: отобразить эпизоды из видеоархива с определенным ID.
Имя карточки: отобразить эпизоды с заданным именем карточки.
ID эпизода: отобразить эпизод с определенным ID.
Количество событий: отобразить эпизоды с заданным количеством событий.

Специальные фильтры для эпизодов с лицами

Возраст: отобразить эпизоды с людьми определенного возраста.
Борода: фильтровать эпизоды по наличию бороды.
Эмоции: отобразить эпизоды с заданными эмоциями.
Пол: отобразить эпизоды с людьми заданного пола.
Очки: фильтровать эпизоды по наличию очков на лице.
Витальность: фильтровать эпизоды по liveness лица (истинное лицо или изображение).
Медицинская маска: фильтровать эпизоды по наличию медицинской маски.

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

Пол по силуэту: отобразить эпизоды с людьми заданного пола.
Возраст по силуэту: отобразить эпизоды с людьми определенного возраста.
Головной убор: отобразить только эпизоды с людьми в головном уборе заданного типа: шапка/шляпа/кепка, капюшон/платок, без головного убора.
Жилет: отобразить только эпизоды с людьми, одетыми в жилет заданного цвета.
Жилет. Точность распознавания: отобразить только эпизоды с людьми, одетыми в жилет с заданной точностью.
Каска: отобразить только эпизоды с людьми в каске заданного цвета.
Каска. Точность распознавания: отобразить только эпизоды с людьми в каске с заданной точностью распознавания.
Цвет верха одежды: отобразить только эпизоды с людьми, одетыми в одежду заданного цвета (верх).
Цвет низа одежды: отобразить только эпизоды с людьми, одетыми в одежду заданного цвета (низ).
Тип верха одежды: отобразить только те эпизоды, в которых человек носит одежду верха заданного типа: куртка, пальто, безрукавка, толстовка, футболка, рубашка, платье.
Низ одежды: отобразить только те эпизоды, в которых человек носит одежду низа заданного типа: брюки, юбка, шорты, неопределенный.
Верх одежды: отобразить только те эпизоды, в которых человек носит одежду верха заданной обобщенной категории: с длинными рукавами, с короткими рукавами, без рукавов.
Сумка на спине: отображать только эпизоды с людьми с сумкой на спине/без сумки на спине.
Сумка в руке: отображать только эпизоды с людьми с сумкой в руке/без сумки в руке.

Специальные фильтры для эпизодов с транспортными средствами

Марка: фильтровать эпизоды по марке транспортного средства.
Модель: фильтровать эпизоды по модели транспортного средства.
Тип кузова: отобразить эпизоды с транспортными средствами заданного типа кузова (минивэн, лимузин и др.).
Цвет кузова: отобразить эпизоды с транспортными средствами заданного цвета кузова.
Страна: отобразить эпизоды с транспортными средствами, зарегистрированными в заданной стране.
Регистрационный номер: найти эпизод с заданным номером транспортного средства.
Регион: отобразить эпизоды с автомобилями, зарегистрированными в заданном регионе.
Цвет номера: отобразить эпизоды с заданным цветом регистрационного номера транспортного средства.
Спецтранспорт: отображать только эпизоды с транспортными средствами, принадлежащими заданному типу: такси, маршрутный транспорт, каршеринг, скорая помощь, полиция, автомобили МЧС и пожарные машины, газоспасательные и аварийно-спасательные службы, военная техника, коммунальная, строительная техника, прочие.
Категория ТС: отображать только эпизоды с транспортными средствами, принадлежащими заданной категории: мотоцикл, скутер, легковой автомобиль с прицепом, грузовик, грузовик с прицепом, автобус, сочлененный автобус, прочие.
Вес и размер ТС: отобразить эпизоды с транспортными средствами заданного веса и размера кузова.

Примечание

Регион и цвет регистрационного знака определяются только для Объединенных Арабских Эмиратов (ОАЭ). Для других стран значения этих атрибутов будут выводиться как неизвестные в результатах распознавания.

Для просмотра событий эпизода щелкните по нужному эпизоду в списке. Вы будете переправлены на вкладку Эпизод с совпадением или Эпизод без совпадения со сведениями об эпизоде и связанными событиями.

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

Принятие события и эпизода 

Для того чтобы подтвердить эпизод целиком, нажмите Принять в списке эпизодов. В результате все события в эпизоде будут автоматически подтверждены, включая события, которые еще не добавлены (в случае эпизода LIVE).

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

Параметры эпизода 

Для настройки эпизодов вам понадобится файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py . Найдите следующие параметры в секции FFSECURITY:

FACE_EPISODES_THRESHOLD, BODY_EPISODES_THRESHOLD, CAR_EPISODES_THRESHOLD: пороговые значения схожести, которые система использует при поиске недавних событий для формирования эпизода. По умолчанию установлены оптимальные значения. При необходимости вы можете изменить их. Обязательно предварительно проконсультируйтесь с нашими техническими специалистами (support@ntechlab.com).
FACE_EPISODE_SEARCH_INTERVAL, BODY_EPISODE_SEARCH_INTERVAL, CAR_EPISODE_SEARCH_INTERVAL: период, предшествующий событию, за который система ищет уже существующие события с похожими объектами в базе данных вектора признаков. Если такое событие не найдено, система создает новый эпизод. В противном случае она сортирует 100 самых последних похожих объектов и выбирает наиболее подходящее событие из эпизода LIVE.
EPISODE_MAX_DURATION: максимальная продолжительность эпизода в секундах. По истечении этого времени эпизод автоматически закрывается.
EPISODE_EVENT_TIMEOUT: максимальное время в секундах с момента добавления последнего события в эпизод. По истечении этого времени эпизод автоматически закрывается.
EPISODE_KEEP_ONLY_BEST_EVENT: при закрытии эпизода, удалять в нем все события, за исключением события с лучшим объектом. Использование данной опции помогает экономить дисковое пространство.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...

FFSECURITY = {
      ...

      # episodes specific matching threshold that is used to join faces in an episode
      'FACE_EPISODES_THRESHOLD': 0.673,  # FAR = 1.00E-06  # model: [mango_320]
      'BODY_EPISODES_THRESHOLD': 0.75,  # model: [durga]
      'CAR_EPISODES_THRESHOLD': 0.61,  # model: [bottas]
      ...
      # when closing episode, delete all events except the best episode event
      'EPISODE_KEEP_ONLY_BEST_EVENT': False,
      # delete episode events after delay in seconds
      'EPISODE_DELETE_EVENTS_DELAY': 60,
      ...
      # maximum event age in seconds than could be added to an episode.
      'FACE_EPISODE_SEARCH_INTERVAL': 60,
      'BODY_EPISODE_SEARCH_INTERVAL': 60,
      'CAR_EPISODE_SEARCH_INTERVAL': 60,
      # maximum episode duration (episode is closed after)
      'EPISODE_MAX_DURATION': 300,
      # if no new event added to an episode during this timeout, episode will be closed.
      'EPISODE_EVENT_TIMEOUT': 30,
      ...
}

...

Перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Поиск объектов в системе

FindFace Multi позволяет выполнять поиск объектов по всей системе.

Для того чтобы найти человека, выполните следующие действия:

Перейдите на вкладку Поиск.
Задайте искомый объект одним из следующих способов:
- задав URL или ID события
- задав URL или ID карточки
- задав URL или ID кластера
- загрузив фотографию
В случае если вы указали URL карточки, выберите из нее фотографию. Если в карточке несколько фотографий, вы можете выбрать некоторые или все из них. Нажмите на кнопку Применить. При выборе нескольких объектов из карточки диапазон поиска сужается. В результаты поиска попадут только те объекты, которые похожи на объекты на выбранных фотографиях и находятся в пределах заданного порога поиска.
В случае если была загружена фотография, вы увидите ее в новом окне. Если на фотографии присутствует несколько объектов, выберите нужное. Нажмите на кнопку Поиск.
Вы увидите результаты поиска. При необходимости можно сузить область поиска, указав список наблюдения, порог сходства и т. д.

Сравнение двух объектов

FindFace Multi позволяет сравнить два объекта и убедиться, что они совпадают. Выполните следующие действия:

Перейдите на вкладку Сравнение.
Укажите два объекта для проверки одним из следующих способов:
- задав URL события
- загрузив фотографию
Если на изображении несколько объектов, выберите тот, который вас интересует.
В результате будет отображена степень схожести между ними.

Счетчики лиц, силуэтов и транспортных средств. Определение дистанции

Важно

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

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

Метод подсчета основан на временных срезах. Это означает, что счетчик считает лица, силуэты и транспортные средства на статических скриншотах, которые делаются с заданным интервалом.

Вы можете вести подсчет лиц/силуэтов/транспортных средств на каждой отдельной камере или же совместно на всех выбранных камерах.

В этом разделе:

Создание счетчика
Калибровка счетчика для определения дистанции
Мониторинг работы счетчиков
Работа с записями счетчика
Настройка вебхука для счетчика
Настройка счетчиков

Создание счетчика 

Для создания счетчика выполните следующие действия:

Перейдите на вкладку Счетчики.
Нажмите + Новый счетчик.
Укажите название счетчика.
Выберите одну или несколько групп камер для подсчета.
Выберите одну или несколько камер для подсчета.
Установите флажок Лица для подсчета лиц.
Установите флажок Силуэты для подсчета силуэтов. Детектирование силуэтов должно быть включено.
Установите флажок Транспортные средства для подсчета транспортных средств. Детектирование транспортных средств должно быть включено.
Задайте интервал в секундах между двумя последовательными скриншотами, используемыми для подсчета лиц/силуэтов/транспортных средств.
Нажмите Сохранить.
Установите флажок Определение дистанции для измерения расстояния между силуэтами. Данный флажок доступен в том случае, если установлен флажок Силуэты.
Убедитесь, что для счетчика установлен флажок Активен.
Нажмите Сохранить.
(Опционально) Перейдите на вкладку ROI, чтобы задать регион отслеживания лиц/силуэтов/транспортных средств в поле зрения камер(ы). Нажмите Сохранить.

Калибровка счетчика для определения дистанции 

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

Для калибровки счетчика:

Попросите человека встать перед выбранной камерой в полный рост.
Попросите пройти по зоне, фиксируемой камерой, по которой в дальнейшем будут рассчитываться расстояния. Для достижения наилучшего качества человек должен ходить по ровной поверхности.
Введите период калибровки счетчика (от 15 до 300 секунд) и нажмите Откалибровать счетчик.

Если нужно откалибровать счетчик для нескольких камер, выполните шаги 1-3 для каждой камеры, выбранной в поле Камеры.

Если результат калибровки вас не удовлетворил, нажмите Удалить калибровку и выполните калибровку еще раз.

Мониторинг работы счетчиков 

Мониторинг работы счетчиков выполняется на вкладке Счетчики.

Статусы счетчиков:

Зеленый: счетчик работает без ошибок, были получены все кадры со всех камер счетчика за определенный период.
Желтый: количество ошибок менее 70%.
Красный: количество ошибок более 70%.
Серый: счетчик отключен.

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

Выбрав счетчик, вы можете отфильтровать список кадров и оставить только кадры с ошибками. Содержимое ошибки отображается при наведении на id кадра.

Совет

Вы можете настроить желтый и красный статусы на основании доли неудачных записей. Для этого отредактируйте параметр MAX_COUNTER_ERROR_RECORDS в файле конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py :

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...
    # Counter health status config:
    # max percent of camera records with errors
    'MAX_COUNTER_ERROR_RECORDS': {'yellow': 0.3, 'red': 0.5},
    ...
}

Работа с записями счетчика 

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

Если счетчик работает с ошибками, система будет создавать пустые записи с сообщением об ошибке.

Для просмотра записей счетчика перейдите на вкладку Счетчики. Нажмите на счетчик. Перейдите на вкладку Скриншоты.

Вы можете увеличить скриншот, нажав на него. Если включено определение дистанции, на скриншоте будут зафиксированы прямоугольники вокруг силуэтов и расстояние между ними.

Для работы со списком счетчиков используйте следующие фильтры:

Название содержит: фильтровать счетчики по имени.
ID счётчика: отобразить счетчик с определенным ID.
Группы камер: отображать счетчики по определенной группе камер.
Камеры: отображать счетчики по определенной камере.
Дистанция: фильтровать счетчики с определением/без определения дистанции или любой.
Статус: фильтровать счетчики по статусу.

Для работы со скриншотами счетчика используйте следующие фильтры:

Камеры: отображать скриншоты по определенной камере.
Дата и время: отображать скриншоты за определенный период времени.
Ошибка: фильтровать скриншоты с ошибками/без ошибок.
Количество лиц: отображать скриншоты с количеством лиц в заданном интервале.
Количество силуэтов: отображать скриншоты с количеством силуэтов в заданном интервале.
Количество транспортных средств: отображать скриншоты с количеством транспортных средств в заданном интервале.
ID записи счётчика: отобразить скриншоты с определенным ID записи счетчика.
Минимальная дистанция: отобразить скриншоты с минимальной дистанцией в определенном интервале.
Максимальная дистанция: отобразить скриншоты с максимальной дистанцией в определенном интервале.
Средняя дистанция: отобразить скриншоты со средней дистанцией в определенном интервале.

Настройка вебхука для счетчика 

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

См.также

Настройка счетчиков 

Для настройки счетчиков откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и измените следующие параметры:

COUNTERS_DEDUP_OPTIONS: набор опций, которые позволяют избежать дублирования объектов при подсчете в многокамерных счетчиках, т. е. ситуации, когда один и тот же объект считается на нескольких камерах одновременно, что ведет к чрезмерно завышенному результату подсчета. Для каждого типа объектов доступны две опции (face, body, car): enabled - включает дедупликацию объектов, threshold - определяет порог схожести, при котором объекты считаются дубликатами.
COUNTERS_SAVE_FULLFRAME определяет параметры сохранения полных кадров при работе счетчиков: always (всегда), detect - сохранять, только если были обнаружены лица, силуэты или транспортные средства, never (никогда).
COUNTERS_FULLFRAME_JPEG_QUALITY: качество JPEG полных кадров.
COUNTERS_THUMBNAIL_JPEG_QUALITY: качество JPEG миниатюр.
COUNTERS_ROI_INTERSECTION_THRESHOLD: требуемый процент пересечения между прямоугольником вокруг объекта (bbox) и областью интереса, определенной для счетчика.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

# deduplicate objects on multi-camera counters
 'COUNTERS_DEDUP_OPTIONS': {
     'face': {
         'enabled': False,
         'threshold': 0.714,  # model: [mango_320]
     },
     'body': {
         'enabled': False,
         'threshold': 0.65,  # model: [durga]
     },
     'car': {
         'enabled': False,
         'threshold': 0.65,  # model: [bottas]
     },
},
# counters full frame saving options:
# `always` - save always
# `detect` - save only if faces or bodies have been detected
# `never` - never save full frames
'COUNTERS_SAVE_FULLFRAME': 'always',
'COUNTERS_FULLFRAME_JPEG_QUALITY': 75,
'COUNTERS_THUMBNAIL_JPEG_QUALITY': 75,
# required percentage of bbox intersection with ROI
'COUNTERS_ROI_INTERSECTION_THRESHOLD': 0.75,
...

После внесения изменений обязательно перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Кластеры лиц, силуэтов, транспортных средств

FindFace Multi поддерживает автоматическую кластеризацию объектов одного происхождения:

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

Совокупные галереи кластеров лиц, силуэтов и транспортных средств доступны на вкладке Кластеры.

Примечание

Если для кластера лиц/силуэтов найдено совпадение с карточкой человека, он автоматически отобразится в данной карточке. По аналогии, кластер транспортных средств будет сохранен в соответствующей карточке транспортного средства.

Важно

По умолчанию кластеризация объектов отключена. Включите и настройте ее через файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py .

В этом разделе:

Алгоритмы кластеризации
Включение и настройка кластеризации
Работа с галереями кластеров
- Просмотр кластеров. Фильтры
- Объединение и удаление кластеров
Статическая галерея кластеров
Ручная кластеризация

Алгоритмы кластеризации 

FindFace Multi использует следующие алгоритмы кластеризации объектов:

Кластеризация в реальном времени. Данный алгоритм кластеризации обрабатывает эпизоды с целью выбора подходящих изображений объектов и кластеризует выбранные изображения. Он работает на лету после закрытия эпизода. Результаты кластеризации отображаются динамически на вкладке Кластеры и в соответствующей карточке.

Для кластеризации используются не все эпизоды. Если эпизод соответствует всем требованиям (см. подробности ниже), система формирует кластер следующим образом:
- Выбирает событие наилучшего качества.
- Создает новую сущность cluster event (кластерное событие) в основной базе данных PostgreSQL. Сущность содержит метаданные выбранного события, вектор признаков объекта и миниатюру объекта, а также ссылку на родительский эпизод.
- Ищет похожий центроид объекта в галерее cluster_events базы данных векторов признаков Tarantool. Центроид объекта — это виртуальный вектор признаков, усредненный по всем объектам-близнецам, которые были обнаружены на данный момент (например, центроид лица — это вектор признаков, усредненный по всем изображениям лица одного и того же человека). Система обновляет похожий центроид, используя новое событие, если такой центроид найден. Иначе создается новый центроид.
Кластеризация по расписанию. Данный алгоритм кластеризации перерабатывает и пересматривает кластерные события, созданные во время кластеризации в реальном времени. Использование данного алгоритма улучшает качество кластерного центроида, поскольку в этом случае центроид усредняется по большему массиву накопленных векторов признаков. Результаты кластеризации по расписанию отображаются после каждой запланированной итерации на вкладке Кластеры и в соответствующей карточке.

Расписание задается в формате RRULE в параметре CLUSTERS_CLUSTERIZATION_SCHEDULE файла конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Предпочтительны ночные часы, так как запланированная кластеризация занимает много времени и ресурсов ЦП.

Важно

Кластеризация по расписанию полностью перезаписывает содержимое галерей кластеров, включая идентификаторы. Вы можете закрепить определенные кластеры, включив настройки CLUSTERS_AUTO_PIN_HEURISTICS и PIN_MATCHED_CLUSTERS (см. ниже).

Включение и настройка кластеризации 

По умолчанию кластеризация отключена. Чтобы включить и настроить ее, выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py. Найдите раздел Clusters configuration.

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

 # -- Clusters configuration --
 'ENABLE_NIGHT_CLUSTERIZATION': False,
 'ENABLE_REALTIME_CLUSTERIZATION': True,
 # rrule (recurrence rule) for scheduling "night" clusterization
 'CLUSTERIZATION_SCHEDULE': 'RRULE:FREQ=DAILY;INTERVAL=1;WKST=MO;BYHOUR=0;BYMINUTE=0',
 # clusterize only selected objects types (for realtime and nightly clusterization)
 # available are: face, body, car
 'CLUSTERIZE_OBJECT_TYPES': ['face'],
 # keep no more than N the best quality events in centroid (None to disable)
 'CENTROID_MAX_SIZE': None,
 # save cluster events without emben and images (only keep thumbnail for the best event)
 'LONG_LIVING_CLUSTER_EVENTS': False,
 # skip clusterization if unpinned cluster events count is greater than this value
 'CLUSTERIZATION_MAX_CLUSTER_EVENTS': None,
 # create cluster only from cluster events in current case or only from cluster events without case
 'ISOLATE_CASE_CLUSTERS': True,
 # cluster event to cluster matching confidence threshold
 'FACE_CLUSTER_CONFIDENCE_THRESHOLD': 0.714,  # model: [mango_320]
 'BODY_CLUSTER_CONFIDENCE_THRESHOLD': 0.65,  # model: [durga]
 # minimum required event quality for cluster creation
 'FACE_CLUSTER_EVENT_MIN_QUALITY': 0.5,  # model: [quality_fast.v1]
 'BODY_CLUSTER_EVENT_MIN_QUALITY': 0.6,  # model: [pedattr.quality.v0]
 'CAR_CLUSTER_EVENT_MIN_QUALITY': 0.73,  # model: [carattr.quality.v0]
 # discard cluster event if `max_centroids` similar centroids found with confidence greater than `confidence`
 'FACE_CLUSTER_MAX_N_SIMILAR': {'enabled': False, 'max_centroids': 5, 'confidence': 0.714},
 'BODY_CLUSTER_MAX_N_SIMILAR': {'enabled': False, 'max_centroids': 5, 'confidence': 0.65},
 # minimum required object size in pixels for cluster creation
 'FACE_CLUSTER_EVENT_MIN_SIZE': 50,
 'BODY_CLUSTER_EVENT_MIN_SIZE': 50,
 'CAR_CLUSTER_EVENT_MIN_SIZE': 50,
 # minimum required number events in episode for cluster creation
 'FACE_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 1,
 'BODY_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 1,
 'CAR_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 1,
 # age feature threshold for cluster creation
 'FACE_CLUSTER_EVENT_MIN_AGE_THRESHOLD': 16,
  ....
 # pinned clusters keep their id and events after reclusterization
 'CLUSTERS_AUTO_PIN_HEURISTICS': {
    'face': {
        # pin clusters with `value` minimum cluster events
        'min_events': {'enabled': True, 'value': 10},
        # cluster's centroid similarity confidence is less than
        'max_centroid_similarity_threshold': {'enabled': True, 'value': 0.54},  # mango_320
        # minimum average event's quality
        'min_average_events_quality': {'enabled': True, 'value': 0.45},
    },
    'body': {},
    'car': {},
    },
 # always pin clusters with matched events (not affected by heuristics above)
 'PIN_MATCHED_CLUSTERS': False,
 ...

Включите кластеризацию в реальном времени, установив ENABLE_REALTIME_CLUSTERIZATION: True .
При необходимости включите кластеризацию по расписанию, установив ENABLE_NIGHT_CLUSTERIZATION: True.

Важно

Включать кластеризацию по расписанию имеет смысл только в том случае, если включена кластеризация в реальном времени. В противном случае система не сформирует ни одного нового кластера, поскольку только кластеризация в реальном времени является поставщиком уникальных кластерных событий.
```
...
# -- Clusters configuration --
    'ENABLE_NIGHT_CLUSTERIZATION': True,
    'ENABLE_REALTIME_CLUSTERIZATION': True,
...
```
При необходимости задайте рекуррентное правило (RRULE), задающее расписание плановой кластеризации. Если правило не задано, кластеризация автоматически начинается в 00:00 GMT.

Совет

См. калькулятор RRULE.
```
# rrule (recurrence rule) for scheduling clusters clusterization
'CLUSTERIZATION_SCHEDULE': 'RRULE:FREQ=DAILY;INTERVAL=1;WKST=MO;BYHOUR=0;BYMINUTE=0',
```
По умолчанию система формирует только кластеры лиц. Для того чтобы включить формирование кластеров силуэтов и транспортных средств, добавьте соответствующие типы объектов в следующую строку:
```
# available are: face, body, car
'CLUSTERIZE_OBJECT_TYPES': ['face','body','car'],
```
При необходимости измените минимальное количество событий в используемых для кластеризации эпизодах. По умолчанию данное количество равно 1. Сделайте это отдельно для каждого типа объекта.
```
# minimum required number events in episode for cluster creation
'FACE_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 3,
'BODY_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 3,
'CAR_CLUSTER_EVENT_MIN_EPISODE_EVENTS': 2,
```
При необходимости измените минимальное качество используемых для кластеризации изображений объектов. Сделайте это отдельно для каждого типа объекта.

Примечание

Поскольку данная настройка требует наличия высокого уровня знаний и опыта, мы настоятельно рекомендуем предварительно проконсультироваться с нашими техническими специалистами.
```
# minimum required event quality for cluster creation
'FACE_CLUSTER_EVENT_MIN_QUALITY': 0.5,  # model: [quality_fast.v1]
'BODY_CLUSTER_EVENT_MIN_QUALITY': 0.6,  # model: [pedattr.quality.v0]
'CAR_CLUSTER_EVENT_MIN_QUALITY': 0.73,  # model: [carattr.quality.v0]
```
При необходимости измените порог уверенности алгоритма в совпадении объектов при сопоставлении кластерного события и кластера.

Предупреждение

Перед изменением данного параметра проконсультируйтесь с нашими специалистами по адресу support@ntechlab.com.
```
# cluster event to cluster matching confidence threshold
'FACE_CLUSTER_CONFIDENCE_THRESHOLD': 0.714,  # model: [mango_320]
'BODY_CLUSTER_CONFIDENCE_THRESHOLD': 0.65,  # model: [durga]
```
Кластеризация по расписанию полностью перезаписывает все созданные кластеры. Вы можете «закрепить» определенные кластеры, т. е. сохранить их и связанные кластерные события, включая идентификаторы, нетронутыми. Для этого используйте следующие настройки:

Примечание

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

Примечание

Данные настройки не влияют на кластеризацию в реальном времени. Она продолжит создавать новые кластерные события для закрепленных кластеров.
- CLUSTERS_AUTO_PIN_HEURISTICS: установите True или False для следующих параметров и укажите соответствующие значения:
  
  Примечание
  
  При необходимости сделайте это для каждого типа объекта.
  - min_events: закрепить кластер, когда количество связанных с ним кластерных событий превысит заданное минимальное значение.
  - max_centroid_similarity_threshold: закрепить кластер, если сходство между его центроидом и центроидами других кластеров меньше заданного порога. Если кластер похож на некоторые другие кластеры, существует вероятность того, что данные кластеры принадлежат одному человеку/транспортному средству. В этом случае система не закрепит такой кластер, чтобы иметь возможность провести повторную кластеризацию. Напротив, непохожие кластеры будут закреплены.
  - min_average_events_quality: закрепить кластер, если среднее качество ассоциированных кластерных событий больше заданного минимального значения.
```
 # pinned clusters keep their id and events after reclusterization
 'CLUSTERS_AUTO_PIN_HEURISTICS': {
     'face': {
         # pin clusters with `value` minimum cluster events
         'min_events': {'enabled': True, 'value': 10},
         # cluster's centroid similarity confidence is less then
         'max_centroid_similarity_threshold': {'enabled': True, 'value': 0.54},
         # minimum average event's quality
         'min_average_events_quality': {'enabled': True, 'value': 0.45},
     },
     'body': {},
     'car': {},
},
```
- Включите параметр PIN_MATCHED_CLUSTERS, чтобы закрепить кластеры и связанные с ними кластерные события, для которых есть совпадения в картотеке.
```
 # always pin clusters with matched events (not affected by heuristics above)
'PIN_MATCHED_CLUSTERS': True,
```
При необходимости укажите максимальное количество кластерных событий в кластерах, которые являются «незакрепленными». По достижении данного количества кластеризация по расписанию будет автоматически отключена.
```
# skip clusterization if unpinned cluster events count is greater than this value
'CLUSTERIZATION_MAX_CLUSTER_EVENTS': None,
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1. В веб-интерфейсе FindFace Multi появится вкладка Кластеры.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Работа с галереями кластеров 

Просмотр кластеров. Фильтры 

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

При работе с галереями кластеров используйте следующие фильтры:

Примечание

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

Объект: отобразить кластеры только для лиц, силуэтов или транспортных средств.
Совпадения: отобразить кластеры с совпадением/без совпадения или любые.
Списки наблюдения: отобразить только кластеры по определенному списку наблюдения.
Группы камер: отобразить только кластеры по определенной группе камер.
Камеры: отобразить только кластеры по определенной камере.
Имя карточки: отобразить только кластеры по определенной карточке.
Дата и время: отобразить только кластеры, сформированные в определенный период времени.
Первое событие кластера: отобразить только первое событие кластера, сформированное в определенный период времени.
Событие кластера: отобразить только события кластеров, сформированные в определенный период времени.
ID: отобразить кластер с определенным ID.

Специальные фильтры для кластеров лиц

Возраст: отобразить кластеры с людьми определенного возраста.
Борода: фильтровать кластеры по наличию бороды.
Эмоции: отобразить кластеры с заданными эмоциями.
Пол: отобразить кластеры с людьми заданного пола.
Очки: фильтровать кластеры по наличию очков на лице.
Витальность: фильтровать кластеры по liveness лица.
Медицинская маска: фильтровать кластеры по наличию медицинской маски.

Специальные фильтры для кластеров силуэтов

Пол по силуэту: отобразить кластеры с силуэтами людей заданного пола.
Возраст по силуэту: отобразить кластеры с силуэтами людей определенного возраста.
Головной убор: отобразить только кластеры с людьми в головном уборе заданного типа: шапка/шляпа/кепка, капюшон/платок, без головного убора.
Жилет: отобразить только кластеры с людьми, одетыми в жилет заданного цвета.
Жилет. Точность распознавания: отобразить только кластеры с людьми, одетыми в жилет с заданной точностью распознавания.
Каска: отображать только кластеры с людьми, одетыми в каску заданного цвета.
Каска. Точность распознавания: отображать только кластеры с людьми, одетыми в каску с заданной точностью распознавания.
Цвет верха одежды: отобразить только кластеры с людьми, одетыми в одежду заданного цвета (верх).
Цвет низа одежды: отобразить только кластеры с людьми, одетыми в одежду заданного цвета (низ).
Тип верха одежды: отобразить только те кластеры, в которых человек носит одежду верха заданного типа: куртка, пальто, безрукавка, толстовка, футболка, рубашка, платье.
Низ одежды: отобразить только те кластеры, в которых человек носит одежду низа заданного типа: брюки, юбка, шорты, неопределенный.
Верх одежды: отобразить только те кластеры, в которых человек носит одежду верха заданной обобщенной категории: с длинными рукавами, с короткими рукавами, без рукавов.

Специальные фильтры для кластеров транспортных средств

Марка: фильтровать кластеры по марке транспортного средства.
Модель: фильтровать кластеры по модели транспортного средства.
Тип кузова: отобразить кластеры с транспортными средствами заданного типа кузова.
Цвет кузова: отобразить кластеры с транспортного средства заданного цвета кузова.
Страна: отобразить кластеры с транспортными средствами, зарегистрированными в заданной стране.
Регистрационный номер: найти транспортное средство с заданным номером.
Регион: отобразить кластеры с транспортными средствами, зарегистрированными в заданном регионе.
Цвет номера: отобразить кластеры с заданным цветом регистрационного номера транспортного средства.
Спецтранспорт: отображать только кластеры с транспортными средствами, принадлежащими заданному типу: полиция, автомобили МЧС и пожарные машины, газоспасательные и аварийно-спасательные службы, скорая помощь, военная техника, коммунальная, строительная техника, прочие.
Категория ТС: отображать только кластеры с транспортными средствами, принадлежащими заданной категории: мотоцикл, скутер, легковой автомобиль с прицепом, грузовик, грузовик с прицепом, автобус, сочлененный автобус прочие.
Вес и размер кузова: отобразить кластеры с транспортными средствами заданного веса и размера кузова.

Примечание

Регион и цвет регистрационного знака определяются только для Объединенных Арабских Эмиратов (ОАЭ). Для других стран значения этих атрибутов будут выводиться как неизвестные в результатах распознавания.

Щелкните по нужному кластеру, чтобы просмотреть связанные с ним кластерные события. Вы будете перенаправлены на страницу События кластера.

Объединение и удаление кластеров 

Для того чтобы вручную объединить несколько кластеров, выберите их один за другим и нажмите Объединить.

Примечание

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

Для того чтобы удалить кластер, выберите его и нажмите Удалить.

Статическая галерея кластеров 

Иногда бывает необходимо завершить кластеризацию объектов в определенный момент времени, а затем оперировать статической галереей сформированных кластеров.

Для отображения вкладки Кластеры при отключенной кластеризации выполните следующие действия:

Откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py
```
В раздел SERVICES вручную добавьте строку "clusters": True, как показано в примере ниже:
```
...
SERVICES = {
    "ffsecurity": {
        ...
        "clusters": True,
    }
...
```
Отключите процессы кластеризации в реальном времени и по расписанию.
```
...
'ENABLE_NIGHT_CLUSTERIZATION': False,
'ENABLE_REALTIME_CLUSTERIZATION': False,
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```

Ручная кластеризация 

Для того чтобы вручную запустить процесс кластеризации, используйте утилиту run_clusterization.

Вы можете вызвать справку по опциям run_clusterization, выполнив следующую команду:

 sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py run_clusterization --help

 usage: manage.py run_clusterization [-h]
                                  [--object-types OBJECT_TYPES [OBJECT_TYPES ...]]
                                  [--force] [--configuration CONFIGURATION]
                                  [--version] [-v {0,1,2,3}]
                                  [--settings SETTINGS]
                                  [--pythonpath PYTHONPATH] [--traceback]
                                  [--no-color] [--force-color]
                                  [--skip-checks]

 optional arguments:
-h, --help            show this help message and exit
--object-types OBJECT_TYPES [OBJECT_TYPES ...]
                      Clusterize selected object types. Uses
                      CLUSTERIZE_OBJECT_TYPES from config if not provided.
                      Allowed types: face, body, car
--force               Force clusterization even if
                      CLUSTERIZATION_MAX_CLUSTER_EVENTS condition is met
--configuration CONFIGURATION
                      The name of the configuration class to load, e.g.
                      "Development". If this isn't provided, the
                      DJANGO_CONFIGURATION environment variable will be
                      used.
--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.

Данная утилита позволяет по отдельности запускать кластеризацию лиц, силуэтов и транспортных стредств, а также выполнять принудительную кластеризацию, если максимальное количество событий кластера превышает значение параметра CLUSTERIZATION_MAX_CLUSTER_EVENTS (см. Включение и настройка кластеризации). Например, чтобы принудительно запустить кластеризацию лиц, выполните следующую команду:

sudo docker exec -it findface-multi-findface-multi-legacy-1 /opt/findface-security/bin/python3 /tigre_prototype/manage.py run_clusterization --object-types face --force

См.также

Отчеты

В этой главе:

Типы отчетов
Построение стандартного отчета
Построение отчета об учете рабочего времени
Работа с отчетами

Типы отчетов 

В FindFace Multi доступны следующие отчеты:

Стандартные отчеты по следующим системным объектам:
Отчеты об учете рабочего времени, которые позволяют зафиксировать точные моменты входа и выхода сотрудников из предприятия или заданной области и подсчитать общее время, проведенное в данном месте, могут быть построены на вкладке События.

Построение стандартного отчета 

Для того чтобы построить стандартный отчет по системному объекту, выполните следующие действия:

Перейдите на вкладку, соответствующую нужному системному объекту: Поиск, Эпизоды и события, Кластеры, Источники видео, Картотека, Анализ аудитории, Журнал действий.
Нажмите на кнопку Все фильтры. Установите фильтры для отчета.
Нажмите Применить и создать отчет.
Укажите имя отчета.
Если вы находитесь на вкладке События, выберите тип отчета Стандартный отчет (поскольку на данных вкладках доступно два типа отчетов).
Если применимо, выберите, следует ли сохранять изображения отчета в виде ссылок, миниатюр или полных кадров.
Нажмите Добавить. Отчет будет доступен для загрузки на вкладке Отчеты.

Построение отчета об учете рабочего времени 

Отчет об учете рабочего времени можно построить на вкладке: События. Требуется указание камер входа и выхода.

Для того чтобы построить отчет об учете рабочего времени, выполните следующие действия:

Установите фильтры для отчета.
Нажмите Применить и создать отчет.
Укажите имя отчета.
Выберите формат отчета.
Выберите тип отчета: Учет рабочего времени.
Если применимо, выберите, следует ли сохранять изображения отчета в виде ссылок, миниатюр или полных кадров.
Выберите камеру входа.
Выберите камеру выхода.
Нажмите Добавить. Отчет будет доступен для загрузки на вкладке Отчеты.

Работа с отчетами 

Вы можете получить доступ к отчетам, ранее созданным в системе, на вкладке Отчеты. Доступны следующие операции:

Скачивание выбранных отчетов.
Обновление выбранных отчетов.
Удаление выбранных отчетов.

См.также

Настройка сохранения изображений в отчетах

Журнал действий пользователей

Комплексный журнал действий с возможностью поиска является отличным дополнительным инструментом для управления пользователями, обеспечивающим подробный аудит их действий и повышающим защиту системы. Вы можете получить доступ к этой функции на вкладке Журнал действий.

Каждая запись журнала содержит следующие данные:

логин пользователя, выполнившего действие
IP-адрес, с которого поступил запрос на выполнение действия
ID устройства: уникальный идентификатор клиентского устройства пользователя
тип действия, например, авторизация, поиск, изменение объекта, перезагрузка и т. д.
тип объекта, к которому было приложено действие, например, карточка
идентификатор объекта
подробности в зависимости от типа действия
временная метка

Используйте панель фильтров сверху, чтобы задать условия поиска в журнале.

Связанная с людьми аналитика

FindFace Multi является идеальным инструментом для сбора связанной с людьми аналитики. Включите формирование кластеров лиц и силуэтов и используйте их для извлечения значимой информации посредством набора аналитических функций.

Анализ взаимодействий

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

При отслеживании взаимодействий система автоматически определяет круг людей, с которыми человек ранее контактировал. Для каждого человека из первого круга система строит еще один круг ассоциированных людей и так далее. В целом, анализ взаимодействий состоит из трех кругов.

Примечание

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

Анализ взаимодействий доступен на вкладке Анализ взаимодействий.

Совет

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

На вкладке Анализ взаимодействий нажмите на изображение человека, чтобы отобразить первый круг его взаимодействий и ассоциированные события. Продолжайте, пока не раскроете все дерево взаимодействий.

Фильтры можно применять к каждому кругу:

Совет

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

Совпадения: отобразить кластеры с совпадением/без совпадения или любые.
Списки наблюдения: отобразить только кластеры по определенному списку наблюдения.
Группы камер: отобразить только кластеры по определенной группе камер.
Камеры: отобразить только кластеры по определенной камере.
Имя карточки: отобразить только кластеры по определенной карточке.
Дата и время: отобразить только кластеры, сформированные в определенный период времени.
Первое событие кластера: отобразить только первое событие кластера, сформированное в определенный период времени.
Событие кластера: отобразить только события кластеров, сформированные в определенный период времени.
ID: отобразить кластер с определенным ID.

Специальные фильтры для кластеров лиц

Возраст: отобразить кластеры с людьми определенного возраста.
Борода: фильтровать кластеры по наличию бороды.
Эмоции: отобразить кластеры с заданными эмоциями.
Пол: отобразить кластеры с людьми заданного пола.
Очки: фильтровать кластеры по наличию очков на лице.
Витальность: фильтровать кластеры по liveness лица.
Медицинская маска: фильтровать кластеры по наличию медицинской маски.

При поиске по кругу связей применяются следующие настройки:

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

Анализ аудитории

FindFace Multi включает статистику по количеству посетителей, их полу, среднему возрасту, наиболее часто посещаемым зонам (судя по самым активным камерам в системе) и характеру посещений (первое посещение или возвращение).

Диаграммы с аналитическими данными доступны на вкладке Анализ аудитории.

Важно

Построение аналитики выполняется только при включенной кластеризации лиц.

Для работы с данными аналитики используйте следующие фильтры:

Дата и время
Шаг шкалы
Минимальное время между посещениями
Количество возвращений
Камеры
Списки наблюдения
Возраст
Пол

См.также

Кластеры лиц, силуэтов, транспортных средств

Видеонаблюдение

В этой главе:

Видеостена
- Отображение видео
Видеомагнитофон

Видеостена 

В FindFace Multi встроена базовая функциональность видеонаблюдения. Используйте видеостену для отображения видео с камер и видеофайлов.

Важно

Расширенные возможности видеонаблюдения доступны с помощью Видеомагнитофона.

Отображение видео 

Видеостена может работать в двух режимах (по четыре раскладки в каждом):

видеотрансляция
видеотрансляция с детектированием объектов и лентой эпизодов

Для отображения на видеостене видеоизображения выполните следующие действия:

Перейдите на вкладку Видеостена.
Выберите режим работы и раскладку камер.
Перетащите на видеостену выбранные камеры.

Вы можете работать с лентой эпизодов и событий на видеостене по аналогии с вкладкой Эпизоды и события, включая те же фильтры, которые доступны для эпизодов и событий.

Примечание

См. полный список фильтров эпизодов и фильтров событий, применимых к видеостене.

Видеомагнитофон 

Включение видеозаписи с камеры 

Если Видеомагнитофон развернут и настроен, в основных настройках камер появится флажок Записывать видео. Установите этот флажок, чтобы включить запись видеофрагментов с камеры и отправку их в Видеомагнитофон для дальнейшей обработки.

Просмотр видео с камеры в видеоплеере 

При определенных настройках при нажатии на предварительный просмотр камеры вместо статического кадра открывается видеоплеер, транслирующий видео с камеры в режиме реального времени.

Видеоплеер имеет интуитивно понятный дизайн. Предоставляются следующие возможности:

Прямая трансляция с камеры.
Просмотр записанных с камеры видеофрагментов. Фрагменты будут отмечены на временной шкале фиолетовым цветом. Чтобы быстро переключиться с просмотра архивного видео на прямую трансляцию с камеры, нажмите кнопку Live.
Визуальная индикация моментов, соответствующих событиям с лицами или транспортными средствами (если данная функциональность активна), в виде цветных маркеров на временной шкале. События без совпадений отмечаются розовым цветом, а с совпадениями — салатовым.

Примечание

Данная функциональность является опциональной и должна быть предварительно настроена. См. Настройка Видеомагнитофона.

Важно

Время на временной шкале отображается в часовом поясе зрителя. Например, если событие произошло в 14:00 в Абу-Даби, для зрителя в Париже его метка будет стоять на 12:00.
Перемещение в прошлое и будущее по временной шкале с возможностью увеличения и уменьшения ее масштаба.

Совет

По временной шкале можно перемещаться с помощью кнопок < / > или водя курсором по временной шкале с зажатой правой кнопкой мыши.

Совет

Для увеличения и уменьшения масштаба используйте колесико мыши с нажатой клавишей Ctrl.
Для экспорта выбранных клипов, выберите интервал и нажмите Скачать.

Воспроизведение видео из события и эпизода 

Вы можете просмотреть видео с интересующего вас эпизода или события, если у вас активирован Видеомагнитофон и имеется записанный видеоархив во время события или эпизода. При наведении курсора на миниатюре объекта (лица/силуэта или транспортного средства) отобразится кнопка play. Нажмите на нее, чтобы начать воспроизведение видео с того момента, когда было зафиксировано событие или эпизод с камеры.

Руководство по интеграции

Данная глава посвящена возможностям интеграции с FindFace. В текущей версии для интеграции своей системы можно использовать только HTTP API.

HTTP API

Подробная интерактивная документация HTTP API FindFace доступна после установки по адресу http://<findface-ip:port>/api-docs. Изучайте и пробуйте.

Совет

Замените <findface-ip:port> на свой IP адрес FindFace Multi.

Совет

Документацию также можно найти в веб-интерфейсе, перейдя в меню по пунктам Настройки -> Документация API.

Обзор

Совет

Если после изучения данного раздела у вас останутся вопросы, не стесняйтесь обращаться к нашим специалистам по адресу support@ntechlab.com.

Аутентификация

Все методы API требуют простой HTTP-аутентификации на основе токенов. Для аутентификации введите слово «Token» и значение токена, разделенные пробелом, в HTTP-заголовок авторизации: Authorization: Token 000.... Все запросы, которые не могут предоставить действительный токен аутентификации, приведут к ошибке авторизации HTTP 401.

Формат параметров

Для отправки запросов методами API поддерживаются следующие два формата:

application/json : параметры тела запроса представляют собой JSON.
multipart/form-data: параметры передаются составными частями, при этом загрузка фотоизображения осуществляется в том же запросе.

Дополнительная информация

Ограничения к вводным данным:

Поддерживаемый формат изображений: JPEG, PNG, WEBP.
Максимальный размер фотоизображения: 10 Мб.
Максимальное разрешение для фотоизображения: 6000 пикселей на самой большой стороне.
Минимальный размер лица: 50x50 пикселей.

Для осуществления ручной настройки см. /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml.

Приступая к работе

В этой главе вы найдете рекомендуемую последовательность шагов, следуя которой вы сможете задействовать весь спектр функциональных возможностей FindFace Multi.

В этой главе:

Подготовка к работе
Создание списков наблюдения и картотеки
Загрузка и обработка видеофайла
Источники данных
FindFace Multi в действии

Совет

Замените <findface-ip:port> на ваш IP адрес FindFace Multi, а <token> – на значение вашего токена.

Подготовка к работе 

Выполните первичную настройку системы:

Выполните развертывание FindFace Multi и изучите API документацию http://<findface-ip:port>/api-docs.
Выполните базовую HTTP авторизацию, отправив логин и пароль в форму для ввода.
Создайте свой токен авторизации с вашим UUID сессии и опционально авторизацией по лицу.
Вставьте ваш токен следующим образом: Token <token> в поле API Key формы для авторизации или в HTTP заголовок Authorization.

Создание списков наблюдения и картотеки 

Создайте новый список наблюдения, с помощью POST метода, или используйте список по умолчанию.
Найдите ID идентификатор списка наблюдения для того, чтобы отправить POST запрос на создание новой карточки.
Выполните обнаружение лица (машины, силуэта) на приложенном фотоизображении и скопируйте ID интересующего объекта..
Прикрепите фотографию лица человека с помощью detection id.

Загрузка и обработка видеофайла 

Организуйте видеонаблюдение с помощью загрузки видеофайла.
Найдите id из списка видеоархивов или путем добавления нового видеоархива.
Прикрепите исходный видеофайл вместе с id видеоархива.
Запустите обработку видеоархива.

Источники данных 

Для настройки видеомониторинга объектов добавьте камеры в FindFace Multi, сгруппировав их c учетом расположения.

В системе доступна группа камер по умолчанию. Список доступных групп камер.
При необходимости создайте новую группу камер.
Используйте id группы камер, чтобы отправить POST запрос для создания новой камеры.

FindFace Multi в действии 

Ищите объекты в базе обнаруженных объектов и картотеке. Подробнее.
Сравнивайте объекты, чтобы проверить их на совпадение.

Аутентификация

Все API запросы необходимо отправлять на адрес http://<findface-ip:port>.

Аутентификация HTTP Basic

Базовая аутентификация HTTP представляет собой простой механизм аутентификации «запрос-ответ», который может использоваться сервером для запроса аутентификационной информации (имя пользователя и пароль).

Введите свои учетные данные в форму для входа в систему:

Username – имя пользователя вашей учетной записи FindFace Multi.
Password – пароль для вашей учетной записи FindFace Multi.

Эти данные должны быть переданы в заголовке запроса Authorization в виде base64 кода.

Authorization: Basic <base64(username:password)>

Авторизация API Key

Для того чтобы создать токен авторизации, используйте следующий метод:

POST /auth/login/

Предварительно вы должны предоставить основные учетные данные для авторизации (имя пользователя, пароль).

Этот метод возвращает в ответе токен авторизации, который вы можете использовать в остальных API методах.

Если система использует авторизацию по лицу и паролю, то вместе с заголовком базовой авторизации дополнительно передайте токен, полученный во время авторизации по лицу, в поле video_auth_token.

Тело запроса является обязательным и содержит объект в формате application/json со следующими параметрами:

Совет

* - обозначает обязательные параметры.🆁 – только для чтения.

Параметры	Схема JSON	Описание
`video_auth_token`	string	Ограничения: Минимум 1 символ. Неактивный токен при авторизации лицом. Требуется, если задано face_and_password.
`uuid*`	string	Ограничения: от 1 до 256 символов. Уникальный идентификатор сессии на устройстве.
`mobile`	boolean	Устройство мобильное.
`device_info`	<any-key>: str┃int┃float┃bool┃object┃array┃null	Информация об устройстве.

Пример запроса

{
 "video_auth_token": "A",
 "uuid": "A",
 "mobile": false,
 "device_info": {}
}

CURL пример

curl -X POST "http://<findface-ip:port>/auth/login/" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Basic <base64(username:password)>" \
 -H "Content-Type: application/json" \
 -d '{"uuid":"A"}' \

Возвращает:

200 – в случае успеха.
400 – если тело запроса не определено.

В случае успешного ответа (ОK: 200), возвращается объект со следующими параметрами. Пример.

Пример ответа

Параметры	Схема JSON	Описание
`token*`	string	Токен авторизации.
`user*`	{…}	Информация о пользователе.
`token_expiration_datetime*`	date-time	Дата и время истечения срока действия токена.

user содержит следующие параметры:

id* : integer 🆁

active* : boolean

created_date* : date-time 🆁

groups : [integer]

modified_date* : date-time 🆁 – Дата и время изменения объекта.

permissions* : [string]

real_name* : string – Ограничения: максимум 80 символов.

name* : string – Максимум 80 символов.

comment : string – Расширенное описание пользователя, до 2048 символов.

camera_group_permissions* : {<any-key>: string}

watch_list_permissions* : {<any-key>: string}

group_permissions* : {<any-key>: string}

primary_group* : integer

language : enum – Допустимые значения: en-us┃es┃ru. Язык пользовательского интерфейса.

has_face* : boolean 🆁 – Фотография пользователя предоставлена.

face_cover : string┃null – Ограничения: Максимум 32 символа.

ad_user* : boolean 🆁 – Пользователь зарегистрирован в Active Directory.

Пример ответа

{
 "token": "string",
 "user": {
   "id": 0,
   "active": false,
   "created_date": "1970-01-01T00:00:00.000Z",
   "groups": [
     0
   ],
   "modified_date": "1970-01-01T00:00:00.000Z",
   "permissions": [
     "string"
   ],
   "real_name": "AAAAAA",
   "name": "AAAAAA",
   "comment": "AAAAAA",
   "camera_group_permissions": {},
   "watch_list_permissions": {},
   "group_permissions": {},
   "primary_group": 0,
   "language": "en-us",
   "has_face": false,
   "face_cover": "AAAAAA",
   "ad_user": false
 },
 "token_expiration_datetime": "1970-01-01T00:00:00.000Z"
}

Вставьте полученный токен в поле API Key формы для авторизации: Token <token> и нажмите SET или отправьте в заголовке авторизации: Authorization: Token 000.... Все запросы, которые не могут предоставить действительный токен аутентификации, приведут к ошибке авторизации HTTP 401.

Для того чтобы отключить примененные ключи, нажмите REMOVE или CLEAR ALL API KEYS или отправьте запрос POST /auth/logout/.

Списки наблюдения

Отобразить списки наблюдений

Для того чтобы отобразить списки наблюдений, используйте следующий метод:

GET /watch-lists/

Запрос содержит следующие параметры QUERY-STRING PARAMETERS:

Название	Схема JSON	Описание
`limit`	integer	Количество возвращаемых результатов.
`ordering`	string	Допустимые значения: id, created_date, modified_date.

Для того чтобы найти ID списка наблюдения, укажите произвольное значение для limit и ordering.

CURL пример

curl -X GET "http://<findface-ip:port>/watch-lists/?limit=2&ordering=id" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \

В случае успешного ответа (OK: 200) возвращается объект, содержащий массив results со следующими параметрами. Пример.

Совет

* – означает, что параметр является обязательным. 🆁 – только для чтения.

Название	Схема JSON	Описание
`id*`	integer 🆁	ID списка наблюдения.
`created_date*`	date-time 🆁	Дата создания объекта.
`modified_date*`	date-time 🆁	Дата изменения объекта.
`active`	boolean	`true`, если список наблюдения активен.
`name*`	string	Название списка наблюдения, до 256 знаков.
`comment`	string	Комментарий, до 2048 знаков.
`color`	string	Цвет метки объекта в шестнадцатеричном формате. Ограничения: Максимум 6 символов.
`notify`	boolean	`true` , если включены звуковые оповещения.
`acknowledge`	boolean	Требуется подтверждение событий, которые соответствуют списку наблюдения.
`permissions`	{<any-key>: string}	Разрешения.
`camera_groups`	[integer]	Группы камер, используемые в списке наблюдения.
`face_threshold`	number┃null	Порог схожести для распознавания лиц для текущего списка наблюдения (от 0 до 1).
`body_threshold`	number┃null	Порог схожести для распознавания силуэтов для текущего списка наблюдения (от 0 до 1).
`car_threshold`	number┃null	Порог схожести для распознавания автомобилей для текущего списка наблюдения (от 0 до 1).
`ignore_events`	boolean	События не будут создаваться, если установлено значение `True`.
`send_events_to_external_vms`	boolean	`true`, если события, соответствующие этому списку наблюдения, должны быть отправлены на внешнюю виртуальную машину.
`active_after`	date-time┃null	Информация о дате и времени.
`active_before`	date-time┃null	Информация о дате и времени.
`disable_schedule`	{…}	Сериализатор mixin, который вызывает ошибку проверки `ValidationError`, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.
`recount_schedule_on*` 🆁	date-time	Информация о дате и времени.
`origin`	string	Максимум 256 символов.

Пример ответа

{
 "results": [
   {
     "id": -1,
     "created_date": "2023-01-16T13:44:36.407610Z",
     "modified_date": "2023-01-16T13:44:36.407750Z",
     "active": true,
     "name": "Unmatched",
     "comment": "Default list for unmatched events",
     "color": "ffffff",
     "notify": false,
     "acknowledge": false,
     "permissions": {
       "1": "edit",
       "2": "view",
       "3": "view"
     },
     "camera_groups": [],
     "face_threshold": null,
     "body_threshold": null,
     "car_threshold": null,
     "ignore_events": false,
     "send_events_to_external_vms": false,
     "active_after": null,
     "active_before": null,
     "disable_schedule": {},
     "recount_schedule_on": null,
     "origin": "ffsecurity"
   },
   {
     "id": 1,
     "created_date": "2023-01-16T13:44:36.394542Z",
     "modified_date": "2023-01-16T13:44:36.394577Z",
     "active": true,
     "name": "Default Watch List",
     "comment": "",
     "color": "123456",
     "notify": false,
     "acknowledge": false,
     "permissions": {
       "1": "edit",
       "2": "view",
       "3": "view"
     },
     "camera_groups": [],
     "face_threshold": null,
     "body_threshold": null,
     "car_threshold": null,
     "ignore_events": false,
     "send_events_to_external_vms": false,
     "active_after": null,
     "active_before": null,
     "disable_schedule": {},
     "recount_schedule_on": null,
     "origin": "ffsecurity"
   }
 ]
}

Создать новый список наблюдений

Чтобы добавить новый список наблюдений, используйте следующий метод:

POST /watch-lists/

Тело запроса является обязательным и содержит объект application/json со следующими параметрами списка наблюдения.

Название	Схема JSON	Описание
`active`	boolean	`true`, если список наблюдения активен.
`name*`	string	Название списка наблюдения, до 256 знаков.
`comment`	string	Комментарий, до 2048 знаков.
`color`	string	Цвет метки объекта в шестнадцатеричном формате. Ограничения: от 1 до 6 символов.
`notify`	boolean	`true` , если включены звуковые оповещения.
`acknowledge`	boolean	Требуется подтверждение событий, которые соответствуют списку наблюдения.
`permissions`	<any-key>: string	Ограничения: Минимум 1 символ.
`camera_groups`	[integer]	Группы камер, используемые в списке наблюдения.
`face_threshold`	number┃null	Порог схожести для распознавания лиц для текущего списка наблюдения (от 0 до 1).
`body_threshold`	number┃null	Порог схожести для распознавания силуэтов для текущего списка наблюдения (от 0 до 1).
`car_threshold`	number┃null	Порог схожести для распознавания автомобилей для текущего списка наблюдения (от 0 до 1).
`ignore_events`	boolean	События не будут создаваться, если установлено значение `True`.
`send_events_to_external_vms`	boolean	`true`, если события, соответствующие этому списку наблюдения, должны быть отправлены на внешнюю виртуальную машину.
`active_after`	date-time┃null	Информация о дате и времени.
`active_before`	date-time┃null	Информация о дате и времени.
`disable_schedule`	{…}	Сериализатор mixin, который вызывает ошибку проверки `ValidationError`, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.
`origin`	string	Ограничения: от 1 до 256 символов.

Пример запроса

Совет

Этот пример приведен только для ознакомления, подставьте свои значения в соответствующие поля. Вы можете заполнить только обязательные поля, а остальные будут по умолчанию.

{
 "active": false,
 "name": "A",
 "comment": "AAAAAA",
 "color": "A",
 "notify": false,
 "acknowledge": false,
 "permissions": {},
 "camera_groups": [
   0
 ],
 "face_threshold": 0,
 "body_threshold": 0,
 "car_threshold": 0,
 "ignore_events": false,
 "send_events_to_external_vms": false,
 "active_after": "1970-01-01T00:00:00.000Z",
 "active_before": "1970-01-01T00:00:00.000Z",
 "disable_schedule": {
   "monday": [
     [
       "A"
     ]
   ],
   "tuesday": [
     [
       "A"
     ]
   ],
   "wednesday": [
     [
       "A"
     ]
   ],
   "thursday": [
     [
       "A"
     ]
   ],
   "friday": [
     [
       "A"
     ]
   ],
   "saturday": [
     [
       "A"
     ]
   ],
   "sunday": [
     [
       "A"
     ]
   ]
 },
 "origin": "A"
}

Вы можете отправить в запросе следующие параметры:

{
 "active": true,
 "name": "Test_list",
 "comment": "AAAAAA",
 "color": "35a2ee"
}

CURL пример

curl -X POST "http://<findface-ip:port>/watch-lists/" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \
 -H "Content-Type: application/json" \
 -d '{"active":true,"name":"Test_list","comment":"AAAAAA","color":"35a2ee"}' \

Если ответ успешен (Created: 201), то возвращается объект, который содержит следующие параметры. Пример.

Пример ответа

{
 "id": 2,
 "created_date": "2023-01-16T14:07:52.424520Z",
 "modified_date": "2023-01-16T14:07:52.424549Z",
 "active": true,
 "name": "Test_list",
 "comment": "AAAAAA",
 "color": "35a2ee",
 "notify": false,
 "acknowledge": false,
 "permissions": {
   "1": "edit"
 },
 "camera_groups": [],
 "face_threshold": 0,
 "body_threshold": 0,
 "car_threshold": 0,
 "ignore_events": false,
 "send_events_to_external_vms": false,
 "active_after": null,
 "active_before": null,
 "disable_schedule": {},
 "recount_schedule_on": null,
 "origin": "ffsecurity"
}

Используйте id списка наблюдения, чтобы отправить POST запрос для создания новой карточки.

Полезные API запросы

GET /watch-lists/
POST /watch-lists/
GET /watch-lists/{id}/
DELETE /watch-lists/{id}/
PATCH /watch-lists/{id}/
POST /watch-lists/{id}/purge/
GET /watch-lists/count/
POST /watch-lists/purge_all/

Карточка

Создание новой карточки

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

POST /cards/humans/

Совет

Для карточек ТС в запросе вместо humans укажите cars.

Тело запроса является обязательным и содержит объект application/json со следующими параметрами.

Совет

* – означает, что параметр является обязательным. 🆁 – только для чтения.

Название	Схема JSON	Описание
`active`	boolean	`true`, если объект активен.
`name*`	string	Название карточки, до 256 символов.
`comment`	string	Комментарий, до 2048 символов.
`watch_lists*`	[integer]	Массив из ID списков наблюдений.
`meta`	Любой тип данных	Метаданные.
`active_after`	date-time┃null	Информация о дате и времени.
`active_before`	date-time┃null	Информация о дате и времени.
`disable_schedule`	{…}	Сериализатор mixin, который вызывает ошибку проверки `ValidationError`, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.

Пример запроса

Совет

Этот пример приведен только для ознакомления, подставьте свои значения в соответствующие поля. Вы можете заполнить только обязательные поля, а остальные будут по умолчанию.

{
 "active": false,
 "name": "A",
 "comment": "AAAAAA",
 "watch_lists": [
   0
 ],
 "meta": {},
 "active_after": "1970-01-01T00:00:00.000Z",
 "active_before": "1970-01-01T00:00:00.000Z",
 "disable_schedule": {
   "monday": [
     [
       "A"
     ]
   ],
   "tuesday": [
     [
       "A"
     ]
   ],
   "wednesday": [
     [
       "A"
     ]
   ],
   "thursday": [
     [
       "A"
     ]
   ],
   "friday": [
     [
       "A"
     ]
   ],
   "saturday": [
     [
       "A"
     ]
   ],
   "sunday": [
     [
       "A"
     ]
   ]
 }
}

Вы можете отправить в запросе следующие параметры:

{
 "active": true,
 "name": "Angelina Jolie",
 "comment": "Миссис Смит",
 "watch_lists": [
   2
 ]
}

CURL пример

curl -X POST "http://<findface-ip:port>/cards/humans/" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \
 -H "Content-Type: application/json" \
 -d '{"active":true,"name":"Angelina Jolie","comment":"Миссис Смит","watch_lists":[2]}' \

Если ответ успешен (Created: 201), то возвращается объект, который содержит следующие параметры. Пример.

Название	Схема JSON	Описание
`id*`	integer 🆁	ID карточки.
`active`	boolean	`true`, если объект активен.
`filled*`	boolean 🆁	`true`, если карточка заполнена.
`created_date*`	date-time 🆁	Дата создания.
`modified_date*`	date-time 🆁	Дата изменения.
`name*`	string	Название карточки, до 256 символов.
`comment`	string	Комментарий, до 2048 символов.
`watch_lists*`	[integer]	Массив из ID списков наблюдений.
`looks_like` `confidence` `collection` `matched_object`	number string┃null string┃null	Порог схожести – от 0 до 1. Группа карточек. Совпадающий объект.
`meta`	Любой тип данных	Метаданные.
`looks_like_confidence*`	number 🆁	Степень схожести.
`active_after`	date-time┃null	Информация о времени и дате.
`active_before`	date-time┃null	Информация о времени и дате.
`disable_schedule`	массив	Сериализатор mixin, который вызывает ошибку проверки `ValidationError`, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.
`recount_schedule_on*`	date-time 🆁	Информация о времени и дате.
`face_objects*`	integer 🆁	Счетчик связанных лиц.
`body_objects*`	integer 🆁	Счетчик связанных силуэтов.
`face_cluster*`	integer 🆁	Кластер лиц.
`body_cluster*`	integer 🆁	Кластер силуэтов.
`links_to_relations` `id` `name` `created_date` `card` `relation`	integer 🆁 string date-time 🆁 integer integer	ID Название, до 256 символов. Дата создания связи. Связанная карточка. Связь.

Примечание

Связи не поддерживаются в FindFace Multi 2.1 и хранятся только в API.

Пример ответа

{
 "id": 1,
 "active": true,
 "filled": true,
 "created_date": "2023-01-17T07:43:56.363330Z",
 "modified_date": "2023-01-17T07:43:56.363354Z",
 "name": "Angelina Jolie",
 "comment": "Миссис Смит",
 "watch_lists": [
   2
 ],
 "meta": {},
 "active_after": null,
 "active_before": null,
 "disable_schedule": {},
 "recount_schedule_on": null,
 "face_objects": 0,
 "body_objects": 0,
 "face_cluster": null,
 "body_cluster": null,
 "links_to_relations": []
}

Вывести список карточек

Чтобы вывести списком карточки «Люди» с их параметрами, используйте следующий метод:

GET /cards/humans/

Запрос содержит параметры QUERY-STRING PARAMETERS. Подробнее http://<findface-ip:port>/api-docs.

Вы можете использовать этот метод для поиска лиц в системе. Укажите значение detection:<detection id>, полученное при обнаружении объекта на фотографии, в поле looks_like.

CURL пример

curl -X GET "http://<findface-ip:port>/cards/humans/?looks_like=detection%3Acf4ffvmv54rotim9jt60" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \

Если ответ успешен (OK: 200), то возвращается объект со следующими параметрами:

Название	Схема JSON	Описание
`next_page`	string┃null	Следующая страница.
`prev_page`	string┃null	Предыдущая страница.
`results`	[{…}]	Содержит параметры.

Пример ответа

 {
 "next_page": null,
 "prev_page": null,
 "results": [
   {
     "id": 1,
     "active": true,
     "filled": true,
     "created_date": "2023-01-17T07:43:56.363330Z",
     "modified_date": "2023-01-17T11:56:42.496871Z",
     "name": "Angelina Jolie",
     "comment": "Миссис Смит",
     "watch_lists": [
       2
     ],
     "looks_like": {
       "confidence": 0.8078,
       "collection": "face_objects",
       "matched_object": "4493493039043981648"
     },
     "meta": {},
     "looks_like_confidence": 0.8078,
     "active_after": null,
     "active_before": null,
     "disable_schedule": {},
     "recount_schedule_on": null,
     "face_objects": 1,
     "body_objects": 0,
     "face_cluster": 11,
     "body_cluster": null,
     "links_to_relations": []
   }
 ]
}

Полезные API запросы

GET /cards/cars/
POST /cards/cars/
GET /cards/cars/{id}/
DELETE /cards/cars/{id}/
PATCH /cards/cars/{id}/
GET /cards/cars/count/
GET /cards/humans/
POST /cards/humans/
GET /cards/humans/{id}/
DELETE /cards/humans/{id}/
PATCH /cards/humans/{id}/
GET /cards/humans/count/

Обнаружение объектов на фотографии

Чтобы обнаружить объект на фотографии, используйте следующий метод:

POST /detect

Тело запроса является обязательным и содержит multipart/form-data со следующими параметрами.

Название	Схема JSON	Описание
`photo`	binary	Исходный файл изображения.
`attributes`	объект	Атрибуты для объектов: лицо, автомобиль и силуэт.

Поле attributes может быть пустым или содержать объекты face, car и body со следующими параметрами для каждого объекта:

age (возраст): тип boolean
beard (борода): тип boolean
emotions (эмоции): тип boolean
glasses (очки): тип boolean
gender (пол): тип boolean
medmask (медицинская маска): тип boolean
headpose (наклон головы): тип boolean

Прикрепите исходный файл изображения и отправьте POST запрос.

CURL пример

curl -X POST "http://<findface-ip:port>/detect" \
-H "Accept: application/json" \
-H "Content-Language: ru" \
-H "Accept-Language: ru" \
-H "Authorization: Token <token>" \
-H "Content-Type: multipart/form-data" \
-F "photo=@Смит_01.png" \
-F "attributes={
 "face": {
   "age": false,
   "beard": false,
   "emotions": false,
   "glasses": false,
   "gender": false,
   "medmask": false,
   "headpose": false
 },
 "car": {
   "description": false,
   "license_plate": false,
   "special_vehicle_type": false,
   "category": false,
   "weight_type": false,
   "orientation": false
 },
 "body": {
   "color": false,
   "clothes": false,
   "bags": false,
   "protective_equipment": false,
   "age_gender": false
 }
}" \

В случае успешного ответа (ОK: 200), возвращается объект со следующими параметрами. Пример.

Название	Схема JSON	Описание
`orientation*`	integer	Ориентация фотографии в формате EXIF.
`objects`	поддерживается любой из форматов: str┃int┃float┃bool┃object┃array┃null	Возвращаемые объекты с запрашиваемыми атрибутами.

Пример ответа

{
 "orientation": 1,
 "objects": {
   "face": [
     {
       "id": "cf0mbqev54rqhngnq940",
       "bbox": {
         "left": 451,
         "top": 235,
         "right": 645,
         "bottom": 502
       },
       "detection_score": 0.80645436,
       "low_quality": false,
       "features": {}
     },
     {
       "id": "cf0mbqev54rqhngnq94g",
       "bbox": {
         "left": 757,
         "top": 79,
         "right": 948,
         "bottom": 353
       },
       "detection_score": 0.90099674,
       "low_quality": false,
       "features": {}
     }
   ]
 }
}

В ответе вы получите ID объекта и координаты прямоугольника вокруг объекта (лица, автомобиля, силуэта). Скопируйте значение id интересующего вас объекта, чтобы использовать его для добавления объекта в карточку или для поиска объекта.

Объекты

Добавить объект «Лицо»

POST /objects/faces/

Данный метод позволяет создать объект «Лицо», который содержит исходное фотоизображение, миниатюру лица и другие атрибуты.

Совет

Для объектов «Автомобиль» и «Силуэт» в запросах используйте cars или body вместо faces.

Тело запроса является обязательным и содержит multipart/form-data со следующими параметрами:

Название	Схема JSON	Описание
`create_from`	string	Данное поле может содержать один из следующих вариантов идентификатора объекта: `detection:<detection id>`: используйте обнаруженный объект с помощью метода `POST /detect` на исходном изображении. Исходное фотоизображение в поле `source_photo` должно совпадать с фотоизображением в запросе `POST /detect`. `event:<event id>` для лица, силуэта или автомобиля: создавайте новый объект из События (поле `source_photo` должно быть пустым). `object:<object id>` для лица, силуэта или автомобиля: используйте другой объект в качестве шаблона для текущего объекта (поле `source_photo` должно быть пустым).
`detect_id`	string	Вспомогательный параметр.
`mf_selector`	enum	Этот параметр определяет действие FindFace Multi, когда в `source_photo` присутствует несколько объектов, а `create_from` не задан. Значение по умолчанию: `reject`. Допустимые значения: `reject` – Отклонить, если в исходном фотоизображении несколько объектов. `biggest` – Выбрать наибольший объект в исходном фотоизображении.
`upload_list`	integer	Добавить объект в данный список загрузок.
`source_photo`	binary	Исходное фотоизображение (является обязательным, если в поле `create_from` указан `detection:<detection id>` или остается пустым)
`frame_coords_left`	integer	Левая граница прямоугольника вокруг объекта.
`frame_coords_top`	integer	Верхняя граница прямоугольника вокруг объекта.
`frame_coords_right`	integer	Правая граница прямоугольника вокруг объекта.
`frame_coords_bottom`	integer	Нижняя граница прямоугольника вокруг объекта.
`active`	boolean	`true`, если объект активен. Значение по умолчанию `true`.
`card`	integer	ID связанной карточки.

Прикрепите фотоизображение в поле source_photo, укажите ID соответствующей карточки и вставьте detection:<detection id> в форму create_from, где detection id полученный id при обнаружении объекта на фотоизображении. В поле source_photo должно быть то же изображение, что и в запросе POST /detect.

CURL пример

curl -X POST "http://<findface-ip:port>/objects/faces/" \
  -H "Accept: application/json" \
  -H "Content-Language: ru" \
  -H "Accept-Language: ru" \
  -H "Authorization: Token <token>" \
  -H "Content-Type: multipart/form-data" \
  -F "create_from=detection:cf2g86uv54rqhngnq960" \
  -F "source_photo=@Смит_01.png" \
  -F "card=3" \

В случае успешного ответа (Created: 201), возвращается объект со следующими параметрами. Пример.

Название	Схема JSON	Описание
`id*`	string 🆁	ID.
`created_date*`	date-time 🆁	Дата создания объекта.
`modified_date*`	date-time 🆁	Дата изменения объекта.
`source_photo_name*`	string 🆁	Имя файла, указанное для `source_photo` при создании объекта.
`frame_coords_left`	integer	Левая граница прямоугольника вокруг объекта.
`frame_coords_top`	integer	Верхняя граница прямоугольника вокруг объекта.
`frame_coords_right`	integer	Правая граница прямоугольника вокруг объекта.
`frame_coords_bottom`	integer	Нижняя граница прямоугольника вокруг объекта.
`thumbnail*`	uri 🆁	Миниатюра объекта.
`active`	boolean	`true`, если объект активен. Значение по умолчанию `true`.
`features*`	Поддерживается любой из форматов: str┃int┃float┃bool┃object┃array┃null	Признаки.
`card*`	integer	ID соответствующей карточки.

Пример ответа

{
 "card": 3,
 "created_date": "2023-01-16T08:12:55+00:00",
 "modified_date": "1970-01-01T00:00:00+00:00",
 "source_photo_name": "Смит_01.png",
 "source_photo": "http://172.23.218.94/uploads/cards/7w/3/face_%D0%A1%D0%BC%D0%B8%D1%82_01_ftgY5K.png",
 "thumbnail": "http://172.23.218.94/uploads/cards/TD/3/face_%D0%A1%D0%BC%D0%B8%D1%82_01_thumbnail_VyVsIj.png",
 "frame_coords_left": 757,
 "frame_coords_top": 79,
 "frame_coords_right": 948,
 "frame_coords_bottom": 353,
 "active": true,
 "features": {},
 "id": "4493225067924944019",
 "meta": {}
}

Полезные API запросы

GET /objects/bodies/
POST /objects/bodies/
GET /objects/bodies/{id}/
DELETE /objects/bodies/{id}/
PATCH /objects/bodies/{id}/
GET /objects/cars/
POST /objects/cars/
GET /objects/cars/{id}/
DELETE /objects/cars/{id}/
PATCH /objects/cars/{id}/
GET /objects/faces/
POST /objects/faces/
GET /objects/faces/{id}/
DELETE /objects/faces/{id}/
PATCH /objects/faces/{id}/

Видео

Вывести списком видеоархив

Чтобы составить список видеоархивов, используйте следующий метод:

GET /videos/

Запрос седержит следующие QUERY-STRING PARAMETERS.

Название	Схема JSON	Описание
`case_in`	массив из integer	Выбрать видеоролики, относящиеся к нужным событиям.
`created_date_gt`	date-time	Выбрать объекты с `created_date` больше, чем указанное значение.
`created_date_gte`	date-time	Выбрать объекты со значением `created_date` больше или равным указанному.
`created_date_last_n_days`	number	Выбрать объекты со значением `created_date` за последние N дней.
`created_date_lt`	date-time	Выбрать объекты со значением `created_date` меньше указанного.
`created_date_lte`	date-time	Выбрать объекты со значением `created_date` меньше или равно указанному.
`created_date_nth_full_week`	number	Выбрать объекты со значением `created_date` за последние N недель (включая субботу и воскреснье)
`created_date_nth_work_week`	number	Выбрать объекты со значением `created_date` за последние N недель (только рабочие дни, исключая субботу и воскресенье).
`limit`	string	Количество выводимых результатов.
`name*`	string	Выбрать видеоролики с указанным именем.
`ordering`	string	Допустимые значения: id, created_date, name.
`page`	string	Положение курсора.
`save_to`	string	Выбрать видеоархивы с указанным значением поля `save_to`.

Например, укажите произвольное значение для вывода результатов в поле limit.

CURL пример

curl -X GET "http://<findface-ip:port>/videos/?limit=2" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \

В случае успешного ответа (OK: 200) возвращается объект со следующими параметрами. Пример.

Название	Схема JSON
`next_page`	string┃null
`prev_page`	string┃null
`results`	массив

results содержат массив со следующими параметрами:

Название	Схема JSON	Описание
`id*`	integer 🆁	ID видеоархива.
`camera_group*`	integer	Группа камер.
`name*`	string┃null	Название видеоархива. Максимум 256 символа.
`url`	string┃null	URL.
`camera`	integer┃null	Камера.
`processing_start_date*`	date-time 🆁	Дата и время начала обработки видео.
`active*`	boolean 🆁	Обработка видео активна.
`screenshot*`	uri 🆁	URL скриншота.
`stream_settings`	{…}	Сериализатор mixin, который вызывает ошибку проверки ValidationError, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.
`source_len*`	number 🆁	Длина источника в секундах.
`health_status*`	{…}	Дополнительная информация о статусе.
`finished*`	boolean 🆁	`true`, если обработка видео завершена.
`queued*`	boolean 🆁	`true`, если видео находится в очереди на обработку.
`face_count*`	integer 🆁	Количество созданных лиц.
`file_size*`	integer 🆁	Размер видеофайла в архиве.
`created_date*`	date-time 🆁	Дата создания объекта.
`body_count*`	integer 🆁	Количество созданных силуэтов.
`car_count*`	integer 🆁	Количество созданных автомобилей.
`case`	integer┃null	Происшествие.
`face_cluster_count*`	integer┃null 🆁	Количество созданных из видео кластеров лиц.
`body_cluster_count*`	integer┃null 🆁	Количество созданных из видео кластеров силуэтов.
`car_cluster_count*`	integer┃null 🆁	Количество созданных из видео кластеров автомобилей.

Примечание

Происшествия не поддерживаются в FindFace Multi 2.1 и хранятся только в API.

Пример ответа

{
 "next_page": null,
 "prev_page": null,
 "results": [
   {
     "id": 2,
     "camera_group": 1,
     "name": "file.mp4",
     "url": null,
     "camera": null,
     "processing_start_date": null,
     "active": false,
     "screenshot": "http://<findface-ip:port>/videos/2/screenshot/",
     "stream_settings": {
       "detectors": {
         "face": {
           "filter_max_size": 8192,
           "filter_min_quality": 0.45,
           "filter_min_size": 60,
           "fullframe_crop_rot": false,
           "fullframe_use_png": false,
           "jpeg_quality": 95,
           "overall_only": true,
           "post_best_track_frame": true,
           "post_best_track_normalize": true,
           "post_first_track_frame": false,
           "post_last_track_frame": false,
           "realtime_post_every_interval": false,
           "realtime_post_first_immediately": false,
           "realtime_post_interval": 1,
           "roi": "",
           "track_interpolate_bboxes": true,
           "track_max_duration_frames": 0,
           "track_miss_interval": 1,
           "track_overlap_threshold": 0.25,
           "track_send_history": false,
           "tracker_type": "simple_iou",
           "track_deep_sort_matching_threshold": 0.65,
           "track_deep_sort_filter_unconfirmed_tracks": true
         },
         "body": null,
         "car": null
       },
       "disable_drops": true,
       "ffmpeg_format": "",
       "ffmpeg_params": [],
       "imotion_threshold": 0,
       "play_speed": -1,
       "rot": "",
       "router_timeout_ms": 15000,
       "router_verify_ssl": true,
       "start_stream_timestamp": 0,
       "stream_data_filter": "",
       "use_stream_timestamp": false,
       "video_transform": "",
       "enable_recorder": false,
       "enable_liveness": false
     },
     "source_len": null,
     "health_status": {
       "enabled": false,
       "status": "DISABLED",
       "msg": "",
       "statistic": {
         "processed_duration": 0,
         "faces_posted": 0,
         "faces_failed": 0,
         "faces_not_posted": 0,
         "processing_fps": 0,
         "frames_dropped": 0,
         "frames_processed": 0,
         "frames_imotion_skipped": 0,
         "decoding_soft_errors": 0,
         "frame_width": 0,
         "frame_height": 0,
         "last_stream_timestamp": 0,
         "objects": null,
         "job_starts": 0
       },
       "code": "gray",
       "code_desc": "Обработка видео не запущена"
     },
     "finished": false,
     "queued": false,
     "face_count": 0,
     "file_size": 2259950,
     "created_date": "2023-01-12T08:57:36.811305Z",
     "body_count": 0,
     "car_count": 0,
     "case": null,
     "face_cluster_count": 0,
     "body_cluster_count": 0,
     "car_cluster_count": 0
   }
 ]
}

Добавить новый видеоархив

Чтобы добавить новый видеоархив, используйте следующий метод:

POST /videos/

Тело запроса содержит application/json объект со следующими параметрами:

Название	Схема JSON	Описание
`camera_group*`	integer	Значение ID группы камер.
`name*`	string┃null	Название видеоархива (от 1 до 256 знаков).
`url`	string┃null	Минимум 1 символ.
`camera`	integer┃null	Камера.
`stream_settings`	{…}	Сериализатор mixin, который вызывает ошибку проверки ValidationError, если представлены избыточные поля. Может использоваться во вложенных сериализаторах.
`case`	integer┃null	Происшествие.

Примечание

Происшествия не поддерживаются в FindFace Multi 2.1 и хранятся только в API.

Пример запроса

Совет

Этот пример приведен только для ознакомления, подставьте свои значения в соответствующие поля. Вы можете заполнить только обязательные поля, а остальные будут по умолчанию.

{
 "camera_group": 0,
 "name": "A",
 "url": "A",
 "camera": 0,
 "stream_settings": {
   "detectors": {
     "face": {
       "filter_max_size": 0,
       "filter_min_quality": 0,
       "filter_min_size": 0,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 0,
       "overall_only": false,
       "post_best_track_frame": false,
       "post_best_track_normalize": false,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 0,
       "roi": "string",
       "track_interpolate_bboxes": false,
       "track_max_duration_frames": 0,
       "track_miss_interval": 0,
       "track_overlap_threshold": 0,
       "track_send_history": false,
       "tracker_type": "string",
       "track_deep_sort_matching_threshold": 0,
       "track_deep_sort_filter_unconfirmed_tracks": false
     },
     "body": {
       "filter_max_size": 0,
       "filter_min_quality": 0,
       "filter_min_size": 0,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 0,
       "overall_only": false,
       "post_best_track_frame": false,
       "post_best_track_normalize": false,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 0,
       "roi": "string",
       "track_interpolate_bboxes": false,
       "track_max_duration_frames": 0,
       "track_miss_interval": 0,
       "track_overlap_threshold": 0,
       "track_send_history": false,
       "tracker_type": "string",
       "track_deep_sort_matching_threshold": 0,
       "track_deep_sort_filter_unconfirmed_tracks": false
     },
     "car": {
       "filter_max_size": 0,
       "filter_min_quality": 0,
       "filter_min_size": 0,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 0,
       "overall_only": false,
       "post_best_track_frame": false,
       "post_best_track_normalize": false,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 0,
       "roi": "string",
       "track_interpolate_bboxes": false,
       "track_max_duration_frames": 0,
       "track_miss_interval": 0,
       "track_overlap_threshold": 0,
       "track_send_history": false,
       "tracker_type": "string",
       "track_deep_sort_matching_threshold": 0,
       "track_deep_sort_filter_unconfirmed_tracks": false
     }
   },
   "disable_drops": false,
   "ffmpeg_format": "string",
   "ffmpeg_params": [
     "A"
   ],
   "imotion_threshold": 0,
   "play_speed": 0,
   "rot": "string",
   "router_timeout_ms": 0,
   "router_verify_ssl": false,
   "start_stream_timestamp": 0,
   "stream_data_filter": "string",
   "use_stream_timestamp": false,
   "video_transform": "string",
   "enable_recorder": false,
   "enable_liveness": false
 },
 "case": 0
}

Вы можете отправить в запросе следующие параметры.

{
 "camera_group": 1,
 "name": "Pitt&Jolie"
}

CURL пример

curl -X POST "http://<findface-ip:port>/videos/" \
  -H "Accept: application/json" \
  -H "Content-Language: ru" \
  -H "Accept-Language: ru" \
  -H "Authorization: Token <token>" \
  -H "Content-Type: application/json" \
  -d '{"camera_group":1,"name":"Pitt&Jolie"}' \

Если ответ успешен (Created: 201), то возвращается объект, который содержит следующие параметры. Пример.

Пример ответа

{
 "id": 6,
 "camera_group": 1,
 "name": "Pitt&Jolie",
 "url": null,
 "camera": null,
 "processing_start_date": null,
 "active": false,
 "screenshot": "http://<findface-ip:port>/videos/6/screenshot/",
 "stream_settings": {
   "detectors": {
     "face": {
       "filter_max_size": 8192,
       "filter_min_quality": 0.45,
       "filter_min_size": 60,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 95,
       "overall_only": true,
       "post_best_track_frame": true,
       "post_best_track_normalize": true,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 1,
       "roi": "",
       "track_interpolate_bboxes": true,
       "track_max_duration_frames": 0,
       "track_miss_interval": 1,
       "track_overlap_threshold": 0.25,
       "track_send_history": false,
       "tracker_type": "simple_iou",
       "track_deep_sort_matching_threshold": 0.65,
       "track_deep_sort_filter_unconfirmed_tracks": true
     },
     "body": {
       "filter_max_size": 8192,
       "filter_min_quality": 0.6,
       "filter_min_size": 70,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 95,
       "overall_only": true,
       "post_best_track_frame": true,
       "post_best_track_normalize": true,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 1,
       "roi": "",
       "track_interpolate_bboxes": true,
       "track_max_duration_frames": 0,
       "track_miss_interval": 1,
       "track_overlap_threshold": 0.25,
       "track_send_history": false,
       "tracker_type": "simple_iou",
       "track_deep_sort_matching_threshold": 0.65,
       "track_deep_sort_filter_unconfirmed_tracks": true
     },
     "car": {
       "filter_max_size": 8192,
       "filter_min_quality": 0.73,
       "filter_min_size": 100,
       "fullframe_crop_rot": false,
       "fullframe_use_png": false,
       "jpeg_quality": 95,
       "overall_only": true,
       "post_best_track_frame": true,
       "post_best_track_normalize": true,
       "post_first_track_frame": false,
       "post_last_track_frame": false,
       "realtime_post_every_interval": false,
       "realtime_post_first_immediately": false,
       "realtime_post_interval": 1,
       "roi": "",
       "track_interpolate_bboxes": true,
       "track_max_duration_frames": 0,
       "track_miss_interval": 1,
       "track_overlap_threshold": 0.25,
       "track_send_history": false,
       "tracker_type": "simple_iou",
       "track_deep_sort_matching_threshold": 0.65,
       "track_deep_sort_filter_unconfirmed_tracks": true
     }
   }
 },
 "source_len": null,
 "health_status": {
   "enabled": false,
   "status": "WAITING_FOR_SYNC",
   "msg": "",
   "statistic": {},
   "code": "red",
   "code_desc": "Отсутствует задача в видео менеджере. Дождитесь синхронизации."
 },
 "finished": false,
 "queued": false,
 "face_count": 0,
 "file_size": 0,
 "created_date": "2023-01-18T08:38:52.119129Z",
 "body_count": 0,
 "car_count": 0,
 "case": null,
 "face_cluster_count": 0,
 "body_cluster_count": 0,
 "car_cluster_count": 0
}

Далее укажите id , чтобы загрузить файл с помощью запроса PUT /videos/{id}/upload/source_file/.

Загрузить видеофайл

Чтобы загрузить видеофайл, используйте следующий метод:

PUT /videos/{id}/upload/source_file/

Запрос содержит PATH PARAMETERS:

Название	Схема JSON	Описание
`id*`	integer	Уникальный идентификатор видео.

Прикрепите в тело запроса исходный видеофайл, указав id видеоархива.

Возвращает:

Created: 201 – в случае успеха.
Not Found: 404 – в случае ошибки.

CURL пример

curl -X PUT "http://<findface-ip:port>/videos/6/upload/source_file/" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \
 -H "Content-Type: video/mp4" \
 --data-binary @pittjolie.mp4 \

Запуск обработки видеоархива

Чтобы запустить обработку видеоархива, используйте следующий метод:

POST /videos/{id}/process/

Запрос содержит id в PATH PARAMETERS, обозначающий уникальный идентификатор видеоархива.

CURL пример

curl -X POST "http://<findface-ip:port>/videos/6/process/" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \

Возвращает:

OK: 200 – в случае успеха.
Not Found: 404 – в случае ошибки.

Полезные API запросы

GET /videos/
POST /videos/
GET /videos/{id}/
PUT /videos/{id}/
DELETE /videos/{id}/
POST /videos/{id}/process/
GET /videos/{id}/screenshot/
POST /videos/{id}/screenshot/
POST /videos/{id}/stop/
PUT /videos/{id}/upload/source_file/
GET /videos/count/

Группы камер

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

Вывести список групп камер

Для того чтобы отобразить список групп камер, используйте следующий метод:

GET /camera-groups/

Запрос содержит следующие QUERY-STRING PARAMETERS:

Название	Схема JSON	Описание
`limit`	integer	Количество выводимых результатов.
`ordering`	string	Допустимые значения: `id`, `created_date`, `modified_date`.

Чтобы узнать id группы камеры, укажите значения для полей limit и ordering.

CURL пример

curl -X GET "http://<findface-ip:port>/camera-groups/?limit=3&ordering=id" \
  -H "Accept: application/json" \
  -H "Content-Language: ru" \
  -H "Accept-Language: ru" \
  -H "Authorization: Token <token>" \

В случае успешного ответа (OK: 200) возвращается объект, содержащий массив результатов со следующими параметрами. Пример.

Совет

* – означает, что параметр является обязательным. 🆁 – только для чтения.

Название	Схема JSON	Описание
`id*`	integer 🆁	ID группы камер.
`created_date*`	date-time 🆁	Дата создания объекта.
`modified_date*`	date-time 🆁	Дата изменения объекта.
`active`	boolean	Обрабатывать события из этой группы камер.
`name*`	string	Название группы камер, до 256 знаков.
`comment`	string	Комментарий, до 2048 символов.
`deduplicate`	boolean	`True`, если события из этой группы камер должны быть дедуплицированы.
`deduplicateDelay`	integer	Тайм-аут дедупликации событий (от 1 до 10000). Значение по умолчанию: 15.
`labels`	любое значение string	Метки, используемые для выделения определенного экземпляра findface-video-worker для обработки видеопотоков из этой группы камер.
`permissions`	любое значение string	Разрешения в данной группе камер.
`face_threshold`	number┃null	Порог схожести для лица (от 0 до 1).
`body_threshold`	number┃null	Порог схожести для силуэта (от 0 до 1).
`car_threshold`	number┃null	Порог схожести для автомобиля (от 0 до 1).

Пример ответа

{
 "results": [
   {
     "id": -1,
     "created_date": "2023-01-16T13:44:36.531501Z",
     "modified_date": "2023-01-16T13:44:36.531519Z",
     "active": true,
     "name": "Video archive default Camera Group",
     "comment": "",
     "deduplicate": false,
     "deduplicateDelay": 15,
     "labels": {},
     "permissions": {
       "1": "edit",
       "2": "view",
       "3": "view"
     },
     "face_threshold": null,
     "body_threshold": null,
     "car_threshold": null
   }
 ]
}

Создать группу камер

Чтобы добавить новую группу камер, используйте следующий метод:

POST /camera-groups/

Тело запроса обязательно и содержит application/json объект со следующими параметрами. Пример.

Название	Схема JSON	Описание
`active`	boolean	Обрабатывать события из этой группы камер.
`name*`	string	Название группы камер, до 256 знаков.
`comment`	string	Комментарий, до 2048 символов.
`deduplicate`	boolean	`True`, если события из этой группы камер должны быть дедуплицированы.
`deduplicateDelay`	integer	Тайм-аут дедупликации события (от 0 до 10000). Значение по умолчанию: 15.
`labels`	любое значение string	Метки, используемые для выделения определенного экземпляра findface-video-worker для обработки видеопотоков из этой группы камер.
`permissions`	любое значение string	Разрешения в данной группе камер.
`face_threshold`	number┃null	Порог схожести для лица (от 0 до 1).
`body_threshold`	number┃null	Порог схожести для силуэта (от 0 до 1).
`car_threshold`	number┃null	Порог схожести для автомобиля (от 0 до 1).

CURL пример

curl -X POST "http://<findface-ip:port>/camera-groups/" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \
 -H "Content-Type: application/json" \
 -d '{"active":false,"name":"Test_camera_group","comment":"AAAAAA","deduplicate":false,"deduplicateDelay":0,"labels":{},"permissions":{},"face_threshold":0,"body_threshold":0,"car_threshold":0}' \

Пример запроса

Совет

Этот пример приведен только для ознакомления, подставьте свои значения в соответствующие поля. Вы можете заполнить только обязательные поля, а остальные будут по умолчанию.

Вы можете отправить в запросе следующие параметры:

{
 "active": false,
 "name": "Test_camera_group",
 "comment": "AAAAAA",
 "deduplicate": false,
 "deduplicateDelay": 0,
 "labels": {},
 "permissions": {},
 "face_threshold": 0,
 "body_threshold": 0,
 "car_threshold": 0
}

В случае успешного ответа (Created: 201) возвращается объект со следующими параметрами. Пример.

Пример ответа

{
 "id": 2,
 "created_date": "2023-01-23T12:14:09.885006Z",
 "modified_date": "2023-01-23T12:14:09.885030Z",
 "active": false,
 "name": "Test_camera_group",
 "comment": "AAAAAA",
 "deduplicate": false,
 "deduplicateDelay": 0,
 "labels": {},
 "permissions": {
   "1": "edit"
 },
 "face_threshold": 0,
 "body_threshold": 0,
 "car_threshold": 0
}

Используйте id группы камер для того, чтобы отправить POST запрос для создания новой камеры.

Полезные API запросы

GET /camera-groups/
POST /camera-groups/
GET /camera-groups/{id}/
DELETE /camera-groups/{id}/
PATCH /camera-groups/{id}/
GET /camera-groups/count/

Камеры

Создать новую камеру

Чтобы создать новую камеру, используйте следующий метод:

POST /cameras/

Тело запроса содержит application/json объект со следующими обязательными параметрами:

`name*`	Схема JSON	Описание
`group*`	integer	Группа камер.
`name*`	string	Название камеры (от 1 до 256 знаков).

Остальные параметры см. http://<findface-ip:port>/api-docs.

Вы можете отправить в запросе следующие параметры, подставив свои значения:

Пример запроса

{
 "group": 1,
 "active": false,
 "name": "Camera_name",
 "comment": "AAAAAA",
 "url": "url"
}

CURL пример

curl -X POST "http://<findface-ip:port>/cameras/" \
 -H "Accept: application/json" \
 -H "Content-Language: ru" \
 -H "Accept-Language: ru" \
 -H "Authorization: Token <token>" \
 -H "Content-Type: application/json" \
 -d '{"group":1,"active":false,"name":"Camera_name","comment":"AAAAAA","url":"url"}' \

Возвращает

Created: 201 – в случае успеха.

Поиск лиц в системе

FindFace Multi позволяет выполнять поиск лиц по всей системе.

Вы можете задать поиск лиц одним из следующих способов:

загрузив фотографию

по ID события

по ID объекта

по ID кластера

Чтобы найти человека по загруженной фотографии, выполните следующие действия:

Загрузите фотографию с помощью метода POST /detect.
Прикрепите исходную фотографию и отправьте POST запрос.
В ответе вы получите id объекта и координаты границ лица.
Если на изображении несколько лиц, выберите одно их них, нужное вам. Скопируйте id нужного вам объекта и используйте его для поиска с помощью метода GET /cards/humans/ в поле looks_like следующим образом: detection:<detection id>.
Вы также можете использовать:
- event:<event id> (для лица, силуэта или автомобиля)
- object:<object id> (для лица, силуэта или автомобиля)
- cluster:<cluster id>
Вы увидите результаты поиска. Пример. При необходимости можно сузить область поиска, указав список наблюдения, порог сходства и т. д.

Сравнение двух лиц

FindFace Multi позволяет сравнить два лица и убедиться в их принадлежности одному человеку.

Вы можете сравнить два объекта из разных источников или объект с объектом внутри одной и той же карточки и вернуть сходство между ними.

Выполните следующие действия:

Выполните обнаружение лица (автомобиля, силуэта) на прикрепленном изображении и скопируйте id интересующего вас объекта.
Используйте метод GET /verify.

GET /verify

Запрос содержит следующие QUERY-STRING PARAMETERS:

Название

Схема JSON

Описание

card_id

string

Минимум 1 символ. В этом поле указывают ID карты, в которой хранится объект для сравнения.

*object1

string

Минимум 1 символ. Это поле может содержать одну из следующих ссылок:

detection:<detection id> – для обнаруженного объекта

faceevent:<event id> – для события «лицо»

carevent:<event id> – для события «автомобиль»

bodyevent:<event id> – для события «силуэт»

faceobject:<face id> – для объекта «лицо»

carobject:<face id> – для объекта «автомобиль»

carobject:<face id> – для объекта «силуэт»

object2

string

Минимум 1 символ. Аналогично как для object1.

CURL пример

curl -X GET "http://<findface-ip:port>/verify?card_id=1&object1=detection%3Acf58e4uv54rotim9jtd0&object2=detection%3Acf58g1mv54rotim9jtdg" \
  -H "Accept: application/json" \
  -H "Content-Language: ru" \
  -H "Accept-Language: ru" \
  -H "Authorization: Token <token>" \

В случае успешного ответа (OK: 200), возвращается объект, содержащий уровень схожести.

Название	Схема JSON	Описание
`confidence*`	number	Оценка сходства лиц (от 0 до 1).

Пример ответа

{
 "confidence": {
   "face_objects": {
     "4493493039043981648": 0.7896046
   },
   "average_conf": 0.7896046
 }
}

Вебхуки

Вы можете настроить FindFace Multi для автоматической отправки уведомлений об определенных событиях, эпизодах, записях счетчиков на заданный URL-адрес. Для этого создайте и настройте вебхук. При возникновении нужного события/эпизода/записи счетчика FindFace Multi отправит HTTP-запрос на URL-адрес, указанный в настройках вебхука.

Вебхуки можно использовать для решения разнообразных задач, например, для уведомления пользователя об определенном событии, вызова определенных действий на целевом веб-сайте, при решении задач безопасности, таких как удаленное автоматическое управление доступом и др.

В этом разделе:

Настройка вебхука
Как работает вебхук
Подробные данные в вебхуках (Verbose)

Настройка вебхука 

Важно

Пользователь должен иметь соответствующие права доступа для создания, просмотра, изменения или удаления вебхука. Чтобы настроить права доступа, перейдите в Настройки → Роли.

Примечание

Перед использованием вебхуков убедитесь, что хотя бы один из следующих параметров задан в файле /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py: SERVICE_EXTERNAL_ADDRESS или EXTERNAL_ADDRESS.

Для создания вебхука выполните следующие действия:

Перейдите на вкладку Настройки. Выберите Вебхуки.
Нажмите + Новый вебхук.
Введите заголовок вебхука.
Укажите адрес, на который будут отправляться оповещения.
Вы можете отправлять уведомления в пакетном режиме. Укажите максимальное количество уведомлений в пакете. Фактическое количество может быть меньшим.
Укажите максимальное количество попыток отправить уведомление. Интервал между попытками увеличивается экспоненциально с максимумом 100 секунд.

Важно

Для того чтобы получить все сообщения с момента потери соединения, если оно имеет место, установите значение 0. Установите 1, чтобы пропустить старые сообщения.
FindFace Multi будет автоматически отправлять оповещения о событиях, эпизодах, записях счетчика, удовлетворяющих заданным фильтрам. Фильтровать события можно по следующим параметрам.

Существует два способа настройки фильтров:
- визуально
- с помощью кода
Чтобы настроить фильтры визуально, нажмите Настроить.

Универсальные фильтры для событий распознавания (лицо, силуэт, транспортное средство):
- Совпадения: фильтровать только события с совпадением объектов/без совпадения объектов или все события.
- Списки наблюдения: фильтровать только события по определенному списку наблюдения или все события.
- Группы камер: фильтровать только события по определенной группе камер.
- Камеры: фильтровать события по определенной камере.
- Имя карточки: фильтровать события с заданным именем карточки.
- Лучший кадр события: фильтровать все события трека, только события с кадрами в реальном времени, только одно событие с лучшим кадром по окончанию трека.
- Линия: фильтровать события с пересечением определенной линии.
- Направление пересечения линии: фильтровать события с пересечением линий в заданном направлении или все события.
- Есть обратное пересечение: фильтровать события с обратным пересечением/без обратного пересечения или все события.
Фильтры для событий распознавания лиц:
- Возраст: фильтровать события с людьми определенного возраста.
- Борода: фильтровать события по наличию бороды.
- Эмоции: фильтровать события с заданными эмоциями.
- Пол: отобразить события с людьми заданного пола.
- Очки: фильтровать события по наличию очков на лице.
- Витальность: фильтровать события по витальности (liveness) лица.
- Медицинская маска: фильтровать события по наличию медицинской маски.
- Поворот: фильтровать события по углу поворота головы.
- Наклон: фильтровать события по углу наклона головы.
Фильтры для событий распознавания силуэтов:
- Пол по силуэту: отобразить события с людьми заданного пола.
- Возраст по силуэту: отобразить события с людьми определенного возраста.
- Головной убор: отображать только события с людьми в головном уборе заданного типа: шапка/шляпа/кепка, капюшон/платок, без головного убора.
- Жилет: отображать только события с людьми, одетыми в жилет заданного цвета.
- Каска: отображать только события с людьми, одетыми в каску заданного цвета.
- Цвет верха одежды: отображать только события с людьми, одетыми в одежду заданного цвета (верх).
- Цвет низа одежды: отображать только события с людьми, одетыми в одежду заданного цвета (низ).
- Тип верха одежды: отображать только те события, в которых человек носит одежду верха заданного типа: куртка, пальто, жилет, толстовка, футболка, рубашка, платье.
- Низ одежды: отображать только те события, в которых человек носит одежду низа заданного типа: брюки, юбка, шорты, неопределенный.
- Верх одежды: отображать только те события, в которых человек носит одежду верха заданной обобщенной категории: с длинными рукавами, с короткими рукавами, без рукавов.
- Сумка на спине: отображать только события с людьми с сумкой на спине/без сумки на спине.
- Сумка в руке: отображать только события с людьми с сумкой в руке/без сумки в руке.
Фильтры для событий распознавания транспортных средств:
- Марка: фильтровать события по марке транспортного средства.
- Модель: фильтровать события по модели транспортного средства.
- Тип кузова: отобразить события с транспортными средствами заданного типа кузова.
- Цвет кузова: отобразить события с транспортными средствами заданного цвета кузова.
- Страна: отобразить события с транспортными средствами, зарегистрированными в заданной стране.
- Регистрационный номер: найти транспортное средство с заданным номером.
- Спецтранспорт: отображать только события с транспортными средствами, принадлежащими заданному типу: полиция, автомобили МЧС и пожарные машины, газоспасательные и аварийно-спасательные службы, скорая помощь, военная техника, коммунальная, строительная техника, прочие.
- Категория ТС: отображать только события с транспортными средствами, принадлежащими заданной категории: мотоцикл, скутер, легковой автомобиль с прицепом, грузовик, грузовик с прицепом, автобус, сочлененный автобус и прочие.
- Вес и размер ТС: отобразить события с транспортными средствами заданного веса и размера кузова.
- Ракурс ТС: отобразить события с транспортными средствами заданного ракурса (спереди, сзади, сбоку).
Примечание

Цвет номера, Регион отключены по умолчанию. Чтобы включить эти параметры раскомментируйте "license_plate_number_color", "license_plate_region" в разделе FFSECURITY_UI_CONFIG в конфигурационном файле /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py


FFSECURITY_UI_CONFIG = {
        ...
        "cars": {
            "features": {
              ...
              "license_plate_number_color": [
                        "unknown",
                        "white",
                        "yellow",
                        "blue",
                        "green",
                        "grey",
              ],
               ...
              "license_plate_region": ["unknown", "DXB", "SHJ", "ADH", "AJM", "UAK", "RAK", "FUJ"],
              ...
            },
          ....
         },
  }
```
После внесения изменений перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
Эпизоды с людьми:
- Тип эпизода: фильтровать эпизоды по статусу (открыт/с событиями/закрыт).
- Совпадения: лица: отобразить только эпизоды с совпадением лиц/без совпадения лиц/все эпизоды.
- Совпадения: силуэты: отобразить только эпизоды с совпадением силуэтов/без совпадения силуэтов/все эпизоды.
- Списки наблюдения: отобразить только эпизоды по определенному списку наблюдения.
- Группы камер: отобразить только эпизоды по определенной группе камер.
- Камеры: отобразить только эпизоды по определенной камере.
- Имя карточки: отобразить эпизоды с заданным именем карточки.
- Количество событий: отобразить эпизоды с заданным количеством событий.
Эпизоды с транспортными средствами:
- Тип эпизода: фильтровать эпизоды по статусу (открыт/с событиями/закрыт).
- Совпадения: отобразить только эпизоды с совпадением транспортных средств/без совпадения транспортных средств/все эпизоды.
- Списки наблюдения: отобразить только эпизоды по определенному списку наблюдения.
- Группы камер: отобразить только эпизоды по определенной группе камер.
- Камеры: отобразить только эпизоды по определенной камере.
- Имя карточки: отобразить эпизоды с заданным именем карточки.
- ID эпизода: отобразить эпизод с определенным ID.
- Количество событий: отобразить эпизоды с заданным количеством событий.
Записи счетчиков:
- Группы камер: отобразить записи счетчика по определенной группе камер.
- Камеры: отобразить записи счетчика по определенной камере.
- Количество лиц ≥: фильтровать записи счетчика по количеству лиц.
- Количество силуэтов ≥: фильтровать записи счетчика по количеству силуэтов.
- Количество транспортных средств ≥: фильтровать записи счетчика по количеству транспортных средств.
- ID счётчика: фильтровать записи счетчика с определенным ID.
- Минимальная дистанция: отправить оповещение, если минимальное задетектированное расстояние находится в указанном диапазоне.
- Максимальная дистанция: отправить оповещение, если максимальное задетектированное расстояние находится в указанном диапазоне.
- Средняя дистанция: отправить оповещение, если среднее задетектированное расстояние находится в указанном диапазоне.
Для некоторых фильтров дополнительно можно указать порог срабатывания.

Примечание

Некоторые параметры доступны только в режиме кода и не представлены в визуальных фильтрах. Чтобы правильно настроить эти параметры с помощью кода, прочтите их описания.

Чтобы настроить фильтры с помощью кода, переключитесь в режим Код. Используйте следующие описания:

Универсальные фильтры для событий распознавания (лицо, силуэт, транспортное средство):

Секции: face_events, body_events, car_events.
- "matched_lists": ID списка наблюдения, [integer].
- "camera_groups": ID группы камер, [integer].
- "cameras": ID камеры, [integer].
- "matched_card": ID совпавшей карточки, [integer].
- "matched": результат сопоставления с картотекой, логическое значение. Установите true или false, если отправку оповещения должны вызывать только события с совпадениями или только события без совпадений.
- "confidence_gte": минимальное значение уверенности алгоритма, number. Минимальное значение – 0, максимальное – 1.
- "bs_type": режим отслеживания объектов на видео, возможные значения: overall, realtime.
- "line": ID пересечения линии, [integer].
- "line_crossing_direction": направление пересечения линии, [enum]. Возможные значения: AB, BA.
- "backward_line_crossing": установите true или false, если событие имеет или не имеет обратное пересечение, boolean.
Фильтры для событий распознавания лиц:

Секция: face_events.
- "headpose_yaw_angle_gte": минимальный поворот головы, integer (градусы). Если голова полностью повернута влево, угол равен -180. Если полностью повернута вправо, то 180. Нейтральное положение головы соответствует 0.
- "headpose_yaw_angle_lte": максимальный поворот головы, integer (градусы). Если голова полностью повернута влево, угол равен -180. Если полностью повернута вправо, то 180. Нейтральное положение головы соответствует 0.
- "headpose_pitch_angle_gte": минимальный наклон головы, integer (градусы). Если голова наклонена вперед, а подбородок касается груди, угол равен -180. Если голова наклонена назад и обращена к небу, то 180. Нейтральное положение головы соответствует 0.
- "headpose_pitch_angle_lte": максимальный наклон головы, integer (градусы). Если голова наклонена вперед, а подбородок касается груди, угол равен -180. Если голова наклонена назад и обращена к небу, то 180. Нейтральное положение головы соответствует 0.
- "gender": пол, [string]. Возможные значения: "male", "female".
- "age_lte": максимальный возраст, integer.
- "age_gte": минимальный возраст, integer.
- "glasses": очки, [string]. Возможные значения: "none", "eye" (очки), "sun" (солнцезащитные очки).
- "emotions": эмоции, [string]. Возможные значения: "any", "angry", "fear", "sad", "neutral", "disgust", "happy", "surprise".
- "beard": борода, [string]. Возможные значения: "none", "beard".
- "medmask": медицинская маска, [string]. Возможные значения: "correct", "incorrect", "none".
- "liveness": оценка витальности liveness, [string]. Возможные значения: "real", "fake".
- "temperature_gte": минимальная температура, number.
- "liveness_gte": минимальное значение уверенности алгоритма в том, что лицо витально, number. Минимальное значение – 0, максимальное – 1.
Фильтры для событий распознавания силуэтов:

Секция: body_events.
- "headwear": тип головного убора (шапка/кепка, капюшон/платок, без убора), [string]. Возможные значения: "hat", "hood", "none".
- "upper_clothes": обобщенная категория одежды верхней части тела (с длинными рукавами, с короткими рукавами, без рукавов), [string]. Возможные значения: "long_sleeves", "short_sleeves", "without_sleeves".
- "detailed_upper_clothes": детализированный тип одежды верхней части тела (куртка, пальто, жилет без рукавов, толстовка, футболка, рубашка, платье), [string]. Возможные значения: "jacket", "coat", "sleeveless", "sweatshirt", "t-shirt", "shirt", "dress".
- "top_color": цвет одежды верхней части тела, [string]. Возможные значения: white, "black", "grey", "brown", "red", "orange", "yellow", "green", "lightblue", "blue", "purple", "pink", "beige", "violet".
- "lower_clothes": тип одежды нижней части тела (брюки, юбка, шорты, неопределенный), [string]. Возможные значения:"pants", "obscured", "skirt", "shorts".
- "bottom_color": цвет одежды нижней части тела, [string]. Возможные значения: white, "black", "grey", "brown", "red", "orange", "yellow", "green", "lightblue", "blue", "purple", "pink", "beige", "violet".
- "bag_hand": наличие сумки в руке(ах), [string]. Возможные значения: "none", "hand".
- "bag_ground": наличие сумки на полу, [string]. Возможные значения: "ground", "none".
- "bag_back": наличие сумки на спине, [string]. Возможные значения: "none", "back".
- "vest_type_score_gte": минимальная достоверность распознавания наличия жилета, number. Минимальное значение – 0, максимальное – 1.
- "vest_type_score_lte": максимальная достоверность распознавания наличия жилета, number. Минимальное значение – 0, максимальное – 1.
- "vest_type": наличие средства индивидуальной защиты в виде жилета, [string]. Возможные значения:"green/yellow", "orange", "not_visible", "none".
- "helmet_type_score_lte": максимальная достоверность распознавания наличия шлема, number. Минимальное значение – 0, максимальное – 1.
- "helmet_type_score_gte": минимальная достоверность распознавания наличия шлема, number. Минимальное значение – 0, максимальное – 1.
- "helmet_type": наличие средства индивидуальной защиты в виде шлема, [string]. Возможные значения: "red/orange", "white", "other", "not_visible", "none".
- "age_group_score_lte": максимальная достоверность распознавания возрастной группы, number. Минимальное значение – 0, максимальное – 1.
- "age_group_score_gte": минимальная достоверность распознавания возрастной группы, number. Минимальное значение – 0, максимальное – 1.
- "age_group": возраст по группе, [string]. Возможные значения: "0-16", "17-35", "36-50", "50+".
- "gender_score_lte": максимальная достоверность распознавания пола, number.
- "gender_score_gte": минимальная достоверность распознавания пола, number.
- "body_gender": пол, [string]. Возможные значения: "male", "female".
Фильтры для событий распознавания транспортных средств:

Секция: car_events.
- "category_confidence_gte": минимальная достоверность распознавания категории транспортного средства, number. Минимальное значение – 0, максимальное – 1.
- "category_confidence_lte": максимальная достоверность распознавания категории транспортного средства, number. Минимальное значение – 0, максимальное – 1.
- "category_type": категория транспортного средства, [string]. Возможные значения: "unknown", "A", "B", "BE", "C", "CE", "D", "DE", "other".
- "color" цвет кузова, [string]. Возможные значения: "beige", "black", "blue", "brown", "cyan", "gold", "green", "grey", "orange", "pink", "purple", "red", "silver", "violet", "white", "yellow".
- "body": тип кузова транспортного средства, [string]. Возможные значения: "suv", "sedan", "crossover", "convertible", "coupe", "wagon", "cab", "minibus", "minivan", "limousine".
- "make": марка транспортного средства, [string]. Ознакомьтесь с соответствующим фильтром событий, чтобы узнать, какие производители поддерживаются в текущей версии.
- "model": модель транспортного средства, [string]. Ознакомьтесь с соответствующим фильтром событий, чтобы узнать, какие модели поддерживаются в текущей версии.
- "license_plate_number": регистрационный номер транспортного средства, [string]. Подстановочные знаки (wildcards), заменяющие другие символы, не поддерживаются.
- "license_plate_number_color": цвет номерного знака, [string]. Возможные значения: "unknown", "white", "yellow", "blue", "green", "grey".
- "license_plate_number_color_confidence_lte": максимальная достоверность распознавания цвета номерного знака, number.
- "license_plate_number_color_confidence_gte": минимальная достоверность распознавания цвета номерного знака, число.
- "license_plate_country": страна номерного знака, [string]. Ознакомьтесь с соответствующим фильтром событий, чтобы узнать, какие страны поддерживаются в текущей версии.
- "license_plate_region": регион номерного знака, словарь строк. Ознакомьтесь с соответствующим фильтром событий, чтобы узнать, какие регионы поддерживаются в текущей версии.
- "special_vehicle_type": спецназначение транспортного средства, [string]. Возможные значения: "taxi", "route_transport", "car_sharing", "ambulance", "police", "rescue_service", "gas_service", "military", "road_service", "other_special", "not_special".
- "weight_type": весовая категория транспортного средства, [string]. Возможные значения: "B_light", "B_heavy", "C_light", "C_heavy", "D_light", "D_long", "other".
- "weight_type_confidence_lte": максимальная достоверность распознавания весовой категории транспортного средства, number. Минимальное значение – 0, максимальное – 1.
- "weight_type_confidence_gte": минимальная достоверность распознавания весовой категории транспортного средства, number. Минимальное значение – 0, максимальное – 1.
- "orientation": ракурс транспортного средства, [string]. Возможные значения: "front", "back", "side".
- "orientation_confidence_lte": максимальная достоверность распознавания ракурса автомобиля, number. Минимальное значение – 0, максимальное – 1.
- "orientation_confidence_gte": минимальная достоверность распознавания ракурса автомобиля, number. Минимальное значение – 0, максимальное – 1.
Эпизоды с людьми:

Секция: human_episodes.
- "allowed_types": статус эпизода [string]. Возможные значения: открытие эпизода (episode_open), добавление нового события в эпизод (episode_event), закрытие эпизода (episode_close).
- "matched_lists": ID списка наблюдения, [integer].
- "cameras": ID камеры, [integer].
- "camera_groups": ID группы камер, [integer].
- "events_count_gte": минимальное количество событий в эпизоде, integer.
- "events_count_lte": максимальное количество событий в эпизоде, integer.
- "face_matched": статус совпадения лица в эпизоде с картотекой, логическое значение. Установите true, если только эпизоды с совпадениями лиц, или false, если только эпизоды без совпадений лиц должны вызывать отправку оповещения.
- "body_matched": статус совпадения силуэта в эпизоде с картотекой, логическое значение. Установите true, если только эпизоды с совпадениями силуэтов, или false, если только эпизоды без совпадений силуэтов должны вызывать отправку оповещения.
Эпизоды с транспортными средствами:

Секция: car_episodes.
- "allowed_types": статус эпизода [string]. Возможные значения: открытие эпизода (episode_open), добавление нового события в эпизод (episode_event), закрытие эпизода (episode_close).
- "matched_lists": ID списка наблюдения, [integer].
- "cameras": ID камеры, number.
- "camera_groups": ID группы камер, [integer].
- "events_count_gte": минимальное количество событий в эпизоде, integer.
- "events_count_lte": максимальное количество событий в эпизоде, integer.
- "car_matched": статус совпадения транспортного средства в эпизоде с картотекой, логическое значение. Установите true, если только эпизоды с совпадениями ТС, или false, если только эпизоды без совпадений ТС должны вызывать отправку оповещения.
Записи счетчиков:

Секция: counters.
- "counter": ID счетчика, [integer].
- "cameras": ID камеры, [integer].
- "camera_groups": ID группы камер, [integer].
- "faces_count_gte": минимальное количество лиц в записи счетчика, integer.
- "faces_count_lte": максимальное количество лиц в записи счетчика, integer.
- "silhouettes_count_gte": минимальное количество силуэтов в записи счетчика, integer.
- "silhouettes_count_lte": максимальное количество силуэтов в записи счетчика, integer.
- "cars_count_gte": минимальное количество транспортных средств в записи счетчика, integer.
- "cars_count_lte": максимальное количество транспортных средств в записи счетчика, integer.
- "proximity_min_lte": отправить оповещение, если минимальное задетектированное расстояние в метрах меньше указанной величины, number.
- "proximity_min_gte": отправить оповещение, если минимальное задетектированное расстояние в метрах больше указанной величины, number.
- "proximity_avg_lte": отправить оповещение, если среднее задетектированное расстояние в метрах меньше указанной величины, number.
- "proximity_avg_gte": отправить оповещение, если среднее задетектированное расстояние в метрах больше указанной величины, number.
- "proximity_max_lte": отправить оповещение, если максимальное задетектированное расстояние в метрах меньше указанной величины, number.
- "proximity_max_gte": отправить оповещение, если максимальное задетектированное расстояние в метрах больше указанной величины, number.
Пример

Примечание

Этот пример приведен только для ознакомления, подставьте свои значения в соответствующие поля.
```
{
  "name": "AA",
  "active": false,
  "url": "http://example.com",
  "batch_size": 1,
  "filters": {
    "face_events": {
      "matched_lists": [
        -1
      ],
      "camera_groups": [
        -1
      ],
      "cameras": [
        1
      ],
      "matched_card": [
        1
      ],
      "matched": false,
      "confidence_gte": 0,
      "bs_type": [
        "A"
      ],
      "line": [
        1
      ],
      "line_crossing_direction": [
        "AB"
      ],
      "backward_line_crossing": false,
      "headpose_yaw_angle_gte": -180,
      "headpose_yaw_angle_lte": -180,
      "headpose_pitch_angle_gte": -180,
      "headpose_pitch_angle_lte": -180,
      "gender": [
        "A"
      ],
      "age_lte": 0,
      "age_gte": 0,
      "glasses": [
        "A"
      ],
      "emotions": [
        "A"
      ],
      "beard": [
        "A"
      ],
      "medmask": [
        "A"
      ],
      "liveness": [
        "A"
      ],
      "temperature_gte": 0,
      "liveness_gte": 0
    },
    "body_events": {
      "matched_lists": [
        -1
      ],
      "camera_groups": [
        -1
      ],
      "cameras": [
        1
      ],
      "matched_card": [
        1
      ],
      "matched": false,
      "confidence_gte": 0,
      "bs_type": [
        "A"
      ],
      "line": [
        1
      ],
      "line_crossing_direction": [
        "AB"
      ],
      "backward_line_crossing": false,
      "headwear": [
        "A"
      ],
      "upper_clothes": [
        "A"
      ],
      "detailed_upper_clothes": [
        "A"
      ],
      "top_color": [
        "A"
      ],
      "lower_clothes": [
        "A"
      ],
      "bottom_color": [
        "A"
      ],
      "bag_hand": [
        "A"
      ],
      "bag_ground": [
        "A"
      ],
      "bag_back": [
        "A"
      ],
      "vest_type_score_gte": 0,
      "vest_type_score_lte": 0,
      "vest_type": [
        "A"
      ],
      "helmet_type_score_lte": 0,
      "helmet_type_score_gte": 0,
      "helmet_type": [
        "A"
      ],
      "age_group_score_lte": 0,
      "age_group_score_gte": 0,
      "age_group": [
        "A"
      ],
      "gender_score_lte": 0,
      "gender_score_gte": 0,
      "body_gender": [
        "A"
      ]
    },
    "car_events": {
      "matched_lists": [
        -1
      ],
      "camera_groups": [
        -1
      ],
      "cameras": [
        1
      ],
      "matched_card": [
        1
      ],
      "matched": false,
      "confidence_gte": 0,
      "bs_type": [
        "A"
      ],
      "line": [
        1
      ],
      "line_crossing_direction": [
        "AB"
      ],
      "backward_line_crossing": false,
      "category_confidence_gte": 0,
      "category_confidence_lte": 0,
      "category_type": [
        "A"
      ],
      "color": [
        "A"
      ],
      "body": [
        "A"
      ],
      "make": [
        "A"
      ],
      "model": [
        "A"
      ],
      "license_plate_number": [
        "A"
      ],
      "license_plate_number_color": [
        "A"
      ],
      "license_plate_number_color_confidence_lte": 0,
      "license_plate_number_color_confidence_gte": 0,
      "license_plate_country": [
        "A"
      ],
      "license_plate_region": [
        "A"
      ],
      "special_vehicle_type": [
        "A"
      ],
      "weight_type": [
        "A"
      ],
      "weight_type_confidence_lte": 0,
      "weight_type_confidence_gte": 0,
      "orientation": [
        "A"
      ],
      "orientation_confidence_lte": 0,
      "orientation_confidence_gte": 0
    },
    "human_episodes": {
      "allowed_types": [
        "A"
      ],
      "matched_lists": [
        -1
      ],
      "cameras": [
        1
      ],
      "camera_groups": [
        -1
      ],
      "events_count_gte": 0,
      "events_count_lte": 1,
      "face_matched": false,
      "body_matched": false
    },
    "car_episodes": {
      "allowed_types": [
        "A"
      ],
      "matched_lists": [
        -1
      ],
      "cameras": [
        1
      ],
      "camera_groups": [
        -1
      ],
      "events_count_gte": 0,
      "events_count_lte": 1,
      "car_matched": false
    },
    "counters": {
      "counter": [
        0
      ],
      "cameras": [
        0
      ],
      "camera_groups": [
        -1
      ],
      "faces_count_gte": 1,
      "faces_count_lte": 0,
      "silhouettes_count_gte": 1,
      "silhouettes_count_lte": 0,
      "cars_count_gte": 1,
      "cars_count_lte": 0,
      "proximity_min_lte": 0,
      "proximity_min_gte": 0,
      "proximity_avg_lte": 0,
      "proximity_avg_gte": 0,
      "proximity_max_lte": 0,
      "proximity_max_gte": 0
    },
    "areas": {
      "area_in": [
        0
      ],
      "camera_in": [
        0
      ],
      "camera_group_in": [
        -1
      ]
    }
  },
  "send_attempts": 0
}
```
Важно

Используйте только фильтры, соответствующие цели поиска. Для выключения фильтра удалите его из вебхука. Не оставляйте фильтр пустым ([]), поскольку это может повлиять на работу других фильтров, и фильтрация окажется нерезультативной.
Примечание

Для получения всех оповещений передайте скобки без вложенных фильтров:
```
{}
```
Совет

Пример №1. Получение оповещений обо всех событиях с транспортными средствами:
```
{ "car_events": {} }
```
Пример №2. Получение оповещений об открытии эпизодов с людьми с совпадениями в картотеке по лицам и силуэтам:
```
{ "human_episodes": { "allowed_types": ["episode_open"], "face_matched": true, "body_matched": true }}
```
Примечание

Вы можете задать несколько значений в фильтрах с квадратными скобками. В этом случае вебхук будет активироваться при совпадении одного из значений фильтра. В примере ниже вы будете оповещены о событии с силуэтом с группы камер 1 или 3, если совпала карточка с id 12 или 25.
```
{
        "body_events": {
                "camera_groups": [1, 3],
                "matched_card": [12, 25],
        },
}
```
Поставьте флажок Активная.
Нажмите Сохранить.

Как работает вебхук 

Для тестирования работы вебхука можно использовать следующий простой веб-сервер на Python, обеспечивающий захват отправленных вебхуком оповещений о событиях:

from pprint import pprint
from aiohttp import web


async def handle(request):
    pprint(await request.json())
    return web.Response(status=200)


app = web.Application()
# for aiohttp v 3.x
# app.add_routes([web.post('/', handle)])

# for aiohttp v 2.x
app.router.add_post('/', handle)

web.run_app(app, port=8888)

Важно

Используемый вами сервер-ловушка оповещений по вебхуку должен возвращать ответ HTTP 200 после получения вебхука от FindFace Multi, по аналогии с примером выше.

Если для вебхука не задано ни одного фильтра, данный веб-сервер будет получать оповещения обо всех произошедших в системе событиях, эпизодах, записях счетчиков.

Для просмотра статуса отправки вебхука в FindFace Multi выполните следующую команду:

sudo journalctl CONTAINER_NAME=findface-multi-findface-multi-legacy-1 -f | grep 'Webhook'

Подробные данные в вебхуках (Verbose)

По умолчанию оповещения по вебхуку содержат только идентификаторы таких сущностей, как карточки, списки наблюдения, камеры и группы камер. Для того чтобы получать подробную информацию по данным сущностям, включите подробный режим оповещений по вебхукам (режим verbose).

Для этого откройте файл конфигурации /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и установите в нем 'VERBOSE_WEBHOOKS': True:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...
FFSECURITY = {
    ...
    # send serialized cards, card-lists, camera and camera groups in webhooks
    'VERBOSE_WEBHOOKS': True,
    ...
}
...

После внесения изменений обязательно перезапустите контейнер findface-multi-findface-multi-legacy-1.

sudo docker container restart findface-multi-findface-multi-legacy-1

Внешние системы управления видео (VMS)

На стороне FindFace Multi реализован механизм интеграции с внешними системами управления видео (VMS), позволяющий добавлять камеры из них в FindFace Multi и осуществлять их обработку. После добавления камеры из VMS для нее становятся доступны все действия, которые доступны для обычной камеры FindFace Multi.

Интеграция с внешними VMS возможна через плагин. Взаимодействие между плагином и FindFace Multi осуществляется по HTTP. Плагин взаимодействует с VMS, FindFace Multi – с плагином.

В этой главе:

Создание сервисной учетной записи для плагина интеграции с VMS
Включение плагина в FindFace Multi
Создание новой базы данных в PostgreSQL
Установка и настройка плагина для интеграции VMS с FindFace
Добавление внешних VMS в FindFace Multi

Этот раздел содержит пошаговое руководство по установке и настройке функции внешних VMS в FindFace Multi. Пользователь должен иметь большой опыт администрирования ОС Linux и контейнеров Docker.

Создание сервисной учетной записи для плагина интеграции с VMS 

Создайте пользователя (имя пользователя: ntech) с определенным набором разрешений, который будет использоваться в качестве сервисной учетной записи для плагина интеграции. Для этого выполните приведенную ниже команду:

adduser --system --disabled-password --disabled-login --home /var/empty \
                --no-create-home --quiet --force-badname --group ntech

Включение плагина в FindFace Multi 

Откройте файл /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и найдите раздел External VMS Integration settings.
Измените параметр 'ENABLED' на True.
Запомните значение TOKEN, так как оно вам понадобится для настройки плагина позже. Значение по умолчанию – PLUGIN_TOKEN. Пожалуйста, обратите внимание, что префикс токена VmsPluginToken должен быть только в конфигурационном файле findface-multi-legacy.py.
... # -- External VMS integration settings -- # cleanup settings 'EXTERNAL_VMS_EVENTS_MAX_AGE': 0, 'EXTERNAL_VMS_SEND_EVENTS_STATUS_MAX_AGE': 0, 'EXTERNAL_VMS': { 'ENABLED': True, 'PLUGIN_ADDRESS': 'http://127.0.0.1:18333', 'TOKEN': 'VmsPluginToken PLUGIN_TOKEN', 'EVENT_SENDER': { 'ENABLED': True, 'ALLOWED_TYPES': ['face'], 'SENDER_TASKS': 1, 'MAX_SEND_ATTEMPTS': 1, 'MIN_EVENT_SEND_TIMEOUT': 0.1, 'MAX_EVENT_SEND_TIMEOUT': 100, 'RESPONSE_TIMEOUT': 10, }, }, ...
Совет

В нашем примере мы устанавливаем плагин на тот же хост, где развернут FindFace Multi. В случае использования отдельного компьютера, пожалуйста, укажите правильный адрес сервера, на котором находится плагин интеграции с VMS, в параметре PLUGIN_ADDRESS.

Примечание

Если вам нужно отправлять события на VMS, пожалуйста, также установите значение 'ENABLED': True в разделе EVENT_SENDER.
Перезапустите контейнер findface-multi-findface-multi-legacy-1 .
sudo docker container restart findface-multi-findface-multi-legacy-1

Краткое описание параметров приведено ниже:

Параметр	Описание
EXTERNAL_VMS_EVENTS_MAX_AGE	Время хранения событий, полученных от VMS (дни). 0 – неограниченно.
EXTERNAL_VMS_SEND_EVENTS_STATUS_AGE	Время хранения событий, отправленных в VMS (дни). 0 – неограниченно.
EXTERNAL_VMS: ENABLED	Статус модуля интеграции VMS c FindFace. Если `ENABLED`, то в пользовательском интерфейсе появится опция “Внешние VMS”.
PLUGIN_ADDRESS	IP адрес плагина.
TOKEN	Токен, необходимый плагину интеграции с VMS для аутентификации в Findface Multi (должен соответствовать токену в файле конфигурации плагина).
EVENT_SENDER:ENABLED	Если `True`, все совпадающие события в Findface Multi будут отправлены во внешние VMS.
ALLOWED_TYPES	Типы отправляемых объектов. В настоящее время поддерживаются только объекты «Лица».
SENDER_TASKS	Количество одновременных задач для отправки событий в плагин. Значение по умолчанию = 1. При необходимости оно может быть увеличено. За дополнительной информацией обратитесь к нашим экспертам за консультацией (support@ntechlab.com).
MAX_SEND_ATTEMPTS	Количество попыток отправки до того, как она будет признана неудачной.
MIN_EVENT_SEND_TIMEOUT MAX_EVENT_SEND_TIMEOUT	Время между попытками отправки, если произошла неудачная отправка. Оно будет расти экспоненциально от минимума к максимуму до тех пор, пока увеличивается количество попыток MAX_SEND_ATTEMPTS.
RESPONSE_TIMEOUT	Время ожидания ответа от плагина при отправке события.

Создание новой базы данных в PostgreSQL 

Откройте файл /opt/findface-multi/docker-compose.yaml и запишите значение POSTGRES_PASSWORD. Оно понадобится для следующего шага.
sudo vi /opt/findface-multi/docker-compose.yaml ... postgresql: environment: {POSTGRESQL_ALLOW_REMOTE_CONNECTIONS: 'no', POSTGRES_PASSWORD: POSTGRES_PASSWORD} ...
Войдите в контейнер findface-multi-postgresql-1, выполнив следующую команду:
sudo docker exec -i findface-multi-postgresql-1 /bin/bash -c "PGPASSWORD={POSTGRES_PASSWORD} psql --username postgres"
Чтобы убедиться, что вы успешно вошли в контейнер, используйте команду \l для просмотра списка баз данных:
Выполните следующую команду, чтобы создать новую базу данных, необходимую для работы VMS:
CREATE DATABASE ffsintegration WITH OWNER ntech ;
Подтвердите создание базы данных, снова выполнив команду \l. После завершения используйте параметр \q для выхода из PostgreSQL.

Установка и настройка плагина для интеграции VMS с FindFace 

Откройте файл /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py и найдите раздел DATABASES. Запомните значение PASSWORD для пользователя ntech:

sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

...
# camera groups, watchlists and so on. Only PostgreSQL is supported.
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'DISABLE_SERVER_SIDE_CURSORS': True,
        'NAME': 'ffsecurity', 'HOST': '127.0.0.1', 'PORT': 5439, 'USER': 'ntech', 'PASSWORD': 'PASSWORD'
    }
}

Запросите плагин findface-vms-integration-plugin.img у представителя компании NtechLab.

Загрузите плагин в систему.

docker load < findface-vms-integration-plugin.img

Отредактируйте файл /opt/findface-multi/docker-compose.yaml, добавив в него секцию findface-vms-integration-plugin.

cd /opt/findface-multi/

sudo vi docker-compose.yaml

Добавьте секцию findface-vms-integration-plugin в конец файла docker-compose.yaml.

findface-vms-integration-plugin:
  depends_on: [findface-ntls, postgresql, findface-multi-legacy]
  image: findface-vms-integration-plugin:latest
  network_mode: service:pause
  volumes: ['./configs/findface-vms-integration-plugin/findface-vms-integration-plugin.conf:/etc/findface-vms-integration-plugin.conf']
  restart: always

Создайте конфигурационный файл для плагина.

sudo mkdir configs/findface-vms-integration-plugin/
sudo vi configs/findface-vms-integration-plugin/findface-vms-integration-plugin.conf

Ниже приведен пример конфигурационного файла findface-vms-integration-plugin.conf.

# URL prefix for API version 1 endpoints
# Default: /api/v1
#
API_V1_STR: /v1

# App listens on this interface. Set it to 0.0.0.0 to listen on all available interfaces
# Default: 127.0.0.1
#
# HOST: 127.0.0.1

# App accepts HTTP connections on this port
# Default: 18333
#
# PORT: 18333

# Public URL for App
# Default: http://127.0.0.1:18333
#
# PUBLIC_URL: http://127.0.0.1:18333

# Public URL for FFS
# Default: http://127.0.0.1
#
# FFS_PUBLIC_URL: http://127.0.0.1:18333

# Full database URL dialect+driver://username:password@host:port/database.
# Alternatively, connection parameters can be specified one by one (see below).
#
# SQLALCHEMY_DATABASE_URI:

# Database host
#
POSTGRES_SERVER: 127.0.0.1

# Database port number
#
POSTGRES_PORT: 5432

# Database user
#
POSTGRES_USER: ntech

# Database user password
#
POSTGRES_PASSWORD: POSTGRES_PASSWORD

# Database name
#
POSTGRES_DB: ffsintegration

# Log SQL statements
# Default: FALSE
#
# LOG_QUERIES: FALSE

# Secret token used to validate requests made by FindFace Security
# Required: yes
#
FFS_TOKEN: PLUGIN_TOKEN

# Include traceback information in error responses
# Default: FALSE
#
RESP_TRACEBACK: True

# Logging level
# Default: INFO
#
# LOG_LEVEL:

# Enable journald log handler.
# Default: TRUE
#
# LOG_TO_JOURNALD: TRUE

# Timeout for requests to VMS
# Default: 10
#
# VMS_REQUEST_TIMEOUT_SEC: 10

# Timeout for requests to FindFace
# Default: 10
#
# FF_REQUEST_TIMEOUT_SEC: 10

Совет

В нашем примере мы устанавливаем плагин на тот же хост, где развернут FindFace Multi. В случае использования отдельного компьютера, пожалуйста, укажите правильный адрес сервера FindFace Multi в параметре POSTGRES_SERVER, а URL – в параметре FFS_PUBLIC_URL.

Если вы установили плагин на тот же хост, что и FindFace Multi, то вам нужно только добавить правильный логин и пароль для локальной базы данных PostgreSQL.
POSTGRES_USER: ntech POSTGRES_PASSWORD: POSTGRES_PASSWORD
Значение POSTGRES_PASSWORD можно получить из файла /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py.
Для включения внешнего плагина VMS в FindFace Multi запустите все контейнеры FindFace Multi из директории /opt/findface-multi.
sudo docker-compose up -d
Откройте FindFace Multi в браузере. Вы увидите, что появился раздел Настройки -> Внешние VMS.

Предупреждение

Для корректного воспроизведения видеоархивов с внешних VMS необходимо установить на внешнем сервере VMS тот же часовой пояс, что и на сервере FindFace Multi.

Добавление внешних VMS в FindFace Multi 

В разделе Настройки -> Внешние VMS нажмите на кнопку Новая VMS.
Укажите параметры вашей VMS в открывшихся окнах и нажмите на кнопку Сохранить, как только все будет готово:
После завершения теперь вы можете управлять потоками со своих VMS на вкладке Камеры. Например, вы можете мгновенно добавить все или выбранные камеры в FindFace Multi.
Если вам нужно отправить события на внешнюю VMS, в настройках камеры, добавленной из VMS, проверьте, настроена ли отправка событий на внешние VMS:
В обязательных свойствах списка наблюдения установите флажок Отправка событий сопоставления в VMS и нажмите на кнопку Сохранить, чтобы применить изменения.
Отправленные и полученные сообщения можно просмотреть на соответствующих вкладках выбранной VMS:
Если Видеомагнитофон развернут и настроен, вы можете воспроизводить видеоархивы из внешних систем управления видео VMS (Axxon, Trassir и Hikcentral) через него. Чтобы использовать эту функциональность, сначала убедитесь, что камера, добавленная из внешних VMS, активна. Затем перейдите на вкладку Эпизоды и события и наведите курсор на интересующее вас событие или эпизод. На миниатюре объекта (лица/силуэта или транспортного средства) отобразится кнопка play. Нажмите на нее, чтобы начать воспроизведение видео с того момента, когда было зафиксировано событие или эпизод с камеры.

Вы также можете воспроизводить видеоархив через камеру, нажав play на миниатюре камеры в списке камер на вкладке Источники видео. В результате видео с камеры внешних VMS будет отображаться в видеомагнитофоне. Если в указанное время в FindFace Multi имеется записанный видеоархив, то в видеомагнитофоне будет воспроизводиться он, а не видеоархив из внешних VMS.

Теперь ваша установка FindFace Multi расширена и поддерживает внешние VMS. Вы можете подключить столько VMS, сколько потребуется, и легко добавлять существующие видеопотоки в FindFace всего за несколько кликов.

Внешние детекторы

Существует возможность интеграции FindFace Multi с внешними детекторами, предоставляющими кадры для распознавания объектов, например, с терминалами контроля доступа. В этом случае при получении кадра от внешнего детектора FindFace Multi будет автоматически инициировать извлечение вектора признаков объекта и создание события. Работа с данными событиями выполняется по аналогии с событиями с камер видеонаблюдения.

Важно

Чтобы использовать внешний детектор для распознавания объектов, необходимо включить определение витальности лиц. Если вы не включили определение витальности лиц при установке продукта, можно сделать это сейчас, воспользовавшись информацией из раздела Включение определения витальности лиц.

Модель для определения витальности liveness.web.v0, включенная в конфигурацию по умолчанию, используется для аутентификации по лицу. Если ваш сценарий использования подразумевает подключение к внешнему детектору для распознавания объектов, замените модель liveness.web.v0 на модель liveness.pacs.v2 в файле конфигурации findface-extraction-api.yaml. Так как обе модели используют один и тот же нормализатор facenorm.multicrop_full_crop2x_size400.cpu.fnk, менять его не нужно.

Замените модель для liveness в файле конфигурации /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml:

GPU

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

extractors:
  ...
  models:
    face_liveness: faceattr/liveness.pacs.v2.gpu.fnk
    ...

CPU

sudo vi /opt/findface-multi/configs/findface-extraction-api/findface-extraction-api.yaml

extractors:
  ...
  models:
    face_liveness: faceattr/liveness.pacs.v2.cpu.fnk
    ...

Перезапустите контейнер findface-multi-findface-extraction-api-1.

sudo docker container restart findface-multi-findface-extraction-api-1

Интеграция внешних детекторов выполняется через HTTP API. После первичной настройки FindFace Multi выдаст токен. Указывайте данный токен в каждом API-запросе, отправляемом внешним детектором в FindFace Multi, чтобы авторизовать устройство.

Для интеграции внешнего детектора с FindFace Multi выполните следующие действия:

Перейдите в Источники Видео -> Внешние детекторы
Нажмите + Добавить или + Добавить внешние детекторы, если еще не добавлено ни одного детектора.
В открывшейся вкладке добавьте внешний детектор в группу камер, чтобы впоследствии было удобнее фильтровать события с данного устройства.

Совет

Вы можете выделить отдельную группу камер специально под внешние детекторы.
На вкладке Добавить и настроить включите liveness. На этой же вкладке вы увидите токен.
Указывайте данный токен в каждом API-запросе, отправляемом внешним детектором в FindFace Multi для создания события. В результате кадры, переданные в запросах, будут связаны с камерой, соответствующей внешнему детектору, и обработаны по аналогии с кадрами с камер видеонаблюдения.

Подробная интерактивная документация HTTP API FindFace Multi доступна после установки по адресу http://<ffsecurity_ip:port>/api-docs. Изучайте и пробуйте.

Совет

Документацию также можно найти в веб-интерфейсе, перейдя в меню по пунктам Настройки -> Документация API.

Тревожный монитор

В этом разделе:

Подготовка сервера
Настройка событий
Настройка приложения
Работа с тревожным монитором

FindFace Multi позволяет встроить дополнительную функциональность «Тревожный монитор», который отображает информацию об отдельных сигналах тревоги и событиях по мере их возникновения. Это позволяет повысить информированность службы охраны о критичных событиях. Тревожный монитор не может быть перекрыт другими окнами, не может быть изменена конфигурация на отключение звука, что делает его более простым инструментом для мониторинговых центров. Операторы могут подтвердить сигналы тревоги или отменить их.

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

Для работы с сервисом тревожного монитора FindFace Multi использует Annex - программную платформу, предоставляющую инструментарий видеоаналитики. Annex устанавливается по умолчанию при разворачивании FindFace Multi и включает в себя набор компонентов и сервисов:

Компонент	Используемые порты	Описание	Поставщик
backend_provider	1111	Сервис, который предоставляет интерфейс (REST API) для поставки данных различным микросервисам, обогащает при необходимости входные данные и конвертирует их в нужный формат.	Собственная разработка NtechLab
backend_api	2222	Сервис, который предоставляет интерфейс (REST API) к базам данных прикладных сервисов, а также прокси-интерфейс к FindFace Multi и FindFace Server.
service_notifier	3311	Служебный сервис-проводник для рассылки уведомлений (Notify) по различным клиентским каналам (WebSocket, Telegram, Mail), а также для отправки клиентских ответов (Reply) обратно сервисам.
alarm-app	4444	Веб-сервис тревожного монитора.
service_alarmer	н/п	Прикладной сервис для объявления сообщений тревоги с возможностью подтверждения пользователем.

Annex получает события из FindFace Multi через вебхуки и отправляет их в Тревожный монитор.

Перед запуском тревожного монитора, убедитесь, что Annex развернут и выполните некоторые предварительные действия в FindFace Multi.

Убедитесь, что все сервисы Annex запущены.
```
sudo docker ps -a
```
Для корректной работы тревожного монитора с Annex необходимо включить параметр VERBOSE_WEBHOOKS – для получения информации о вебхуке, линии пересечения, карточке, с которой произошло сопоставление, а также SAVE_DETECTOR_PARAMS – для получения информации о bbox.
```
sudo vi /opt/findface-multi/configs/findface-multi-legacy/findface-multi-legacy.py

FFSECURITY = {
    ...
    # send serialized cards, card-lists, camera and camera groups in webhooks
    'VERBOSE_WEBHOOKS': True,
    ...
    # save full detector params from video worker request
    'SAVE_DETECTOR_PARAMS': True,
    ...
}
```
Перезапустите контейнер findface-multi-findface-multi-legacy-1.
```
sudo docker container restart findface-multi-findface-multi-legacy-1
```
В веб-интерфейсе FindFace Multi создайте пользователя. См. Управление ролями и пользователями. Используйте эти учетные данные для входа в Тревожный монитор.

Настройка событий 

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

Чтобы отслеживать события, выполните следующие действия:

В веб-интерфейсе FindFace Multi перейдите во вкладку Настройки. Выберите Вебхуки.
Нажмите Новый вебхук.
Укажите заголовок вебхука.
Укажите URL адрес, на который будут отправляться оповещения http://ip_address:port/ff_multi/alarmer/.

Примечание

Подставьте вместо ip_address:port свой IP адрес для Annex и порт для annex-backend_provider-1, например http://127.0.0.1:1111/ff_multi/alarmer/.
Укажите фильтры.

Настройка приложения 

Приложение доступно для разных платформ и операционных систем.
Установка приложения выполняется стандартными для вашей ОС способами, а также оно доступно в веб-интерфейсе из навигационной панели FindFace Multi.

Примечание

Мы рекомендуем установить приложение Тревожный монитор. Пожалуйста, свяжитесь с нашей службой поддержки и отделом продаж по адресу support@ntechlab.com, чтобы получить последнюю версию приложения.

Выполните следующие действия:

Загрузите последнюю версию приложения Тревожный монитор для вашей операционной системы.
Запустите исполняемый файл для запуска приложения.
Перейдите в настройки.

Примечание

Если вы используете веб-интерфейс для запуска тревожного монитора, введите http://ip_address:4444/config/ в адресной строке, чтобы перейти к настройкам. Где ip_address – это IP-адрес, доступный для Annex.
Выберите звуковой сигнал и его громкость.
При необходимости, протестируйте звук и громкость тревоги, нажав на кнопку Имитация тревоги.
Укажите адрес веб-сервера, например ws://ip_address/annex.

Примечание

ip_address – это IP-адрес, доступный для Annex.
Выберите язык приложения.
Нажмите Применить.
Нажмите Вход.
Введите имя пользователя и пароль.

Работа с тревожным монитором 

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

Тревожный монитор поддерживает следующие типы тревожных событий:

Пересечение линии (линия и трек отображаются только для силуэтов)
Совпадения/не совпадения со списками (для лиц, силуэтов и ТС)
Счетчики (bbox отображаются только для силуэтов)

Пример события пересечения линии

На экране отображается следующие элементы:

Полный кадр события с bbox’ом силуэта, линией пересечения и треком объекта
Фотография силуэта человека, пересекшего линию
Заголовок вебхука
Группа камер/камера
Дата и время события

Пример события совпадения объекта (лица/силуэта)

На экране отображается следующие элементы:

Полный кадр события
Фотография объекта из видеопотока
Фотография объекта их картотеки, с которым произошло сопоставление
Списки наблюдения в которых содержится человек/ТС
Заголовок вебхука
Группа камер/камера
Дата и время события

Пример события счетчика

На экране отображается следующие элементы:

Полный кадр события
Скриншот
Название счетчика и количество силуэтов на скриншоте
Заголовок вебхука
Группа камер/камера
Дата и время события

Нажмите Принять, чтобы принять тревогу или Отмена, чтобы отклонить. Подтверждение тревоги ожидается в течение 90 секунд по умолчанию. По истечении интервала происходит автоматическое подтверждение. Вы можете изменить это значение, используя параметр ack_interval в URL вебхука, например http://127.0.0.1:1111/ff_multi/alarmer/?ack_interval=180. Если значение равно 0, то подтверждение не ожидается.

Аналитический сервис BI

Аналитический сервис BI – это сервис для сбора, хранения, визуализации и интерпретации данных за некоторый период в соответствии с определенной логикой. Сервис работает в связке с FindFace Multi следующим образом:

FindFace Multi генерирует массив данных.
Сервис аналитики осуществляет сбор, консолидацию и хранение данных.
BI-система служит для визуализации данных.

В настоящее время аналитика работает только для пересечения линий.

Развертывание аналитического сервиса и BI-системы Superset

Аналитический сервис и BI-система Superset устанавливаются вместе с FindFace Multi из одного дистрибутива. Выберите соответствующие пункты во время инсталляции.

В: Do you want to install Analytics service?(y/n) (Хотите ли вы установить сервис аналитики?)

О: Ответьте y для установки сервиса аналитики.

В: Do you want to install Superset BI?(y/n) (Хотите ли вы установить BI-систему Superset?)

О: Отвечая y на этот вопрос, вы выбираете установку программного приложения с открытым исходным кодом Apache Superset. Если вы предпочитаете собственную BI-систему, вы можете пропустить предложенную установку и ответить n.

Предварительные действия в FindFace Multi

Для того чтобы данные появились в BI-системе, выполните некоторые предварительные действия в FindFace Multi. Нарисуйте виртуальную ломаную линию на нужной камере в FindFace Multi, выберите объект(ы). Подробная информация о создании линии представлена в разделе Пересечение линий. На вкладке BI Аналитика добавьте информацию о созданной линии. Описание атрибутов линии поможет объединить разные данные на одном графике в BI-системе или отсортировать ненужные данные.

После того как вы создали линию, система начнет создавать события, связанные с пересечением линии, с указанием направления пересечения. На графике вы сможете увидеть количество пересечений линии (трафик) с фильтром по направлению пересечения. Вы также сможете сравнивать одни и те же данные о пересечении линии за несколько периодов.

Работа с BI-системой Superset

После установки аналитического сервиса и BI-системы Superset на панели навигации веб-интерфейса появится кнопка Аналитика BI. При нажатии на кнопку в отдельной вкладке откроется веб-интерфейс BI-системы. Адрес веб-интерфейса системы будет зависеть от интерфейса, который вы выбрали при установке экземпляра продукта на шаге №4.5. Используемый порт – 8088, например, 192.168.112.254:8088. В качестве логина и пароля по умолчанию используются учетные данные admin | admin. Позже пароль можно изменить на вкладке Settings -> Info (здесь и далее информация представлена для BI-системы Apache Superset).

На графиках просматривайте общий трафик или трафик по конкретному объекту. К графикам можно применить фильтры, расположенные на левой боковой панели.

Для конкретного объекта отслеживайте атрибуты трафика (для лиц и силуэтов: пол, возраст, наличие маски или СИЗ и другие атрибуты; для транспортных средств: категория, марка автомобиля, принадлежность к спецтранспорту и другие атрибуты).

Для включения нужного языка в пользовательском интерфейсе раскомментируйте его, убрав # в конфигурационном файле /opt/findface-multi/configs/superset/superset_config.py.

sudo vi /opt/findface-multi/configs/superset/superset_config.py

LANGUAGES = {
   "en": {"flag": "us", "name": "English"},
   # "es": {"flag": "es", "name": "Spanish"},
   # "it": {"flag": "it", "name": "Italian"},
   # "fr": {"flag": "fr", "name": "French"},
   # "zh": {"flag": "cn", "name": "Chinese"},
   # "ja": {"flag": "jp", "name": "Japanese"},
   # "de": {"flag": "de", "name": "German"},
   # "pt": {"flag": "pt", "name": "Portuguese"},
   # "pt_BR": {"flag": "br", "name": "Brazilian Portuguese"},
   "ru": {"flag": "ru", "name": "Russian"},
   # "ko": {"flag": "kr", "name": "Korean"},
   # "sk": {"flag": "sk", "name": "Slovak"},
   # "sl": {"flag": "si", "name": "Slovenian"},
   # "nl": {"flag": "nl", "name": "Dutch"},
}

Перезапустите контейнер findface-multi-superset-1.

sudo docker container restart findface-multi-superset-1

На верхней панели выберите нужный язык в выпадающем меню:

Многофункциональная система видеоаналитики FindFace Multi

Новое в FindFace Multi 2.1

Руководство системного администратора

Архитектура

Требования

Развертывание и удаление FindFace Multi

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

Подготовка сервера CentOS 7

Подготовка сервера Debian 11

Автоматическое односерверное развертывание FindFace Multi

Развертывание FindFace Video Worker на удаленных серверах

Пошаговое развертывание Видеомагнитофона

Полностью настраиваемая установка

Стандартное развертывание в многосерверной среде

Установка моделей нейронных сетей

Процедуры и первичные инструкции после развертывания

Удаление экземпляра продукта

Администрирование и основная конфигурация

Лицензирование

Основные настройки

Управление пользователями и безопасность системы

Управление ролями и пользователями

Аутентификация и мониторинг сессии пользователя

Настройка шифрования данных

Включение защиты картотеки

Отключение ACL

Список сессий пользователей. Блокировки

Разрешенные расширения файлов в карточках

Группы камер

Привязка группы камер к экземпляру findface-video-worker

Списки наблюдения

Настройка сохранения изображений в отчетах

Дедупликация событий

Включение защиты персональных данных

Настройка Видеомагнитофона

Удаление видеозаписей

Пользовательские вкладки, поля и фильтры в карточке

Пользовательские метаданные в Tarantool

Пакетная загрузка карточек через консоль

Настройка нейронных сетей FindFace Multi

Обзор моделей нейронных сетей

Распознавание лиц и их атрибутов

Распознавание положения головы

Возможные сценарии использования распознавания положения головы

Как настроить функциональность распознавания положения головы

Распознавание транспортных средств и их атрибутов

Интерпретация результатов распознавания ТС

Распознавание спецтранспорта

Распознавание силуэтов и их атрибутов

Включение определения витальности лиц

Миграция векторов признаков на другую модель нейронной сети

Деактивация сервиса findface-liveness-api, установленного вместе с FindFace Multi

Обслуживание и устранение неисправностей

Обновление до FindFace Multi 2.1

Резервное копирование и восстановление FindFace Multi и его данных

Изменение структуры базы данных векторов признаков

Проверка статуса компонентов

Логирование

Устранение неполадок с лицензированием и findface-ntls

Ручная очистка базы данных от старых данных

Сброс пароля

Подключение S3-совместимого хранилища

Настройка S3-совместимого хранилища

Настройка FindFace Multi для работы S3-совместимого хранилища

Команда для переноса данных

Многоуровневое хранение данных

Привязка группы камер к экземпляру `findface-video-worker`

Деактивация сервиса `findface-liveness-api`, установленного вместе с FindFace Multi

Устранение неполадок с лицензированием и `findface-ntls`