- System requirements
- Profiler architecture
- Profiler installation
- Uninstall profiler
- Running the profiler
- Profiler activation
- Welcome screen
- Start profiling
- Profiling overhead
- Snapshots
- Solving performance problems
- CPU profiling
- Thread profiling
- Virtual threads support
- Object allocation profiling
- Memory profiling
- Monitor profiling
- Exception profiling
- JFR (Java Flight Recorder)
- Telemetry
- Probes: monitor events of various kinds
- Inspections: automatic recognition of typical problems
- Automatically trigger actions on event
- Automatic deobfuscation
- Summary
- Filters
- Profiler command line
- Export of profiling results to external formats
- Profiler Java API
- Profiler HTTP API
- Settings
- Troubleshooting and FAQ
Profiler installation
Interactive installation
Linux
Download and unzip the profiler archive.
macOS
Download and mount disk image, drag the profiler app to the Applications folder.
Windows
Download and run the installer following the wizard steps.
Unattended installation
Unattended installation is performed without user interaction, usually for automation purposes.
The following example uses profiler command line
to enter the license key and accept profiler EULA.
You need to replace <arch>, <build> and
<key> placeholders with actual values.
Linux
Installation
The profiler can be installed in any directory — for example,
in the user's home directory or system-wide in a shared location such as
/opt or /usr/bin.
The user who runs the command below must have write permissions for
the chosen installation directory.
unzip YourKit-JavaProfiler-2025.9-<build>-<arch>.zipAccepting EULA and entering license key
The user who runs the command below must be the same user who will run the profiler. Since the profiler configuration is stored in the user's home directory, a mismatch will cause the license key to be saved in the wrong location.
./YourKit-JavaProfiler-2025.9/bin/profiler.sh -accept-eula -license-key=<key>macOS
# Attach image
hdiutil attach YourKit-JavaProfiler-2025.9-<build>-<arch>.dmg
# Copy profiler files into ~/Applications
cp -r /Volumes/YourKit\ Java\ Profiler/YourKit\ Java\ Profiler.app ~/Applications
# Accept EULA and enter license key
~/Applications/YourKit\ Java\ Profiler.app/Contents/Resources/bin/profiler.sh -accept-eula -license-key=<key>Windows
Installation
The user who performs the installation and runs the command below must have administrator privileges.
start /wait YourKit-JavaProfiler-2025.9-<build>-<arch>.exe /S /D=C:\profilerAccepting EULA and entering license key
The user who runs the command below must be the same user who will run the profiler. Since the profiler configuration is stored in the user's home directory, a mismatch will cause the license key to be saved in the wrong location.
start /wait C:\profiler\bin\profiler.exe -accept-eula -license-key=<key>