Nginx ip_hash 负载均衡怎么记录会话保持的日志监控指标-Nginx-PHP中文网

要监控nginx ip_hash会话保持效果，需自定义日志格式记录$http_x_forwarded_for、$upstream_addr等关键字段，结合real_ip配置确保ip真实，并通过单ip后端数分布、节点占比稳定性、跳变率等指标评估漂移、倾斜或失效问题。

nginx ip_hash 负载均衡怎么记录会话保持的日志监控指标

要监控 Nginx ip_hash 的会话保持效果，核心不是“记录会话”，而是验证请求是否稳定落在同一台后端，并识别漂移、倾斜或失效问题。Nginx 本身不维护会话状态日志，需靠日志字段组合 + 外部分析实现可观测性。

关键日志字段必须启用

默认 access log 不包含足够信息。需自定义 log_format，显式记录以下字段：

$remote_addr：原始连接 IP（但可能只是代理地址）
$http_x_forwarded_for：代理链中第一个真实客户端 IP（需配合 real_ip 模块才可信）
$upstream_addr：实际转发到的后端地址和端口（含连接复用信息，如 10.0.1.10:8080, 10.0.1.10:8080 表示复用）
$upstream_http_set_cookie（可选）：若后端返回了 session cookie，可用于交叉验证路由一致性
$status 和 $request_time：辅助判断后端异常或响应延迟是否引发误判

示例配置：

log_format iphash_log '$http_x_forwarded_for - $remote_addr [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$upstream_addr" $request_time';

然后在 server 或 location 中使用：access_log /var/log/nginx/iphash_access.log iphash_log;

Nginx Hosting

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

下载

监控哪些指标能反映会话保持质量

从日志中提取并聚合以下维度，即可评估 ip_hash 是否正常工作：

单 IP 对应后端数分布：对每个 $http_x_forwarded_for 统计出现过的 $upstream_addr 数量。理想情况下 >95% 的 IP 只对应 1 个后端；若大量 IP 出现 2+ 个后端，说明发生漂移
后端节点请求占比稳定性：按小时统计各 $upstream_addr 的请求数占比。IP Hash 理论上应接近均匀（如 3 台后端≈33%±5%），持续偏离（如某台长期超 50%）表明 NAT 倾斜或节点变更未收敛
高频 IP 请求跳变率：筛选每分钟请求 ≥10 次的客户端 IP，计算其相邻两分钟内 $upstream_addr 是否变化。跳变率 >1% 即需告警（排除后端宕机场景）
代理头缺失率：统计 $http_x_forwarded_for 为空但 $remote_addr 是私有网段（如 10.x、172.16–31.x、192.168.x）的日志比例。该值高说明前端未透传真实 IP，ip_hash 实际基于代理 IP 计算，必然失效

生产环境必须配套的配置项

光有日志不够，需确保日志内容真实有效：

在 http 块中声明可信代理段：set_real_ip_from 10.0.0.0/8;（按实际 CDN/WAF/公司出口网段填写）
指定真实 IP 来源头：real_ip_header X-Forwarded-For;（或 X-Real-IP，需与前端一致）
在 proxy_pass 的 location 中透传头信息：proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
开启 upstream 健康检查（如 check 指令），避免因节点临时 down 导致哈希重散列却无感知