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 | 峰值线程数 |

建议设置监控告警项

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

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