Мониторинг и логи

Проверки состояния

Адрес	Для чего
GET /healthz	Liveness. Базу не трогает: именно его опрашивает healthcheck контейнера, поэтому сбой базы не приводит к перезапуску. Перезапуск базу бы не починил, а выполнявшиеся задания агентов потерял бы
GET /readyz (или GET /api/ready)	Readiness. Проверяет базу и отвечает 503, когда она недоступна. Направьте сюда readiness probe оркестратора, чтобы на время сбоя перестать слать трафик, не убивая процесс
GET /api/health	Версия (version) и коммит (commit) работающего экземпляра

На сервере, поставленном через install.sh, sudo /opt/kvalli/install.sh status показывает контейнеры и /api/health.

Логи

Логи — JSON в stdout контейнера. Уровень задаёт LOG_LEVEL: trace, debug, info, warn, error.

docker compose logs -f app          # Docker Compose, в /opt/kvalli
kubectl -n kvalli logs deploy/kvalli -c kvalli -f   # Kubernetes

Трассировка запроса

Каждый ответ несёт заголовок X-Request-Id, и каждая строка лога для этого запроса помечена им. Входящий id принимается, если он похож на trace id, — так прокси перед Kvalli сохраняет одну нить через оба лога.

Ответ 5xx называет только операцию, которая не удалась, и содержит id запроса. Сама ошибка остаётся в логе под этим id — его и указывайте в обращении в поддержку. Токены ссылок на отчёты пишутся в лог как /share/[redacted].

Страница «Система» (Enterprise)

Настройки → Система показывает состояние установки: ошибки сервера и задания агентов за последние сутки, состояние подключений, базы и диска, лицензию, отвечает ли браузерный воркер. Там же — диагностический пакет для поддержки, см. Телеметрия.

Счётчики ошибок и заданий хранятся в процессе: перезапуск начинает их заново.

Ограничения нагрузки

Для каждого пользователя или API-ключа:

• общий API — 300 запросов в минуту; 3000 в минуту на один адрес в целом;
• запросы к моделям — 60 в минуту на аккаунт или ключ;
• вход — 10 попыток пароля на аккаунт и адрес за 15 минут;
• задания агентов — не больше 3 одновременно на проект и 20 на установку (MAX_ACTIVE_AGENT_JOBS).

Подробности — в API: ограничения частоты запросов.

Бюджет токенов

KVALLI_LLM_DAILY_TOKENS ограничивает, сколько токенов проект может потратить за сутки по UTC. Не задано или 0 — без лимита. Расход по людям видит администратор в Настройки → Расход по людям.