Nginx 中访问日志怎么自定义 log_format 格式输出请求响应耗时-Nginx-PHP中文网

nginx 使用 $request_time 变量记录请求总耗时（单位秒，精度毫秒），需配合自定义 log_format 输出；它包含请求体接收、后端处理及响应发送全过程，不等同于 $upstream_response_time。

nginx 中访问日志怎么自定义 log_format 格式输出请求响应耗时

在 Nginx 中，要记录请求的响应耗时（即从接收到完整请求头开始，到把响应全部发送给客户端结束的时间），需使用内置变量 $request_time，并配合自定义 log_format 实现。

启用 request_time 变量输出

$request_time 是 Nginx 的标准变量，单位为秒，精度为毫秒（如 0.032 表示 32 毫秒），无需额外模块，只要 Nginx 版本 ≥ 0.7.62 即可直接使用。

该值包含接收请求体时间（若存在）、后端处理（如 proxy_pass）和发送响应的总耗时
注意它不等于 $upstream_response_time（后者只统计上游服务返回首字节的时间）
若启用了请求体读取延迟（如 client_body_timeout），这部分也会被计入 $request_time

定义带耗时的 log_format

在 http 块中定义格式，例如：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

log_format main '$remote_addr - $remote_user [$time_local] '
                 '"$request" $status $body_bytes_sent '
                 '"$http_referer" "$http_user_agent" '
                 '$request_time $upstream_response_time';

$request_time 放在最后，便于日志解析（也可按需调整位置）
建议同时保留 $upstream_response_time，便于对比 Nginx 自身开销与后端响应延迟
若需更高精度（微秒级），Nginx 1.19.5+ 支持 $msec 和 $request_completion 组合计算，但通常 $request_time 已足够

在 server 或 location 中启用该格式

指定 access_log 使用刚定义的格式：

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

确保日志路径有写入权限，且磁盘空间充足（高并发下耗时字段会略微增大日志体积）
如只需对特定接口记录耗时，可在对应 location 块内单独配置 access_log
调试时可临时加 log_not_found off; 避免 404 日志干扰耗时分析

验证与常见问题

重启 Nginx 后发起请求，查看日志是否出现数值：

192.168.1.100 - - [10/Jan/2025:14:22:33 +0800] "GET /api/user HTTP/1.1" 200 1245 "-" "curl/8.5.0" 0.042 0.039

若 $request_time 恒为 0.000，检查是否误用了 $time_local 等静态变量替代，或 Nginx 版本过低
若所有请求耗时都偏大（如 >1s），可能是客户端网络慢、Nginx 限速（limit_rate）、或日志写入阻塞（可改用 buffer 和 flush 优化）
注意：keepalive 连接上的多个请求，$request_time 记录的是单次请求耗时，不是连接总时长