vhost_traffic_status_display

指令 `vhost_traffic_status_display` 启用在 NGINX 中显示虚拟主机的流量状态。

语法vhost_traffic_status_display;
默认值none
上下文server, location
参数none

说明

vhost_traffic_status_display 指令属于 NGINX Virtual Host Traffic Status 模块,用于启用或禁用虚拟主机的流量统计显示。该指令可以放置在 NGINX 配置的 serverlocation 上下文中。启用后,它允许用户通过特定的 URIs 请求流量状态信息,通常用于在 Web 服务器级别监控和分析流量模式。

该指令不接受任何参数,实际上是激活负责处理此类显示请求的处理程序。相关处理程序确保从用于流量统计的共享内存区域收集信息,并根据配置允许不同类型的响应,包括 JSON 或 HTML 格式。显示处理程序还可以管理控制命令,启用诸如实时重置或删除统计等功能,在监控场景中提供更丰富的交互性。

重要的是为共享内存区域配置适当的访问权限,并确保为所需对象启用了流量状态收集,否则显示输出可能无法工作或显示不完整的数据。通过使用此指令,管理员可以获得有关虚拟主机的请求计数、数据传输速率和响应状态的有价值洞见,从而大大有助于性能调优和资源管理。

配置示例

server {
    listen 80;
    server_name example.com;
    location /status {
        vhost_traffic_status_display;
    }
}

确保共享内存区已正确配置并分配;否则,显示将无法按预期工作。

此指令不接受任何参数,因此像 vhost_traffic_status_display on; 这样的配置不正确并会导致错误。

如果请求方法不是 GET 或 HEAD,显示将返回 405 Method Not Allowed 错误。

← 返回所有指令