MyPerf4J

一个针对高并发、低延迟应用设计的高性能且无侵入的实时Java性能监控和统计工具。
受 perf4j 和 TProfiler启发而来。

MyPerf4J具有以下几个特性：

• 无侵入: 采用JavaAgent方式，对应用程序完全无侵入，无需修改应用代码
• 高性能: 性能消耗非常小，每次记录只花费73ns，可以在生产环境长期使用
• 低内存: 采用内存复用的方式，整个生命周期只产生极少的临时对象，不影响应用程序的GC
• 高精度: 采用纳秒来计算响应时间
• 高实时: 支持秒级监控，最低1s!

文档

• English README Document

• 中文文档

监控指标

MyPerf4J为每个应用收集数十个监控指标，所有的监控指标都是实时采集和展现的。

下面是MyPerf4J目前支持的监控指标列表:

• Method
  
  RPS，Count，Avg，Min，Max，StdDev，TP50, TP90, TP95, TP99, TP999, TP9999, TP99999, TP100

• JVM Thread
  
  TotalStarted，Runnable，Blocked，Waiting，TimedWaiting，Terminated，Active，Peak，Daemon，New

• JVM Memory
  
  HeapInit，HeapUsed，HeapCommitted，HeapMax，NonHeapInit，NonHeapUsed，NonHeapCommitted，NonHeapMax

• JVM GC
  
  CollectCount，CollectTime

• JVM Class
  
  Total，Loaded，Unloaded

> 想知道如何实现上述效果？请先按照[快速启动](https://github.com/ThinkpadNC5/MyPerf4J#%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8)的描述启动应用，再按照[这里](https://github.com/ThinkpadNC5/MyPerf4J/wiki/InfluxDB_)的描述进行安装配置即可。

快速启动

MyPerf4J采用JavaAgent配置方式，透明化接入应用，对应用代码完全没有侵入。

打包

• git clone git@github.com:ThinkpadNC5/MyPerf4J.git
• mvn clean package
• 把 MyPerf4J-ASM-${MyPerf4J-version}.jar 重命名为 MyPerf4J-ASM.jar

配置

在JVM启动参数里加上以下两个参数

-javaagent:/your/path/to/MyPerf4J-ASM-${MyPerf4J-version}.jar

-DMyPerf4JPropFile=/your/path/to/myPerf4J.properties

其中，MyPerf4JPropFile的配置如下:

#应用名称
AppName=MyPerf4JTest

#配置MetricsProcessors，可不配置
#MethodMetricsProcessor=cn.myperf4j.ext.metric.processor.influxdb.InfluxDBMethodMetricsProcessor
#ClassMetricsProcessor=cn.myperf4j.ext.metric.processor.influxdb.InfluxDBJvmClassMetricsProcessor
#GCMetricsProcessor=cn.myperf4j.ext.metric.processor.influxdb.InfluxDBJvmGCMetricsProcessor
#MemMetricsProcessor=cn.myperf4j.ext.metric.processor.influxdb.InfluxDBJvmMemoryMetricsProcessor
#ThreadMetricsProcessor=cn.myperf4j.ext.metric.processor.influxdb.InfluxDBJvmThreadMetricsProcessor
   
#配置备份Recorders的数量，默认为1，最小为1，最大为8，当需要在较小MillTimeSlice内统计大量方法性能数据时可配置大一些
BackupRecordersCount=1
   
#配置Record模式，可配置为accurate/rough
RecorderMode=accurate
   
#配置时间片，单位为ms，最小1s，最大600s
MillTimeSlice=10000
   
#需要监控的package，可配置多个，用英文';'分隔
IncludePackages=cn.perf4j.demo
   
#不需要监控的package，可配置多个，用英文';'分隔
ExcludePackages=org.spring;
   
#可配置多个方法名，用英文';'分隔
ExcludeMethods=equals;hash
   
#是否排除私有方法，true/false
ExcludePrivateMethod=true
   
#通用的方法执行时间阈值，单位为ms
ProfilingTimeThreshold=1000
   
#在一个时间片内，超过方法执行时间阈值的次数，仅在RecorderMode=accurate时有效
ProfilingOutThresholdCount=10

想了解更多的配置？请看这里

运行

• 输出结果，默认输出到stdout.log:

  MyPerf4J Performance Statistics [2018-07-01 23:40:23, 2018-07-01 23:40:24]
  Api[2/3]                    RPS  Avg(ms)  Min(ms)  Max(ms)   StdDev     Count     TP50     TP90     TP95     TP99    TP999   TP9999  TP99999    TP100
  DemoServiceImpl.getId1  7454181     0.00        0        0     0.00   7454181        0        0        0        0        0        0        0        0
  DemoServiceImpl.getId2  7454180     0.00        0        0     0.00   7454180        0        0        0        0        0        0        0        0

卸载

在JVM启动参数中去掉以下两个参数，重启即可卸载此工具。

-javaagent:/your/path/to/MyPerf4J-ASM.jar

-DMyPerf4JPropFile=/your/path/to/myPerf4J.properties

问题

如果您遇到任何问题或有疑问，请您毫不犹豫的提交Issue : )

更多信息

想更深入的了解MyPerf4J？请看https://github.com/ThinkpadNC5/MyPerf4J/wiki/Chinese-Doc。

PS: 如果觉得写得还行，请star这个项目，让更多人了解和使用MyPerf4J :) 。