简体中文 | English

MyPerf4J

价值

• 快速定位性能瓶颈
• 快速定位故障原因

优势

• 高性能: 单线程支持每秒 1500 万次 响应时间的记录，每次记录只花费 67 纳秒
• 无侵入: 采用 JavaAgent 方式，对应用程序完全无侵入，无需修改应用代码
• 低内存: 采用内存复用的方式，整个生命周期只产生极少的临时对象，不影响应用程序的 GC
• 高精度: 采用纳秒来计算响应时间
• 高实时: 支持秒级统计，最低统计粒度为 1 秒，并且是全量统计，不丢失任何一次记录

文档

• English Doc
• 中文文档

监控指标

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

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

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

• JVM Metrics
  Thread，Memory，ByteBuff，GC，Class

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

快速启动

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

打包

• git clone [email protected]:LinShunKang/MyPerf4J.git
• mvn clean package
• 把 MyPerf4J-ASM-${MyPerf4J-version}.jar 重命名为 MyPerf4J-ASM.jar

可以尝试直接下载 MyPerf4J-ASM.jar

配置

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

• -javaagent:/your/path/to/MyPerf4J-ASM.jar
• -DMyPerf4JPropFile=/your/path/to/MyPerf4J.properties

形如：java -javaagent:/your/path/to/MyPerf4J-ASM.jar -DMyPerf4JPropFile=/your/path/to/MyPerf4J.properties -jar yourJar.jar

注意：使用 Windows 的同学，请注意修改路径格式，包括 MyPerf4JPropFile 中的文件路径

其中，MyPerf4JPropFile的配置如下:

#应用名称
AppName=YourApplicationName

#MetricsProcessor 类型，0:以标准格式化结构输出到 stdout.log 1:以标准格式化结构输出到磁盘  2:以 InfluxDB LineProtocol 格式输出到磁盘
MetricsProcessorType=1

#配置各个 Metrics 日志的文件路径，可不配置
MethodMetricsFile=/your/path/to/log/method_metrics.log
ClassMetricsFile=/your/path/to/log/class_metrics.log
GCMetricsFile=/your/path/to/log/gc_metrics.log
MemMetricsFile=/your/path/to/log/memory_metrics.log
BufPoolMetricsFile=/your/path/to/log/buf_pool_metrics
ThreadMetricsFile=/your/path/to/log/thread_metrics.log

#配置 Record 模式，可配置为 accurate/rough
RecorderMode=accurate
   
#配置时间片，单位为 ms，最小 1s，最大 600s
MilliTimeSlice=10000
   
#需要监控的 package，可配置多个，用英文';'分隔
IncludePackages=your.package.to.monitor;cn.perf4j.demo;cn.perf4j.demo1.[p1,p2,p3];cn.*.demo.*

#是否展示方法参数类型
ShowMethodParams=true

查看配置文件模板。想了解更多的配置？请看这里

注意：需要修改 AppName、IncludePackages 和 xxxMetricsFile

运行

• 输出结果，输出到 /your/path/to/log/method_metrics.log:

  MyPerf4J Method Metrics [2019-03-03 17:27:50, 2019-03-03 17:28:00]
  Method[5]                              Type      RPS  Avg(ms)  Min(ms)  Max(ms)   StdDev     Count     TP50     TP90     TP95     TP99    TP999   TP9999  TP99999    TP100
  DemoServiceImpl.getId1(long)        General    51317     0.00        0        1     0.00    513178        0        1        1        1        1        1        1        1
  DemoServiceImpl.getId2(long)        General   168637     0.00        0        4     0.00   1686377        0        1        2        3        4        4        4        4
  DemoServiceImplV2.getId1(long)      General      357     0.00        0        0     0.00      3570        0        0        0        0        0        0        0        0
  DemoServiceImplV2.getId3(long)      General      713     0.51        0        5     0.08      7138        0        1        2        3        4        5        5        5
  Dao.doQuery()                  DynamicProxy     1394     0.51        0        5     0.05     13944        0        1        2        3        4        5        5        5
  

卸载

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

• -javaagent:/your/path/to/MyPerf4J-ASM.jar
• -DMyPerf4JPropFile=/your/path/to/MyPerf4J.properties

问题

如果您有任何问题、疑问或者建议，您可以 提交 Issue 或者 发送邮件 ：）

注意，为了保障大家的时间，请保证您已经完整阅读过以下内容：

• 提问模板
• 快速启动
• 中文文档
• 常见问题

参考项目

MyPerf4J 是受以下项目启发而来：

• Perf4J
• TProfiler

更多信息

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