$upstream_bytes_sent表示nginx向upstream发送的请求体字节数（不含请求头），仅在proxy_pass等反向代理且有请求体时生效，需结合$upstream_addr和$request_uri实现路径与节点双重归因。
$upstream_bytes_sent 是 Nginx 官方变量，表示 Nginx 向 upstream（后端）发送的请求体字节数（不含请求头），单位为字节。它仅在使用 proxy_pass、fastcgi_pass 等反向代理指令时有效，且真实反映“发给后端的数据量”，对监控 API 调用负载、大请求识别、上游带宽预估非常关键。
要精准捕获并区分不同上游路径的实际网络吞吐，核心在于：让日志能明确标识“发往哪个 upstream 地址”、“走的是哪条 location 路径”、“是否含请求体” —— 不能只靠 $upstream_bytes_sent 单一字段。
明确 $upstream_bytes_sent 的适用边界
- ✅ 仅对有请求体的请求生效（如 POST/PUT/DELETE +
Content-Length > 0或 chunked body） - ✅ 若请求无请求体（如 GET/HEAD），该值恒为
0 - ✅ 多个 upstream（failover 或 backup）场景下，只记录最终成功发送的那个 upstream 的发送量
- ❌ 静态文件服务、
return、rewrite内部跳转等不经过 upstream 的流程，值为0
配置含上下文的 log_format 实现路径级吞吐归因
必须组合以下变量，才能把字节数和具体转发路径绑定：
-
$upstream_addr：实际发送目标（如10.0.2.5:8000,10.0.2.6:8000），支持多实例识别 -
$request_uri或$uri：原始请求路径（如/api/v2/order/create），用于区分业务路径 -
$upstream_bytes_sent：核心吞吐字段，直接反映发出字节数 -
$upstream_cache_status（可选）：辅助判断是否绕过上游（如BYPASS时$upstream_bytes_sent应为0）
示例配置（写在 http{} 块内）：
log_format upstream_send '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'$upstream_addr $upstream_bytes_sent $upstream_cache_status '
'$request_uri';
注意：不要给
$upstream_bytes_sent加引号，否则会输出字符串"0"而非数值0，影响后续 awk/Prometheus 解析。
按 upstream 分组或按 location 路径启用独立日志
避免日志混杂，推荐为不同转发策略单独定义日志路径：
upstream order_backend {
server 10.0.2.5:8000;
server 10.0.2.6:8000 backup;
}
upstream report_backend {
server 10.0.2.7:9000;
}
server {
location /api/order/ {
proxy_pass http://order_backend;
access_log /var/log/nginx/order-upstream.log upstream_send;
}
location /api/report/ {
proxy_pass http://report_backend;
access_log /var/log/nginx/report-upstream.log upstream_send;
}
}
这样 /var/log/nginx/order-upstream.log 中每行都对应订单路径的请求，$upstream_addr 和 $upstream_bytes_sent 可直接关联到具体后端节点与路径。
验证与常见问题排查
- 发起一个带 body 的 POST 请求（如
curl -X POST http://domain/api/order/ -d '{"id":1}'），检查日志末尾是否出现非零数字（如10.0.2.5:8000 24 HIT /api/order/） - 若始终为
0：- 确认请求方法是否含 body（GET 不会触发发送）
- 检查是否启用了
proxy_buffering off或chunked_transfer_encoding on（部分场景会影响统计精度，但$upstream_bytes_sent仍以实际 socket write 为准） - 排查是否被
proxy_set_body ""或proxy_pass_request_body off主动清空了请求体
吞吐分析建议（轻量实用）
-
实时统计某路径每秒平均发送量（单位：KB/s）：
tail -f /var/log/nginx/order-upstream.log | \ awk '{sum += $NF; count++} NR % 100 == 0 {print strftime("%H:%M:%S"), "avg:", int(sum/count/1024), "KB/s"; sum=count=0}' -
统计各 upstream 节点发送总量（离线分析）：
awk '{addr[$5] += $6} END {for (a in addr) print a, addr[a] " bytes"}' /var/log/nginx/order-upstream.log
不复杂但容易忽略的是：$upstream_bytes_sent 必须和 $upstream_addr、$request_uri 共同出现，才有路径与节点双重归因能力。单记字节数，等于只看水表不看水管走向。
