需在Nginx中区分http块（HTTP代理）和stream块（TCP/UDP代理）配置自定义日志，使用对应作用域变量（如$http中$upstream_addr，$stream中$upstream_connect_time），确保proxy_pass启用后记录命中状态与回源详情。
要在 Nginx 日志中清晰记录负载均衡的命中状态（即请求被分发到哪个后端）和回源详情（如连接耗时、响应字节数、上游地址等），关键不是靠“猜”，而是通过 自定义日志格式 + 正确作用域 + 可用变量 实现。HTTP 代理和 TCP/UDP 代理的日志配置方式不同，需区分处理。
明确日志作用域：http 块 vs stream 块
Nginx 的日志记录能力依赖于上下文：
-
HTTP 负载均衡（如 proxy_pass 到多个后端 Web 服务）：日志必须在
http块内定义，使用$upstream_addr、$upstream_response_time、$upstream_status等变量，这些变量只在location或server的access_log中有效。 -
TCP/UDP 负载均衡（如 MySQL、Redis 透传）：需启用
stream模块，在stream块中定义log_format和access_log，可用变量为$upstream_addr、$upstream_bytes_sent、$upstream_connect_time等。 - 不能把
stream的日志配置写在http块里，反之亦然——否则会报错或变量为空。
记录 HTTP 负载均衡详情的核心配置
在 http 块中添加如下内容（推荐放在 log_format 区域之后、upstream 定义之前）：
log_format upstream_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'upstream: $upstream_addr '
'upstream_status: $upstream_status '
'upstream_response_time: $upstream_response_time '
'upstream_connect_time: $upstream_connect_time '
'upstream_header_time: $upstream_header_time';
然后在对应 location 或 server 中启用该格式：
access_log /var/log/nginx/upstream_access.log upstream_log;- 确保该
location使用了proxy_pass，否则$upstream_*变量全为空字符串。 - 若后端不可达，
$upstream_addr显示为"-"，$upstream_status为"502"或类似错误码，$upstream_response_time仍可记录失败前的连接尝试耗时。
记录 TCP 负载均衡详情（如数据库代理）
在 stream 块中配置（注意：必须独立于 http）：
stream {
log_format tcp_proxy '$remote_addr:$remote_port - [$time_local] '
'$protocol $status $bytes_sent $bytes_received '
'upstream: $upstream_addr '
'connect: $upstream_connect_time '
'sent: $upstream_bytes_sent';
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/tcp_proxy.log tcp_proxy;
upstream db_cluster {
server 192.168.10.10:3306;
server 192.168.10.11:3306;
}
server {
listen 3307;
proxy_pass db_cluster;
proxy_timeout 1s;
}
}
说明：
-
$upstream_addr在成功转发时显示实际选中的后端 IP:PORT；失败时可能为空或显示"-"。 -
$upstream_connect_time是建立 TCP 连接的耗时（单位秒，精度毫秒），对排查网络延迟或后端拒绝连接非常关键。 - 日志路径需确保 Nginx 工作用户（如
www-data）有写权限，且目录存在。
验证与调试技巧
配置完成后务必测试，避免日志“看起来有但实际没写”：
- 执行
nginx -t检查语法；若提示unknown variable，说明变量用错作用域（例如在http块里用了stream变量）。 - 重启或重载 Nginx：
nginx -s reload； - 发起真实请求（如
curl http://your-domain/api或mysql -h your-ip -P 3307）； - 立刻查看对应日志文件：
tail -f /var/log/nginx/upstream_access.log，确认是否出现非空的upstream:字段； - 故意停掉一个后端，再发请求，观察日志中
upstream_status是否变为502、$upstream_addr是否切换到另一台——这证明负载逻辑与日志联动正常。
