Attach technique allows to load the profiler agent into running JVM. Attached agent has several limitations in functionality in comparison with agent loaded on JVM startup. Attaching simplifies configuration by avoiding special steps to enable profiling, and makes profiling even more "on-demand" than ever.
All detected running Java processes are shown in the "Monitor Applications" list on Welcome screen. The colored circle indicates the profiler agent status. When agent is already loaded the circle is green. Orange circle shows that agent is not yet loaded but can be attached.
Attach to the application you want to profile by clicking on its name. Attach from context menu to provide custom agent options.
Attaching is possible to both local and remote applications. Local applications are shown under the node with icon. Applications running on the remote machines are shown under their own nodes with icon. To add a new remote machine click . See remote profiling from user interface to learn more.
Unfortunately, the attach mode is not an ultimate solution. The problem is that existing JVMs provide only limited set of profiling capabilities for the attached agents. To get all profiling capabilities, you still have to start the profiled application with the profiler agent instead.
The attach mode is only supported for Oracle JDK, OpenJDK HotSpot, JRockit, and IBM JDK based on OpenJ9.
Older IBM VMs, i.e. those not based on the OpenJ9 JVM, do not provide necessary capabilities to let YourKit Java Profiler function in the attach mode. To profile them, start application with the profiler agent.
Attach may fail due to insufficient access rights. For example, it may not be possible to attach to a Java EE server running as a Windows service. If attempt to attach fails, start the application with the profiler agent instead.
Client JVM can crash in attach mode due to a JVM bug
Due to a JVM bug 6776659 HotSpot client JVM can crash in attach mode.
There is no crash for the server JVM:
-server solves the problem.
A long pause is possible on first attempt to start CPU tracing or object allocation recording, because classes loaded before the profiler agent has attached need to be instrumented. Depending on application, it can take from several seconds to several tens of seconds, or even a few minutes in worst cases.
The good news is that there will be no pause on subsequent starts of CPU tracing or object allocation recording for the same running JVM instance.
No profiling results for some methods:
This means that their calls will be missing in: