Attach to process
JetBrains Fleet provides a way to attach the debugger to both local and remote processes.
Prerequisites
The following prerequisites have to be met to enable full-fledged debugging:
The remote process should be started with the debug agent.
The application needs to be compiled with debugging information.
You need to have the application's source code.
Debug agent
Processes intended to allow debugger connections are started with the debug agent. Debug agent is a component of a host application that is responsible for communicating with the debugger. The communication happens over a socket connection, irrespective of whether the process is local or remote.
Start a process with the debug agent
When starting the process, add the following line to its VM options:
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005The option has the following parameters:
address– the port that will be used for debuggingserver=y– specifies that the process should listen for incoming debugger connections (act as a server).suspend– specifies whether the VM should wait until the debugger has connected or start executing the application's code immediately
-agentlib:jdwp=transport=dt_socket,server=n,address=192.168.1.178:5005,suspend=y,onthrow=<FQ exception class name>,onuncaught=<y/n>The option has the following parameters:
address– the IP address and the port of the server end. Both IPv4 and IPv6 are supported.server=n– specifies that the process should connect to the debugger (act as a client)suspend=y– specifies that the VM should wait until the debugger has connected before executing the application code.onthrow– optionally delays the connection until the specified exception is thrown. Use the exception's fully-qualified name as the value.onuncaught– optionally delays the connection until an uncaught exception is thrown. Use the exception's fully-qualified name as the value.
The format may differ depending on the JDK version.
Debug information
Debug information is a special kind of information in the application bytecode. The debugger uses this information to identify local variables, line numbers, and so on. The bytecode of an application may or may not have debugging information included.
The debug information is provided to the program at compile-time. This is controlled with the -g compiler flag. By default, the compiler includes most of the information required for debugging, but if it was not you, who compiled the application, it may happen that the program that you are going to debug was compiled without this information.
Application sources
You have to have the sources of the application you are debugging. JetBrains Fleet matches debugging events with the sources and displays information relevant to the debugging session in the editor. This allows you to view the debugging session as if it was the source code that is being executed.
Attach to a process
Press ⌘ ⇧ K and start typing
Attach to Process. Select Attach to Process.Choose from the suggested local processes or enter the host and port of the application you want to attach to. For example:
192.168.1.5:5005