![](/img/trans.png)
[英]Java Flight Recorder (JFR) from command line: [jfr] [ERROR] [1014.291] Repository could not be removed at shutdown
[英]Where are built-in JFR (Java Flight Recorder) events documented?
使用 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
。
里面的官方Java SE的Javadoc( https://docs.oracle.com/en/java/javase/11/docs/api/index.html )的jdk.jfr.Event
被记录在案,但jdk.*
类是没有。
如果不在官方 Java SE 平台 Javadocs 中,那么内置 JFR 事件类的官方文档放在哪里?
事件及其字段布局取决于 JDK 版本。
尽管事件名称看起来像包名称,但 JDK 中的大多数事件都不是使用 Java 类实现的。 前缀“jdk”。 仅用于将它们与用户定义的事件区分开来。
如果您想查看特定 JDK 支持的内容,可以使用“jfr”工具查看元数据。
JDK 11-16:
$ java -XX:StartFlightRecording:filename=m.jfr -version
$ jfr metadata m.jfr.
JDK 17 及更高版本:
$ jfr metadata
输出将采用 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 描述生成的 C++ 类[1]。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
声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.