目录

jfr

jfr在线教程在新窗口打开

提示

Java Flight Recorder (JFR) 是一种用于收集有关正在运行的 Java 应用程序的诊断和分析数据的工具。它集成到 Java 虚拟机 (JVM) 中,几乎不会造成性能开销,因此即使在负载较重的生产环境中也可以使用。

jfr 命令支持在程序动态运行过程中开启和关闭 JFR 记录。 记录收集有关 event 的数据。事件在特定时间点发生在 JVM 或 Java 应用程序中。每个事件都有一个名称、一个时间戳和一个可选的有效负载。负载是与事件相关的数据,例如 CPU 使用率、事件前后的 Java 堆大小、锁持有者的线程 ID 等。

jfr 命令基本运行结构是 jfr cmd [actionArg]

注意: JDK8 的 8u262 版本之后才支持 jfr

参数说明

参数名称参数说明
cmd要执行的操作 支持的命令【start,status,dump,stop】
actionArg属性名模式
[n:]记录名称
[r:]记录 id 值
[dumponexit:]程序退出时,是否要 dump 出 .jfr 文件,默认为 false
[d:]延迟多久后启动 JFR 记录,支持带单位配置,eg: 60s, 2m, 5h, 3d. 不带单位就是秒,默认无延迟
[duration:]JFR 记录持续时间,支持单位配置,不带单位就是秒,默认一直记录
[s:]采集 Event 的详细配置文件,默认是 default.jfc 位于 $JAVA_HOME/lib/jfr/default.jfc
[f:]将输出转储到指定路径
[maxage:]缓冲区数据最大文件记录保存时间,支持单位配置,不带单位就是秒,默认是不限制
[maxsize:]缓冲区的最大文件大小,支持单位配置, 不带单位是字节,m 或者 M 代表 MB,g 或者 G 代表 GB。
[state:]jfr 记录状态

启动 JFR 记录

$ jfr start
Started recording 1. No limit specified, using maxsize=250MB as default.

提示

默认情况下,开启的是默认参数的 jfr 记录

启动 jfr 记录,指定记录名,记录持续时间,记录文件保存路径。

$ jfr start -n myRecording --duration 60s -f /tmp/myRecording.jfr
Started recording 2. The result will be written to:
/tmp/myRecording.jfr

查看 JFR 记录状态

默认是查看所有 JFR 记录信息

$ jfr status
Recording: recording=1 name=Recording-1 (running)
Recording: recording=2 name=myRecording duration=PT1M (closed)

查看指定记录 id 的记录信息

$ jfr status -r 1
Recording: recording=1 name=Recording-1 (running)

查看指定状态的记录信息

$ jfr status --state closed
Recording: recording=2 name=myRecording duration=PT1M (closed)

dump jfr 记录

jfr dump 会输出从开始到运行该命令这段时间内的记录到 JFR 文件,且不会停止 jfr 的记录
指定记录输出路径

$ jfr dump -r 1 -f /tmp/myRecording1.jfr
Dump recording 1, The result will be written to:
/tmp/myRecording1.jfr

不指定文件输出路径,默认是保存到arthas-output目录下

$ jfr dump -r 1
Dump recording 1, The result will be written to:
/tmp/test/arthas-output/20220819-200915.jfr

停止 jfr 记录

不指定记录输出路径,默认是保存到arthas-output目录下

$ jfr stop -r 1
Stop recording 1, The result will be written to:
/tmp/test/arthas-output/20220819-202049.jfr

注意一条记录只能停止一次。

也可以指定记录输出路径。

通过浏览器查看 arthas-output 下面 JFR 记录的结果

默认情况下,arthas 使用 8563 端口,则可以打开: http://localhost:8563/arthas-output/在新窗口打开 查看到arthas-output目录下面的 JFR 记录结果:

生成的结果可以用支持 jfr 格式的工具来查看。比如:

  • JDK Mission Control : https://github.com/openjdk/jmc