debug_points

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

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

Описание

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

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

debug_points stop;

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

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