使用 prometheus 监控 java 垃圾回收,最直接且标准的方法是在 jvm 启动参数中添加 -xx:enablejvmci 配合 micrometer 库,或者更常见地直接使用 -javaagent:/path/to/prometheus-jmx-exporter.jar。通过 jmx exporter 代理,prometheus 可以定期抓取 jvm 的 mbean 数据,其中包含 gc 次数和耗时等关键指标。配置好 exporter 后,prometheus 即可拉取 jvm_gc_pause_seconds 或 jvm_gc_collection_seconds 等指标,从而在 grafana 中展示 gc 频率、持续时间及停顿原因。

JVM 启动时如何配置 JMX Exporter 以暴露 GC 指标?
要在 JVM 启动时暴露 GC 指标,需要下载 prometheus-jmx-exporter 的 Jar 包,并编写一个 YAML 配置文件来定义要采集的 MBean 模式。启动命令中需加入 -javaagent 参数指向该 Jar 包,并通过 -Dcom.sun.management.jmxremote 确保 JMX 端口开放(如果未启用远程 JMX,Exporter 通常通过本地 socket 或 RMI 连接)。配置文件需指定 hostPort 和 port(Exporter 自身的 HTTP 监听端口),并在 rules 部分匹配 jvm.gc.* 相关的 MBean 属性,将其转换为 Prometheus 格式的指标。这样,当 Prometheus 访问 Exporter 的 HTTP 端点时,就能获取到包括 Young GC、Full GC 的次数和耗时在内的详细数据。

java -javaagent:/opt/prometheus/jmx_prometheus_javaagent-0.17.2.jar=8080:/opt/prometheus/config.yml -jar myapp.jar
上述命令中,8080 是 Exporter 监听的 HTTP 端口,/opt/prometheus/config.yml 是配置文件路径。配置文件示例如下:
lowercaseOutputName: true
rules:
- pattern: 'jvm.gc\.collection\.(?<name>.*)<time>'
name: jvm_gc_collection_seconds_sum
type: SUMMARY
attrNameSnakeCase: true
- pattern: 'jvm.gc\.collection\.(?<name>.*)<count>'
name: jvm_gc_collection_count
type: COUNTER
attrNameSnakeCase: true</count></name></time></name>
运行此配置后,Prometheus 抓取 http://localhost:8080/metrics 将得到 jvm_gc_collection_seconds_sum 和 jvm_gc_collection_count 等指标,标签 gc 会标识为 G1 Young Generation、PS Scavenge 等具体 GC 器名称。
Prometheus 配置文件中如何设置 scrape_config 以抓取 JMX Exporter 数据?
在 Prometheus 的 prometheus.yml 配置文件中,需要添加一个新的 scrape_config 块,目标地址指向运行了 JMX Exporter 的 JVM 主机和端口。通常使用 static_configs 指定 targets,例如 ['localhost:8080']。同时,为了正确解析指标,可能需要调整 metrics_path 为 /metrics(默认即为 /metrics,但显式声明更清晰)。此外,建议设置合理的 scrape_interval,例如 15s 或 30s,以避免对 JVM 造成过大压力。如果应用部署在 Kubernetes 中,则应使用 ServiceMonitor 或 PodMonitor 资源对象来自动发现 Endpoints,而不是静态配置。

scrape_configs:
- job_name: 'java-app-gc'
metrics_path: '/metrics'
scrape_interval: 15s
static_configs:
- targets: ['localhost:8080']
labels:
app: 'my-java-service'
此配置确保 Prometheus 每 15 秒从 localhost:8080 抓取一次指标。标签 app: 'my-java-service' 有助于在查询时区分不同服务。抓取到的指标如 jvm_gc_collection_seconds_count{gc="G1 Young Generation"} 可直接用于告警规则,例如当 Full GC 频率超过阈值时触发通知。
如何通过 PromQL 查询特定 GC 类型的总停顿时间?
要查询特定 GC 类型(如 G1 Young Generation)的总停顿时间,可以使用 PromQL 函数 sum by (gc) 对 jvm_gc_collection_seconds_sum 指标进行聚合。例如,查询语句 sum by (gc) (rate(jvm_gc_collection_seconds_sum[5m])) 可计算过去 5 分钟内各 GC 类型的平均停顿速率。若需查看累计总时间,可使用 sum by (gc) (jvm_gc_collection_seconds_sum)。结合 instance 或 app 标签,可进一步细化到具体实例或服务。对于 G1 GC,重点关注 gc="G1 Young Generation" 和 gc="G1 Mixed Generation" 的指标,它们分别代表年轻代和混合代的停顿。通过 Grafana 面板可视化这些查询结果,可直观监控 GC 行为趋势,辅助调优决策。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











