Health check: Java Flight Recorder (JFR)
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Purpose
The Java Flight Recorder (JFR) health check runs every hour to verify that JFR is enabled and is recording Java Virtual Machine runtime data.
For more information about the Java Flight Recorder, see Diagnosing runtime issues using the Java Flight Recorder.
Health check results
| Icon | Result | What this means |
|---|---|---|
 | Java Flight Recorder (JFR) is enabled and the recording is running. | The Java Flight Recorder is enabled and Java Virtual Machine runtime data is being recorded. |
| Java Flight Recorder is disabled. | The Java Flight recorder is disabled. |
 | Java Flight Recorder (JFR) is enabled, but the recording is not running. | The Java Flight Recorder is enabled, but an issue is preventing runtime data from being recorded. |
Resolution
Here are a few things you can try if the Java Flight Recorder health check fails:
For further assistance, contact Atlassian Support.
Verify that your instance supports the Java Flight Recorder
Currently, the Java Flight Recorder in-app diagnostics are available in:
- Jira Server and Data Center 8.13 or newer
- Bitbucket Server and Data Center 8.3 or newer
- Confluence Server and Data Center 7.4 or newer
Learn more about Java Flight Recorder system requirements.
Verify that your instance meets Java version requirements
Your instance should run on one of the following supported versions of Java:
Oracle JRE or JDK
- Java 8
- Java 11
In Oracle Java versions earlier than 11, the Java Flight Recorder is available only in commercial packages based on the Java Platform, Standard Edition (Oracle Java SE Advanced and the Oracle Java SE Suite). Enabling the feature requires setting the -XX:+UnlockCommercialFeatures startup option. Learn more about setting properties and options on startup.
OpenJDK
Java 1.8 (build 8u282 or newer)
Java 11 (build 11.0.5 or newer)
Verify that the Java Flight Recorder directory is writable
The Java Flight Recorder stores logs, snapshots, and configuration files inside the <APP_HOME>/log/jfr directory, where <APP_HOME> is your application's home directory. Make sure that your application instance can write to that directory.
Check the logs
Look for any Java Flight Recorder-related errors in your application's main log file:
For Jira Server and Data Center, see Logging and profiling.
For Confluence Server and Data Center, see Working with Confluence logs.
For Bitbucket Server and Data Center, see Enable debug logging.
Restart the Java Flight Recorder
- Go to Administration (
) > System > Troubleshooting and support tools. - Select the Thread diagnostics tab and toggle the Thread diagnostics option on and off.