Reporting performance problems
This article is dedicated to reporting performance problems with IntelliJ IDEs and related information to JetBrains support. You can submit a support request via the Help menu in your IDE or via Submit a Request button at the top of this page.
IntelliJ IDEA , Android Studio, and PyCharm Community Editions 2025.x version do not bundle the Async Profiler for IDE Performance Testing plug-in that is required for profiling. Please install it: In Settings (Preferences) | Plugins search for Async Profiler for IDE Performance Testing on the Marketplace tab.
IDE hangs and doesn't respond
When IDE hangs and doesn't respond so that you can't use the menu to capture the CPU snapshot, provide the thread dumps.
The CPU usage is high or IDE is slow
If you can continue working with the IDE, but it feels slower than expected or CPU usage is high:
-
Capture CPU Snapshot
Details
To provide an informative CPU snapshot you should click on Help | Diagnostic Tools | Start CPU Usage Profiling. For the first time you may be prompted to restart IDE (necessary VM options will be added) - in this case, after restarting select Start CPU Usage Profiling again.
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 Help | Diagnostic Tools | Stop CPU Usage Profiling to save the snapshot file (snapshot is saved in the user home directory and IDE will show a notification with the exact file name, the extension of the file is .zip). If you don't see a notification and can't find the snapshot file, please check that notifications are enabled for the Profiler.
When reporting the problem, please make sure to describe what you were doing in detail.
- Upload snapshot
Memory Leak or High Memory Consumption
If you can continue working with the IDE, but there is a memory leak:
-
Capture memory Snapshot
Details
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 Help | Diagnostic Tools | Capture Memory Snapshot menu item.
To capture automatic memory snapshots when IDE runs out of memory, add
-XX:+HeapDumpOnOutOfMemoryErrorinto .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
-XX:HeapDumpPath=/dumps/folderoption 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> - Upload snapshot
Profiling Slow Startup
If IDE is starting up slow:
- For 2023.2+ IDE versions, install the YourKit Profiler for IDE Performance Testing plug-in from Settings | Plugins.
-
Capture CPU usage snapshot of slow startup
Details
Invoke Help | Diagnostic Tools | Profile Slow Startup. Press Change and Restart IDE. After the restart, invoke Help | Diagnostic Tools | Stop CPU Usage Profiling.
- Upload snapshot
Profiling Slow Indexing
If the indexing process of an exact project runs longer than expected:
-
Capture CPU snapshot of slow indexing
Details
If you are using 2023.2 or later version, please open Settings (Preferences) | Plugins, search for YourKit Profiler for IDE Performance Testing on Marketplace tab and install it firstly.
Invoke Help | Diagnostic Tools | Profile Indexing. Click Invalidate and Restart (please note that Local History and Indices will be destroyed). Click Open Snapshot in ... to locate the snapshot.
If indexing doesn't stop, invoke Help | Diagnostic Tools | Stop YourKit Profiler (or Stop CPU Usage Profiling in earlier version) after waiting on the indexing phase a bit.
- Upload snapshot
Profiling build process
Please refer to this web help page to get detailed instructions on how to profile a build.
Article is closed for comments.
I can't seem to enable the profiler agent. I'm running IDEA EAP 15CE on Mac OS/X 10.10.5.
When I look in ~/Library/Preferences, I see two IDEA related directories:
I copied /Applications/IntelliJ\ IDEA\ 15\ CE.app/Contents/bin/idea.vmoptions over to IntelliJIdea15 and edited the file there to include:
I restarted the IDE, but there were no new options under the Tools menu. So then I tried editing idea.vmoptions under the IdeaIC15 directory, but when I do that, the IDE won't start at all and I see nothing to indicate what the error is in idea.log.
Is there something I'm doing wrong here?