Перейти к основному содержимому
Версия: 2.7.1

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

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

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

img.jpg

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

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

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

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

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

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

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

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

    nvcc --version

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

    img.png

    Поддерживаемые версии 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 или ниже.

    img.png

    Также, можно обновить драйверы на своем компьютере и отключить автообновление драйверов. Проверить совместимость версии 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.