server_traffic_status_limit_traffic_by_set_key
根据指定键限制流量统计收集。
Nginx stream server traffic status core module
·
streamstream server
语法server_traffic_status_limit_traffic_by_set_key key1 [key2 [key3]];
默认值none
上下文stream, stream server
参数2-3
说明
server_traffic_status_limit_traffic_by_set_key 指令是 NGINX Stream Server Traffic Status 模块的一部分，用于根据指定的一组键为 NGINX stream 服务器配置流量限制。该指令通过允许管理员定义流量统计的聚合和报告方式来增强监控。使用此指令，可以指定一个唯一标识符来指示指标应如何分组，从而更容易分析运行在 NGINX 框架内的不同服务器或服务的流量模式和性能。
该指令接受两个到三个参数，包括用于流量跟踪的特定键。管理员可以根据流量分析需求定义这些键——常见示例可能包括服务名称或客户端 IP。指令的行为依赖于这些参数，因为指定不正确或过于通用的键可能导致误导性的流量统计。因此，在部署此指令时，谨慎的规划和键管理至关重要。
当在 stream 或 stream server block 的上下文中应用时，该指令有助于实施详细的流量分析，通过更容易地监控工作负载特定部分的流量配额，从而帮助防止潜在的过载情况。
配置示例
stream {
server {
listen 12345;
server_traffic_status_limit_traffic_by_set_key client_ip;
...
}
}⚠
确保指定的 keys 不重叠（除非有意为之），因为重叠可能导致统计不准确。
⚠
注意跟踪的唯一 keys 数量；过多的唯一条目可能会增加内存占用和处理时间。
⚠
在高流量情况下，为过多的 keys 记录流量可能对性能产生影响。忽视性能优化策略可能导致服务器意外变慢。