stream_server_traffic_status_display

`stream_server_traffic_status_display` 指令启用显示 stream servers 的流量统计信息。

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

说明

stream_server_traffic_status_display 指令是 NGINX stream server traffic status 模块的一部分,便于通过 HTTP 监控流量统计。启用时,它会提供一个端点,该端点返回有关 TCP upstream servers 的流量、连接和错误率的信息。对于希望将实时流量统计与监控系统共享的管理员,或通过 Web 界面访问 NGINX 的用户,这一点尤其有用。

要正确使用此指令,必须将其放置在 NGINX 配置中的 server 或 location 上下文中。明确支持 GET 和 HEAD HTTP 方法,以允许检索状态数据,而其他方法可能返回相应的 HTTP 错误。该模块要求先初始化 shared memory;如果初始化失败,访问统计信息的请求将返回服务不可用响应。可以在 request URI 中包含控制命令以动态修改或重置流量状态,从而使该指令在管理流量和分析性能指标的运维任务中非常灵活。

配置示例

server {
    listen 8080;
    location /status {
        stream_server_traffic_status_display;
    }
}

确保为此指令正确配置共享内存以使其生效。

使用除 GET 或 HEAD 以外的方法的请求将不被接受,导致 HTTP 错误。

如果该模块未启用或未初始化,访问状态将导致 501 错误。

← 返回所有指令