gary-xie / jmxmon

基于open-falcon的jmx监控插件

jmxmon 简介

jmxmon是一个基于open-falcon的jmx监控插件，通过这个插件，结合open-falcon agent，可以采集任何开启了JMX服务端口的java进程的服务状态，并将采集信息自动上报给open-falcon服务端

主要功能

通过jmx采集java进程的jvm信息，包括内存占用、gc耗时、gc次数、gc吞吐、老年代使用率、新生代晋升大小、活跃线程数等信息。

对应用程序代码无侵入，几乎不占用系统资源。

环境需求

Linux

JDK>=1.6

Open-Falcon>=0.0.5

目标java进程开启jmx端口

jmxmon部署

1. 安装并启动open-falcon agent
2. 下载并解压编译好的 release包 到目标安装目录下
3. cp conf.example.properties conf.properties
4. 修改conf.properties配置文件，一般情况下只需要将jmx.ports的端口号配置上就可以了
5. sh control start
6. sh control tail查看日志，或者cat var/app.log以确认程序是否正常启动

配置说明

配置文件默认文件名为conf.properties，内容说明如下：

# 工作目录用来存放jmxmon的临时缓存文件，注意不要修改此目录下的文件
workDir=./

# 需要监听的本地jmx端口，支持监听多个端口，多端口用逗号分隔
jmx.ports=10000,10001,10002,10003

# 本地agent的上报url，如果使用open-falcon的默认配置，则这里不需要改变
agent.posturl=http://localhost:1988/v1/push

# 可选项：上报给open-falcon的endpoint，默认值为本机hostname。不建议修改
#hostname=

# 可选项：上报给open-falcon的上报间隔，默认值60，单位秒。不建议修改
#step=

采集指标

Counters	Type	Notes
parnew.gc.avg.time	GAUGE	一分钟内，每次YoungGC(parnew)的平均耗时
concurrentmarksweep.gc.avg.time	GAUGE	一分钟内，每次CMSGC的平均耗时
parnew.gc.count	GAUGE	一分钟内，YoungGC(parnew)的总次数
concurrentmarksweep.gc.count	GAUGE	一分钟内，CMSGC的总次数
gc.throughput	GAUGE	GC的总吞吐率（应用运行时间/进程总运行时间）
new.gen.promotion	GAUGE	一分钟内，新生代的内存晋升总大小
new.gen.avg.promotion	GAUGE	一分钟内，平均每次YoungGC的新生代内存晋升大小
old.gen.mem.used	GAUGE	老年代的内存使用量
old.gen.mem.ratio	GAUGE	老年代的内存使用率
thread.active.count	GAUGE	当前活跃线程数
thread.peak.count	GAUGE	峰值线程数
heap.mem.init	GAUGE	初始总内存
heap.mem.max	GAUGE	最大可用内存
heap.mem.used	GAUGE	已使用内存

建议设置监控告警项

不同应用根据其特点，可以灵活调整触发条件及触发阈值

告警项	触发条件	备注
gc.throughput	all(#3)<98	gc吞吐率低于98%，影响性能
old.gen.mem.ratio	all(#3)>90	老年代内存使用率高于90%，需要调优
thread.active.count	all(#3)>500	线程数过多，影响性能