proxy_wasm_log_dispatch_errors
指令 `proxy_wasm_log_dispatch_errors` 启用在分发期间对 WebAssembly 代理失败的错误日志记录。
Proxy-Wasm support for Nginx powered by wasmtime
语法proxy_wasm_log_dispatch_errors on | off;
默认值off
上下文
参数1
说明
proxy_wasm_log_dispatch_errors 指令配置 NGINX 在将事件分发到 WebAssembly 过滤器模块时记录发生的错误。此功能对于诊断在代理上下文中进行 WebAssembly 操作时出现的问题至关重要。当该指令设置为 on 时，分发过程中遇到的任何错误都会以详细信息记录到 NGINX 的错误日志中，便于开发人员和管理员有效地排查与 WebAssembly 相关的问题。
该指令接受一个参数：布尔值，可为 on 或 off。将其设为 on 会启用错误日志功能，而 off 则禁用该功能。该指令的行为主要影响与集成到 NGINX 配置中的 WebAssembly 模块相关的错误处理方式。通过使用此指令，用户可以确保捕获来自 WebAssembly 执行的所有必要错误信息，这在测试和生产环境中都非常有价值。
总的来说，每当在 NGINX 中使用 WebAssembly 过滤器时，建议使用 proxy_wasm_log_dispatch_errors on; 以便洞悉因 WASM 二进制或 NGINX 本身问题引起的潜在故障，从而最终提高系统的可靠性和可观察性。
配置示例
http {
proxy_wasm_log_dispatch_errors on;
server {
listen 8080;
location / {
proxy_pass http://backend;
proxy_wasm my_filter;
}
}
}⚠
确保日志级别已正确设置以捕获错误日志；否则，错误可能不会出现在日志中。
⚠
使用 off 禁用日志会在出现 WebAssembly 模块问题时使调试变得困难。