怎么在 Nginx 中记录负载均衡集群的详细调度日志-Nginx-PHP中文网

要在 Nginx 中记录负载均衡集群的详细调度日志，需自定义 log_format 使用 $upstream_addr、$upstream_status、$upstream_response_time 等变量，并在 proxy_pass 位置启用该日志格式；配合 $upstream_http_x_backend_id 可记录后端返回的业务标识，实现精准链路追踪。

怎么在 nginx 中记录负载均衡集群的详细调度日志

要在 Nginx 中记录负载均衡集群的详细调度日志，核心是利用 $upstream_addr、$upstream_status、$upstream_response_time 等内置变量，并自定义 log_format，同时确保后端服务能返回可识别的标识（如响应头）用于追踪请求流转路径。

配置自定义日志格式，包含关键上游信息

在 http 块中定义一个带上游调度详情的日志格式：

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 '
  'request_id: $request_id';

说明：

$upstream_addr：实际转发到的后端地址（含 IP 和端口），若经过多级代理或失败重试，会以逗号分隔多个地址
$upstream_status：对应每个 upstream server 的 HTTP 状态码，也按逗号分隔，与 $upstream_addr 顺序一一对应
$upstream_response_time：各次转发的耗时（秒，精度毫秒），同样逗号分隔
$request_id 可配合 map 或第三方模块（如 nginx-http-request-id）生成唯一请求 ID，便于全链路追踪

启用 upstream 模块的健康检查与状态日志（可选但推荐）

若使用 upstream 块做负载均衡，建议开启主动健康检查，并配合 stub_status 或 nginx_upstream_check_module 查看实时调度状态：

upstream backend {
    server 10.0.1.10:8080 max_fails=2 fail_timeout=10s;
    server 10.0.1.11:8080 max_fails=2 fail_timeout=10s;
    check interval=3 rise=2 fall=5 timeout=1;
}

注意：check 指令需编译时启用 nginx_upstream_check_module。它本身不写日志，但能让你确认哪台节点被选中、是否被标记为 down，辅助分析日志中的调度异常。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

在 location 中应用自定义日志并确保变量可用

在 server 或 location 块中启用该日志格式，并确保请求确实经过 upstream 转发（即用了 proxy_pass）：

location /api/ {
    proxy_pass https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/upstream_access.log upstream_log;
error_log /var/log/nginx/upstream_error.log warn;

}

关键点：

只有在执行了 proxy_pass 到 upstream 的 location 中，$upstream_* 变量才有效；静态资源或内部重定向不会填充这些值
如果启用了 proxy_next_upstream（如超时、502 时重试），日志中 $upstream_addr 会显示所有尝试过的后端，例如 10.0.1.10:8080, 10.0.1.11:8080
建议搭配 proxy_next_upstream_tries 3 和 proxy_next_upstream_timeout 5s 明确控制重试行为，让日志更可控

补充：记录后端返回的自定义响应头（如 X-Backend-ID）

若后端服务在响应头中返回标识（如 X-Backend-ID: node-a），可在 Nginx 中捕获并写入日志：

log_format upstream_log 
  ...
  'backend_id: $upstream_http_x_backend_id';
<h1>在 location 中透传并捕获</h1><p>location /api/ {
proxy_pass <a href="https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e">https://www.php.cn/link/65b5b8d1f89bf53a5713bc3afdd83e9e</a>;
proxy_pass_request_headers on;</p><h1>让 $upstream_http_x_backend_id 可用</h1><pre class="brush:php;toolbar:false;">proxy_hide_header X-Backend-ID;
add_header X-Backend-ID $upstream_http_x_backend_id;

}

说明：