PyCharm 2018.2 Help

Attaching to Process

While running a Python script launched either outside of PyCharm or inside PyCharm, you can attach it to another Python process if that process is not in the debug mode.

Prerequisites for Ubuntu users

If you are using PyCharm on Ubuntu (or probably, on some other Linux distribution), an error message ptrace: Operation not permitted may appear upon your first attempt to attach to a process. In this case, do one of the following:

  • To disable this restriction temporarily, enter the command:
    echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
  • To disable this restriction permanently, open the /etc/sysctl.d/10-ptrace.conf file for editing and change the line kernel.yama.ptrace_scope = 1 to kernel.yama.ptrace_scope = 0.
    To apply the changes immediately, enter the above command echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope. Alternatively, run sudo service procps restart or simply restart your system.

You can find more details here.

Attaching to process

Attach to a process following these general steps:

  1. Launch the process intended for debugging. You can do it from operating system or using the PyCharm terminal.
  2. To find the process to attach to, do one of the following:
    • On the main menu, choose Run | Attach to Process:
      Attach to Process menu item
    • On the main menu, choose Help | Find Action or press Ctrl+Shift+A. In the list of actions that appears, find the desired action by typing the first letters, and select it:
      Attach to process action
  3. From the list of available processes that appears, select the desired process. Simplify your search by typing the first letters of its name or PID.
    py attachToProcess
    In case there are several debuggers that can be used for the selected process, you can choose among them in the pop-up menu.

    You might want to show only specific processes in the Attach to Process list. Add the required pattern to the corresponding field in the Python Debugger settings (Settings/Preferences | Build, Execution, Deployment | Python Debugger ). For example, put "Scientific" if you want to attach only processes matching this string:

    Show only Scientific processes in the list of the available processes

  4. Proceed with debugging the same way as you usually do it in PyCharm (set breakpoints, step through, pause and resume the process, evaluate expressions, etc.)
  5. When finished, detach the process: select the Run | Stop or click the Stop the process button icons actions suspend svg of the Debug Tool Window.
Last modified: 20 June 2018

See Also