Web 服务器与网关 / 系统课时
记录上游阶段耗时
记录上游阶段耗时
本课学习如何通过 Nginx 日志拆分请求在上游链路中的各阶段耗时,快速判断连接建立、等待响应和数据传输哪个环节成为瓶颈。完成配置后,可以基于日志数据定位反向代理性能问题。
学习目标
- 理解 request_time 与 upstream 各耗时变量的区别。
- 配置日志格式记录完整上游阶段耗时。
- 根据耗时字段判断常见性能瓶颈。
理解 Nginx 上游耗时模型
反向代理请求通常经过客户端连接、Nginx 转发、连接上游、等待上游处理、接收响应等阶段。单独观察总耗时只能知道慢,而拆分阶段耗时才能判断慢在哪里。
Nginx 提供多个变量记录 upstream 阶段信息:request_time 表示整个请求处理时间,upstream_connect_time 表示连接上游耗时,upstream_header_time 表示等待上游响应头耗时,upstream_response_time 表示接收上游响应耗时。
配置耗时日志格式
通过 log_format 将关键变量写入访问日志。以下配置片段需要放在 http 上下文中。
nginx
http {
log_format upstream_timing '$remote_addr $request_time '
'connect=$upstream_connect_time '
'header=$upstream_header_time '
'response=$upstream_response_time';
access_log /var/log/nginx/access.log upstream_timing;
}预期结果
text
203.0.113.10 0.245 connect=0.010 header=0.120 response=0.240日志中的时间单位为秒,实际数值会根据网络环境、上游处理能力和响应大小变化。
分析耗时字段定位问题
当 upstream_connect_time 很高,通常说明连接上游存在网络延迟、连接池不足或上游端口压力。当 upstream_header_time 很高,说明请求已经连接成功,但业务处理或数据库访问可能较慢。
如果 upstream_response_time 明显高于 upstream_header_time,通常表示上游已经开始返回数据,但响应传输过程较慢,需要继续检查带宽、响应大小或客户端读取速度。
常见排查组合
生产环境中可以结合状态码、请求路径和耗时字段进行筛选。例如先找出响应时间超过阈值的请求,再判断具体耗时阶段。
bash
awk '$2 > 1 {print}' /var/log/nginx/access.log预期结果
text
203.0.113.10 1.532 connect=0.012 header=1.420 response=1.530实际排查时应结合业务高峰、上游日志和监控指标,不应只根据单个请求下结论。
按自己的节奏,确认真正理解。