backtraces
'backtraces' 指令启用针对在 NGINX 中使用的 Wasm 模块错误的详细堆栈跟踪日志记录。
Proxy-Wasm support for Nginx powered by wasmtime
语法backtraces on;
默认值off
上下文
参数flag
说明
'backtraces' 指令用于 NGINX 的 Proxy-Wasm 模块上下文，专门用于调试和开发目的。当设置为 'on' 时，每当在执行 WebAssembly (Wasm) 过滤器或模块时发生错误，它就会启用增强的堆栈跟踪日志记录。这些堆栈跟踪可以帮助定位发生故障的具体函数和行，从而简化调试流程。
'backtraces' 指令配置后，会与 NGINX 环境的整体调试机制交互。它要求 NGINX 在构建时启用调试支持，以便提供额外的诊断功能。该指令不接受任何参数，主要用于切换回溯日志记录功能的开启或关闭。因此，其用法很简单，仅涉及开/关 设置，清楚地指示何时应启用或禁用增强日志记录。由于输出可能非常冗长，进而影响性能和日志文件的可读性，在生产环境中应谨慎使用该指令。
配置示例
wasm {
module my_filter /path/to/my_filter.wasm;
backtraces on;
}⚠
启用 'backtraces' 可能产生过多日志，淹没错误日志并影响性能。
⚠
确保在编译 NGINX 时启用了调试支持，以便有效使用此指令。