backtraces
Директива 'backtraces' включает подробное логирование стеков вызовов при ошибках в модулях Wasm, используемых в NGINX.
Описание
Директива 'backtraces' применяется в контексте модуля NGINX Proxy-Wasm, в частности для целей отладки и разработки. При установке в значение 'on' она включает расширенное логирование стеков вызовов всякий раз, когда происходит ошибка при выполнении WebAssembly (Wasm) фильтров или модулей. Это особенно полезно для разработчиков, которым нужно выявлять и устранять проблемы в их реализациях Wasm, поскольку она предоставляет видимость конкретного стека вызовов в момент ошибки. Стековые трассы помогают точно определить функции и строки, где произошли сбои, что упрощает процесс отладки.
Когда директива 'backtraces' настроена, она взаимодействует с общей системой отладки окружения NGINX. Для её работы требуется, чтобы NGINX был собран с включённой поддержкой отладки, что делает доступными дополнительные диагностические возможности. Эта директива не принимает никаких параметров или аргументов и фокусируется исключительно на переключении функции создания обратных трасс. Следовательно, её использование простое и сводится к простому 'on'/'off' переключению, обеспечивая чёткое разграничение того, когда расширенное логирование должно быть активно или неактивно. Важно использовать эту директиву осмотрительно в продуктивных средах из-за потенциальной многословности вывода, которая может повлиять на производительность и читаемость логов.
Пример конфига
wasm {
module my_filter /path/to/my_filter.wasm;
backtraces on;
}Включение 'backtraces' может привести к подробному журналированию, которое засорит журналы ошибок и ухудшит производительность.
Убедитесь, что NGINX скомпилирован с поддержкой отладки, чтобы эффективно использовать эту директиву.