要计算Nginx中某请求路径的平均耗时,需先在log_format中显式包含$request_time变量并重载配置,再用awk按$request_uri筛选日志行并计算$NF(或对应列)的均值,同时建议结合P95和调用量综合评估性能。

要计算 Nginx 中某个请求路径(如 /api/user/profile)的平均耗时,核心是两件事:确保日志里有 $request_time 字段,再按 $request_uri 精准筛选并求均值。这不是 Nginx 自动算出来的,而是靠日志+命令行工具完成。
确保日志格式包含 $request_time 并定位到正确列
$request_time 是 Nginx 内置变量,单位为秒(精度毫秒),表示从接收到第一个字节到发送完最后一个响应字节的总耗时。必须显式写入 log_format 才能记录:
log_format main '$remote_addr - [$time_local] "$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" $request_time $upstream_response_time';
access_log /var/log/nginx/access.log main;重载配置:nginx -t && nginx -s reload
之后打开日志,确认每行末尾(或你指定位置)有类似 0.123 的数值。用 awk '{print NF; exit}' access.log 查总列数,再用 awk '{print $1,$2,$7,$NF}' access.log | head -3 确认 $request_uri 和 $request_time 分别在第几列(常见是 $7 和 $NF,但自定义格式后可能不同)。
提取目标路径的所有耗时值
假设你要算 /api/order/list 的平均耗时,且已确认 $request_uri 在第 7 列、$request_time 在最后一列:
-
只提取耗时数字(便于后续统计):
awk '$7 ~ /^\/api\/order\/list($|\?)/ {print $NF}' access.log -
同时输出路径和耗时(方便核对):
awk '$7 ~ /^\/api\/order\/list($|\?)/ {print $7, $NF}' access.log
注意正则中的
($|\?)能匹配/api/order/list或/api/order/list?page=1等带参数的情况,避免漏掉。
计算平均值(含简单、可靠、进阶三种方式)
-
基础平均(推荐用于快速估算):
awk '$7 ~ /^\/api\/order\/list($|\?)/ {sum += $NF; cnt++} END {if(cnt>0) print "avg:", sum/cnt, "s"}' access.log -
排除异常值(如客户端断连导致的 499 状态):
awk '$7 ~ /^\/api\/order\/list($|\?)/ && $9 != 499 {sum += $NF; cnt++} END {if(cnt>0) print "avg:", sum/cnt, "s"}' access.log这里
$9是状态码列,需根据你日志实际列序调整(通常为第 9 列)。 -
结合分位数看分布(更真实):
安装datamash后可一键得均值、P95、最大值:awk '$7 ~ /^\/api\/order\/list($|\?)/ {print $NF}' access.log | datamash mean 1 pctl 95 1 max 1
补充建议:别只看平均值
平均耗时容易被个别慢请求拉高。比如 99% 请求是 0.2s,1% 是 5s,平均就变成 0.24s——看似正常,实则存在隐患。所以:
- 优先关注 P95/P99 耗时
- 同时统计该路径出现频次:
awk '$7 ~ /^\/api\/order\/list($|\?)/ {cnt++} END {print cnt}' access.log - 如果平均耗时高 + 调用量大(比如每天上万次),比单次超长但极少调用的接口更值得优先优化
不复杂但容易忽略。


















