Reporting performance problems

IDE hangs and doesn't respond

Please refer to this document for reporting the problems when IDE is completely frozen and doesn't respond to any actions for a long time.

If you can continue working with the IDE, but it feels slower than expected, CPU usage is high or there is a memory leak, read below.

Enabling Profiler Agent


Profiler agent is enabled by default in EAP builds, to enable it in the release builds do the following:

  1. Locate the .vmoptions file for your product (Mac OS users: don't forget to make a copy of the original file to ~/Library/Preferences/<product> and edit this copy instead).
  2. At the end of the .vmoptions file add the following line:

Windows users running under 64-bit JVM and editing <product>64.vmoptions file should use this line instead:



Linux users can utilize an alternative way to enable profiler: edit bin/<product>.sh startup script and change IS_EAP="false" to IS_EAP="true".

Agent library name on Linux is different, if you choose to modify the .vmoptions file, use the following: 


or this for the 64-bit systems:



IntelliJ IDEA and PyCharm Community Editions do not include a YourKit profiler agent, because the YourKit agent library is not open-source. To take a CPU or memory snapshot with the Community Edition, you can download an evaluation version of YourKit Java Profiler, copy the yjpagent library to the IDE bin directory, add it to the .vmoptions as described above, and connect to the running IDE instance from the standalone YourKit Profiler UI.


Capturing Snapshots

After restarting the IDE you should see two new items under the Tools menu: Start CPU Usage Profiling and Capture Memory Snapshot.

CPU Snapshot

To provide an informative CPU snapshot you should click on Start CPU Usage Profiling and then perform the actions which are causing performance problems, try to reproduce the performance problem several times while the snapshot is being recorded, then click on the Tools | Stop CPU Usage Profiling and save the snapshot file. When reporting the problem, please make sure to describe what you were doing in detail.

CPU Snapshot with Invocation Counts

When asked to provide a snapshot with the invocation counts, in addition to the -agentlib... option please also add the following into the .vmoptions file:


Make sure there is no disabletracing option in the -agentlib... line, use the options string from the Enabling Profiling Agent section of this document.

Restart your IDE and capture the CPU snapshot from the Tools menu or using the toolbar button.

Memory Snapshot

If the problem you are reporting is related to the heavy memory usage and frequent garbage collection, while increasing the heap size doesn't help, use the Capture Memory Snapshot menu item. To capture automatic memory snapshots when IDE runs out of memory, add


into .vmoptions file. .hprof dump file will be created in the current working directory of the application (IDEA_HOME/bin). In case this directory is read-only, add 


option to change it. See Oracle documentation for more details.

Please note, that memory snapshot may contain the sensitive source code from your project.

jmap Binary Memory Snapshot

Use jmap utility from the Java distribution to get shared object memory maps or heap memory details for a process. Process ID (pid) can be obtained using jps utility or your system specific process manager. Example:

jmap -dump:live,format=b,file=heap.bin <pid>


Thread Dumps

When IDE hangs and doesn't respond so that you can't use the menu to capture the snapshot, please provide the thread dumps.

 Profiling Slow Startup

To profile slow startup by automatically enabling CPU snapshot recording right after IDE is started, please use the sampling option:


 Adjust this line depending on the OS and the JDK (32-bit/64-bit, see in Help | About). Please check the Enabling Profiler Agent section above. You just need to replace "delay=10000" option with the "sampling" option.

CPU snapshot file will be saved automatically after your close the IDE into your HOME directory with the .snapshot extension.

Uploading Snapshots to JetBrains FTP Server

If your snapshot is smaller than 10MB, it's fine to attach directly to support tickets or YouTrack issues. Otherwise, please use or FTP:

After you've saved the snapshot, please upload it to our FTP server: (anonymous login, .uploads directory has no permissions to list/download files, only for upload, so that other users will not be able to download your snapshots). Inform JetBrains developers via YouTrack performance problem report about the uploaded file and provide its name (or send this file name to the Support Team via the ticket).

If you can't use FTP, upload the snapshot at or use some file sharing service, like Dropbox, Google Drive, etc. and send us the link.

Please see Uploading Large Files for JetBrains Support Team for more details.

Have more questions? Submit a request


  •  This line no longer works on 64 bit linux:

    *      *-agentlib:yjpagent64=delay=10000

    The line that works is


    The new line is needed since at least idea-IU-117.798.  The name of the library is now

  • Michael Hirsch, thanks for the correction, I've updated the document.

  • I'm seeing hanging too, with pycharm maxing the CPU for about a minute when it happens, which seems to be when I open a contextual menu.

  • I am also seeing hanging in pycharm 3.4 when using the contextual menu. Should I submit some Snapshots?

  • I have 8.03 on Windows and cannot save my CPU Snapshot. After I click Stop CPU Usage Profiling there is no way to save the snapshot file. 


  • Snapshots are now saved automatically and you should see a notification about that with a link to open the folder where it's stored:



  • Thanks Serge - I also needed to turn Profiler notifications on (they're disabled by default). I got it now though. 

  • I tried to run CPU profiler in webstorm 10 EAP but there is no option for Start CPU Usage Profiling

  • How do you disable the profiler if it is on by defautl? I am having performance problem and want to try to turn this part off.

  • Remove this line from the .vmoptions file


  • @Serge I am running an EAP .. i figured it out by going into and setting is_eap to false

  • I'm unable to edit idea64.exe.vmoptions on my Windows machine...seems there's some process that's using it and not allowing me to edit it.  I've closed completely out of IntelliJ IDEA and still can't edit it.

  • Run your editor as Administrator, then open the file and edit it, otherwise UAC will not allow to edit files under Program Files folder for regular users.

  • I'm such a dummy...just got a coffee so that will hopefully help my brain work!  It is annoying that I'm running as an Admin on my PC and yet I have to grant the User group permission to modify the file...all set now...thanks.

  • IntelliJ is very aggressive about toString()'ing things in the debugger, and when I disabled the cache on my database to try to slim-down our memory profile, boy did that get me in trouble. Specifically, I'm using MapDB which (as the name implies) has databases that interface as objects. As such a mapDBStoreObjectThatsInstanceOfMap.size() call, when the database isnt caching, will take a really long time.

    Any chance there's a @Debugger(ignoreField = true) annotation I could put on this field or something similar?

    Better yet, If I could make a feature request, it would be that whatever code is evaluating the toString of these things in the environment, does so on another thread with liberal use of timeouts.

  • I have webstorm 10.0.2 the latest version of web storm. Some how my CSS auto complete does not work. I can't see the auto complete of my bootstrap css and my custom css. I just recognize only html and javascript.  In webstorm version 8 is working perfectly fine. When I download the new version of webstorm, it won't work any more. What should I do?

  • Sam, please submit a ticket to support with idea.log (

  • Hi Serge, 

    In: Library/Preferences/

    I had no WebStorm folder so I created one and copied the webstorm.vmoptions file to that location.

    Restarted webstorm.

    I was supposed to get the tools "Start CPU Usage Profiling and Capture Memory Snapshot".

    I only have "capture memory snapshot" which was present from the beginning.

    Thanks / E

  • You are looking in a wrong folder, search for the existing one, it's under ~/Library/Preferences, not /Library/Preferences. ~ stands for /Users/<user name>, so the actual folder is under /Users/<user name>/Library/Preferences.

  • Is it possible to capture CPU Snapshot automatically? I am requested to do so but I am unable to save snapshot because IntelliJ will hang indefinitely once the issue happens.

  • Martin, in such cases you should provide a thread dump instead: .

  • This IDE is the black sheep of the JetBrains family. I have a super-powerful computer and the Webstorm stumbles like a cow in a bucket.

  • The instructions to locate vmoptions file can be found here:



    ????? ???? ???? ?????????

    OSX ws 10

    ??? ????? ?? ??? ??????????? ??? ?? ?????? ?

    ????????? ???????? ??? ?????? ?? ???? ????? ????? ?? ???? ????? lightweight 

  • Serge Baranov, ?????? ? ???? ??????????? ???? ?????? ? :)


  • Please submit a ticket to support with a memory snapshot.

  • Serge Baranov

    ??? ??????????. ????????? 

    1) ? ?? ??????, ? ????? ????????? ?????? ?? ??????????

    2) 40 ???????? ? ???? ???????? ??? ????

    3) ????? ?? ?? ???? ?? ?????? ? ????? ??????? ??????. ??? ???? ? ???????? ???? ?????, ? ???? ??? ??????.

  • I believe OS X needs this line instead (for the YourKit I downloaded today):

    But IntelliJ IDEA still doesn't have extra options in the Tools menu...

  • Luke, make sure you've added it to the correct .vmoptions file per . Note the Mac OS X specifics (modify a copy of the original file). Check idea.log to ensure that profiler agent was loaded. YourKit agent is already present in the Ultimate Edition. If you are using Community Edition, you need to connect to IDE via profiler UI, there will be no buttons in the menu.

Article is closed for comments.