$upstream_response_time记录nginx向后端发起请求到接收完最后一个字节响应的耗时（秒，毫秒精度），仅含网络往返与后端处理时间，不含nginx自身开销；多后端时以逗号分隔各次耗时，未走upstream时为“-”，需结合$upstream_status和$upstream_addr协同分析。
$upstream_response_time 是 Nginx 日志格式中一个非常实用的变量，用于记录 Nginx 向上游服务器（如 FastCGI、proxy_pass 指向的后端服务）发起请求后，从发送请求开始到收到最后一个字节响应所花费的时间（单位：秒，精度为毫秒，以逗号分隔多个 upstream 的耗时）。
它记录的是什么时间
这个变量反映的是 Nginx 与后端服务之间的网络往返 + 后端处理响应的时间，不包括 Nginx 自身处理请求头、读取客户端请求体或向客户端发送响应的时间。如果使用了负载均衡（比如多个 upstream server），它会按实际参与本次请求的后端顺序，用逗号拼接每个后端的响应时间，例如："0.002, 0.004" 表示本次请求先后经过两个 upstream，耗时分别为 2ms 和 4ms。
如何在 log_format 中使用
需先在 http 块中定义日志格式，然后在 server 或 location 中启用：
- 在
http{...}内添加：log_format main '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $upstream_response_time $request_time'; - 确保对应 server 或 location 使用该格式：
access_log /var/log/nginx/access.log main;
常见注意事项
- 如果请求未转发给 upstream（例如静态文件直接返回、rewrite 跳转、或 error_page 处理），
$upstream_response_time会显示为短横线 "-" ，不是 0 - 它和
$request_time不同：$request_time是整个请求从接收第一个字节到发送完响应的总耗时（含 Nginx 自身开销），通常 ≥$upstream_response_time - 若后端超时或连接失败，该值可能为 "0.000"（取决于失败阶段），不能单纯靠是否为 0 判断成功与否，需结合
$upstream_status一起看
配合 upstream_status 分析后端健康度
单独看响应时间意义有限，建议同时记录 $upstream_status（后端返回的状态码，如 200、502、504 等），便于区分是慢响应还是错误响应：
- 例如：
log_format detailed '$upstream_addr $upstream_response_time $upstream_status $request_time $status'; - 这样就能快速筛选出：哪些 upstream 地址经常返回 504 且耗时接近 proxy_timeout，或哪些地址平均响应时间持续偏高
