log_zmq_off
在 NGINX 配置中,`log_zmq_off` 指令用于在特定 location 中禁用 ZeroMQ 日志。
ZeroMQ logger module for NGINX
·
location
语法log_zmq_off ;
默认值none
上下文location
参数1
说明
在 NGINX 配置的 location 块中使用 log_zmq_off 指令。它允许用户根据被访问的 location 有选择地静默特定请求的日志记录。当某些端点用于高并发请求或健康检查且不需要日志记录或日志可能导致额外开销时,这一功能尤其有用。该指令接受一个参数,该参数是应被关闭的日志服务器配置的名称。如果参数为 'all',则该 location 的所有已配置 ZeroMQ 服务器的日志将被禁用。
当设置了 log_zmq_off 时,NGINX 将不会发送与指定服务器或(取决于提供的参数)所有服务器相关的任何日志消息。此功能对于优化性能至关重要,并可确保日志相关操作不会干扰进入请求的正常处理,尤其是在带宽或处理能力受限的环境中。该指令可以使用不同的参数多次应用,以在 NGINX 配置的各个 location 之间动态管理日志。
配置示例
location /status {
log_zmq_off all;
}
location /endpoint {
log_zmq_off main;
}⚠
确保 server name 正确以避免不必要的日志;在该 location 使用 'all' 会使该位置的所有记录器静默。
⚠
在未考虑性能影响的情况下使用该指令,可能会导致重要日志数据丢失。