MyPerf4J 针对高并发、低延迟应用设计的高性能 Java 性能监控和统计工具

MyPerf4J

一个针对高并发、低延迟应用设计的高性能 Java 性能监控和统计工具。

特性

• 高性能: 单线程支持每秒 1000万次 响应时间的记录，每次记录只花费 73纳秒
• 无侵入: 采用 JavaAgent 方式，对应用程序完全无侵入，无需修改应用代码
• 低内存: 采用内存复用的方式，整个生命周期只产生极少的临时对象，不影响应用程序的GC
• 高精度: 采用纳秒来计算响应时间
• 高实时: 支持秒级监控，最低 1 秒!

使用场景

• 在开发环境中快速定位 Java 应用程序的性能瓶颈
• 在生产环境中长期监控 Java 应用程序的性能指标

文档

• English Doc
• 中文文档undefined

监控指标

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

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

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

  Markdown
  

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

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

  Markdown
• JVM GC CollectCount，CollectTime
  

  Markdown
• JVM Class Total，Loaded，Unloaded
  

  Markdown

> 想知道如何实现上述效果？请先按照[快速启动](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

如果你使用的是 JDK 7 或者更高版本可以尝试直接下载 MyPerf4J-ASM.jar

配置

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

-javaagent:/your/path/to/MyPerf4J-ASM.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 是受以下项目启发而来：

• Perf4J
• TProfiler

更多信息

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