Fully featured low overhead profiler for Java EE and Java SE platforms.
Easy to use performance and memory .NET profiler for Windows and Linux.
Performance monitoring and profiling of Jenkins, Bamboo, TeamCity, Gradle, Maven, Ant and JUnit.

Enabling profiling manually

Most likely, you will not need to configure profiling manually. Please first consider the automated ways to enable profiling in your local or remote application.

Step 1: Add VM option '-agentpath'

Add -agentpath:<full agent library path> VM option to the command line of Java application to be profiled.

The agent library path depends on your OS:

Platform VM option
AIX ppc64, 64-bit Java -agentpath:<profiler directory>/bin/aix-ppc-64/libyjpagent.so
FreeBSD x86, 64-bit Java -agentpath:<profiler directory>/bin/freebsd-x86-64/libyjpagent.so
Linux (glibc) x86, 32-bit Java -agentpath:<profiler directory>/bin/linux-x86-32/libyjpagent.so
x86, 64-bit Java -agentpath:<profiler directory>/bin/linux-x86-64/libyjpagent.so
ARM 32-bit (ARMv7 and higher, hard-float) -agentpath:<profiler directory>/bin/linux-arm-32/libyjpagent.so
ARM 64-bit (AArch64) -agentpath:<profiler directory>/bin/linux-arm-64/libyjpagent.so
ppc64, 64-bit Java, big-endian -agentpath:<profiler directory>/bin/linux-ppc-64/libyjpagent.so
ppc64le, 64-bit Java, little-endian -agentpath:<profiler directory>/bin/linux-ppc-64le/libyjpagent.so
Linux (Alpine, musl) x86, 64-bit Java -agentpath:<profiler directory>/bin/linux-musl-x86-64/libyjpagent.so
macOS Universal binary for arm64 and x86_64 -agentpath:<profiler directory>/bin/mac/libyjpagent.dylib
Windows 32-bit Java -agentpath:<profiler directory>\bin\win32\yjpagent.dll
64-bit Java -agentpath:<profiler directory>\bin\win64\yjpagent.dll

If you have copied the profiler agent library file from the profiler installation directory to another location, please change the path accordingly.

You can find examples of startup scripts for your platform in <profiler directory>/samples

To check that Java can load the profiler agent, invoke the following command that prints a description of agent parameters:

java -agentpath:<full agent library path>=help

If JVM reports an error, refer to the knowledge base article for troubleshooting.

Step 2: (Optional) Specify startup options

You can specify additional startup options. In most cases there's no need to use them.

To profile a Java EE server (especially JBoss!), specify startup option delay=10000

The options are comma separated: -agentpath:<full agent library path>[=<option>, ...].


java -agentpath:c:\yourkit\yjpagent.dll FooClass
java -agentpath:c:\yourkit\yjpagent.dll=alloceach=10,allocsizelimit=4096 FooClass

YourKit uses cookies and other tracking technologies to improve your browsing experience on our website, to show you personalized content and targeted ads, to analyze our website traffic, and to understand where our visitors are coming from.

By browsing our website, you consent to our use of cookies and other tracking technologies in accordance with the Privacy Policy.