怎么在 Nginx 中记录反向代理请求的性能基准数据-Nginx-PHP中文网

nginx可通过自定义日志格式记录端到端及各阶段耗时：$request_time为总耗时，$upstream_connect_time、$upstream_header_time、$upstream_response_time分别表示建连、首行响应、完整响应时间，需在proxy_pass生效的location中配置且后端正常返回才有效。

怎么在 nginx 中记录反向代理请求的性能基准数据

Nginx 本身不直接提供“端到端请求耗时”的内置性能基准报表，但可以通过组合日志格式、内置变量和后端响应头，精准记录反向代理链路中各阶段的耗时数据。关键不是开启某个开关，而是正确配置日志字段并理解每个变量的含义。

启用带耗时字段的自定义日志格式
在 http 块中定义一个包含代理相关时间戳的日志格式：

log_format proxy_perf '$remote_addr - $remote_user [$time_local] '
                      '"$request" $status $body_bytes_sent '
                      'rt=$request_time uct="$upstream_connect_time" '
                      'uht="$upstream_header_time" urt="$upstream_response_time" '
                      'host=$host req_id=$request_id';

其中：

$request_time：从接收到客户端第一个字节，到返回最后一个字节给客户端的总耗时（秒，精度毫秒）
$upstream_connect_time：Nginx 与后端建立 TCP 连接所用时间（如 0.002、0.015）
$upstream_header_time：从发起连接到收到后端响应首行（含状态码）的时间
$upstream_response_time：从发起请求到接收完全部后端响应数据的时间（含 header + body）

这些变量只在 proxy_pass 生效的 location 中可用，且需确保后端服务正常返回，否则对应字段会显示为“-”。

绑定日志格式到 server 或 location
在对应虚拟主机或反向代理块中启用该格式：

server {
    listen 80;
    server_name api.example.com;

    access_log /var/log/nginx/proxy_perf.log proxy_perf;

    location / {
        proxy_pass http://backend_servers;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;

        # 可选：为每条请求生成唯一 ID，便于跨系统追踪
        proxy_set_header X-Request-ID $request_id;
    }
}

注意：$request_id 是 Nginx 内置变量（需 ngx_http_core_module，1.11.0+ 默认支持），无需额外模块。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

验证与解读典型日志行
一条真实日志可能如下：

203.201.12.45 - - [16/Jun/2026:02:15:22 +0000] "GET /v1/users?id=123 HTTP/1.1" 200 342 rt=0.182 uct="0.003" uht="0.047" urt="0.181" host=api.example.com req_id=1a2b3c4d5e6f

解读：

总耗时 rt=0.182s（182ms）
建连仅 0.003s → 网络延迟低、连接池复用良好
头部返回 0.047s → 后端业务逻辑启动快
全响应 0.181s → 几乎等于总耗时 → 说明 Nginx 自身处理开销极小，瓶颈大概率在后端

若出现 uct="-" 或 urt="-"，通常意味着后端不可达、超时或主动拒绝连接。

补充建议提升数据可靠性

设置合理的超时，避免单次异常拉高平均值：

proxy_connect_timeout 2;
proxy_send_timeout    10;
proxy_read_timeout    10;

开启 keepalive 减少建连开销（尤其对 HTTP/1.1 后端）：

upstream backend_servers {
    keepalive 32;
    server 192.168.1.10:8080;
}
location / {
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    # ... 其他 proxy_ 指令
}