Prometheus监控JVM需通过JMX Exporter或Micrometer转换指标:JMX Exporter以Java Agent方式无侵入暴露指标,适用于老项目;Micrometer原生集成Spring Boot新项目,指标更丰富。

Prometheus 本身不直接采集 JVM 指标,必须借助“翻译层”把 JVM 内部的运行时数据(如堆内存、GC 事件)转换成它能识别的 /metrics 格式。核心路径是:JVM → JMX 或 Micrometer → Exporter/SDK → Prometheus 抓取 → Grafana 展示。
用 JMX Exporter 无侵入暴露 JVM 指标
适合老项目、无法改代码的 Java 应用。原理是通过 Java Agent 在进程内读取 JMX MBean,再以 HTTP 端点暴露 Prometheus 格式指标。
- 下载
jmx_prometheus_javaagent.jar(推荐 0.18.x+ 版本,兼容 JDK 17/21) - 准备配置文件(如
jmx_config.yml),至少启用关键规则:
rules:
- pattern: "java.lang<type=Memory>:(HeapMemoryUsage|NonHeapMemoryUsage):(used|committed|max)"
name: jvm_memory_bytes_$2
labels:
area: "$1"
type: GAUGE
- pattern: "java.lang<type=GarbageCollector, name=.*>:(CollectionCount|CollectionTime)"
name: jvm_gc_$2_total
labels:
gc: "$1"
type: COUNTER
- 启动应用时添加 JVM 参数:
-javaagent:/path/jmx_prometheus_javaagent.jar=8080:/path/jmx_config.yml - Prometheus 配置 job 抓取该地址(如
http://pod-ip:8080/metrics)
用 Micrometer(Spring Boot 推荐)原生集成
适用于 Spring Boot 2.0+ 新项目,指标更丰富、语义更清晰,且天然支持业务指标打点。
- 添加依赖:
micrometer-registry-prometheus - 开启 Actuator 端点:
management.endpoints.web.exposure.include=prometheus - 默认暴露在
/actuator/prometheus,指标名带jvm_前缀,例如:
jvm_memory_used_bytes{area="heap",id="PS Old Gen"}jvm_gc_pause_seconds_count{action="endOfMajorGC",cause="Metadata GC Threshold"}jvm_threads_live_threads
重点关注的内存与 GC 核心指标
不是所有指标都需告警,以下几类是定位卡顿、OOM、泄漏的关键信号:
-
堆内存水位:
jvm_memory_used_bytes{area="heap"}/jvm_memory_max_bytes{area="heap"}—— 持续 >85% 且缓慢上升,预示老年代压力或内存泄漏 -
GC 频次与耗时:
jvm_gc_collection_seconds_count{gc=~"G1|ConcurrentMarkSweep|ParallelOldGC"}和_sum—— P99 GC 时间突增、每分钟 Full GC ≥ 1 次,大概率触发 STW -
非堆/元空间异常:
jvm_memory_used_bytes{area="nonheap",id="Metaspace"}—— 持续增长且未回落,可能类加载泄漏 -
线程数失控:
jvm_threads_live_threads—— 超过 500 并持续上涨,常伴随线程池未关闭或阻塞
在 K8s 中稳定采集的要点
容器环境有特殊约束,忽略这些容易导致指标丢失或抓取失败:
- JMX Exporter 的
hostPort必须绑定到0.0.0.0(而非127.0.0.1),否则 Prometheus 无法从 Pod 外访问 - 避免将 jar 包挂载为 ConfigMap(二进制不兼容),建议打包进镜像;配置文件可挂载,但需确保路径在容器内可读
- K8s Service 或 Endpoint 需正确关联到应用 Pod 的 Exporter 端口(如 8080),并设置 readinessProbe 检查该端口健康
- 若用 Prometheus Operator,用
ServiceMonitor关联 Service,并指定targetLabels区分不同 JVM 实例


















