JDK Flight Recorder

Production time profiling and diagnostics for OpenJDK

JDK Flight Recorder is an event recorder built into the OpenJDK [1] Java virtual machine. It can be thought of as the software equivalent of a Data Flight Recorder (Black Box) in a commercial aircraft. It captures information about the JVM itself, and the application running in the JVM. There is a wide variety of data captured, for example method profiling, allocation profiling and garbage collection related events. The JDK Flight Recorder was designed to minimize the Observer Effect in the profiled system, and is meant to be always on in production systems. The technology was open sourced in 2018.

Analysis and visualization of flight recordings are normally done using JDK Mission Control.

## Technology

[edit]

A recording file consists of binary chunks of data. Each chunk is self describing and self contained. In other words, the metadata (such as the datatype and the content type of each attribute) needed to make use of the data (not only parse the events, but actually use them) is included in the chunk. Also all the values required to be resolved through e.g. constant pools are also included in the chunk.

There is a wide variety of technologies employed to make the JFR efficient, for example:

* Binary representations, no translations back and forth to strings, the buffers are efficiently emitted to disk
* Most events are recorded into thread local native buffers
* On some platforms invariant TSC is employed for efficient time stamping
* Integer compression scheme, to keep in-memory and on-file size down
* Since implemented in the JVM, much data is readily available, or emitted at a time when the data is readily available, keeping cost down

If converting a binary recording to JSON, it can easily blow up by two orders of magnitude or more, depending on length and content recorded.

The expected performance overhead of JFR using the default template is less than a percent, and for the profiling template, less than two percent.

## History

[edit]

JDK Flight Recorder started out as JRockit Flight Recorder, and was originally used as a means to collect data to be used to improve the JVM itself.[2][3] After Oracle acquired Sun Microsystems, JRockit Flight Recorder was rebranded Java Flight Recorder.[4] In 2018 Java Flight Recorder was open sourced and released as part of OpenJDK 11.[5] When open sourced it was rebranded JDK Flight Recorder, due to Java trademark issues.

## Versions

[edit]

These are the versions of JFR file format available. It does not encompass all the versions that have ever existed, but rather versions that exist in JVMs after the migration to HotSpot.

JFR Version | JDK Versions

|

v0.9 | Oracle JDK 7 (u4+), Oracle JDK 8
v1.0 | Oracle JDK 9, Oracle JDK 10
v2.0 | Oracle JDK 11+, Open JDK 11+, Azul JDK 8 and Azul JDK 11+

## Development

[edit]

The development of JDK Flight Recorder is taking place as part of the OpenJDK JDK [6] project on GitHub,[7] although most of the public discussions are taking place on the OpenJDK hotspot-jfr-dev [8] mailing list.

## See also

[edit]

* Free and open-source software portal
* Computer programming portal

* Java platform
* JDK Mission Control
* Java version history
* JRockit

## References

[edit]

1. ^ "OpenJDK". Retrieved 28 June 2023.
2. ^ "JRockit Flight Recorder Runtime Guide" (PDF). Retrieved 22 January 2019.
3. ^ Oracle JRockit: the Definitive Guide. Packt Pub. 2010. p. 588\. ISBN 978-1847198068.
4. ^ "Java Flight Recorder Runtime Guide". Retrieved 22 January 2019.
5. ^ "JEP 328: Flight Recorder". Retrieved 22 January 2019.
6. ^ "OpenJDK JDK Project". Retrieved 28 June 2023.
7. ^ "GitHub OpenJDK JDK". Retrieved 28 June 2023.
8. ^ "hotspot-jfr-dev mailing list". Retrieved 28 June 2023.