На этой странице

Диагностика типичных сбоев

Проверьте соответствующий слой

Сначала проверьте шлюз. Подставьте адрес своей установки.

curl --fail 'http://localhost:13000/health/?format=json'

HTTP 200 означает, что база, кеш и хранилище исходных файлов прошли проверку. Для диагностики сервисов ниже сохраните имя проекта и порядок файлов Compose из команды запуска.

Симптом

Что проверить в первую очередь

Мастер установки или веб-интерфейс не запускается

Посмотрите ps -a и журналы migrate, assets, web и шлюза. Проверьте инициализацию, порт и адрес. Имена сервиса шлюза зависят от профиля развёртывания.

Проверка HTTP отвечает, поиск выдаёт ошибку

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

При загрузке PDF возникает ошибка формата или извлечения

Уточните, используется ли локальное извлечение UTF-8 или HTTP-сервис. Проверьте адрес и учётные данные из контейнеров API и воркера. Проверьте профиль OCR и предел размера файла.

Обработка документа остановилась

Сначала проверьте статус операции. До повтора проверьте доставки Beat, подписки воркера, его активные и зарезервированные задачи. См. фоновые задачи.

Поиск работает, генерация выдаёт ошибку

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

Вход в браузере работает с перебоями

Проверьте TLS, точные адреса веб-интерфейса и параметры cookie. Ответ 429 может приходить от лимита шлюза или блокировки входа в приложении. Если перед Caddy есть прокси или CDN, проверьте число доверенных узлов.

После масштабирования растёт ожидание пула БД

Сравните ожидание клиентов PgBouncer и соединения PostgreSQL. Проверьте прямой маршрут обслуживания. Меняйте параллельность и бюджеты соединений вместе.

Если установщик завершился с ошибкой, откройте ~/.contextbase/install.log. Запишите имя проекта, версию приложения и время сбоя. Для обращения в поддержку приложите текст ошибки без закрытых сведений, шаги воспроизведения и результаты проверок. Исключите учётные данные и документы пользователей. См. руководство поддержки.

ContextBase0.1.0

Поиск в документации