nginx负载均衡日志需记录真实转发链路，核心是使用$upstream_addr、$upstream_response_time、$upstream_status和$request_time四个变量，在http块定义log_format trace_chain格式，仅在启用proxy_pass的location中配置access_log，并透传x-forwarded-for与启用real_ip_module确保客户端ip准确。
要在 Nginx 负载均衡架构中记录真实的客户端转发链路，核心是把“谁来的、往哪去、经过哪、耗多久”这四件事在日志里一次性说清楚。关键不在于堆变量，而在于选对变量、配对上下文、避开空值陷阱。
必须包含的上游转发链路变量
这些变量只在启用 proxy_pass 且请求真正发往后端时才有值，缺一不可：
-
$upstream_addr：实际连接的后端地址（如
10.0.2.5:8080），重试时显示为逗号分隔列表（10.0.2.5:8080, 10.0.2.6:8080） - $upstream_response_time：对应每次转发的耗时（秒，含毫秒），顺序与 $upstream_addr 严格一致
- $upstream_status：每次转发收到的 HTTP 状态码，同样按逗号分隔，便于定位失败节点
- $request_time：客户端全程总耗时，用于比对是否因某节点拖慢整条链路
日志格式定义要独立且明确
在 http 块顶层 定义专用格式，避免和默认日志混用：
log_format trace_chain '$remote_addr - $remote_user [$time_local] "
"$request" $status $body_bytes_sent "
"$http_referer" "$http_user_agent" '
'upstream="$upstream_addr" status="$upstream_status" '
'rt="$upstream_response_time" req="$request_time" '
'x-trace-id="$upstream_http_x_trace_id" '
'x-forwarded-for="$http_x_forwarded_for";
注意：引号包裹每个字段值，方便后续用 awk / Logstash / Loki 解析；$upstream_http_x_trace_id 可从后端响应头提取，用于全链路追踪对齐。
确保日志只在代理路径中生效
不要在静态资源 location 或未配置 proxy_pass 的 server 块中启用该格式，否则 $upstream_* 全为空字符串：
- 在使用 proxy_pass http://backend_pool 的 location 中配置 access_log
- 若 upstream 使用域名（如
server api.example.com:443），需确认 resolver 已配置，否则 $upstream_addr 可能无法解析为 IP - 避免在 if 或 rewrite 后才执行 proxy_pass 的 location 中依赖该变量——Nginx 变量在指令执行时求值，非最终路由时刻
补充真实客户端标识（防 IP 伪造）
仅靠 $remote_addr 不可靠，尤其存在多层代理时：
- 在 proxy_pass 前设置：proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for
- 在后端 Nginx（或应用）中启用 real_ip_module，配合 set_real_ip_from 指定可信代理网段，再用 $remote_addr 读取真实客户端 IP
- 日志中同时保留 $http_x_forwarded_for 和经 realip 处理后的 $remote_addr，便于交叉验证
