nginx 默认 access_log 不含请求耗时,需通过 $request_time(总处理时间)和 $upstream_response_time(后端响应时间)精准记录;二者单位为秒、毫秒精度,适用场景不同,须结合 proxy_pass 等指令使用,并推荐启用 buffer 缓冲提升性能。

Nginx 默认 access_log 不包含请求处理耗时,要记录转发时间开销,关键不是“开启开关”,而是精准选用两个核心时间变量:$request_time 和 $upstream_response_time,并明确它们的差异与适用场景。
$request_time 与 $upstream_response_time 的区别必须清楚
-
$request_time是 Nginx 从收到第一个字节到发出最后一个字节的总耗时(单位:秒,毫秒精度),含客户端上传时间、Nginx 自身处理、等待上游响应、发送响应等全部环节。 -
$upstream_response_time是 Nginx 与后端(如 PHP-FPM、Tomcat、API 服务)建立连接、发送请求、接收完整响应所花的时间(同样毫秒精度),这才是真正反映后端服务性能的指标。
当用户上传大文件或网络较慢时,$request_time会明显大于$upstream_response_time;若两者接近,说明瓶颈大概率在后端而非网络。
定义带时间字段的日志格式
在 http 块中添加自定义 log_format(例如命名为 with_time):
log_format with_time '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'$request_time $upstream_response_time';
然后在 server 或 location 块中启用:
access_log /var/log/nginx/access.log with_time;
注意:$upstream_response_time 仅在配置了 proxy_pass、fastcgi_pass 等反向代理指令的上下文中才有值;静态文件服务时该字段为空或为“-”。
使用tbot机器ID身份文件配合tsh CLI,通过Teleport访问控制SSH登录托管主机或执行远程命令。
按需增强,避免冗余记录
- 对纯静态资源(js/css/img),可单独用极简格式,不记录时间字段,节省磁盘和 I/O。
- 对核心接口(如
/api/v1/order),建议同时记录$request_time和$upstream_response_time,便于区分是网络问题还是后端慢。 - 若只关心后端响应,可忽略
$request_time;若需排查用户侧延迟(如上传卡顿),则必须保留$request_time。
配合缓冲写入提升性能
高并发下频繁刷盘会影响吞吐,推荐启用缓冲:
access_log /var/log/nginx/access.log with_time buffer=64k flush=5s;
这表示日志先缓存在内存中,达到 64KB 或满 5 秒后统一写入磁盘,兼顾实时性与性能。
后续分析建议
日志生成后,可用简单命令快速筛查慢请求:
- 查找
upstream_response_time超过 2 秒的请求:awk '$NF > 2 {print}' /var/log/nginx/access.log - 统计平均响应时间:
awk '{sum += $NF; n++} END {printf "avg: %.3f\n", sum/n}' /var/log/nginx/access.log(注意:
$NF默认取最后一列,确保$upstream_response_time在格式末尾)
不复杂但容易忽略










