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

如何配置 Nginx 实现对后端接口的“响应时间中位数”实时监控

雨浩酱_8874

雨浩酱_8874

发布时间:2026-05-09 16:14:35

|

543人浏览过

|

来源于php中文网

原创

Nginx 不直接计算中位数,需通过 $upstream_response_time 采集后端耗时,配合 Prometheus/ELK/Loki 等外部工具实现响应时间中位数监控。

如何配置 nginx 实现对后端接口的“响应时间中位数”实时监控

Nginx 本身不直接计算中位数,但可以通过标准变量 + 外部工具链实现“响应时间中位数”的准实时监控。关键在于:把原始耗时数据可靠采集出来,再交给擅长统计的系统处理。


用 $upstream_response_time 记录真实后端耗时

这是最核心的一步。该变量单位为秒(含毫秒精度),记录从 Nginx 向后端发起请求到收到响应头的时间,不含 Nginx 自身开销,适合横向对比后端性能。

  • 多次重试时以逗号分隔,如 "0.012, 0.045"
  • 失败则对应位置为 -,如 "0.018, -"
  • 配合 $upstream_addr 可定位具体节点

在 http 块中定义专用日志格式:

log_format upstream_metrics '$remote_addr [$time_local] "$request" '
                            '$status $body_bytes_sent '
                            '"$upstream_addr" $upstream_response_time '
                            '$request_time';

然后在 location 或 server 中启用:

access_log /var/log/nginx/upstream_metrics.log upstream_metrics;

✅ 这样每行日志就包含一次请求的后端地址与耗时,是后续计算中位数的原始依据。


将日志流实时接入支持分位数计算的监控系统

Nginx 日志是文本流,需借助外部工具做实时聚合。推荐两条成熟路径:

Nginx Hosting
Nginx Hosting

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

下载
  • Prometheus + nginx-prometheus-exporter + Grafana

    • nginx-prometheus-exporter 可解析 access log(需开启 --enable-upstream-stats)
    • 它会暴露 nginx_upstream_response_msecs 指标(直方图类型)
    • 在 Grafana 中用 histogram_quantile(0.5, sum(rate(nginx_upstream_response_msecs_bucket[5m])) by (le)) 即可算出 5 分钟窗口内的响应时间中位数(单位毫秒)
  • ELK(Logstash + Elasticsearch + Kibana)或 Loki + Grafana

    • Logstash 用 dissect 或 grok 提取 $upstream_response_time 字段并转为数值
    • Elasticsearch 索引中对该字段开启 histogram 聚合,Kibana 里用 Percentiles 可视化中位数
    • Loki 配合 Promtail 抓取日志,Grafana 使用 | line_format "{{.upstream_response_time}}" | unwrap .upstream_response_time + quantile_over_time(0.5, ...) 实现类似效果

⚠️ 注意:$upstream_response_time 是字符串,若含 - 或多个值(如重试),需在采集端做过滤或拆分。建议先用 map 或 Lua(OpenResty)预处理成单值(如取首次成功耗时)。


(可选)轻量级脚本方式:每分钟滚动计算中位数

适用于测试环境或临时验证,不建议用于高流量生产场景:

  • 用 awk 提取有效耗时(跳过 -,取第一个非空值):
    awk '$12 != "-" && $12 > 0 {print $12}' /var/log/nginx/upstream_metrics.log | sort -n | awk '{
        a[NR]=$1
    }
    END {
        if (NR%2==1) print a[int(NR/2)+1]*1000 "ms"
        else print (a[NR/2]+a[NR/2+1])/2*1000 "ms"
    }'
  • 配合 cron 每分钟执行,结果写入临时文件或推送到 Redis,供简单看板读取

? 提示:该方式延迟约 1 分钟,且未去重、未按接口路径区分。如需按 /api/user /api/order 分别看中位数,必须在日志中加入 $request_uri 并在聚合时分组。


不复杂但容易忽略的是数据清洗和维度对齐。只要 $upstream_response_time 准确落盘,并匹配上 $upstream_addr 和 $request_uri,中位数就只是工具链上的一个函数调用。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

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

切问学术

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2823

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7090

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6606

2024.03.19

nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4007

2023.08.04

nginx配置详解
nginx配置详解

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

6865

2023.08.04

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

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

601

2024.02.23

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

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

1516

2024.07.09

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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