内置的JFR(Java Flight Recorder)事件在哪里记录?

时间:2020-10-31 20:11:28

标签: java java-11 jfr

使用JDK 11,如果查看JRF记录的摘要,可以看到有140个不同的事件。其中一些可能未发生,在输出中清晰可见:

$ jfr summary /c/dev/jfrec/ddos.jfr

 Version: 2.0
 Chunks: 1
 Start: 2020-10-31 19:39:36 (UTC)
 Duration: 54 s

 Event Type                              Count  Size (bytes)
=============================================================
 jdk.JavaMonitorWait                      2727         79342
 jdk.NativeMethodSample                   2590         40722
 jdk.ThreadPark                           2125         89947
 ...
 jdk.GCHeapConfiguration                     1            30
 jdk.YoungGenerationConfiguration            1            21
 jdk.JavaMonitorInflate                      0             0
 jdk.ReservedStackActivation                 0             0

它们的名称都像是软件包jdk中的Java类一样。

另一方面,如果要实现自己的自定义JFR事件,则必须扩展jdk.jfr.Event类,因此我想所有jdk.*事件也都扩展了jdk.jfr.Event。 / p>

在正式的Java SE Javadocs(https://docs.oracle.com/en/java/javase/11/docs/api/index.html)中,jdk.jfr.Event被记录下来,但是jdk.*没有

如果不在官方Java SE平台Javadocs中,那么内置JFR事件类的官方文档放在哪里?

1 个答案:

答案 0 :(得分:2)

事件及其字段布局取决于JDK版本。

即使事件名称看起来像程序包名称,JDK中的大多数事件也不是使用Java类实现的。前缀“ jdk”。仅用于将它们与用户定义的事件区分开。

如果要查看特定JDK支持的内容,可以创建一个记录,然后使用“ jfr”工具查看元数据。

$ java -XX:StartFlightRecordering:filename=m.jfr -version
$ jfr metadata m.jfr.

即使实际事件是通过其他方式定义的,输出仍将使用Java语法。

@Name("jdk.CPUInformation")
@Category({"Operating System", "Processor"})
@Label("CPU Information")
class CPUInformation extends jdk.jfr.Event {
  @Label("Start Time")
  @Timestamp("TICKS")
  long startTime;

  @Label("Type")
  String cpu;

  @Label("Description")
  String description;

  @Unsigned
  @Label("Sockets")
  int sockets;

  @Unsigned
  @Label("Cores")
  int cores;

  @Unsigned
  @Label("Hardware Threads")
  int hwThreads;
}

(如果您对实现感兴趣,则有一些本机事件是通过XML描述[1]生成的C ++类。java.base/ jdk.internal.event [2]中的事件缺少元数据,但是使用镜像位于jdk.jfr / jdk.jfr.events [3]中的事件,您还可以在其中找到一些用Java实现的事件。

[1] https://github.com/openjdk/jdk/blob/master/src/hotspot/share/jfr/metadata/metadata.xml

[2] https://github.com/openjdk/jdk/tree/master/src/java.base/share/classes/jdk/internal/event

[3] https://github.com/openjdk/jdk/tree/master/src/jdk.jfr/share/classes/jdk/jfr/events