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 或其他指令中 —— 它是只读的“日志专用变量”。

Nginx Hosting

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

下载

确保日志使用该格式

在 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+）；