如何通过 log_format 结合 $upstream_status 分析后端服务的响应分布-Nginx-PHP中文网

要准确分析后端响应分布，必须记录并分析 $upstream_status 而非仅看 $status；需自定义含 $upstream_status、$upstream_addr 和 $upstream_response_time 的日志格式，启用后结合 awk 聚合统计错误分布，联动 $status 与 $upstream_status 判定故障类型，并建议接入监控系统实现长期观测。

如何通过 log_format 结合 $upstream_status 分析后端服务的响应分布

要真正看清后端服务的响应分布，不能只看 Nginx 返回给客户端的 $status（比如一堆 502），而必须依赖 $upstream_status——它才是后端真实吐出的状态码。这个变量是分析健康分布的“眼睛”，但前提是日志格式得先把它记下来。

必须启用含 upstream_status 的自定义日志格式

Nginx 默认 access_log 不记录上游信息。需在 http 块中明确定义：

用 log_format 包含 $upstream_status、$upstream_addr 和 $upstream_response_time
推荐格式示例：
log_format upstream_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent $upstream_status $upstream_addr $upstream_response_time "$http_referer" "$http_user_agent"';
在 server 或 location 块中启用：
access_log /var/log/nginx/upstream.log upstream_log;
重启 Nginx 后，日志里每行就会带上有意义的 upstream 状态，如：
192.168.1.100 - - [28/Apr/2026:10:22:33 +0000] "GET /api/user HTTP/1.1" 200 1245 200 10.0.2.5:8080 0.042 "https://app.com" "curl/7.68"

按 upstream_status + upstream_addr 聚合识别异常节点

健康分布的关键是“谁在错、错得多不多”。直接用命令快速统计：

Livestream Script Generator

直播带货脚本：话术、节奏、互动、促单。适用于主播、电商运营、MCN机构。

下载

查各后端地址返回的错误码分布（例如哪台机器 500 高发）：
awk '{print $8, $9}' /var/log/nginx/upstream.log | grep "^[45]" | sort | uniq -c | sort -nr
（假设 $8 是 upstream_status，$9 是 upstream_addr）
定位高频失败的后端实例：
awk '$8 ~ /^[45]/ {print $9}' /var/log/nginx/upstream.log | sort | uniq -c | sort -nr | head -10
注意重试干扰：若某行显示 "500 10.0.2.5:8080, 10.0.2.6:8080"，说明第一次失败后重试了另一节点——两个地址都要纳入排查，不能只盯第一个。

联动 $status 和 $upstream_status 判定故障类型

单看 upstream_status 容易误判。必须结合 Nginx 自身返回状态，才能区分真实问题根源：

$status=502 且 $upstream_status="-"：Nginx 根本没连上后端（网络不通、端口未监听、防火墙拦截）
$status=504 且 $upstream_status="-"：后端无响应超时（可能是进程卡死、OOM、或 upstream_response_timeout 设置过短）
$status=200 但 $upstream_status=500：后端实际报错，但 Nginx 错误页或 proxy_intercept_errors 配置掩盖了问题——这就是典型的“健康假象”
$status=502 且 $upstream_status=502：后端自己返回了 502（如它也作为网关转发失败），需继续向上游追查