server_traffic_status_filter
启用对 `stream` 服务器流量状态数据的基于特定条件的过滤。
Nginx stream server traffic status core module
·
streamstream server
语法server_traffic_status_filter on|off;
默认值off
上下文stream, stream server
参数flag
说明
server_traffic_status_filter 指令允许管理员过滤 NGINX 中 stream 服务器流量状态模块返回的数据。启用时，该指令可帮助缩小在特定条件或需求下相关的流量统计范围。这对于通过针对特定流或服务器来优化性能监控和分析特别有用，可以避免向用户展示大量无关数据。
该指令可以添加到 stream 或 stream server 上下文中，表明它既能在通用的 stream 级别管理流量统计，也能在特定的服务器级别进行管理。接受一个 flag 作为参数意味着它可以开启或关闭，为管理员提供灵活性，并允许在不完全重新加载配置的情况下进行动态更改。
该指令的行为与其他 stream 状态指令密切相关：启用过滤器可能与配置特定的键、限制被计数的连接类型或管理数据如何汇总以便报告等操作配合使用。通过使用此过滤器，建议用户将其与其他指令结合使用，以确保数据反映分析或监控任务实际所需的内容，从而保持服务器状态的精简视图。
配置示例
stream {
server {
listen 12345;
...
server_traffic_status_filter on;
}
}⚠
确保服务器已安装 NGINX stream server traffic status core module；否则，该指令将无法生效。
⚠
避免组合可能冲突的多个 filter directives，以免导致流量统计数据不一致。
⚠
在高负载环境中使用该指令时要小心，因为过滤可能会引入额外的开销。