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

  想知道如何实现上述效果？请先按照快速启动的描述启动应用，再按照这里的描述进行安装配置即可。

快速启动

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

打包

• git clone [email protected]: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 #MetricsProcessor 类型，0:以标准格式化结构输出到 stdout.log 1:以标准格式化结构输出到磁盘 2:以 InfluxDB LineProtocol 格式输出到磁盘 MetricsProcessorType=1 #配置各个 Metrics 日志的文件路径，可不配置 MethodMetricsFile=/data/logs/MyPerf4J/method_metrics.log #ClassMetricsFile=/data/logs/MyPerf4J/class_metrics.log #GCMetricsFile=/data/logs/MyPerf4J/gc_metrics.log #MemMetricsFile=/data/logs/MyPerf4J/memory_metrics.log #ThreadMetricsFile=/data/logs/MyPerf4J/thread_metrics.log #配置日志文件滚动时间间隔，分别有 MINUTELY、HOURLY 和 DAILY 三个值 LogRollingTimeUnit=HOURLY #配置备份 Recorders 的数量，默认为 1，最小为 1，最大为 8，当需要在较小 MillTimeSlice 内统计大量方法性能数据时可配置大一些 BackupRecordersCount=1 #配置 Record 模式，可配置为 accurate/rough RecorderMode=accurate #配置时间片，单位为 ms，最小 1s，最大 600s MillTimeSlice=10000 #是否展示方法参数类型 ShowMethodParams=true #需要监控的 package，可配置多个，用英文';'分隔 IncludePackages=cn.perf4j.demo #不需要监控的 package，可配置多个，用英文';'分隔 ExcludePackages=org.spring; #可配置多个方法名，用英文';'分隔 ExcludeMethods=equals;hash #是否排除私有方法，true/false ExcludePrivateMethod=true #通用的方法执行时间阈值，单位为 ms ProfilingTimeThreshold=1000 #在一个时间片内，超过方法执行时间阈值的次数，仅在 RecorderMode=accurate 时有效 ProfilingOutThresholdCount=10 

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

运行

• 输出结果，输出到 /data/logs/MyPerf4J/method_metrics.log:

  MyPerf4J Method Metrics [2018-09-06 19:21:40, 2018-09-06 19:21:45] Method[4] RPS Avg(ms) Min(ms) Max(ms) StdDev Count TP50 TP90 TP95 TP99 TP999 TP9999 TP99999 TP100 DemoServiceImpl.getId1(long) 1974 0.00 0 0 0.00 9870 0 0 0 0 0 0 0 0 DemoServiceImpl.getId2(long) 2995 0.50 0 2 0.01 14975 0 1 2 2 2 2 2 2 DemoServiceImplV2.getId1(long) 787 0.00 0 0 0.00 3938 0 0 0 0 0 0 0 0 DemoServiceImplV2.getId3(long) 1575 0.50 0 1 0.01 7876 1 1 1 1 1 1 1 1 

卸载

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

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

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

问题

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

更多信息

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