$connection_requests

变量 $connection_requests 返回当前连接接收到的请求数量。 — NGINX Core (HTTP)

$connection_requests NGINX Core (HTTP)

说明

在 NGINX 中,$connection_requests 变量用于跟踪在单个连接生命周期内已处理的请求数量。每当该连接上发起新请求时,该变量就会递增;当连接首次建立时从零开始。每个请求——无论是初始请求还是由 keep-alive 触发的后续请求——都会增加该计数。该变量对于监控和理解请求模式、优化连接重用以及调试与连接处理相关的性能问题特别有用。 在 NGINX 中,$connection_requests 变量的生命周期始于新连接建立时。对于该连接上的每个传入请求,服务器都会递增该变量,直到连接关闭或请求处理完成。该变量的典型值对于单次请求连接可能从 1 开始,并随着客户端在同一连接中发出的多次请求而相应增加。在保持连接的场景中,该变量允许网站管理员分析 keep-alive 连接在处理多个请求方面相较于为每个请求打开新连接的效率。 鉴于该变量反映的是请求数量,它可用于旨在性能调优或详细请求记录的配置中;从监控该变量获得的洞见可能带来资源分配和响应时间方面的改进。记录该变量可以提供关于客户端行为及其请求模式的有价值信息,从而更容易识别潜在瓶颈或提高效率。

配置示例

log_format custom_format '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$connection_requests"';

access_log /var/log/nginx/access.log custom_format;

子系统

http

可缓存

上下文

http, server, location, if

该变量仅在使用 keep-alive 时适用;否则,对于单次请求,它始终默认为 1。

注意日志详细程度;在高流量场景中记录 $connection_requests 变量可能影响性能。

确保 server blocks 和 locations 已正确配置以使用 keep-alive;否则,变量的递增将无法反映多次请求。