如何通过分析 upstream_status 日志统计集群中各节点的健康分布

阿晨吖_6137

阿晨吖_6137

2026-05-25

931人浏览

原创

要真正看清集群中各节点的健康分布,必须依赖 $upstream_status 而非 $status,它记录后端真实响应及重试全过程;需自定义日志格式并启用 upstream_log,结合 awk 按节点与错误码聚合分析,注意重试干扰,并可为各节点生成独立日志实现精细化可观测。

如何通过分析 upstream_status 日志统计集群中各节点的健康分布

要真正看清集群中各节点的健康分布,不能只看 Nginx 返回给客户端的 $status(比如全是 200),而必须依赖 $upstream_status——它记录的是后端真实返回的状态码,包括重试过程中的每一次响应,是诊断抖动、定位故障节点的核心依据。

必须先记录有意义的 upstream_status

Nginx 默认 access_log 不包含上游状态。需在 http 块中明确定义日志格式:

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 后,每行日志就会类似:

192.168.1.100 - - [12/May/2026:15:30:22 +0000] "GET /api/order HTTP/1.1" 200 342 200 10.0.2.5:8080 0.037 "https://app.com" "curl/7.68"

注意:若发生重试,$upstream_status 可能为 "504,502,200",$upstream_addr 可能为 "10.0.2.5:8080, 10.0.2.6:8080"——这两个字段都要一起分析。

按节点+错误码聚合,识别异常源头

健康分布的关键是“谁在错、错得多不多”。用 awk 快速统计:

  • 查各节点返回的 4xx/5xx 分布(例如哪台机器 500 高发):

    Upload audio to AIOZ Stream
    Upload audio to AIOZ Stream

    快速上传音频至 AIOZ Stream API。支持默认或自定义编码配置创建音频对象,上传文件并完成处理后返回音频链接。

    下载
    awk '{print $7, $8}' /var/log/nginx/upstream.log | grep "^[45]" | sort | uniq -c | sort -nr

    (假设 $7 是 $upstream_status,$8 是 $upstream_addr;字段序号需根据实际日志格式校准)

  • 定位高频失败的后端地址:

    awk '$7 ~ /^[45]/ {print $8}' /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 判定故障类型

  • $status == 502 且 $upstream_status == 502 → 后端主动返回 502,查其自身日志(如应用崩溃、数据库连不上)
  • $status == 502 但 $upstream_status == "-" 或为空 → CLB/Nginx 未收到任何响应,常见于后端端口未监听、安全组拦截(如阿里云 CLB 要求放行 100.64.0.0/10)、连接被 reset
  • $status == 200 但 $upstream_status 含 "504,200" 或 "502,200" → 后端存在抖动,靠重试兜底,P99 延迟可能已恶化,需检查 proxy_read_timeout 是否过短,或后端慢查询

进阶:为每个节点生成独立日志,实现长期可观测

仅靠全局日志难以区分节点行为。推荐用 map 映射地址为 ID,并动态写入节点专属日志:

map $upstream_addr $backend_id {
    default "unknown";
    "10.0.2.5:8080" "node-a";
    "10.0.2.6:8080" "node-b";
}
log_format node_log '$remote_addr [$time_local] "$request" '
                     '$status $upstream_status $upstream_response_time $backend_id';
access_log /var/log/nginx/backend/$backend_id-access.log node_log;

这样就能对 node-a-access.log 单独做错误率计算、P95 响应时间分析、缓存命中率统计等,真正落到每个实例。

不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

stream

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

403

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3727

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

6485

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

581

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1496

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3978

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

122

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

517

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

159

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
零基础精通 PS 视频教程
零基础精通 PS 视频教程

共268课时 | 120.1万人学习

前端工程师必备技能—PS切图
前端工程师必备技能—PS切图

共11课时 | 2.2万人学习

麦子学院Photoshop切片视频教程
麦子学院Photoshop切片视频教程

共13课时 | 4.3万人学习