На этой странице
Диагностика типичных сбоев¶
Проверьте соответствующий слой¶
Сначала проверьте шлюз. Подставьте адрес своей установки.
curl --fail 'http://localhost:13000/health/?format=json'
HTTP 200 означает, что база, кеш и хранилище исходных файлов прошли проверку. Для диагностики сервисов ниже сохраните имя проекта и порядок файлов Compose из команды запуска.
Симптом |
Что проверить в первую очередь |
|---|---|
Мастер установки или веб-интерфейс не запускается |
Посмотрите |
Проверка HTTP отвечает, поиск выдаёт ошибку |
HTTP-проверка охватывает базу, кеш и хранилище исходных файлов. Отдельно проверьте готовность моделей и индекса пространства. Локальной модели может требоваться скачать веса. |
При загрузке PDF возникает ошибка формата или извлечения |
Уточните, используется ли локальное извлечение UTF-8 или HTTP-сервис. Проверьте адрес и учётные данные из контейнеров API и воркера. Проверьте профиль OCR и предел размера файла. |
Обработка документа остановилась |
Сначала проверьте статус операции. До повтора проверьте доставки Beat, подписки воркера, его активные и зарезервированные задачи. См. фоновые задачи. |
Поиск работает, генерация выдаёт ошибку |
Проверьте провайдера и модель пространства, маршрут соединения, лимиты ответа и готовность модели. Отдельные настроенные этапы поиска тоже могут обращаться к моделям. |
Вход в браузере работает с перебоями |
Проверьте TLS, точные адреса веб-интерфейса и параметры cookie.
Ответ |
После масштабирования растёт ожидание пула БД |
Сравните ожидание клиентов PgBouncer и соединения PostgreSQL. Проверьте прямой маршрут обслуживания. Меняйте параллельность и бюджеты соединений вместе. |
Если установщик завершился с ошибкой, откройте ~/.contextbase/install.log.
Запишите имя проекта, версию приложения и время сбоя. Для обращения в
поддержку приложите текст ошибки без закрытых сведений, шаги
воспроизведения и результаты проверок. Исключите учётные данные и
документы пользователей. См.
руководство поддержки.