Диагностика и устранение неполадок

Описание ошибок в логах

Fatal

Критические ошибки, в результате которых прекращается работа отдельных модулей или всего OMNI Agent. В журнале имеют тип “fatal”. Для устранения ошибки потребуется перезапустить OMNI Agent.

Конфигурация

• Не найден каталог с конфигурацией OMNI Agent.

  ReconfigurationHandlerImpl couldn't find configs dir

  Неверно указан путь к папке OMNIAgent при запуске OMNI Agent или в папке OMNIAgent отсутствует каталог config.
• Ошибка при попытке обновления конфигурации.

  ReconfigurationHandlerImpl settingsFetchThread exception: <error message>

Инфраструктура

• Нарушение работы внутренней очереди OMNI Agent.

  Fatal exception catched: ‘Task queue is not valid’

• Произошло необработанное исключение в главном потоке OMNI Agent.

  QVideomod exception catched: <error message>

  • Одна из причин - некорректный формат json-файлов конфигурации (например, в результате ручных правок). В этом случае <error message> может быть таким:

    [json.exception.parse_error.XXX] parse error at line YYY, column ZZZ: <error context>

Внутренние модули

• Ошибка в модуле <module name> при обработке сообщения внутренней очереди OMNI Agent. Модуль прекращает свою работу.

  <module name> workerThreadFunc exception: <error message>

• Ошибка инициализации сервиса обработки видеопотоков Face SDK.

  VideoworkerCallbacksHandler Exception during setup: <error message>

• Критическая ошибка в провайдере OpenNI.

  <failed method name> failed: ‘<error message>’

Error

Нарушение работы одного из модулей. В журнале такие ошибки имеют тип "error". При возникновении ошибок модуль и OMNI Agent в целом могут сохранять работоспособность.

Активация

• Ошибка в параметрах конфигурации модуля активации.

  libactivation error configure license params

  Проверить содержимое файлов конфигурации TDV/tdv_connection_params.json и TDV/method_version.json.
• Ошибка работы с файлом активации OMNI Agent.

  libactivation error check activation file

  Файл активации activation.json отсутствует, поврежден или недоступен для чтения. Решение: переактивация OMNI Agent.
• Не удалось считать файл локальной лицензии.

  libactivation couldn't read license file: <file path>

  Файл лицензии отсутствует, поврежден или не доступен для чтения. Убедитесь, что файл лицензии доступен.

БД

• Ошибка в ответе на запрос изменений БД к сервису синхронизации БД.

  DatabaseTDVHelperImpl::getDiffFromServer server error <error message>

  • Проверить доступность сервиса синхронизации OMNI Platform.
  • Переактивировать OMNI Agent.

• Неспецифицированная ошибка в модуле синхронизации БД OMNI Agent с БД OMNI Platform

  DatabaseTDV updateDatabase error: <error message>

  • Дождитесь следующей синхронизации.
  • При повторе ошибки переактивируйте OMNI Agent.
  • При повторе ошибки удалите локальную базу OMNI Agent.

• Ошибка синхронизации БД OMNI Agent с БД OMNI Platform

  DatabaseTDV fetchDatabase error: <error message>

  • Дождитесь следующей синхронизации.
  • При повторе ошибки переактивируйте OMNI Agent.
  • При повторе ошибки удалите локальную базу OMNI Agent.

• Ошибка при обновлении профиля в локальной БД OMNI Agent: некорректная версия шаблона.

  DatabaseTDV incorrect template version: ‘<method name>’ for profile <profile uuid>

  • Удалите локальную базу OMNI Agent.

• Ошибка при инициализации локальной БД OMNI Agent.

  DatabaseTDV Initial set database failed: <error message>

  • Убедитесь, что на диске, где размещается рабочий каталог OMNI Agent, есть свободное пространство.
  • Удалите локальную базу OMNI Agent.

• В модуле синхронизации БД OMNI Agent поток синхронизации прекратил свою работу в результате ошибки.

  DatabaseSyncHandlerImpl databaseSyncThread: error occurred: <error message>

  Перезапустите OMNI Agent.

HTTP Server

• Ошибка при обработке запроса к HTTP серверу OMNI Agent.

  VideomodHttpServer has error in callback handler <method name> : <error message>

  Перезапустите OMNI Agent.

• Необработанное исключение в потоке обработки запросов HTTP-сервера OMNI Agent.

  WorkerThreadFunc: error occurred: <error message>

  Перезапустите OMNI Agent.

Агрегация данных пайплайнов

• Ошибка рассинхронизации событий окончания и матчинга трека лица.

  HumanProcessHandlerImpl ::NON_MATCH_ATTENTIONS_WRAPPED_EVENT null face process - <face id>

  Может проявляться при перегрузке аппаратных средств. Рекомендуется уменьшить число используемых потоков.

Прочее

• Ошибка в потоке обработки задач внутренней очереди OMNI Agent.

  Queue QueueThreadFunc: error occurred: <error message>

• Ошибка при отправке событий в OMNI Platform

  ServerPostEventHandlerImpl Bad response from platform: <error code> (<error message>). Raw data length: <data length>

• Ошибка в конфигурации модуля преобразования координат (используется для трекинга на карте помещения): недостаточное число точек конфигурации.

  ViewTransformingHandler: invalid calibration configuration

  • Выполните калибровку камер через веб-интерфейс OMNI Agent.
  • Переактивируйте OMNI Agent.

• Ошибка в конфигурации вебхука: не задан адрес хоста.

  WebhooksHandlerImpl empty/no legacy address provided (skip)

  Установите адрес вебхука через веб-интерфейс OMNI Agent.

• Ошибка при копировании файлов.

  Error while copying files: from <source> to <dest>. Call terminate

  Может возникнуть при восстановлении конфигурации по умолчанию, если файлы конфигурации недоступны для записи или конфигурация по умолчанию отсутствует/недоступна. Проверьте наличие и доступность директорий config и config.default.

Дефолтный порт для запуска веб-сервера OMNI Agent занят (Windows)

По умолчанию OMNI Agent запускается на порту 8080. Если порт занят, веб-сервер становится недоступен.

Решение: перейдите по ссылке

Ошибка установки на Astra Linux

Решение: ошибка не влияет на работу OMNI Agent, просто пропустите все подобные сообщения.

Инсталлятор OMNI Agent не запускается на некоторых Linux (Ubuntu) дистрибутивах

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

Решение: скопируйте команду из окна ошибки в терминал, запустите ее с sudo (или от имени пользователя с root привелегиями) и нажмите OK в окне ошибки.

OMNI Agent не запускается при включенном GPU

Решение: выполните шаги по диагностике вашей видеокарты:

1. Проверьте установку CUDA Toolkit и убедитесь, что драйверы NVIDIA подходят для установленной версии.

   1.1 Чтобы узнать версию CUDA Toolkit, установленную на вашем компьютере, воспользуйтесь командой:

   nvcc --version

   В примере ниже на нашем компьютере установлена версия CUDA Toolkit 11.8.

   

   Поддерживаемые версии CUDA Toolkit. Если требуется обновить или установить новую версию, следуйте инструкциям на сайте NVIDIA.

   1.2 Проверьте версию CuDNN:

   Linux:

   cat /usr/local/cuda/include/cudnn_version.h | grep CUDNN_MAJOR -A 2

   Windows:

   cat "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDNN8.5\include\cudnn_version.h” | grep CUDNN_MAJOR -A 2

   1.3 Убедитесь, что последняя версия драйвера NVIDIA установлена и работает корректно:

   nvidia-smi

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

   В примере ниже версия драйвера NVIDIA 530.41.03 поддерживает CUDA Toolkit версии 12.1 или ниже.

   

   Также, можно обновить драйверы на своем компьютере и отключить автообновление драйверов. Проверить совместимость версии CUDA Toolkit с драйверами можно на сайте NVIDIA.

2. Для проверки общей работоспособности CUDA Toolkit скомпилируйте и запустите CUDA Samples.

Не освобождается занятая память при многократном удалении и повторном добавлении камер

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

Решение: После настройки OMNI Agent (списка камер), перезапустите его. В дальнейшем потребление памяти не должно увеличиваться.

Если все-таки при изменении набора камер память не освобождается, выполните одну из инструкций ниже:

• Для Linux/Windows

  • Отключите swapfile, чтобы OMNI Agent мог быстро перезапуститься без DOS-системы.

• Для Linux

  • Установите следующие значения переменных окружения в файлах run.sh и OMNIAgent.sh в папке установки OMNI Agent (по умолчанию /opt/OMNIAgent):
    • MALLOC_MMAP_THRESHOLD_=65535
    • MALLOC_TRIM_THRESHOLD_=65535
  • Перезапустите OMNI Agent.

ВНИМАНИЕ

Изменение значений переменных окружения может привести к снижению качества работы алгоритмов OMNI Agent.

Медленное чтение или запись базы данных на ОС Windows.

Возможное решение: Отключить Защиту в реальном времени в настройках Windows Defender. Было обнаружено значительное замедление операций чтения и записи в базу данных при его активации.