spring boot应用需通过actuator暴露/actuator/prometheus端点,配置spring-boot-starter-actuator和micrometer-registry-prometheus依赖,并在application.yml中启用health、info、metrics、prometheus端点;nginx仅作反向代理透传,prometheus直连java应用抓取指标,不经过nginx-exporter。

要在 Nginx 环境中实时获取后端 Java 应用的 JVM 运行指标,关键不是让 Nginx 去“采集”JVM 数据,而是让 Java 应用自身主动暴露可观测性端点,再由独立监控系统(如 Prometheus)直接抓取——Nginx 在其中主要承担反向代理、路由和健康状态透传的角色。
Java 应用需暴露标准监控端点
Spring Boot 项目应启用 Actuator 并暴露 /actuator/prometheus 或 /actuator/metrics:
- 添加依赖:
spring-boot-starter-actuator和micrometer-registry-prometheus - 配置
application.yml:management: endpoints: web: exposure: include: health,info,metrics,prometheus endpoint: prometheus: scrape-interval: 15s - 确保 JVM 启动时开启 JMX(如需补充指标):
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false
Nginx 需正确代理监控路径
避免因路径重写或权限拦截导致监控端点不可达:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 在 server 块中显式放行
/actuator/路径,例如:location /actuator/ { proxy_pass http://java-backend/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } - 禁用对
/actuator/prometheus的缓存(防止指标 stale):location = /actuator/prometheus { proxy_pass http://java-backend/actuator/prometheus; proxy_cache_bypass $http_upgrade; add_header Cache-Control "no-cache"; } - 如使用 Basic Auth 或 IP 白名单,需同步允许 Prometheus 抓取器 IP 访问该路径
Prometheus 直接抓取 Java 端点,不经过 Nginx Exporter
Nginx 本身不解析 JVM 指标,所以不要试图用 nginx-exporter 抓取 Java 数据。正确做法是:
- 在 Prometheus
scrape_configs中新增 job,直连 Java 应用地址(非 Nginx 域名):- job_name: 'springboot-jvm' static_configs: - targets: ['10.0.1.20:8080'] # Java 实例真实 IP+端口 metrics_path: '/actuator/prometheus'
- 若 Java 应用仅通过 Nginx 对外暴露(如无内网直连),则需在 Nginx 上做一层透明代理,并确保
Host和X-Forwarded-For头正确透传,且后端 Spring Boot 配置server.forward-headers-strategy: native - 关键指标示例:
jvm_memory_used{area="heap"}、process_cpu_usage、http_server_requests_seconds_count
可选增强:Nginx 协同健康状态与权重联动
当 Java 应用提供 /actuator/health 时,Nginx 可结合 upstream_check_module 主动探测其状态,并动态调整负载分发:
- 在 upstream 中配置 HTTP 健康检查,匹配
200且响应体含"status":"UP" - 利用 OpenResty + Lua 获取
/actuator/metrics/jvm.memory.used的数值,结合阈值计算服务权重,反馈给 Nginx 负载均衡逻辑 - 这样既保障了可用性,又让流量分配具备 JVM 资源水位感知能力
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










