Решение проблем

Частые проблемы и как их решить. Если вашей здесь нет, создайте issue.

Ошибка при создании Validator

Чаще всего причина — недопустимое значение параметра. Сообщение об ошибке называет параметр и допустимый диапазон.

Сверьтесь с таблицей на странице настроек.

Растёт потребление памяти

Убедитесь, что Validator создаётся один раз, а не на каждый запрос. Каждый экземпляр держит собственные структуры.

Если память растёт и при одном экземпляре, проверьте ограничения в настройках.

Как включить отладочный вывод

Задайте переменную окружения CINDERGUARD_DEBUG=1. cinderguard начнёт писать подробности в стандартный поток ошибок.

CINDERGUARD_DEBUG=1 ./your-app

Ошибки компиляции после обновления

Скорее всего, вы перешли через мажорную версию. Посмотрите список изменений и раздел об обновлении версий.

Медленная работа под нагрузкой

Снимите профиль. Если в нём видны блокировки внутри cinderguard, увеличьте параллельность или разделите нагрузку между несколькими экземплярами.