Skip to content
High performance Java APM. Powered by ASM. Try it. Test it. If you feel its better, use it.
Java
Branch: develop
Clone or download
Pull request Compare This branch is 44 commits behind LinShunKang:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
MyPerf4J-ASM
MyPerf4J-Base
MyPerf4J-Core
.coveralls.yml
.gitignore
.travis.yml
LICENSE
README.CN.md
README.EN.md
README.md
_config.yml
pom.xml

README.md

简体中文 | English

MyPerf4J

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

GitHub (pre-)release Build Status Coverage Status GitHub issues GitHub closed issues GitHub

价值

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

优势

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

文档

监控指标

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

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

快速启动

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

打包

  • git clone git@github.com: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

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

注意:需要修改 AppNameIncludePackagesxxxMetricsFile

运行

  • 输出结果,输出到 /your/path/to/log/method_metrics.log:
    MyPerf4J Method Metrics [2019-06-02 23:44:30, 2019-06-02 23:44:40]
    Method[4]                            Type        Level      RPS  Avg(ms)  Min(ms)  Max(ms)   StdDev     Count     TP50     TP90     TP95     TP99    TP999   TP9999    TP100
    DemoServiceImpl.getId1(long)      General      Service  3274139     0.00        0        0     0.00  32741398        0        0        0        0        0        0        0
    DemoServiceImpl.getId2(long)      General      Service  3274139     0.00        0        0     0.00  32741398        0        0        0        0        0        0        0
    DemoDAO.getId1(long)         DynamicProxy          DAO  3274139     0.00        0        0     0.00  32741398        0        0        0        0        0        0        0
    DemoDAO.getId2(long)         DynamicProxy          DAO  3274139     0.00        0        0     0.00  32741398        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/LinShunKang/MyPerf4J/issues/30(按登记顺序排列)

       

参考项目

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

更多信息

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

You can’t perform that action at this time.