Системные ошибки IVA Terra

В данном разделе представлены системные ошибки, возникающие в процессе работы IVA Terra, а также их причины, последствия и способы устранения. Сведения о типичных ошибках системы и процессов, а также рекомендации по их решению приведены в таблицах ниже.

Общие системные ошибки

Проблема Причина Последствия Способ решения

Проблема	Причина	Последствия	Способ решения
Сессии мероприятий с постоянным состоянием Активна	Мероприятие проводится в режиме Стенограмма выключена и Субтитры включены. При получении первого аудиофрагмента создается каталог для хранения аудиофрагментов `./TERRA_DATA/rawaudio/{conference_id}`, но сам фрагмент не сохраняется (offline=false)	В файловой системе создается лишний каталог и файл metrics.json В таблице транскрибаций создается запись с постоянным состоянием Активна	Убедиться, что дата окончания стенограммы находится в статусе Активна как минимум на минуту ранее относительно текущего момента времени Удалить запись о стенограмме в web-панели администрирования
Ошибка 403 отказ системы в обработке аудиофрагментов	Нарушена целостность данных в БД клиентов Запрос (SELECT) на поиск токенов в таблице клиентов завершается неудачей из-за некорректной остановки Docker-контейнера в процессе перезагрузки ОС	Отсутствие доступа к web-панели администрирования Проблемы с приемом аудиопотока Неполадки в обмене сообщениями между сервисами	Выполнить корректное завершение работы системы командой: `docker-compose docker-compose.yml down` Перезапустить систему командой: `docker-compose docker-compose.yml up -d`

Сессии мероприятий с постоянным состоянием Активна

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

При получении первого аудиофрагмента создается каталог для хранения аудиофрагментов ./TERRA_DATA/rawaudio/{conference_id}, но сам фрагмент не сохраняется (offline=false)

В файловой системе создается лишний каталог и файл metrics.json
В таблице транскрибаций создается запись с постоянным состоянием Активна

Убедиться, что дата окончания стенограммы находится в статусе Активна как минимум на минуту ранее относительно текущего момента времени
Удалить запись о стенограмме в web-панели администрирования

Ошибка 403

отказ системы в обработке аудиофрагментов

Нарушена целостность данных в БД клиентов
Запрос (SELECT) на поиск токенов в таблице клиентов завершается неудачей из-за некорректной остановки Docker-контейнера в процессе перезагрузки ОС

Отсутствие доступа к web-панели администрирования
Проблемы с приемом аудиопотока
Неполадки в обмене сообщениями между сервисами

Выполнить корректное завершение работы системы командой:
```
docker-compose docker-compose.yml down
```
Перезапустить систему командой:
```
docker-compose docker-compose.yml up -d
```

Процесс COLLECT_SOUND

Проблема Причина Последствия Способ решения

Проблема	Причина	Последствия	Способ решения
Ошибка 403 и вывод сообщения `Wrong credentials: <token>` ошибка отсутствия ключа доступа	Значение token отсутствует в списке известных ключей доступа	Невозможность завершить обработку запроса	Проверить корректность значения token и его наличие в списке разрешенных токенов
Ошибка 400 и вывод сообщения `Online is False and Offline is False` ошибка при обработке запросов онлайн- / офлайн-обработки	Параметры online и offline запроса процесса COLLECT_SOUND имеют одинаковое значение 'false'	Отсутствие запроса от клиента на онлайн-обработку аудиоконтента Отсутствие запроса от клиента на сохранение аудиофрагмента	Убедиться, что хотя бы один из параметров (online / offline) установлен в 'true'

Ошибка 403 и вывод сообщения Wrong credentials: <token>

ошибка отсутствия ключа доступа

Значение token отсутствует в списке известных ключей доступа

Невозможность завершить обработку запроса

Проверить корректность значения token и его наличие в списке разрешенных токенов

Ошибка 400 и вывод сообщения Online is False and Offline is False

ошибка при обработке запросов онлайн- / офлайн-обработки

Параметры online и offline запроса процесса COLLECT_SOUND имеют одинаковое значение 'false'

Отсутствие запроса от клиента на онлайн-обработку аудиоконтента
Отсутствие запроса от клиента на сохранение аудиофрагмента

Убедиться, что хотя бы один из параметров (online / offline) установлен в 'true'

Процесс SOUND_PROCESSING

Проблема Причина Последствия Способ решения

Проблема	Причина	Последствия	Способ решения
Ошибка 404 и вывод сообщения `Data absent` ошибка при отсутствии информации о конференции	Отсутствие идентификатора конференции conference_id в базе данных	Невозможность завершить обработку запроса	Убедиться, что conference_id существует в таблице конференций БД
Ошибка 403 и вывод сообщения `Wrong credentials: <token>` ошибка отсутствия или несовпадения ключей доступа	Параметры token и conference_id имеют пустые значения Отсутствие совпадения токена (из поля access_key), хранимого в таблице конференций БД (сохраненный при регистрации первого аудиофрагмента) и извлекаемого из строки соответствующей conference_id, с токеном в запросе	Невозможность завершить обработку запроса	Убедиться, что параметры token и conference_id предоставлены и корректны Проверить соответствие token с access_key из таблицы конференций БД
Ошибка 400 и вывод сообщения `Invalid conference_id` ошибка валидации идентификатора конференции	Значение conference_id не соответствует регулярному выражению '^[&=_a-zA-Z0-9-]+$'	Невозможность завершить обработку запроса	Убедиться, что значение conference_id соответствует ожидаемому формату
Ошибка 400 и вывод сообщения `Invalid lang` ошибка валидации языка текста стенограммы	Значение lang не соответствует регулярному выражению '^\w*$'	Невозможность завершить обработку запроса и выполнить перевод	Убедиться, что значение lang соответствует ожидаемому формату и содержится в списке поддерживаемых языков
Ошибка 404 и вывод сообщения `Conference minutes status file not found` отсутствие аудиофрагментов для конференции	Отсутствие файлов .wav в каталоге конференции ./TERRA_DATA/rawaudio/conference_id: Отсутствие поступления аудиофрагментов / удаление аудиофрагментов в связи с истечением срока хранения Отсутствие файла итоговой стенограммы (`./TERRA_DATA/minutes/minutes_{conference_id}_{lang}.xml`)	Удаление файла-статуса (./TERRA_DATA/minutes/minutes_{conference_id}_{lang}.xml.status), если он существует Невозможность завершить обработку стенограммы Статус обработки стенограммы остается Активна	Проверить наличие аудиофайлов и при необходимости загрузить их заново

Ошибка 404 и вывод сообщения Data absent

ошибка при отсутствии информации о конференции

Отсутствие идентификатора конференции conference_id в базе данных

Невозможность завершить обработку запроса

Убедиться, что conference_id существует в таблице конференций БД

Ошибка 403 и вывод сообщения Wrong credentials: <token>

ошибка отсутствия или несовпадения ключей доступа

Параметры token и conference_id имеют пустые значения
Отсутствие совпадения токена (из поля access_key), хранимого в таблице конференций БД (сохраненный при регистрации первого аудиофрагмента) и извлекаемого из строки соответствующей conference_id, с токеном в запросе

Невозможность завершить обработку запроса

Убедиться, что параметры token и conference_id предоставлены и корректны
Проверить соответствие token с access_key из таблицы конференций БД

Ошибка 400 и вывод сообщения Invalid conference_id

ошибка валидации идентификатора конференции

Значение conference_id не соответствует регулярному выражению '^[&=_a-zA-Z0-9-]+$'

Невозможность завершить обработку запроса

Убедиться, что значение conference_id соответствует ожидаемому формату

Ошибка 400 и вывод сообщения Invalid lang

ошибка валидации языка текста стенограммы

Значение lang не соответствует регулярному выражению '^\w*$'

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

Убедиться, что значение lang соответствует ожидаемому формату и содержится в списке поддерживаемых языков

Ошибка 404 и вывод сообщения Conference minutes status file not found

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

Отсутствие файлов .wav в каталоге конференции ./TERRA_DATA/rawaudio/conference_id:

Отсутствие поступления аудиофрагментов / удаление аудиофрагментов в связи с истечением срока хранения
Отсутствие файла итоговой стенограммы (./TERRA_DATA/minutes/minutes_{conference_id}_{lang}.xml)

Удаление файла-статуса (./TERRA_DATA/minutes/minutes_{conference_id}_{lang}.xml.status), если он существует
Невозможность завершить обработку стенограммы
Статус обработки стенограммы остается Активна

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

Процесс TEXT_TRANSLATING

Проблема Причина Последствия Способ решения

Проблема	Причина	Последствия	Способ решения
Ошибка 404 и вывод сообщения `TRANSLATOR DISABLED OR URL IS NOT CONFIGURED` ошибка при отключении / отсутствии URL-адреса переводчика	В настройках переменных окружения: Отключено использование переводчика (USE_TRANSLATOR: false) Указан пустой адрес размещения сервиса переводов (TRANSLATOR_URL: )	Невозможность выполнения запроса на перевод	Убедиться, что: Переводчик включен URL-адрес сервиса указан корректно
Ошибка 403 и вывод сообщения `Wrong credentials: <token>` ошибка отсутствия ключа доступа	Значение token отсутствует в списке известных ключей доступа	Невозможность завершить обработку запроса	Проверить корректность значения token и его наличие в списке разрешенных токенов
Ошибка 400 и вывод сообщения с описанием исключения ошибка при таймауте обработки	Возникновение исключительных ситуаций при взаимодействии с сервисом переводов, включая таймаут в обработке запроса	Невозможность завершить обработку запроса	Увеличить значение таймаута (Таймаут ожидания ответов от сервиса переводов, по умолчанию: 5) в настройках сервиса Проверить доступность сервиса перевода
Ошибка 400 ошибка отсутствия параметров payload	Отсутствие обязательных параметров в запросе payload (например, from_lang, to_lang, content).	Невозможность выполнить перевод текста	Убедиться, что все обязательные параметры переданы в запросе
Ошибка 400 и вывод сообщения с описанием причины ошибка валидации запроса	Ошибка валидации контента запроса (структура запроса не соответствует ожидаемому формату)	Невозможность завершить обработку запроса	Убедиться, что структура запроса соответствует ожидаемому формату, включая наличие всех обязательных параметров (from_lang, to_lang, content)

Ошибка 404 и вывод сообщения TRANSLATOR DISABLED OR URL IS NOT CONFIGURED

ошибка при отключении / отсутствии URL-адреса переводчика

В настройках переменных окружения:

Отключено использование переводчика (USE_TRANSLATOR: false)
Указан пустой адрес размещения сервиса переводов (TRANSLATOR_URL: )

Невозможность выполнения запроса на перевод

Убедиться, что:

Переводчик включен
URL-адрес сервиса указан корректно

Ошибка 403 и вывод сообщения Wrong credentials: <token>

ошибка отсутствия ключа доступа

Значение token отсутствует в списке известных ключей доступа

Невозможность завершить обработку запроса

Проверить корректность значения token и его наличие в списке разрешенных токенов

Ошибка 400 и вывод сообщения с описанием исключения

ошибка при таймауте обработки

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

Невозможность завершить обработку запроса

Увеличить значение таймаута (Таймаут ожидания ответов от сервиса переводов, по умолчанию: 5) в настройках сервиса
Проверить доступность сервиса перевода

Ошибка 400

ошибка отсутствия параметров payload

Отсутствие обязательных параметров в запросе payload (например, from_lang, to_lang, content).

Невозможность выполнить перевод текста

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

Ошибка 400 и вывод сообщения с описанием причины

ошибка валидации запроса

Ошибка валидации контента запроса (структура запроса не соответствует ожидаемому формату)

Невозможность завершить обработку запроса

Убедиться, что структура запроса соответствует ожидаемому формату, включая наличие всех обязательных параметров (from_lang, to_lang, content)

Процесс ADP_PROCESSING

Проблема Причина Последствия Способ решения

Проблема	Причина	Последствия	Способ решения
Ошибка 404 и вывод сообщения в формате `PID=123456, TID=1 Conference minutes file not found` ошибка отсутствия файла стенограммы	Отсутствие файла стенограммы	Невозможность завершить обработку стенограммы	Убедиться, что файл стенограммы существует (если нет, проверить процесс его создания и загрузки)
Ошибка 404 и вывод сообщения в формате `PID=123456, TID=1 Conference minutes status file not found` ошибка отсутствия файла-статуса	Отсутствие файла-статуса стенограммы	Невозможность отследить статус обработки стенограммы	Убедиться, что файл-статус создается при начале обработки (если нет, проверить логи на наличие ошибок)
Ошибка 403 и вывод сообщения в формате `PID=123456, TID=1 Conference minutes has finish status` ошибка при статусе 'finish'	В файле-статусе содержится статус 'finish' (обработка стенограммы ADP-сервисами завершена), и параметр принудительной обработки не установлен (force=false)	Невозможность повторной обработки завершенной стенограммы Потеря возможности обновления данных	Убедиться, что чек-бокс принудительной обработки установлен в 'true', если требуется повторная обработка

Ошибка 404 и вывод сообщения в формате PID=123456, TID=1 Conference minutes file not found

ошибка отсутствия файла стенограммы

Отсутствие файла стенограммы

Невозможность завершить обработку стенограммы

Убедиться, что файл стенограммы существует (если нет, проверить процесс его создания и загрузки)

Ошибка 404 и вывод сообщения в формате PID=123456, TID=1 Conference minutes status file not found

ошибка отсутствия файла-статуса

Отсутствие файла-статуса стенограммы

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

Убедиться, что файл-статус создается при начале обработки (если нет, проверить логи на наличие ошибок)

Ошибка 403 и вывод сообщения в формате PID=123456, TID=1 Conference minutes has finish status

ошибка при статусе 'finish'

В файле-статусе содержится статус 'finish' (обработка стенограммы ADP-сервисами завершена), и параметр принудительной обработки не установлен (force=false)

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

Убедиться, что чек-бокс принудительной обработки установлен в 'true', если требуется повторная обработка