讲师中心 微信公众号
AI工具推荐 视频效率加速

Nginx 集群中如何记录请求转发与节点状态日志

浅强君_9302

浅强君_9302

发布时间:2026-07-19 06:31:58

|

523人浏览过

|

来源于php中文网

原创

需分两层实现:一是配置含$upstream_addr、$upstream_status等变量的自定义日志格式记录转发详情;二是通过nginx-upstream-check-module主动健康检查,结合/status接口与error_log中的状态变更提示(如“is down”)捕获节点上下线事件。

nginx 集群中如何记录请求转发与节点状态日志

要在 Nginx 负载均衡集群中同时记录请求转发详情和后端节点状态,需分两层处理:一是精准捕获每次请求实际发往哪个节点、耗时多少、返回码如何;二是感知节点健康变化(如从 up 切为 down),并留下可追溯的痕迹。纯开源 Nginx 不自带节点状态变更日志,但通过变量组合、模块扩展与日志解析,完全可以构建出实用可观测体系。

配置带上游信息的转发日志格式

这是记录请求分发行为的基础。在 http 块中定义专用日志格式,必须包含以下关键变量:

  • $upstream_addr:实际转发的目标地址(IP:port),失败重试时会以逗号分隔多个地址
  • $upstream_status:对应每个转发动作的 HTTP 状态码,顺序与 $upstream_addr 一致
  • $upstream_response_time:各次转发耗时(秒,毫秒精度),同样按逗号分隔
  • $request_time:客户端完整请求总耗时,用于对比识别慢节点或超时异常

示例配置:

log_format upstream_log '[$time_local] $remote_addr "$request" '
'upstream:$upstream_addr status:$upstream_status '
'rt:$upstream_response_time req:$request_time';

然后在 server 或 location 块中启用:
access_log /var/log/nginx/upstream.log upstream_log;

启用主动健康检查并暴露状态接口

仅靠访问日志无法得知节点是否被标记为不可用。需借助 nginx-upstream-check-module(需编译安装)实现周期性探测:

Nginx Config Linter
Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载
  • 在 upstream 块中添加 check 指令,例如:
    check interval=3 rise=2 fall=3 timeout=1 type=http;
  • 配合 check_http_send 和 check_http_expect_alive 自定义探测请求与成功条件(如期望返回 200)
  • 添加 location /status { check_status; } 暴露 HTML 或 JSON 格式实时状态页

该接口输出可被脚本定时抓取、比对,发现 status 字段变化即写入独立状态日志文件,形成节点上下线时间线。

捕获节点状态变更事件到 error_log

部分健康检查模块(如 nginx-upstream-check-module 或 OpenResty 的 lua-resty-upstream-healthcheck)会在节点状态切换时自动输出提示行到 error_log:

  • 确保 error_log 级别设为 notice 或更高
  • 搜索类似 "upstream check: server 192.168.1.10:8000 is down" 的日志条目
  • 可配合 grep -i "is down\|is up" 实时过滤,或用 Filebeat 等工具提取结构化事件

若需更灵活控制(如触发告警、写入数据库),推荐使用 OpenResty + Lua,在状态变化回调中调用 ngx.log 或执行外部命令。

补充建议:日志归集与分析

单机日志价值有限,集群场景下应考虑集中化处理:

  • 用 syslog 协议将 access_log 和 error_log 实时转发至日志中心(如 ELK 或 Loki)
  • 对 $upstream_addr 字段做聚合统计,可快速看出各节点请求数、错误率、平均响应时间
  • 结合 Prometheus + nginx-vts-exporter 或 custom metrics,把节点状态、活跃连接数等指标纳入监控大盘

不复杂但容易忽略。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

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

383

2023.07.27

nginx 配置详解
nginx 配置详解

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

3087

2023.08.04

nginx配置详解
nginx配置详解

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

5605

2023.08.04

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

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

541

2024.02.23

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

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

1456

2024.07.09

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

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

3918

2024.08.07

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

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

122

2026.01.13

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

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

417

2026.01.13

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn