JetBrains Developer Community : All Content - IntelliJ IDEA FAQ

How to report IntelliJ IDEA performance problems and take CPU snapshots

serge@jetbrains.com — Thu, 26 Jan 2006 00:04:32 GMT

Common solutions for IntelliJ IDEA performance problems

Before capturing and providing the CPU snapshot, please be aware of the following known issues (and possible solutions):

Windows System Restore locking attrib.dat.data IntelliJ IDEA cache file when idea.system.path is set to custom location. Disable System Restore. (This should be obsolete starting from IntelliJ IDEA 7.0.4 as now IntelliJ IDEA uses different extension for such files and they are no longer affected by the System Restore).
Antiviral tools monitoring project and caches directories (USER_HOME\.IntelliJIdeaXX). Exclude IntelliJ IDEA project/library/caches directories from the monitor. In some cases only complete uninstall will fix the problem because of the low level drivers affecting the performance even when you disable the antivirus.
IntelliJ IDEA caches on the slow or network drive, check that USER_HOME\.IntelliJIdeaXX is on the local drive, adjust the location in IDEA_HOME\bin\idea.properties if necessary (but be aware of the first item in this list).
Project files/JDK files/Library jar files on the network drives. Move them to your local drives.
Low free system memory and therefore swapping. Close other applications, free as much memory as possible. Install additional RAM, decrease the heap.
Very large files (>10 000 lines). Refactor them if possible. Disable inspections per file to save some resources using the Hector icon in the status bar.
Heavily fragmented partition and full MFT, see the related blog post. Drive defragmentation can make IntelliJ IDEA much faster, we have proven it on our development machines.
Heavy disk activity caused by another applications, such as torrent clients, file servers. One thread can read data from the modern HDD at ~100 MB/sec. If there are 2 or more applications reading/writing to the same HDD at the same time, performance will drop to 2-3 MB/sec. Check that there are no processes constantly reading/writing to the disk. On Windows you can use SysInternals Process Monitor or Process Explorer.
Ant/Maven build or other external process modifying or generating lots of files/logs into the project directories. Synchronization will take lots of time in this case. Exclude such directories from the project.
When using version control, if there are many unversioned files (thousands), Changes view update may be slow. Exclude such directories from the version control in Settings | Version Control | Directory Version Control Settings by adding the directory with such files to the list and setting VCS to NONE.
Too many nodes open in the Project View will slow down editing. Collapsing the nodes will improve the performance. This issue is addressed in IntelliJ IDEA 9.0.
On Linux the editor performance may be seriously affected by the video adapter/drivers. It can be improved by running with -Dsun.java2d.pmoffscreen=false VM option or by editing the xorg.conf.
Too low heap size when running under 64-bit JVM or when working with large projects. Low heap will cause frequent garbage collection. Increase the heap in idea.exe.vmoptions (Windows), idea.vmoptions (Linux) or Info.plist (Mac). For 64-bit JVM you may need to double the defaults. Adding -XX:+UseCompressedOops option should also help when running under 64-bit JDK. Note that normally you should not use heap size higher than 1GB, especially on the 32-bit JVM, where the VM may fail to start whith the heap (-Xmx) > 1GB. If the heap is too high so that it doesn't fit into the free physical RAM, your OS will start swapping which will reduce the performance, also GC pauses may become longer. Don't use extreme memory values unless you know what you are doing.

Automatic Thread Dumps Logging

If the UI of IntelliJ IDEA is unresponsive for more than 5 seconds, it starts writing thread dumps to the logs directory. If you've encountered a situation of IntelliJ IDEA unresponsiveness or deadlock, please find the threadDumps-xxx directory from the session in which you've experienced the problem and send the contents to support@jetbrains.com.

The logs directory on Windows and Linux is USERPROFILE\.IntelliJIdeaXX\system\log.

On Mac OS X, the logs directory can be found at:

~/Library/Caches/IntelliJIDEAXX/logs

for IntelliJ IDEA 8.x and older versions

~/Library/Logs/IntelliJIDEAXX

for 9.0 and later IntelliJ IDEA versions

CPU snapshot capturing instructions

If you have a performance problem not related to the issues mentioned above, please contact support@jetbrains.com and provide the following information:

You hardware configuration (CPU, Memory, HDD)
OS, free memory when you start IntelliJ IDEA, IntelliJ IDEA heap settings, file system, IntelliJ IDEA caches location (if modified)

IntelliJ IDEA Ultimate includes a built-in YourKit profiling agent that can be used to take CPU and memory snapshots. Please use the following instructions to enable it.

Open IDEA_HOME/bin/idea.exe.vmoptions (idea.vmoptions on Linux/Solairs), add the following line at the bottom:
-agentlib:yjpagent

On Mac OS X open Info.plist located in /Applications/IntelliJ IDEA X.X.app/Contents, find the following:

<key>VMOptions</key>

<string>-Xms16m -Xmx192m -XX:MaxPermSize=120m -Xbootclasspath/p:../lib/boot.jar -ea</string>

Modify the string tag by adding -agentlib:yjpagent option, like:

<string>-Xms16m -Xmx192m -XX:MaxPermSize=120m -Xbootclasspath/p:../lib/boot.jar -ea -agentlib:yjpagent</string>

If you want to profile the slow startup of the application, CPU snapshot recording should be started automatically by using the following option instead:

-agentlib:yjpagent=sampling,noj2ee

Note that yjpagent library provided with IntelliJ IDEA 9 or earlier will not work on 64-bit operating system when you run IntelliJ IDEA under 64-bit JVM. If you can't run under 32-bit JVM, please obtain the 64-bit library version from the YourKit Java Profiler distribution (you need Linux .zip download of 7.5 or 8.x version containing library versions for different operating systems: Linux, Mac, Solaris, Windows). Replace yjpagent library in IDEA_HOME\bin with the appropriate version. Use 8.x YourKit version with IntelliJ IDEA 9.x and 7.5 version with previous IntelliJ IDEA versions. IntelliJ IDEA 10 and later has both 32-bit and 64-bit libraries bundled, therefore this step is not required.

For the 64-bit JVMs -agentlib:yjpagent64 option needs to be used instead or the IDE will not start.

Start IntelliJ IDEA and you should notice 2 new buttons in the toolbar, one for taking CPU snapshot, another one for Memory snapshot. You may need to enable View | Toolbar to access the buttons, or use Tools menu actions instead. Press the CPU button and perform the actions which take a lot of CPU resources on your machine. When finished, press this button again to stop recording, save the snapshot and upload it to ftp://ftp.intellij.net/.uploads/ (please note that listing is not allowed in this directory, only upload is permitted, therefore you will not be able to see/download your and other files there, some FTP clients may not like it, also be sure to switch into the binary transfer mode if uploading via commnad line ftp client). If you can't access FTP, use some free file sharing service and send us a link.

Send us an e-mail with the file name and we'll investigate the issue. In the e-mail please also describe what you were doing in detail. If you can reproduce it in a small project, please provide one. You can also submit an issue to YouTrack instead of contacting us by mail.

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

Memory snapshot

In case of memory related issues (memory usage goes high, garbage is not collected, etc) please use the Memory snapshot button in the menu near the CPU snapshot button. If it's not possible to get the snapshot because of the application crashing with OutOfMemory errors, please add the

-XX:+HeapDumpOnOutOfMemoryError

option to the IntelliJ IDEA JVM options. On the next OOM error the .hrpof dump will be produced and saved by the JVM (usually in the application working directory which is IDEA_HOME\bin). Upload this dump to our FTP as described above in the CPU snapshot section.

Please note that memory snapshot may contain the sensitive source code from your project. If you are uploading to a public service, use some password protection or enctyption. JetBrains FTP server is write only and you don't need to protect files uploaded there.

How to take thread dumps and report problems when IntelliJ IDEA hangs and doesn't respond

serge@jetbrains.com — Tue, 07 Aug 2007 15:35:32 GMT

In case IntelliJ IDEA doesn't respond, a thread dump could be taken to help us analyze and fix the problem that you experience.

To get the thread dump you can use jstack command line utility that comes with your JDK and is located in the JDK bin directory. In order to use jstack you need to know the process id of the JVM which runs IntelliJ IDEA. You can use your favorite task manager to get it or use the jps JDK utility. Once the process ID is obtained, run this command in the terminal/command line console:

jstack -l <pid>

Substitute <pid> with the previously obtained process id.

You can also redirect the output to a file that you can attach to your report:

jstack -l <pid> > dump.txt

After the dump is saved you can attach it to the YouTrack issue or send to the support team.

There are also different ways to take thread dumps which are platform specific, use them only in case jstack doesn't work for you.

Windows

Run IntelliJ IDEA via IDEA_HOME\bin\idea.bat file. You have to set IDEA_JDK environment variable first which points to 1.6 installation home. One of the ways to set it is to add the following line in the beginning of idea.bat file:

SET IDEA_JDK=C:\Program Files\Java\jdk1.6.0_10

Reproduce the problem. When IntelliJ IDEA hangs, press Ctrl+Break (NOT Ctrl+C) in the console window, copy the thread dump from the console.

Mac OS

Browse to the /Applications/IntelliJ IDEA XX.app/Contents/MacOS/idea in Finder, in the context menu choose Open With, Terminal. To get a thread dump press Ctrl+\ in the Terminal window.

Linux/Mac OS/Generic Unix/Solaris

You have to run IntelliJ IDEA with the terminal window shown, start your terminal and run IntelliJ IDEA via IDEA_HOME/idea.sh startup script. Reproduce the problem. Now use the ps utility to find IntelliJ IDEA process (it should be java process started from the idea.sh script), note the process ID (PID). Now open the second terminal window and issue the following command:

kill -QUIT PID

where PID is the the java process ID shown by ps. Thread dump should be printed in the first terminal window.

IntelliJ IDEA also takes thread dumps and saves them automatically on certain conditions under the %idea.system.path%\log directory (in the subdirectories starting with threadDumps). However, in some cases they may not get recorded, therefore it's recommended to take dumps manually as described above at the moments when IntelliJ IDEA doesn't respond.

What is EAP?

serge@jetbrains.com — Fri, 17 Oct 2003 13:55:29 GMT

The Early Access Program (EAP) gives you an opportunity to get acquainted with the new version of IntelliJ IDEA being currently under development.

The EAP section of our web-site contains a list of the planned and already implemented features for the next IntelliJ IDEA version. Here you can also download the most recent build, as well as subscribe to the newsgroups where it is recommended to post all the bug-reports and feature-suggestions related to the EAP builds.

To join the Early Access Program of IntelliJ IDEA, please refer to the IntelliJ IDEA EAP page.

How to maintain Subversion feature branches using IntelliJ IDEA 9.0.3

serge@jetbrains.com — Thu, 17 Jun 2010 22:27:13 GMT

Attached PDF document describes how to work with Subversion feature branches in IntelliJ IDEA 9.0.3.

This new feature is a result of addressing IDEA-22730. See also the related IntelliJ IDEA blog post.

Slow editor performance on Ubuntu 8.10

serge@jetbrains.com — Tue, 25 Nov 2008 20:01:28 GMT

The performance problem in all the Java Swing applications is caused by the Ubuntu specific bug. You can find more information in another bug description.

One known workaround until it's fixed in Ubuntu is:

Under Device section of the /etc/X11/xorg.conf file add the following line:

Option "AccelMethod" "XAA"

You can also add the following option, but some users reported that it makes menu drawing slower:

Option "XAANoOffscreenPixmaps" "true"

While this option should fix the editor scrolling performance, there could be other issues, like slow menu drawing speed. Changing Look&Feel to GTK+ is known to make it much faster.

UPDATE: this bug is fixed in JDK 1.6.0_12, running IntelliJ IDEA under this or later JDK version will also fix the performance problem without the need to edit xorg.conf.

Where do I email about features and bugs?

serge@jetbrains.com — Fri, 17 Oct 2003 12:47:34 GMT

You can join the community forums, where different user questions, feature-requests and bug-reports are discussed among IntelliJ IDEA users and our technical staff.

You can also post feture suggestions and bug reports to the YouTrack issue tracker.

In case of critical bug or problem that needs immediate solution, please contact support@intellij.com or fill in the support form. Double check that your reply-to e-mail address is correct and has no spam filters, otherwise we'll be not able to contact you.

Before e-mailing about a problem it's recommended to check that it's not already submitted to the tracker.

IntelliJ IDEA licensing and LAN

serge@jetbrains.com — Sat, 31 Jan 2004 21:08:22 GMT

IntelliJ IDEA allows to use a single license on any number of computers as well as under different platforms unless they are connected to the same LAN.

IntelliJ IDEA checks if there are any running copies of the software in the LAN when the IDE is launched. In case it finds any copy started with the same license key, the earlier started copy is forced to save all data and close.

FAQ for Eclipse users

serge@jetbrains.com — Thu, 14 May 2009 12:31:50 GMT

We've prepared a nice document for the users migrating from Eclipse.

http://www.jetbrains.com/idea/documentation/migration_faq.html