Nginx中记录请求耗时最常用且准确的变量是$request_time，以秒为单位、毫秒精度，仅可用于log_format定义的日志格式中，不可用于if或set等指令。
在 Nginx 中，记录请求耗时（即从接收到客户端请求头开始，到发送完响应给客户端为止的总时间）最常用且准确的变量是 $request_time，它以秒为单位，精度为毫秒（如 0.032 表示 32 毫秒）。
定义含 $request_time 的日志格式
在 http 块中使用 log_format 自定义格式，把 $request_time 加入字段即可：
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time';注意：$request_time 只能在日志格式中使用，不能用于 if、set 或其他指令中 —— 它是只读的“日志专用变量”。
确保日志使用该格式
在 server 或 location 块中，用 access_log 指定刚才定义的格式名（如 main）：
access_log /var/log/nginx/access.log main;
若未显式指定格式名，Nginx 默认使用内置的 combined 格式（不含 $request_time），所以必须明确写上格式名。
区分 $request_time 和 $upstream_response_time
-
$request_time：整个请求生命周期耗时（含 Nginx 处理、等待 upstream、网络传输等）； -
$upstream_response_time：仅 upstream（如后端 PHP/FastCGI/Proxy）返回响应所花的时间，多个 upstream 会以逗号分隔（如0.012, 0.008）；
如果后端有代理或 FastCGI，建议同时记录两者，便于定位瓶颈是在 Nginx 层还是上游服务。
验证与排查常见问题
- 重启 Nginx 后访问测试接口，检查日志是否出现数字（如
0.045）； - 若始终为
-或空，确认是否在http块定义了格式，并在access_log中正确引用； - 若值恒为
0.000，可能是请求极快（低于毫秒级分辨率），或使用了不支持该变量的旧版 Nginx（需 1.3.9+）；
