vhost_traffic_status_filter_by_host

`vhost_traffic_status_filter_by_host` 指令启用基于主机的流量统计过滤。

语法vhost_traffic_status_filter_by_host on | off;
默认值off
上下文http, server, location
参数flag

说明

vhost_traffic_status_filter_by_host 指令是 NGINX 虚拟主机流量状态模块的一部分。启用后,它允许用户根据传入请求的 Host 头过滤流量统计数据。在多租户环境中这尤其有用,因为不同的主机可能由同一个 NGINX 实例提供服务,从而使您能够单独跟踪和分析每个主机的流量指标。

该指令接受一个参数,该参数可以是一个标志值(通常为 on 或 off)。当设置为 'on' 时,指令将启用基于主机的过滤,任何收集到的流量统计都会按相应的主机名进行划分。相反,设置为 'off' 将禁用此功能,所有流量统计将不按主机区分而汇总。该指令的总体行为使其成为运营人员在不同由 NGINX 实例提供的虚拟主机之间洞察流量模式的重要工具。

此指令可用于 http、server 和 location 块的上下文中,提供了根据需要决定流量过滤粒度的灵活性。例如,可以在 http 块中全局设置以适用于所有服务器,或在特定的 server 或 location 块中覆盖设置,以为不同的应用实现量身定制的控制级别和报告精度。

配置示例

http {
    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_host on;

    server {
        listen 80;
        server_name example.com;
    }

    server {
        listen 80;
        server_name another-example.com;
    }
}

请确保 vhost_traffic_status_zone 指令已正确配置并启用,因为该指令依赖它。

在高流量环境中启用过滤时请谨慎,因为为过滤所需的额外处理可能会导致性能指标发生变化。

在按主机过滤时,请确保您的 server_name 指令已正确设置,以避免统计数据被错误报告。

← 返回所有指令