debug_points

Директива `debug_points` управляет поведением NGINX при достижении определённых точек отладки во время обработки.

Синтаксисdebug_points stop | abort;
По умолчаниюnone
Контекстmain
Аргументы1

Описание

Директива debug_points предназначена для разработчиков и опытных пользователей, которые хотят управлять потоком выполнения сервера NGINX в целях отладки. Эту директиву можно настраивать в главном контексте; она принимает один аргумент, задающий, какую точку отладки вызвать. Доступные операнды для этой директивы — stop и abort, каждый из которых по‑разному влияет на процесс NGINX при достижении во время выполнения.

Когда установлено stop, NGINX приостанавливает выполнение в заданной точке отладки, позволяя пользователю при необходимости подключить отладчик. Это особенно полезно для пошагового анализа поведения приложения в ответ на конкретные запросы или системные события. С другой стороны, выбор abort приведёт к немедленному завершению процесса, что удобно при отладке фатальных ошибок или для обеспечения целостности системы в нежелательных состояниях.

Поведение директивы debug_points может значительно улучшить процесс отладки при разработке или диагностике модулей и конфигураций NGINX. Она служит механизмом введения преднамеренных точек останова в коде без внесения изменений в исходный код, что облегчает более эффективные отладочные сценарии.

Пример конфига

debug_points stop;

Убедитесь, что сборка NGINX собрана с поддержкой отладки, иначе эта директива может не работать.

Использование debug_points повлияет на производительность NGINX; его следует удалить или закомментировать в рабочей среде.

← Ко всем директивам